Anonyme Authentifizierung bei Apple-Plattformen mit Firebase

Mit Firebase Authentication können Sie temporäre anonyme Konten erstellen und verwenden, um sich bei Firebase zu authentifizieren. Mit diesen temporären anonymen Konten können Nutzer, die sich noch nicht in Ihrer App registriert haben, mit Daten arbeiten, die durch Sicherheitsregeln geschützt sind. Wenn sich ein anonymer Nutzer in Ihrer App registriert, können Sie seine Anmeldedaten mit dem anonymen Konto verknüpfen, damit er in zukünftigen Sitzungen weiterhin mit seinen geschützten Daten arbeiten kann.

Hinweis

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

   In unserem Installationsleitfaden erfahren Sie, wie Sie Ihrem Apple-Projekt Firebase SDKs auf verschiedene Arten hinzufügen können, z. B. durch direkten Import von Frameworks und Verwendung von CocoaPods.
   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:

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

   Hinweis: Neue Projekte sollten die Standardversion (neueste) des SDK verwenden. Bei Bedarf können Sie jedoch eine ältere Version auswählen.
   3. Wählen Sie die Bibliothek Firebase Authentication aus.
   4. Fügen Sie das Flag -ObjC dem Abschnitt Other Linker Flags (Weitere Verknüpfungsmerker) in den Build-Einstellungen des Ziels hinzu.
   5. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.
2. Wenn Sie Ihre App noch nicht mit Ihrem Firebase-Projekt verknüpft haben, tun Sie dies in der Firebase Console.
3. Anonyme Authentifizierung aktivieren:
   1. Öffnen Sie in der Firebase Console den Bereich Auth.
   2. Aktivieren Sie auf der Seite Anmeldemethoden die Anmeldemethode Anonym.
   3. Optional: Wenn Sie Ihr Projekt auf Firebase Authentication with Identity Platform aktualisiert haben, können Sie die automatische Bereinigung aktivieren. Wenn Sie diese Einstellung aktivieren, werden anonyme Konten, die älter als 30 Tage sind, automatisch gelöscht. In Projekten mit aktivierter automatischer Bereinigung wird die anonyme Authentifizierung nicht mehr auf Nutzungslimits oder Abrechnungskontingente angerechnet. Weitere Informationen finden Sie unter Automatische Bereinigung.

Anonym mit Firebase authentifizieren

Wenn ein abgemeldeter Nutzer eine App-Funktion verwendet, für die eine Authentifizierung mit Firebase erforderlich ist, melden Sie ihn anonym an. Gehen Sie dazu so vor:

1. Importieren Sie das FirebaseCore-Modul in Ihre UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegat verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentication:
   SwiftUISwiftObjective-C
   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Konfigurieren Sie eine FirebaseApp-Freigabeinstanz in der application(_:didFinishLaunchingWithOptions:)-Methode Ihres App-Delegierten:
   SwiftUISwiftObjective-C
   // Use Firebase library to configure APIs
   FirebaseApp.configure()

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

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

3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegierten erstellen und über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an das App-Objekt anhängen. Außerdem müssen Sie das App-Delegate-Swizzling deaktivieren. Weitere Informationen finden Sie in der SwiftUI-Anleitung.
   SwiftUI
   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Rufen Sie die Methode signInAnonymouslyWithCompletion: auf:
   SwiftObjective-C
   Auth.auth().signInAnonymously { authResult, error in
     // ...
   }

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

5. Wenn die signInAnonymouslyWithCompletion:-Methode ohne Fehler abgeschlossen wird, kannst du die Kontodaten des anonymen Nutzers aus dem FIRAuthDataResult-Objekt abrufen:
   SwiftObjective-C
   guard let user = authResult?.user else { return }
   let isAnonymous = user.isAnonymous  // true
   let uid = user.uid

   FIRUser *user = authResult.user;
   BOOL isAnonymous = user.anonymous;  // YES
   NSString *uid = user.uid;

