S'authentifier de manière anonyme avec Firebase sur les plates-formes Apple

Vous pouvez utiliser Firebase Authentication pour créer et utiliser des comptes anonymes temporaires afin de vous authentifier auprès de Firebase. Ces comptes anonymes temporaires peuvent être utilisés pour permettre aux utilisateurs qui ne se sont pas encore inscrits à votre application de travailler avec des données protégées par des règles de sécurité. Si un utilisateur anonyme décide de s'inscrire à votre application, vous pouvez associer ses identifiants de connexion au compte anonyme afin qu'il puisse continuer à travailler avec ses données protégées lors de futures sessions.

Avant de commencer

1. Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

   1. Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
   2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :

     https://github.com/firebase/firebase-ios-sdk.git

   3. Choisissez la bibliothèque Firebase Authentication.
   4. Ajoutez l'indicateur -ObjC à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible.
   5. Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.
2. Si vous n'avez pas encore associé votre application à votre projet Firebase, faites-le depuis la console Firebase.
3. Activez l'authentification anonyme :
   1. Dans la console Firebase, ouvrez la section Authentification.
   2. Sur la page Modes de connexion, activez le mode de connexion Anonyme.
   3. Facultatif : Si vous avez mis à niveau votre projet vers Firebase Authentication with Identity Platform, vous pouvez activer le nettoyage automatique. Lorsque vous activez ce paramètre, les comptes anonymes de plus de 30 jours sont automatiquement supprimés. Dans les projets pour lesquels le nettoyage automatique est activé, l'authentification anonyme ne sera plus comptabilisée dans les limites d'utilisation ni dans les quotas de facturation. Consultez la section Nettoyage automatique.

S'authentifier avec Firebase de manière anonyme

Lorsqu'un utilisateur déconnecté utilise une fonctionnalité d'application nécessitant une authentification avec Firebase, connectez-le de manière anonyme en suivant les étapes ci-dessous :

1. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que tous les autres modules Firebase utilisés par le délégué de votre application. Par exemple, pour utiliser Cloud Firestore et 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. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) du délégué de votre application :

   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. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre structure App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le swizzling du délégué d'application. Pour en savoir plus, consultez les instructions 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. Appelez la méthode signInAnonymouslyWithCompletion: :

   Swift

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

   Objective-C

   [[FIRAuth auth] signInAnonymouslyWithCompletion:^(FIRAuthDataResult * _Nullable authResult,
                                                     NSError * _Nullable error) {
      // ...
    }];

5. Si la méthode signInAnonymouslyWithCompletion: se termine sans erreur, vous pouvez obtenir les données de compte de l'utilisateur anonyme à partir de l'objet 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;

Convertir un compte anonyme en compte permanent

Lorsqu'un utilisateur anonyme s'inscrit à votre application, vous pouvez lui permettre de poursuivre son travail avec son nouveau compte. Par exemple, vous pouvez faire en sorte que les articles qu'il a ajoutés à son panier avant son inscription soient disponibles dans le panier de son nouveau compte. Pour cela, procédez comme suit :

1. Lorsque l'utilisateur s'inscrit, effectuez le flux de connexion pour le fournisseur d'authentification de l'utilisateur jusqu'à l'appel d'une des méthodes FIRAuth.signInWith, mais sans l'inclure. Par exemple, récupérez le jeton d'identité Google de l'utilisateur, le jeton d'accès Facebook, ou son adresse e-mail et son mot de passe.

2. Obtenez un FIRAuthCredential pour le nouveau fournisseur d'authentification :

   Google Sign-In

   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];

   Connexion avec Facebook

   Swift

   let credential = FacebookAuthProvider
     .credential(withAccessToken: AccessToken.current!.tokenString)

   Objective-C

   FIRAuthCredential *credential = [FIRFacebookAuthProvider
       credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];

   Connexion avec une adresse e-mail et un mot de passe

   Swift

   let credential = EmailAuthProvider.credential(withEmail: email, password: password)

   Objective-C

   FIRAuthCredential *credential =
       [FIREmailAuthProvider credentialWithEmail:email
                                                password:password];

3. Transmettez l'objet FIRAuthCredential à la méthode linkWithCredential:completion: de l'utilisateur connecté :

   Swift

       user.link(with: credential) { authResult, error in
     // ...
   }
   }

   Objective-C

       [[FIRAuth auth].currentUser linkWithCredential:credential
       completion:^(FIRAuthDataResult *result, NSError *_Nullable error) {
     // ...
   }];

Si l'appel à linkWithCredential:completion: réussit, le nouveau compte de l'utilisateur peut accéder aux données Firebase du compte anonyme.

Nettoyage automatique

Si vous avez mis à niveau votre projet vers Firebase Authentication with Identity Platform, vous pouvez activer le nettoyage automatique dans la console Firebase. Lorsque vous activez cette fonctionnalité, vous autorisez Firebase à supprimer automatiquement les comptes anonymes de plus de 30 jours. Dans les projets où le nettoyage automatique est activé, l'authentification anonyme n'est pas comptabilisée dans les limites d'utilisation ni dans les quotas de facturation.

• Les comptes anonymes créés après l'activation du nettoyage automatique peuvent être supprimés à tout moment après 30 jours suivant leur création.
• Les comptes anonymes existants pourront être supprimés automatiquement 30 jours après l'activation du nettoyage automatique.
• Si vous désactivez le nettoyage automatique, les comptes anonymes dont la suppression est planifiée le resteront.
• Si vous "mettez à niveau" un compte anonyme en l'associant à une méthode de connexion, il ne sera pas supprimé automatiquement.

Si vous souhaitez voir le nombre d'utilisateurs concernés avant d'activer cette fonctionnalité et que vous avez mis à niveau votre projet vers Firebase Authentication with Identity Platform, vous pouvez filtrer par is_anon dans Cloud Logging.

Étapes suivantes

Maintenant que les utilisateurs peuvent s'authentifier avec Firebase, vous pouvez contrôler leur accès aux données de votre base de données Firebase à l'aide des règles Firebase.