Autenticazione con Firebase in modo anonimo sulle piattaforme Apple

Puoi utilizzare Firebase Authentication per creare e utilizzare account anonimi temporanei per eseguire l'autenticazione con Firebase. Questi account anonimi temporanei possono essere utilizzati per: consenti agli utenti che non si sono ancora registrati alla tua app di lavorare con i dati protetti in base alle regole di sicurezza. Se un utente anonimo decide di registrarsi alla tua app, puoi collegare le sue credenziali di accesso all'account anonimo in modo che possa continuare a lavorare con i suoi dati protetti nelle sessioni future.

Prima di iniziare

  1. Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

    1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
    2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple Firebase:
      3.   https://github.com/firebase/firebase-ios-sdk.git
    3. Scegli la raccolta Firebase Authentication.
    4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di compilazione del target.
    5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
  2. Se non hai ancora collegato la tua app al progetto Firebase, puoi farlo da la console Firebase.
  3. Attiva l'autenticazione anonima:
    1. Nella console Firebase, apri la sezione Auth.
    2. Nella pagina Metodi di accesso, attiva il metodo di accesso Anonimo.
    3. Facoltativo: se hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi attivare la pulizia automatica. Se attivo questa impostazione, gli account anonimi che risalgono a oltre 30 giorni fa verranno eliminati automaticamente. Nei progetti in cui è abilitata la pulizia automatica, l'autenticazione anonima non vengono conteggiati ai fini dei limiti di utilizzo o delle quote di fatturazione. Consulta: Pulizia automatica.

Esegui l'autenticazione con Firebase in modo anonimo

Quando un utente che non ha eseguito l'accesso utilizza una funzionalità dell'app che richiede l'autenticazione con Firebase, accedi all'utente in modo anonimo svolgendo i seguenti passaggi:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate e tutti gli altri Moduli Firebase utilizzati dal delegato della tua app. Ad esempio, per utilizzare Cloud Firestore e Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Se utilizzi SwiftUI, devi creare un delegato per l'applicazione e collegarlo al tuo struct App tramite UIApplicationDelegateAdaptor oppure NSApplicationDelegateAdaptor. Devi anche disattivare lo scambio del delegato dell'app. Per Per ulteriori informazioni, consulta le istruzioni di SwiiftUI.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Chiama il metodo signInAnonymouslyWithCompletion::

    Swift

    Auth.auth().signInAnonymously { authResult, error in
  // ...
}

    Objective-C

    [[FIRAuth auth] signInAnonymouslyWithCompletion:^(FIRAuthDataResult * _Nullable authResult,
                                                  NSError * _Nullable error) {
   // ...
 }];
  5. Se il metodo signInAnonymouslyWithCompletion: viene completato senza errori, puoi recuperare i dati dell'account dell'utente anonimo dall'oggetto FIRAuthDataResult:

    Swift

    guard let user = authResult?.user else { return }
let isAnonymous = user.isAnonymous  // true
let uid = user.uid

    Objective-C

    FIRUser *user = authResult.user;
BOOL isAnonymous = user.anonymous;  // YES
NSString *uid = user.uid;

Convertire un account anonimo in un account permanente

Quando un utente anonimo si registra alla tua app, potresti volergli consentire di continuare a lavorare con il suo nuovo account. Ad esempio, potresti rendere disponibili nel carrello del nuovo account gli articoli che l'utente ha aggiunto al carrello prima di registrarsi. Per farlo, completa i seguenti passaggi passaggi:

  1. Quando l'utente si registra, completa la procedura di accesso per il fornitore di servizi di autenticazione dell'utente fino alla chiamata di uno dei metodi FIRAuth.signInWith, esclusa questa operazione. Ad esempio, puoi ottenere il token ID di Google, il token di accesso di Facebook o l'indirizzo email e la password dell'utente.

  2. Richiedi un FIRAuthCredential per il nuovo provider di autenticazione:

    Accedi con Google
    Swift
    guard
  let authentication = user?.authentication,
  let idToken = authentication.idToken
else {
  return
}

let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                               accessToken: authentication.accessToken)
    Objective-C
    FIRAuthCredential *credential =
[FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                 accessToken:result.user.accessToken.tokenString];
    Accesso Facebook
    Swift
    let credential = FacebookAuthProvider
  .credential(withAccessToken: AccessToken.current!.tokenString)
    Objective-C
    FIRAuthCredential *credential = [FIRFacebookAuthProvider
    credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];
    Accesso via email con password
    Swift
    let credential = EmailAuthProvider.credential(withEmail: email, password: password)
    Objective-C
    FIRAuthCredential *credential =
    [FIREmailAuthProvider credentialWithEmail:email
                                             password:password];

  3. Trasmetti l'oggetto FIRAuthCredential all'account dell'utente che ha eseguito l'accesso Metodo linkWithCredential:completion::

    Swift
        user.link(with: credential) { authResult, error in
  // ...
}
}
    Objective-C
        [[FIRAuth auth].currentUser linkWithCredential:credential
    completion:^(FIRAuthDataResult *result, NSError *_Nullable error) {
  // ...
}];

Se la chiamata a linkWithCredential:completion: va a buon fine, il nuovo account dell'utente può accedere ai dati di Firebase dell'account anonimo.

Pulizia automatica

Se hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi: abilita la pulizia automatica nella console Firebase. Attivando questa funzionalità consenti Firebase per eliminare automaticamente gli account anonimi che risalgono a più di 30 giorni fa. Nei progetti in cui è attivata la pulizia automatica, l'autenticazione anonima non viene conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione.

  • Tutti gli account anonimi creati dopo l'attivazione della pulizia automatica potrebbero essere eliminati automaticamente in qualsiasi momento dopo 30 giorni dalla creazione.
  • Gli account anonimi esistenti saranno idonei per l'eliminazione automatica 30 giorni dopo l'attivazione della pulizia automatica.
  • Se disattivi la pulizia automatica, gli account anonimi pianificati per l'eliminazione rimarranno pianificati per l'eliminazione.
  • Se esegui l'upgrade un account anonimo collegandolo a qualsiasi metodo di accesso, l'account non vengono eliminati automaticamente.

Se vuoi sapere quanti utenti saranno interessati prima di attivare questa funzionalità e hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi filtrare in base a is_anon in Cloud Logging.

Passaggi successivi

Ora che gli utenti possono autenticarsi con Firebase, puoi controllare il loro accesso a presenti nel database Firebase utilizzando regole Firebase.