Autenticazione con Firebase in modo anonimo sulle piattaforme Apple

Puoi utilizzare Firebase Authentication per creare e utilizzare account anonimi temporanei per l'autenticazione con Firebase. Questi account anonimi temporanei possono essere utilizzati per consentire agli utenti che non si sono ancora registrati alla tua app di lavorare con i dati protetti dalle 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 > Add Packages (File > Aggiungi pacchetti).
    2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
    4. Scegli la raccolta Firebase Authentication.
    5. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del target.
    6. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
  2. Se non hai ancora connesso la tua app al progetto Firebase, fallo dalla console Firebase.
  3. Attiva l'autenticazione anonima:
    1. Nella Firebaseconsole, 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 attivi questa impostazione, gli account anonimi che risalgono a oltre 30 giorni fa verranno eliminati automaticamente. Nei progetti con la pulizia automatica attivata, l'autenticazione anonima non rientrerà più nel conteggio dei limiti di utilizzo o delle quote di fatturazione. Vedi Pulizia automatica.

Eseguire 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, esegui l'accesso dell'utente in modo anonimo completando i seguenti passaggi:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal delegato dell'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 nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:FirebaseApp

    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 dell'applicazione e collegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo swizzling del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni per SwiftUI.

    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 ottenere 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 voler consentirgli di continuare il suo lavoro con il nuovo account. Ad esempio, potresti voler rendere disponibili nel carrello del nuovo account gli articoli che l'utente ha aggiunto al carrello prima della registrazione. Per farlo, completa i seguenti passaggi:

  1. Quando l'utente si registra, completa il flusso di accesso per il provider di autenticazione dell'utente fino a, ma non incluso, la chiamata a uno dei metodi FIRAuth.signInWith. Ad esempio, ottieni il token ID Google dell'utente, il token di accesso a Facebook o l'indirizzo email e la password.
  2. Ottieni 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 a Facebook
    Swift
    let credential = FacebookAuthProvider
      .credential(withAccessToken: AccessToken.current!.tokenString)
    Objective-C
    FIRAuthCredential *credential = [FIRFacebookAuthProvider
        credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];
    Accesso con email e password
    Swift
    let credential = EmailAuthProvider.credential(withEmail: email, password: password)
    Objective-C
    FIRAuthCredential *credential =
        [FIREmailAuthProvider credentialWithEmail:email
                                                 password:password];
  3. Passa l'oggetto FIRAuthCredential al metodo linkWithCredential:completion: dell'utente che ha eseguito l'accesso:

    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 Firebase dell'account anonimo.

Pulizia automatica

Se hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi attivare la pulizia automatica nella console Firebase. Quando attivi questa funzionalità, consenti a Firebase di eliminare automaticamente gli account anonimi più vecchi di 30 giorni. Nei progetti con pulizia automatica abilitata, l'autenticazione anonima non verrà conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione.

  • 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 all'eliminazione automatica 30 giorni dopo l'attivazione della pulizia automatica.
  • Se disattivi la pulizia automatica, gli account anonimi la cui eliminazione è pianificata rimarranno pianificati per l'eliminazione.
  • Se "esegui l'upgrade" di un account anonimo collegandolo a un metodo di accesso, l'account non verrà eliminato automaticamente.

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

Passaggi successivi

Ora che gli utenti possono autenticarsi con Firebase, puoi controllare il loro accesso ai dati nel tuo database Firebase utilizzando le regole di Firebase.