Check out what’s new from Firebase at Google I/O 2022. Learn more

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

Vous pouvez laisser vos utilisateurs authentifient avec Firebase en utilisant leur compte Google en intégrant connexion Google dans votre application.

Avant que tu commences

  1. Ajouter Firebase à votre projet d' Apple . Inclure les gousses suivantes dans votre Podfile :
    pod 'FirebaseAuth'
pod 'GoogleSignIn'
  2. Si vous n'êtes pas encore connecté votre application à votre projet Firebase, faites à partir de la console Firebase .
  3. Activer Google comme un signe en méthode dans la console Firebase:
    1. Dans la console Firebase , ouvrez la section Auth.
    2. Sur l'onglet Connexion méthode, activez la connexion Google méthode et cliquez sur Enregistrer.

1. Importez les fichiers d'en-tête requis

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

Rapide

import FirebaseCore
import GoogleSignIn

Objectif c

@import FirebaseCore;
@import GoogleSignIn;

2. Mettre en œuvre connexion Google

Mettre en œuvre de session Google en suivant ces étapes. Voir la documentation développeur de connexion Google pour plus de détails sur l' utilisation de session Google avec iOS.

  1. Ajouter schémas d'URL personnalisées à votre projet Xcode:
    1. Ouvrez la configuration de votre projet: double-cliquez sur le nom du projet dans l'arborescence à gauche. Sélectionnez votre application de la section CIBLES, puis sélectionnez l'onglet Info, et développez la section Types d'URL.
    2. Cliquez sur le bouton +, et ajouter un schéma d'URL pour votre ID client inverse. Pour trouver cette valeur, ouvrez le GoogleService-Info.plist fichier de configuration, et recherchez le REVERSED_CLIENT_ID clé. Copiez la valeur de cette clé, et le coller dans l'URL Schemes boîte sur la page de configuration. Laissez l'autre blanc champs.

      Une fois terminé, votre config devrait ressembler à quelque chose de semblable à ce qui suit (mais avec vos valeurs spécifiques d'application):

  2. Dans votre délégué app application:didFinishLaunchingWithOptions: méthode, configurer le FirebaseApp objet.

    Rapide

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

    Objectif c

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Mettre en œuvre l' application:openURL:options: méthode de votre délégué de l' application. La méthode doit appeler la handleURL méthode de l' GIDSignIn par exemple, qui gère correctement l'URL que votre application reçoit à la fin du processus d'authentification.

    Rapide

    @available(iOS 9.0, *)
func application(_ application: 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. Passez le contrôleur de vue présenté et ID client pour votre application au signe Google En signe en méthode et créer un Firebase auth lettres de créance du résultat Google auth jeton:

    Rapide

    guard let clientID = FirebaseApp.app()?.options.clientID else { return }

// Create Google Sign In configuration object.
let config = GIDConfiguration(clientID: clientID)

// Start the sign in flow!
GIDSignIn.sharedInstance.signIn(with: config, presenting: self) { [unowned self] user, error in

  if let error = error {
    // ...
    return
  }

  guard
    let authentication = user?.authentication,
    let idToken = authentication.idToken
  else {
    return
  }

  let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                 accessToken: authentication.accessToken)

  // ...
}

    Objectif c

    GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];

__weak __auto_type weakSelf = self;
[GIDSignIn.sharedInstance signInWithConfiguration:config presentingViewController:self callback:^(GIDGoogleUser * _Nullable user, NSError * _Nullable error) {
  __auto_type strongSelf = weakSelf;
  if (strongSelf == nil) { return; }

  if (error == nil) {
    GIDAuthentication *authentication = user.authentication;
    FIRAuthCredential *credential =
    [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                     accessToken:authentication.accessToken];
    // ...
  } else {
    // ...
  }
}];
  5. Ajouter un GIDSignInButton à votre story - board, fichier XIB, ou instancier programme. Pour ajouter le bouton à votre story - board ou d'un fichier XIB, ajoutez une vue et définir sa classe personnalisée à GIDSignInButton .
  6. Facultatif: Si vous voulez personnaliser le bouton, procédez comme suit:

    Rapide

    1. Dans votre contrôleur de vue, déclarer le bouton de connexion comme une propriété. 
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. Connectez le bouton à la signInButton propriété que vous venez de déclarer.
    3. Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.

    Objectif c

    1. Dans votre fichier d'en-tête du contrôleur de vue, déclarer le bouton de connexion comme une propriété. 
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. Connectez le bouton à la signInButton propriété que vous venez de déclarer.
    3. Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.

3. Authentifier avec Firebase

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

Rapide

