Sie können Firebase Authentication verwenden, um einen Nutzer anzumelden, indem Sie eine SMS an das Smartphone des Nutzers senden. Der Nutzer meldet sich mit einem Einmalcode an, der in der SMS enthalten ist.
In diesem Dokument wird beschrieben, wie Sie mit dem Firebase SDK einen Anmeldevorgang mit einer Telefonnummer implementieren.
Hinweis
-
Bevor Sie Firebase Authentication verwenden können, müssen Sie das Firebase Unity SDK (insbesondere
FirebaseAuth.unitypackage) zu Ihrem Unity-Projekt hinzufügen.Eine detaillierte Anleitung für diese ersten Einrichtungsschritte finden Sie unter Firebase zu einem Unity-Projekt hinzufügen.
- Wenn Sie Ihre App noch nicht mit Ihrem Firebase-Projekt verbunden haben, können Sie das in der Firebase-Konsole tun.
- Plattformanforderungen für die Anmeldung mit Telefonnummer:
- Die Anmeldung per Telefonnummer ist nur für mobile Plattformen verfügbar.
- Unter iOS ist für die Anmeldung mit einer Telefonnummer ein physisches Gerät erforderlich. Auf einem Simulator funktioniert sie nicht.
Sicherheitsbedenken
Die Authentifizierung nur mit einer Telefonnummer ist zwar praktisch, aber weniger sicher als die anderen verfügbaren Methoden, da die Telefonnummer zwischen Nutzern übertragen werden kann. Auf Geräten mit mehreren Nutzerprofilen kann sich jeder Nutzer, der SMS empfangen kann, mit der Telefonnummer des Geräts in einem Konto anmelden.
Wenn Sie in Ihrer App die Anmeldung per Telefonnummer verwenden, sollten Sie sie zusammen mit sichereren Anmeldemethoden anbieten und Nutzer über die Sicherheitsrisiken der Anmeldung per Telefonnummer informieren.
Anmeldung mit Telefonnummer für Ihr Firebase-Projekt aktivieren
Wenn Sie Nutzer per SMS anmelden möchten, müssen Sie zuerst die Anmeldemethode „Telefonnummer“ für Ihr Firebase-Projekt aktivieren:
- Rufen Sie in der Firebase-Konsole Sicherheit > Authentifizierung auf.
- Aktivieren Sie auf dem Tab Anmeldemethode den Anbieter für die Anmeldung per Telefon.
-
Legen Sie eine Richtlinie für die Regionen fest, in die SMS gesendet werden dürfen oder nicht. Wenn Sie eine Richtlinie für SMS-Regionen festlegen, können Sie Ihre Apps besser vor SMS-Missbrauch schützen. Bei neuen Projekten sind in der Standardrichtlinie keine Regionen zulässig.
- Rufen Sie in der Firebase-Konsole den Tab Sicherheit > Authentifizierung > Einstellungen auf.
- Richten Sie im Bereich Richtlinie für SMS-Regionen Ihre Richtlinie für SMS-Regionen ein.
APNs-Benachrichtigungen erhalten (nur iOS)
Damit die Authentifizierung per Telefonnummer unter iOS verwendet werden kann, muss Ihre App APNs-Benachrichtigungen von Firebase empfangen können. Wenn Sie einen Nutzer zum ersten Mal auf einem Gerät mit seiner Telefonnummer anmelden, sendet Firebase Authentication eine Push-Benachrichtigung an das Gerät, um zu bestätigen, dass die Anfrage zur Anmeldung mit der Telefonnummer von Ihrer App stammt. Aus diesem Grund kann die Anmeldung mit der Telefonnummer nicht in einem Simulator verwendet werden.
So aktivieren Sie APNs-Benachrichtigungen für die Verwendung mit Firebase Authentication:
- Aktivieren Sie in Xcode Push-Benachrichtigungen für Ihr Projekt.
Laden Sie Ihr APNs-Zertifikat in Firebase hoch. Wenn Sie noch kein APNs-Zertifikat haben, erstellen Sie eines im Apple Developer Member Center.
-
Rufen Sie in der Firebase Console die Seite
Einstellungen > Allgemein auf. Klicken Sie dann auf den Tab Cloud Messaging. - Klicken Sie für Ihr Entwicklungszertifikat, Ihr Produktionszertifikat oder beide auf Zertifikat hochladen. Mindestens eine Angabe ist erforderlich.
-
Wählen Sie für jedes Zertifikat die
.p12-Datei aus und geben Sie das Passwort ein, falls vorhanden. Achten Sie darauf, dass die Paket-ID für dieses Zertifikat mit der Paket-ID Ihrer App übereinstimmt. Klicken Sie auf Speichern.
-
Rufen Sie in der Firebase Console die Seite
Bestätigungscode an das Smartphone des Nutzers senden
Wenn Sie die Anmeldung per Telefonnummer initiieren möchten, müssen Sie dem Nutzer eine Oberfläche präsentieren, auf der er seine Telefonnummer eingeben kann. Rufen Sie dann PhoneAuthProvider.VerifyPhoneNumber auf, um Firebase aufzufordern, einen Authentifizierungscode per SMS an das Smartphone des Nutzers zu senden:
-
Telefonnummer des Nutzers abrufen
Die rechtlichen Anforderungen variieren. Als Best Practice und um die Erwartungen Ihrer Nutzer zu erfüllen, sollten Sie sie jedoch darüber informieren, dass sie bei der Anmeldung per Telefon möglicherweise eine SMS zur Bestätigung erhalten und dass Standardgebühren anfallen.
- Rufen Sie
PhoneAuthProvider.VerifyPhoneNumberauf und übergeben Sie ein PhoneAuthOptions-Objekt mit der Telefonnummer des Nutzers. Wenn SiePhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth); provider.VerifyPhoneNumber( new Firebase.Auth.PhoneAuthOptions { PhoneNumber = phoneNumber, TimeoutInMilliseconds = phoneAuthTimeoutMs, ForceResendingToken = null }, verificationCompleted: (credential) => { // Auto-sms-retrieval or instant validation has succeeded (Android only). // There is no need to input the verification code. // `credential` can be used instead of calling GetCredential(). }, verificationFailed: (error) => { // The verification code was not sent. // `error` contains a human readable explanation of the problem. }, codeSent: (id, token) => { // Verification code was successfully sent via SMS. // `id` contains the verification id that will need to passed in with // the code from the user when calling GetCredential(). // `token` can be used if the user requests the code be sent again, to // tie the two requests together. }, codeAutoRetrievalTimeout: (id) => { // Called when the auto-sms-retrieval has timed out, based on the given // timeout parameter. // `id` contains the verification id of the request that timed out. });
PhoneAuthProvider.VerifyPhoneNumberaufrufen, Firebase,- (unter iOS) eine Push-Benachrichtigung ohne Ton an Ihre App gesendet.
- Firebase sendet eine SMS mit einem Authentifizierungscode an die angegebene Telefonnummer und übergibt eine Bestätigungs-ID an die Abschlussfunktion. Sie benötigen sowohl den Bestätigungscode als auch die Bestätigungs-ID, um den Nutzer anzumelden.
-
Speichern Sie die Bestätigungs-ID und stellen Sie sie wieder her, wenn Ihre App geladen wird. So ist gewährleistet, dass du auch dann eine gültige Bestätigungs-ID hast, wenn deine App beendet wird, bevor der Nutzer den Anmeldevorgang abgeschlossen hat (z. B. beim Wechsel zur SMS-App).
Sie können die Bestätigungs-ID beliebig speichern. Eine einfache Möglichkeit besteht darin, die Bestätigungs-ID mit
UnityEngine.PlayerPrefszu speichern.
Wenn der an codeSent übergebene Callback aufgerufen wird, kannst du den Nutzer auffordern, den Bestätigungscode einzugeben, wenn er ihn per SMS erhält.
Wenn dagegen der Callback für verificationCompleted aufgerufen wird, war die automatische Verifizierung erfolgreich und Sie erhalten ein PhoneAuthCredential, das Sie wie unten beschrieben verwenden können.
Nutzer mit dem Bestätigungscode anmelden
Nachdem der Nutzer den Bestätigungscode aus der SMS in deiner App eingegeben hat, melde ihn an, indem du ein PhoneAuthCredential-Objekt aus dem Bestätigungscode und der Bestätigungs-ID erstellst und dieses Objekt an FirebaseAuth.SignInAndRetrieveDataWithCredentialAsync übergibst.
- Lass dir den Bestätigungscode vom Nutzer geben.
- Erstellen Sie ein
Credential-Objekt aus dem Bestätigungscode und der Bestätigungs-ID.PhoneAuthCredential credential = phoneAuthProvider.GetCredential(verificationId, verificationCode);
- Melden Sie den Nutzer mit dem
PhoneAuthCredential-Objekt an:auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => { if (task.IsFaulted) { Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception); return; } FirebaseUser newUser = task.Result.User; Debug.Log("User signed in successfully"); // This should display the phone number. Debug.Log("Phone number: " + newUser.PhoneNumber); // The phone number providerID is 'phone'. Debug.Log("Phone provider ID: " + newUser.ProviderId); });
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, d. h. mit dem Nutzernamen und dem 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 jeder App in Ihrem Projekt zu identifizieren, unabhängig davon, wie sich der Nutzer anmeldet.
-
In Ihren Apps können Sie die grundlegenden Profilinformationen des Nutzers aus dem Objekt
Firebase.Auth.FirebaseUserabrufen:Firebase.Auth.FirebaseUser user = auth.CurrentUser; if (user != null) { string name = user.DisplayName; string email = user.Email; System.Uri photo_url = user.PhotoUrl; // The user's Id, unique to the Firebase project. // Do NOT use this value to authenticate with your backend server, if you // have one; use User.TokenAsync() instead. string uid = user.UserId; }
In den Sicherheitsregeln für Firebase Realtime Database und Cloud Storage können Sie die eindeutige Nutzer-ID des angemeldeten Nutzers aus der Variablen
authabrufen 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 des Authentifizierungsanbieters mit einem vorhandenen Nutzerkonto verknüpfen.
Wenn Sie einen Nutzer abmelden möchten, rufen Sie SignOut() auf:
auth.SignOut();