Authentification à l'aide de Google Sign-In sur les plates-formes Apple

Vous pouvez permettre à vos utilisateurs de s'authentifier auprès de Firebase à l'aide de leurs comptes Google en intégrant Google Sign-In dans votre application.

Avant que tu commences

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

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

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

3. Choisissez la bibliothèque Firebase Authentication.
4. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Activer Google Sign-In pour votre projet Firebase

Pour autoriser les utilisateurs à se connecter à l'aide de Google Sign-In, vous devez d'abord activer le fournisseur de connexion Google pour votre projet Firebase :

1. Dans la console Firebase , ouvrez la section Authentification .
2. Dans l'onglet Méthode de connexion , activez le fournisseur Google .
3. Cliquez sur Enregistrer .

Importer les fichiers d'en-tête requis

Tout d'abord, vous devez importer les fichiers d'en-tête du SDK Firebase et du SDK de connexion Google dans votre application.

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

@import FirebaseCore;
@import GoogleSignIn;

Mettre en œuvre la connexion Google

Mettez en œuvre Google Sign-In en suivant ces étapes. Consultez la documentation du développeur Google Sign-In pour plus de détails sur l'utilisation de Google Sign-In avec iOS.

1. Ajoutez des schémas d'URL personnalisés à votre projet Xcode :
1. Ouvrez la configuration de votre projet : cliquez sur le nom du projet dans l'arborescence de gauche. Sélectionnez votre application dans la section CIBLES , puis sélectionnez l'onglet Infos et développez la section Types d'URL .
2. Cliquez sur le bouton + et ajoutez un schéma d'URL pour votre ID client inversé. Pour trouver cette valeur, ouvrez le fichier de configuration GoogleService-Info.plist et recherchez la clé REVERSED_CLIENT_ID . Copiez la valeur de cette clé et collez-la dans la zone Schémas d'URL de la page de configuration. Laissez les autres champs intacts.

   Une fois terminée, votre configuration devrait ressembler à ce qui suit (mais avec les valeurs spécifiques à votre application) :

   
2. Dans la méthode application:didFinishLaunchingWithOptions: de votre délégué d'application, configurez l'objet FirebaseApp .

   Rapide

   FirebaseApp.configure()
   

   Objectif c

   // Use Firebase library to configure APIs
   [FIRApp configure];
   

3. Implémentez la application:openURL:options: de votre délégué d'application. La méthode doit appeler la méthode handleURL de l'instance GIDSignIn , qui gérera correctement l'URL que votre application reçoit à la fin du processus d'authentification.

   Rapide

   func application(_ app: UIApplication,
                    open url: URL,
                    options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
     return GIDSignIn.sharedInstance.handle(url)
   }
   

   Objectif c

   - (BOOL)application:(nonnull UIApplication *)application
               openURL:(nonnull NSURL *)url
               options:(nonnull NSDictionary<NSString *, id> *)options {
     return [[GIDSignIn sharedInstance] handleURL:url];
   }
   

4. Transmettez le contrôleur de vue de présentation et l'ID client de votre application à la méthode signIn du fournisseur de connexion Google et créez un identifiant d'authentification Firebase à partir du jeton d'authentification Google résultant :

   Rapide

   guard let clientID = FirebaseApp.app()?.options.clientID else { return }
   
   // Create Google Sign In configuration object.
   let config = GIDConfiguration(clientID: clientID)
   GIDSignIn.sharedInstance.configuration = config
   
   // Start the sign in flow!
   GIDSignIn.sharedInstance.signIn(withPresenting: self) { [unowned self] result, error in
     guard error == nil else {
       // ...
     }
   
     guard let user = result?.user,
       let idToken = user.idToken?.tokenString
     else {
       // ...
     }
   
     let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                    accessToken: user.accessToken.tokenString)
   
     // ...
   }
   

   Objectif c

   GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];
   [GIDSignIn.sharedInstance setConfiguration:config];
   
   __weak __auto_type weakSelf = self;
   [GIDSignIn.sharedInstance signInWithPresentingViewController:self
         completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) {
     __auto_type strongSelf = weakSelf;
     if (strongSelf == nil) { return; }
   
     if (error == nil) {
       FIRAuthCredential *credential =
       [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                        accessToken:result.user.accessToken.tokenString];
       // ...
     } else {
       // ...
     }
   }];
   
   