Auth.auth().signIn(with: credential) { authResult, error in
    if let error = error {
      let authError = error as NSError
      if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
        // The user is a multi-factor user. Second factor challenge is required.
        let resolver = authError
          .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
        var displayNameString = ""
        for tmpFactorInfo in resolver.hints {
          displayNameString += tmpFactorInfo.displayName ?? ""
          displayNameString += " "
        }
        self.showTextInputPrompt(
          withMessage: "Select factor to sign in\n\(displayNameString)",
          completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if displayName == tmpFactorInfo.displayName {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider()
              .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                 multiFactorSession: resolver
                                   .session) { verificationID, error in
                if error != nil {
                  print(
                    "Multi factor start sign in failed. Error: \(error.debugDescription)"
                  )
                } else {
                  self.showTextInputPrompt(
                    withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                    completionBlock: { userPressedOK, verificationCode in
                      let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                        .credential(withVerificationID: verificationID!,
                                    verificationCode: verificationCode!)
                      let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                        .assertion(with: credential!)
                      resolver.resolveSignIn(with: assertion!) { authResult, error in
                        if error != nil {
                          print(
                            "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                          )
                        } else {
                          self.navigationController?.popViewController(animated: true)
                        }
                      }
                    }
                  )
                }
              }
          }
        )
      } else {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // ...
      return
    }
    // User is signed in
    // ...
}

Objectif c

