Authentifizierung mit Google Log-in auf Apple-Plattformen

Sie können Ihren Nutzern die Authentifizierung mit Firebase über ihre Google-Konten ermöglichen, indem Sie Google Log-in in Ihre App einbinden.

Hinweis

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
  2. Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wählen Sie die Firebase Authentication Bibliothek aus.
  5. Fügen Sie das Flag -ObjC im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) der Build-Einstellungen Ihres Ziels hinzu.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Google Log-in SDK in ein Projekt einbinden

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).

  2. Fügen Sie bei entsprechender Aufforderung das Google Log-in SDK-Repository hinzu:

    https://github.com/google/GoogleSignIn-iOS
    
  3. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Google Log-in für Ihr Firebase-Projekt aktivieren

Damit sich Nutzer mit Google Log-in anmelden können, müssen Sie zuerst den Google Log-in-Anbieter für Ihr Firebase-Projekt aktivieren:

  1. Öffnen Sie in der Firebase Console den Bereich Authentication (Authentifizierung).
  2. Aktivieren Sie auf dem Tab Sign-in method (Anmeldemethode) den Anbieter Google.
  3. Klicken Sie auf Save (Speichern).

  4. Laden Sie eine neue Kopie der Datei GoogleService-Info.plist Ihres Projekts herunter und kopieren Sie sie in Ihr Xcode-Projekt. Überschreiben Sie alle vorhandenen Versionen mit der neuen. Weitere Informationen finden Sie unter Firebase zu Ihrem iOS Projekt hinzufügen.

Erforderliche Headerdateien importieren

Zuerst müssen Sie die Headerdateien des Firebase SDK und des Google Log-in SDK in Ihre App importieren.

Swift

import FirebaseAuth
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

Google Log-in implementieren

Implementieren Sie Google Log-in mit den folgenden Schritten. Weitere Informationen zur Verwendung von Google Log-in mit iOS finden Sie in der Google Log-in Entwicklerdokumentation.

  1. Fügen Sie Ihrem Xcode-Projekt benutzerdefinierte URL-Schemes hinzu:
    1. Öffnen Sie die Projektkonfiguration. Klicken Sie dazu in der linken Baumansicht auf den Projektnamen. Wählen Sie im Bereich TARGETS (Ziele) Ihre App aus, dann den Tab Info und maximieren Sie den Bereich URL Types (URL-Typen).
    2. Klicken Sie auf die Schaltfläche + und fügen Sie ein URL-Scheme für Ihre umgekehrte Client-ID hinzu. Diesen Wert finden Sie in der GoogleService-Info.plist Konfigurationsdatei unter dem REVERSED_CLIENT_ID Schlüssel. Kopieren Sie den Wert dieses Schlüssels, und fügen Sie ihn auf der Konfigurationsseite in das Feld URL Schemes (URL-Schemes) ein. Lassen Sie die anderen Felder unverändert.

      Ihre Konfiguration sollte dann in etwa so aussehen (aber mit Ihren anwendungsspezifischen Werten):

  2. Konfigurieren Sie in der Methode application:didFinishLaunchingWithOptions: des App-Delegaten das Objekt FirebaseApp.

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Implementieren Sie die Methode application:openURL:options: des App Delegaten. Die Methode sollte die handleURL Methode der GIDSignIn Instanz aufrufen, die die URL, die Ihre Anwendung am Ende des Authentifizierungsprozesses erhält, ordnungsgemäß verarbeitet.

    Swift

    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
      // ...
    }
      return GIDSignIn.sharedInstance.handle(url)
    }

    Objective-C

    - (BOOL)application:(nonnull UIApplication *)application
                openURL:(nonnull NSURL *)url
                options:(nonnull NSDictionary<NSString *, id> *)options {
      return [[GIDSignIn sharedInstance] handleURL:url];
    }
  4. Übergeben Sie den präsentierenden Ansichtscontroller und die Client-ID für Ihre App an die signIn Methode des Google Log-in-Anbieters und erstellen Sie aus dem resultierenden Google-Authentifizierungstoken eine Firebase Authentication-Anmeldedaten:

    Swift

    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: viewController) { result, error in
      guard error == nil else {
        // ...
        return
      }
    
      guard let user = result?.user,
            let idToken = user.idToken?.tokenString
      else {
        // ...
        return
      }
    
      let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                     accessToken: user.accessToken.tokenString)
      self.signIn(with: credential)
    }

    Objective-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. Fügen Sie Ihrem Storyboard oder Ihrer XIB-Datei eine GIDSignInButton-Schaltfläche hinzu oder instanziieren Sie sie programmatisch. Wenn Sie die Schaltfläche Ihrem Storyboard oder Ihrer XIB Datei hinzufügen möchten, fügen Sie eine Ansicht hinzu und legen Sie ihre benutzerdefinierte Klasse auf GIDSignInButton fest.
  6. Optional: Wenn Sie die Schaltfläche anpassen möchten, gehen Sie so vor:

    Swift

    1. Deklarieren Sie die Anmeldeschaltfläche im Ansichtscontroller als Property.
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. Verknüpfen Sie die Schaltfläche mit der gerade deklarierten Property signInButton.
    3. Passen Sie die Schaltfläche an, indem Sie die Properties des Objekts GIDSignInButton festlegen.

    Objective-C

    1. Deklarieren Sie die Anmeldeschaltfläche in der Headerdatei des Ansichtscontrollers als Property.
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. Verknüpfen Sie die Schaltfläche mit der gerade deklarierten Property signInButton.
    3. Passen Sie die Schaltfläche an, indem Sie die Properties des Objekts GIDSignInButton festlegen.

Mit Firebase authentifizieren

Schließen Sie schließlich den Firebase-Anmeldevorgang mit den im vorherigen Schritt erstellten Anmeldedaten ab.

Swift

Auth.auth().signIn(with: credential) { result, error in
  guard error == nil else {
    // ...
    return
  }

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

Objective-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;
  // ...
}];

Nächste Schritte

Nachdem sich ein Nutzer zum ersten Mal angemeldet hat, wird ein neues Nutzerkonto erstellt und mit den Anmeldedaten verknüpft, mit denen sich der Nutzer angemeldet hat, also mit dem Nutzernamen und Passwort, der Telefonnummer oder den Informationen des Authentifizierungsanbieters. Dieses neue Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um einen Nutzer in allen Apps Ihres Projekts zu identifizieren, unabhängig davon, wie sich der Nutzer anmeldet.

  • In Ihren Apps können Sie die grundlegenden Profilinformationen des Nutzers aus dem User Objekt abrufen. Weitere Informationen finden Sie unter Nutzer verwalten.

  • In den Firebase Realtime Database und Cloud Storage Sicherheitsregeln können Sie die eindeutige Nutzer-ID des angemeldeten Nutzers aus der Variablen auth abrufen und damit steuern, auf welche Daten ein Nutzer zugreifen kann.

Sie können Nutzern erlauben, sich mit mehreren Authentifizierungsanbietern in Ihrer App anzumelden, indem Sie Anmeldedaten von Authentifizierungsanbietern mit einem bestehenden Nutzerkonto verknüpfen.

Wenn Sie einen Nutzer abmelden möchten, rufen Sie signOut: auf.

Swift

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

Objective-C

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

Sie können auch Code zur Fehlerbehandlung für alle Authentifizierungs fehler hinzufügen. Weitere Informationen finden Sie unter Fehler behandeln.