5. Ajoutez un GIDSignInButton à votre storyboard, fichier XIB ou instanciez-le par programme. Pour ajouter le bouton à votre storyboard ou fichier XIB, ajoutez une vue et définissez sa classe personnalisée sur GIDSignInButton .
6. Facultatif : si vous souhaitez personnaliser le bouton, procédez comme suit :

   Rapide

   1. Dans votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.

      @IBOutlet weak var signInButton: GIDSignInButton!

   2. Connectez le bouton à la propriété signInButton que vous venez de déclarer.
   3. Personnalisez le bouton en définissant les propriétés de l'objet GIDSignInButton .

   Objectif c

   1. Dans le fichier d'en-tête de votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.

      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;

   2. Connectez le bouton à la propriété signInButton que vous venez de déclarer.
   3. Personnalisez le bouton en définissant les propriétés de l'objet GIDSignInButton .

S'authentifier avec Firebase

Enfin, terminez le processus de connexion Firebase avec les informations d'identification d'authentification créées à l'étape précédente.

Auth.auth().signIn(with: credential) { result, error in

  // At this point, our user is signed in
}
    

[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

Prochaines étapes

Lorsqu'un utilisateur se connecte pour la première fois, un nouveau compte d'utilisateur est créé et lié aux informations d'identification (c'est-à-dire le nom d'utilisateur et le mot de passe, le numéro de téléphone ou les informations du fournisseur d'authentification) avec lesquelles l'utilisateur s'est connecté. Ce nouveau compte est stocké dans le cadre de votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet, quelle que soit la manière dont l'utilisateur se connecte.

• Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir de l'objet User . Voir Gérer les utilisateurs .

• Dans vos règles de sécurité Firebase Realtime Database et Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Vous pouvez autoriser les utilisateurs à se connecter à votre application à l'aide de plusieurs fournisseurs d'authentification en liant les informations d'identification du fournisseur d'authentification à un compte d'utilisateur existant.

Pour déconnecter un utilisateur, appelez signOut: .

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

Vous pouvez également ajouter un code de gestion des erreurs pour l'ensemble des erreurs d'authentification. Voir Gérer les erreurs .

Vous pouvez permettre à vos utilisateurs de s'authentifier auprès de Firebase à l'aide de leurs comptes Google en intégrant Google Sign-In dans votre application.

Avant que tu commences

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

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

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

3. Choisissez la bibliothèque Firebase Authentication.
4. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Activer Google Sign-In pour votre projet Firebase

Pour autoriser les utilisateurs à se connecter à l'aide de Google Sign-In, vous devez d'abord activer le fournisseur de connexion Google pour votre projet Firebase :

1. Dans la console Firebase , ouvrez la section Authentification .
2. Dans l'onglet Méthode de connexion , activez le fournisseur Google .
3. Cliquez sur Enregistrer .

Importer les fichiers d'en-tête requis

Tout d'abord, vous devez importer les fichiers d'en-tête du SDK Firebase et du SDK de connexion Google dans votre application.

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

@import FirebaseCore;
@import GoogleSignIn;

Mettre en œuvre la connexion Google

Mettez en œuvre Google Sign-In en suivant ces étapes. Consultez la documentation du développeur Google Sign-In pour plus de détails sur l'utilisation de Google Sign-In avec iOS.

1. Ajoutez des schémas d'URL personnalisés à votre projet Xcode :
1. Ouvrez la configuration de votre projet : cliquez sur le nom du projet dans l'arborescence de gauche. Sélectionnez votre application dans la section CIBLES , puis sélectionnez l'onglet Infos et développez la section Types d'URL .
2. Cliquez sur le bouton + et ajoutez un schéma d'URL pour votre ID client inversé. Pour trouver cette valeur, ouvrez le fichier de configuration GoogleService-Info.plist et recherchez la clé REVERSED_CLIENT_ID . Copiez la valeur de cette clé et collez-la dans la zone Schémas d'URL de la page de configuration. Laissez les autres champs intacts.

   Une fois terminée, votre configuration devrait ressembler à ce qui suit (mais avec les valeurs spécifiques à votre application) :

   
2. Dans la méthode application:didFinishLaunchingWithOptions: de votre délégué d'application, configurez l'objet FirebaseApp .

   Rapide

   FirebaseApp.configure()
   

   Objectif c

   // Use Firebase library to configure APIs
   [FIRApp configure];
   