[[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

Après l'utilisateur se connecte pour la première fois, est créé un nouveau compte utilisateur et lié aux titres de compétence qui est le nom d'utilisateur et mot de passe, numéro de téléphone, ou auth informations fournisseur utilisateur signé avec. Ce nouveau compte est enregistré dans le cadre de votre projet Firebase, et peut être utilisé pour identifier un utilisateur dans toutes les applications de votre projet, quelle que soit la façon dont les utilisateur se connecte.

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

  • Dans votre base de données et en temps réel Firebase Cloud Storage Les règles de auth sécurité , vous pouvez obtenir la signature dans ID d'utilisateur unique de l' utilisateur de la auth variable et l' utiliser pour contrôler les données d' un accès utilisateur peut.

Vous pouvez permettre aux utilisateurs de se connecter à votre application à l' aide des fournisseurs d'authentification multiples en reliant auth des informations d' identification de fournisseur à un compte d'utilisateur existant.

Pour vous déconnecter un utilisateur, appelez signOut: .

Rapide

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

Objectif c

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

Vous pouvez également ajouter le code de gestion des erreurs pour la gamme complète des erreurs d'authentification. Voir les erreurs de poignée .

,

Vous pouvez laisser vos utilisateurs authentifient avec Firebase en utilisant leur compte Google en intégrant connexion Google dans votre application.

Avant que tu commences

  1. Ajouter Firebase à votre projet d' Apple . Inclure les gousses suivantes dans votre Podfile :
    pod 'FirebaseAuth'
pod 'GoogleSignIn'
  2. Si vous n'êtes pas encore connecté votre application à votre projet Firebase, faites à partir de la console Firebase .
  3. Activer Google comme un signe en méthode dans la console Firebase:
    1. Dans la console Firebase , ouvrez la section Auth.
    2. Sur l'onglet Connexion méthode, activez la connexion Google méthode et cliquez sur Enregistrer.

1. Importez les fichiers d'en-tête requis

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

Rapide

import FirebaseCore
import GoogleSignIn

Objectif c

@import FirebaseCore;
@import GoogleSignIn;

2. Mettre en œuvre connexion Google

Mettre en œuvre de session Google en suivant ces étapes. Voir la documentation développeur de connexion Google pour plus de détails sur l' utilisation de session Google avec iOS.

  1. Ajouter schémas d'URL personnalisées à votre projet Xcode:
    1. Ouvrez la configuration de votre projet: double-cliquez sur le nom du projet dans l'arborescence à gauche. Sélectionnez votre application de la section CIBLES, puis sélectionnez l'onglet Info, et développez la section Types d'URL.
    2. Cliquez sur le bouton +, et ajouter un schéma d'URL pour votre ID client inverse. Pour trouver cette valeur, ouvrez le GoogleService-Info.plist fichier de configuration, et recherchez le REVERSED_CLIENT_ID clé. Copiez la valeur de cette clé, et le coller dans l'URL Schemes boîte sur la page de configuration. Laissez l'autre blanc champs.

      Une fois terminé, votre config devrait ressembler à quelque chose de semblable à ce qui suit (mais avec vos valeurs spécifiques d'application):

  2. Dans votre délégué app application:didFinishLaunchingWithOptions: méthode, configurer le FirebaseApp objet.

    Rapide

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

    Objectif c

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Mettre en œuvre l' application:openURL:options: méthode de votre délégué de l' application. La méthode doit appeler la handleURL méthode de l' GIDSignIn par exemple, qui gère correctement l'URL que votre application reçoit à la fin du processus d'authentification.

    Rapide

    @available(iOS 9.0, *)
func application(_ application: 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. Passez le contrôleur de vue présenté et ID client pour votre application au signe Google En signe en méthode et créer un Firebase auth lettres de créance du résultat Google auth jeton:

    Rapide

    guard let clientID = FirebaseApp.app()?.options.clientID else { return }

// Create Google Sign In configuration object.
let config = GIDConfiguration(clientID: clientID)

// Start the sign in flow!
GIDSignIn.sharedInstance.signIn(with: config, presenting: self) { [unowned self] user, error in

  if let error = error {
    // ...
    return
  }

  guard
    let authentication = user?.authentication,
    let idToken = authentication.idToken
  else {
    return
  }

  let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                 accessToken: authentication.accessToken)

  // ...
}

    Objectif c

    GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];

__weak __auto_type weakSelf = self;
[GIDSignIn.sharedInstance signInWithConfiguration:config presentingViewController:self callback:^(GIDGoogleUser * _Nullable user, NSError * _Nullable error) {
  __auto_type strongSelf = weakSelf;
  if (strongSelf == nil) { return; }

  if (error == nil) {
    GIDAuthentication *authentication = user.authentication;
    FIRAuthCredential *credential =
    [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                     accessToken:authentication.accessToken];
    // ...
  } else {
    // ...
  }
}];
  5. Ajouter un GIDSignInButton à votre story - board, fichier XIB, ou instancier programme. Pour ajouter le bouton à votre story - board ou d'un fichier XIB, ajoutez une vue et définir sa classe personnalisée à GIDSignInButton .
  6. Facultatif: Si vous voulez personnaliser le bouton, procédez comme suit:

    Rapide

    1. Dans votre contrôleur de vue, déclarer le bouton de connexion comme une propriété. 
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. Connectez le bouton à la signInButton propriété que vous venez de déclarer.
    3. Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.

    Objectif c

    1. Dans votre fichier d'en-tête du contrôleur de vue, déclarer le bouton de connexion comme une propriété. 
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. Connectez le bouton à la signInButton propriété que vous venez de déclarer.
    3. Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.

3. Authentifier avec Firebase

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

Rapide

Auth.auth().signIn(with: credential) { authResult, error in
    if let error = error {
      let authError = error as NSError
      if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
        // The user is a multi-factor user. Second factor challenge is required.
        let resolver = authError
          .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
        var displayNameString = ""
        for tmpFactorInfo in resolver.hints {
          displayNameString += tmpFactorInfo.displayName ?? ""
          displayNameString += " "
        }
        self.showTextInputPrompt(
          withMessage: "Select factor to sign in\n\(displayNameString)",
          completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if displayName == tmpFactorInfo.displayName {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider()
              .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                 multiFactorSession: resolver
                                   .session) { verificationID, error in
                if error != nil {
                  print(
                    "Multi factor start sign in failed. Error: \(error.debugDescription)"
                  )
                } else {
                  self.showTextInputPrompt(
                    withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                    completionBlock: { userPressedOK, verificationCode in
                      let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                        .credential(withVerificationID: verificationID!,
                                    verificationCode: verificationCode!)
                      let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                        .assertion(with: credential!)
                      resolver.resolveSignIn(with: assertion!) { authResult, error in
                        if error != nil {
                          print(
                            "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                          )
                        } else {
                          self.navigationController?.popViewController(animated: true)
                        }
                      }
                    }
                  )
                }
              }
          }
        )
      } else {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // ...
      return
    }
    // User is signed in
    // ...
}

Objectif c

[[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

Après l'utilisateur se connecte pour la première fois, est créé un nouveau compte utilisateur et lié aux titres de compétence qui est le nom d'utilisateur et mot de passe, numéro de téléphone, ou auth informations fournisseur utilisateur signé avec. Ce nouveau compte est enregistré dans le cadre de votre projet Firebase, et peut être utilisé pour identifier un utilisateur dans toutes les applications de votre projet, quelle que soit la façon dont les utilisateur se connecte.

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

  • Dans votre base de données et en temps réel Firebase Cloud Storage Les règles de auth sécurité , vous pouvez obtenir la signature dans ID d'utilisateur unique de l' utilisateur de la auth variable et l' utiliser pour contrôler les données d' un accès utilisateur peut.

Vous pouvez permettre aux utilisateurs de se connecter à votre application à l' aide des fournisseurs d'authentification multiples en reliant auth des informations d' identification de fournisseur à un compte d'utilisateur existant.

Pour vous déconnecter un utilisateur, appelez signOut: .

Rapide

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

Objectif c

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

Vous pouvez également ajouter le code de gestion des erreurs pour la gamme complète des erreurs d'authentification. Voir les erreurs de poignée .