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
- Ajouter Firebase à votre projet iOS . Inclure les gousses suivantes dans votre
Podfile:pod 'Firebase/Auth' pod 'GoogleSignIn'
- Si vous n'êtes pas encore connecté votre application à votre projet Firebase, faites à partir de la console Firebase .
- Activez Google Sign-In dans la console Firebase :
- Dans la console Firebase , ouvrez la section Auth.
- 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 du SDK Firebase et du SDK Google Sign-In dans votre application.
Rapide
import Firebase import GoogleSignIn
Objectif c
@import Firebase; @import GoogleSignIn;
2. Mettre en œuvre la connexion Google
Implémentez Google Sign-In 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.
- Ajoutez des schémas d'URL personnalisés à votre projet Xcode :
- Ouvrez votre configuration de projet : double-cliquez sur le nom du projet dans l'arborescence de gauche. Sélectionnez votre application de la section CIBLES, puis sélectionnez l'onglet Info, et développez la section Types d'URL.
- 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 REVERSED_CLIENT_IDclé. Copiez la valeur de cette clé, et le coller dans l'URL Schemes boîte sur la page de configuration. Laissez les autres champs vides.Une fois terminée, votre configuration devrait ressembler à ce qui suit (mais avec des valeurs spécifiques à votre application) :
- Dans votre délégué app
application:didFinishLaunchingWithOptions:méthode, configurer leFirebaseAppobjet.Rapide
// Use Firebase library to configure APIs FirebaseApp.configure()
Objectif c
// Use Firebase library to configure APIs [FIRApp configure];
- Mettre en œuvre l'
application:openURL:options:méthode de votre délégué de l' application. La méthode doit appeler lahandleURLméthode de l'GIDSignInpar 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]; } - Transmettez le contrôleur de vue de présentation et l'ID client de votre application à la méthode de connexion Google Sign In 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) // 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 { // ... } }]; - 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. - Facultatif: Si vous voulez personnaliser le bouton, procédez comme suit:
Rapide
- Dans votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.
@IBOutlet weak var signInButton: GIDSignInButton!
- Connectez le bouton à la
signInButtonpropriété que vous venez de déclarer. - Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.
Objectif c
- 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;
- Connectez le bouton à la
signInButtonpropriété que vous venez de déclarer. - Personnaliser le bouton en définissant les propriétés du GIDSignInButton objet.
- Dans votre contrôleur de vue, déclarez le bouton de connexion en tant que propriété.
3. Authentifiez-vous avec Firebase
Enfin, terminez le processus de connexion Firebase avec les informations d'authentification créées à 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
Une fois qu'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'autorisation, 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, quel que soit le mode de connexion de l'utilisateur.
Dans vos applications, vous pouvez obtenir des informations de profil de base de l'utilisateur du
FIRUserobjet. Voir Gérer les utilisateurs .Dans votre base de données et en temps réel Firebase Cloud Storage Les règles de
authsécurité , vous pouvez obtenir la signature dans ID d'utilisateur unique de l' utilisateur de laauthvariable 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 les informations d' identification de fournisseur auth à 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 un code de gestion des erreurs pour l'ensemble des erreurs d'authentification. Voir les erreurs de poignée .