3. Implémentez la application:openURL:options: de votre délégué d'application. La méthode doit appeler la méthode handleURL de l'instance GIDSignIn , qui gérera correctement l'URL que votre application reçoit à la fin du processus d'authentification.

   Rapide

   func application(_ app: UIApplication,
                    open url: URL,
                    options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
     return GIDSignIn.sharedInstance.handle(url)
   }
   

   Objectif c

   - (BOOL)application:(nonnull UIApplication *)application
               openURL:(nonnull NSURL *)url
               options:(nonnull NSDictionary<NSString *, id> *)options {
     return [[GIDSignIn sharedInstance] handleURL:url];
   }
   

4. Transmettez le contrôleur de vue de présentation et l'ID client de votre application à la méthode signIn du fournisseur de connexion Google et créez un identifiant d'authentification Firebase à partir du jeton d'authentification Google résultant :

   Rapide

   guard let clientID = FirebaseApp.app()?.options.clientID else { return }
   
   // Create Google Sign In configuration object.
   let config = GIDConfiguration(clientID: clientID)
   GIDSignIn.sharedInstance.configuration = config
   
   // Start the sign in flow!
   GIDSignIn.sharedInstance.signIn(withPresenting: self) { [unowned self] result, error in
     guard error == nil else {
       // ...
     }
   
     guard let user = result?.user,
       let idToken = user.idToken?.tokenString
     else {
       // ...
     }
   
     let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                    accessToken: user.accessToken.tokenString)
   
     // ...
   }
   

   Objectif c

   GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];
   [GIDSignIn.sharedInstance setConfiguration:config];
   
   __weak __auto_type weakSelf = self;
   [GIDSignIn.sharedInstance signInWithPresentingViewController:self
         completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) {
     __auto_type strongSelf = weakSelf;
     if (strongSelf == nil) { return; }
   
     if (error == nil) {
       FIRAuthCredential *credential =
       [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                        accessToken:result.user.accessToken.tokenString];
       // ...
     } else {
       // ...
     }
   }];
   
   

5. Ajoutez un GIDSignInButton à votre storyboard, fichier XIB ou instanciez-le par programmation. Pour ajouter le bouton à votre storyboard ou fichier XIB, ajoutez une vue et définissez sa classe personnalisée sur GIDSignInButton .
6. Facultatif : si vous souhaitez personnaliser le bouton, procédez comme suit :

   Rapide

   1. Dans votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.

      @IBOutlet weak var signInButton: GIDSignInButton!

   2. Connectez le bouton à la propriété signInButton que vous venez de déclarer.
   3. Personnalisez le bouton en définissant les propriétés de l'objet GIDSignInButton .

   Objectif c

   1. Dans le fichier d'en-tête de votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.

      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;

   2. Connectez le bouton à la propriété signInButton que vous venez de déclarer.
   3. Personnalisez le bouton en définissant les propriétés de l'objet GIDSignInButton .

S'authentifier avec Firebase

Enfin, terminez le processus de connexion Firebase avec les informations d'identification d'authentification créées à l'étape précédente.

Auth.auth().signIn(with: credential) { result, error in

  // At this point, our user is signed in
}
    

[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

Prochaines étapes

Lorsqu'un utilisateur se connecte pour la première fois, un nouveau compte d'utilisateur est créé et lié aux informations d'identification (c'est-à-dire le nom d'utilisateur et le mot de passe, le numéro de téléphone ou les informations du fournisseur d'authentification) avec lesquelles l'utilisateur s'est connecté. Ce nouveau compte est stocké dans le cadre de votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet, quelle que soit la manière dont l'utilisateur se connecte.

• Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir de l'objet User . Voir Gérer les utilisateurs .

• Dans vos règles de sécurité Firebase Realtime Database et Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Vous pouvez autoriser les utilisateurs à se connecter à votre application à l'aide de plusieurs fournisseurs d'authentification en liant les informations d'identification du fournisseur d'authentification à un compte d'utilisateur existant.

Pour déconnecter un utilisateur, appelez signOut: .

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

Vous pouvez également ajouter un code de gestion des erreurs pour l'ensemble des erreurs d'authentification. Voir Gérer les erreurs .