Um Ihr Projekt vor Missbrauch zu schützen, begrenzt Firebase die Anzahl der neuen E-Mail-Adressen/Passwörter und anonymer Registrierungen, die für Ihre Anwendung über dieselbe IP-Adresse in kurzer Zeit möglich sind. Sie können über die Firebase Console vorübergehende Änderungen an diesem Kontingent anfordern und planen.

Anonymes Konto in ein dauerhaftes Konto umwandeln

Wenn sich ein anonymer Nutzer in Ihrer App registriert, können Sie ihm erlauben, seine Arbeit mit seinem neuen Konto fortzusetzen. Sie können beispielsweise die Artikel, die der Nutzer seinem Einkaufswagen hinzugefügt hat, bevor er sich registriert hat, im Einkaufswagen seines neuen Kontos verfügbar machen. Führen Sie dazu folgende Schritte aus:

1. Wenn sich der Nutzer registriert, führe den Anmeldevorgang für den Authentifizierungsanbieter des Nutzers bis zum Aufruf einer der FIRAuth.signInWith-Methoden durch, aber nicht bis zum Aufruf der Methode. Rufe beispielsweise das Google-ID-Token, das Facebook-Zugriffstoken oder die E-Mail-Adresse und das Passwort des Nutzers ab.

2. Rufen Sie eine FIRAuthCredential für den neuen Authentifizierungsanbieter ab:

   Google Log-in

   SwiftObjective-C
   guard
     let authentication = user?.authentication,
     let idToken = authentication.idToken
   else {
     return
   }
   
   let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                  accessToken: authentication.accessToken)

   FIRAuthCredential *credential =
   [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                    accessToken:result.user.accessToken.tokenString];

   Facebook-Anmeldung

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

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

   Anmeldung per E-Mail-Adresse und Passwort

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

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

3. Übergeben Sie das FIRAuthCredential-Objekt an die Methode linkWithCredential:completion: des angemeldeten Nutzers:

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

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

Wenn der Aufruf von linkWithCredential:completion: erfolgreich war, kann das neue Konto des Nutzers auf die Firebase-Daten des anonymen Kontos zugreifen.

Mit dieser Methode können Sie auch beliebige zwei Konten verknüpfen.

Automatische Bereinigung

Wenn Sie Ihr Projekt auf Firebase Authentication with Identity Platform umgestellt haben, können Sie die automatische Bereinigung in der Firebase-Konsole aktivieren. Wenn Sie diese Funktion aktivieren, erlauben Sie Firebase, anonyme Konten, die älter als 30 Tage sind, automatisch zu löschen. In Projekten, in denen die automatische Bereinigung aktiviert ist, wird die anonyme Authentifizierung nicht auf Nutzungslimits oder Abrechnungskontingente angerechnet.

• Alle anonymen Konten, die nach der Aktivierung der automatischen Bereinigung erstellt wurden, können nach 30 Tagen nach der Erstellung jederzeit automatisch gelöscht werden.
• Vorhandene anonyme Konten können 30 Tage nach Aktivierung der automatischen Bereinigung automatisch gelöscht werden.
• Wenn Sie die automatische Bereinigung deaktivieren, bleiben alle anonymen Konten, die zum Löschen geplant sind, weiterhin zum Löschen geplant.
• Wenn Sie ein anonymes Konto „upgraden“, indem Sie es mit einer Anmeldemethode verknüpfen, wird es nicht automatisch gelöscht.

Wenn Sie vor der Aktivierung dieser Funktion sehen möchten, wie viele Nutzer davon betroffen sind, und Sie Ihr Projekt auf Firebase Authentication with Identity Platform umgestellt haben, können Sie in Cloud Logging nach is_anon filtern.

Nächste Schritte

Da sich Nutzer jetzt mit Firebase authentifizieren können, können Sie ihren Zugriff auf Daten in Ihrer Firebase-Datenbank mithilfe von Firebase-Regeln steuern.