Über einen E-Mail-Link in Android mit Firebase authentifizieren

Mit Firebase Authentication können Sie einen Nutzer anmelden, indem Sie ihm eine E‑Mail mit einem Link senden, auf den er klicken kann, um sich anzumelden. Dabei wird auch die E‑Mail-Adresse des Nutzers bestätigt.

Die Anmeldung per E‑Mail bietet zahlreiche Vorteile:

  • Einfache Registrierung und Anmeldung
  • Geringeres Risiko der Wiederverwendung von Passwörtern in verschiedenen Anwendungen, was die Sicherheit selbst gut gewählter Passwörter untergraben kann
  • Möglichkeit, einen Nutzer zu authentifizieren und gleichzeitig zu bestätigen, dass er der rechtmäßige Inhaber einer E‑Mail-Adresse ist
  • Ein Nutzer benötigt nur ein zugängliches E‑Mail-Konto, um sich anzumelden. Der Besitz einer Telefonnummer oder eines Kontos in sozialen Medien ist nicht erforderlich.
  • Ein Nutzer kann sich sicher anmelden, ohne ein Passwort angeben (oder sich merken) zu müssen, was auf einem Mobilgerät umständlich sein kann.
  • Ein bestehender Nutzer, der sich zuvor mit einer E‑Mail-Kennung (Passwort oder Föderation) angemeldet hat, kann so aktualisiert werden, dass er sich nur mit der E‑Mail-Adresse anmelden kann. Ein Nutzer, der sein Passwort vergessen hat, kann sich beispielsweise trotzdem anmelden, ohne es zurücksetzen zu müssen.

Hinweis

Android-Projekt einrichten

  1. Falls noch nicht geschehen, fügen Sie Ihrem Android-Projekt Firebase hinzu.

  2. Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die Firebase Authentication Bibliothek für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Bibliotheksversionierung zu steuern.

    Außerdem müssen Sie im Rahmen der Einrichtung von Firebase Authentication das Google Play Services SDK zu Ihrer App hinzufügen.

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.10.0"))

    // Add the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth")
    
    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.5.1")    
}

    Mit der Firebase Android BoM, haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

    (Alternative)   Firebase-Bibliotheksabhängigkeiten ohne Verwendung der BoM

    Wenn Sie die Firebase BoM nicht verwenden möchten, müssen Sie die Version jeder Firebase-Bibliothek in der entsprechenden Abhängigkeitszeile angeben.

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die BoM zur Verwaltung der Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind. 

    dependencies {
    // Add the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth:24.0.1")
    
    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.5.1")    
}

Anmeldung per E‑Mail-Link für Ihr Firebase-Projekt aktivieren

Wenn sich Nutzer per E‑Mail-Link anmelden sollen, müssen Sie zuerst den E‑Mail-Anbieter und die Anmeldemethode per E‑Mail-Link für Ihr Firebase-Projekt aktivieren:

  1. Öffnen Sie in der Firebase Konsole den Bereich Auth.
  2. Aktivieren Sie auf dem Tab Anmeldemethode den Anbieter E‑Mail/Passwort. Beachten Sie , dass die Anmeldung per E‑Mail/Passwort aktiviert sein muss, damit die Anmeldung per E‑Mail-Link verwendet werden kann.
  3. Aktivieren Sie im selben Bereich die Anmeldemethode E‑Mail-Link (Anmeldung ohne Passwort) sign-in method.
  4. Klicken Sie auf Speichern.

Um den Authentifizierungsvorgang zu starten, präsentieren Sie dem Nutzer eine Schnittstelle, in der er aufgefordert wird, seine E‑Mail-Adresse anzugeben. Rufen Sie dann sendSignInLinkToEmail auf, um Firebase aufzufordern, den Authentifizierungslink an die E‑Mail-Adresse des Nutzers zu senden.

  1. Erstellen Sie das ActionCodeSettings Objekt, das Firebase Anweisungen zum Erstellen des E‑Mail-Links gibt. Legen Sie die Werte für die folgenden Felder fest:

    • url: Der einzubettende Deeplink und alle zusätzlichen Status, die weitergegeben werden sollen. Die Domain des Links muss in der Firebase Console in der Liste der autorisierten Domains auf die Zulassungsliste gesetzt werden. Sie finden diese Liste auf dem Tab „Anmeldemethode“ (Authentifizierung -> Anmeldemethode). Der Nutzer wird zu dieser URL weitergeleitet, wenn die App nicht auf seinem Gerät installiert ist und nicht installiert werden konnte.
    • androidPackageName und iOSBundleId: Helfen Firebase Authentication zu bestimmen , ob ein reiner Weblink oder ein mobiler Link erstellt werden soll, der auf einem Android- oder Apple-Gerät geöffnet wird.
    • handleCodeInApp: Auf „true“ festlegen. Die Anmeldung muss immer in der App abgeschlossen werden, anders als bei anderen E‑Mail-Aktionen außerhalb des Bandes (Passwortzurücksetzung und E‑Mail-Bestätigungen). Das liegt daran, dass der Nutzer am Ende des Vorgangs, angemeldet sein und sein Authentifizierungsstatus in der App gespeichert werden soll.
    • linkDomain: Wenn für ein Projekt benutzerdefinierte Hosting Link-Domains definiert sind, geben Sie an, welche verwendet werden soll, wenn der Link von einer bestimmten mobilen App geöffnet werden soll. Andernfalls wird automatisch die Standarddomain ausgewählt (z. B. PROJECT_ID.firebaseapp.com).
    • dynamicLinkDomain: Eingestellt. Geben Sie diesen Parameter nicht an.

    Kotlin

    val actionCodeSettings = actionCodeSettings {
    // URL you want to redirect back to. The domain (www.example.com) for this
    // URL must be whitelisted in the Firebase Console.
    url = "https://www.example.com/finishSignUp?cartId=1234"
    // This must be true
    handleCodeInApp = true
    setIOSBundleId("com.example.ios")
    setAndroidPackageName(
        "com.example.android",
        true, // installIfNotAvailable
        "12", // minimumVersion
    )
}
    MainActivity.kt

    Java

    ActionCodeSettings actionCodeSettings =
        ActionCodeSettings.newBuilder()
                // URL you want to redirect back to. The domain (www.example.com) for this
                // URL must be whitelisted in the Firebase Console.
                .setUrl("https://www.example.com/finishSignUp?cartId=1234")
                // This must be true
                .setHandleCodeInApp(true)
                .setIOSBundleId("com.example.ios")
                .setAndroidPackageName(
                        "com.example.android",
                        true, /* installIfNotAvailable */
                        "12"    /* minimumVersion */)
                .build();
    MainActivity.java

    Weitere Informationen zu ActionCodeSettings finden Sie im Abschnitt Status in E‑Mail-Aktionen weitergeben.

  2. Fragen Sie den Nutzer nach seiner E‑Mail-Adresse.

  3. Senden Sie den Authentifizierungslink an die E‑Mail-Adresse des Nutzers und speichern Sie die E‑Mail-Adresse des Nutzers falls er die E‑Mail-Anmeldung auf demselben Gerät abschließt.

    Kotlin

    Firebase.auth.sendSignInLinkToEmail(email, actionCodeSettings)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }
    MainActivity.kt

    Java

    FirebaseAuth auth = FirebaseAuth.getInstance();
auth.sendSignInLinkToEmail(email, actionCodeSettings)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });
    MainActivity.java

Sicherheitsbedenken

Damit ein Anmeldelink nicht verwendet werden kann, um sich als ein anderer Nutzer oder auf einem anderen Gerät anzumelden, muss in Firebase Authentication die E‑Mail-Adresse des Nutzers angegeben werden, wenn der Anmeldevorgang abgeschlossen wird. Damit die Anmeldung erfolgreich ist, muss diese E‑Mail Adresse mit der Adresse übereinstimmen, an die der Anmeldelink ursprünglich gesendet wurde.

Sie können diesen Vorgang für Nutzer optimieren, die den Anmeldelink auf demselben Gerät öffnen, auf dem sie ihn angefordert haben, indem Sie ihre E‑Mail-Adresse lokal speichern, z. B. mit SharedPreferences, wenn Sie die Anmelde-E‑Mail senden. Verwenden Sie dann diese Adresse, um den Vorgang abzuschließen. Geben Sie die E‑Mail-Adresse des Nutzers nicht in den Parametern der Weiterleitungs-URL weiter und verwenden Sie sie nicht wieder, da dies Sitzungseinschleusungen ermöglichen kann.

Nach Abschluss der Anmeldung werden alle bisherigen nicht bestätigten Anmeldemechanismen für den Nutzer entfernt und alle vorhandenen Sitzungen werden ungültig. Wenn beispielsweise jemand zuvor ein nicht bestätigtes Konto mit derselben E‑Mail-Adresse und demselben Passwort erstellt hat, wird das Passwort des Nutzers entfernt, damit sich der Betrüger, der das Eigentum beansprucht und dieses nicht bestätigte Konto erstellt hat, nicht noch einmal mit der nicht bestätigten E‑Mail-Adresse und dem nicht bestätigten Passwort anmelden kann.

Verwenden Sie in der Produktion außerdem eine HTTPS-URL, damit Ihr Link nicht von zwischengeschalteten Servern abgefangen werden kann.

Anmeldung in einer Android-App abschließen

Firebase Authentication verwendet Firebase Hosting, um den E‑Mail-Link an ein Mobilgerät zu senden. Damit die Anmeldung über die mobile App abgeschlossen werden kann, muss die App so konfiguriert sein, dass sie den eingehenden App-Link erkennt, den zugrunde liegenden Deeplink parst und dann die Anmeldung abschließt. Weitere Informationen finden Sie in der Dokumentation zu Android App Links.

Firebase Hosting konfigurieren

Firebase Authentication verwendet Firebase Hosting-Domains, wenn ein Link erstellt und gesendet wird, der in einer mobilen App geöffnet werden soll. Eine Standarddomain wurde bereits für Sie konfiguriert.Firebase Hosting

  1. Firebase Hosting Domains konfigurieren:

    Öffnen Sie in der Firebase Konsole den Hosting Bereich.

    • Wenn Sie die Standarddomain für den E‑Mail-Link verwenden möchten, der in mobilen Apps geöffnet wird, rufen Sie Ihre Standardwebsite auf und notieren Sie sich Ihre Standard Hosting Domain. Eine Standard-Hosting Domain sieht in der Regel so aus: PROJECT_ID.firebaseapp.com.

      Sie benötigen diesen Wert, wenn Sie Ihre App so konfigurieren, dass sie den eingehenden Link abfängt.

    • Wenn Sie eine benutzerdefinierte Domain für den E‑Mail-Link verwenden möchten, können Sie eine bei Firebase Hosting registrieren und sie für die Domain des Links verwenden.

  2. Android-Anwendungen konfigurieren:

    Damit diese Links von Ihrer Android-App verarbeitet werden können, muss der Paketname Ihrer App in den Firebase Console Projekteinstellungen angegeben werden. Außerdem müssen der SHA‑1 und der SHA‑256 des Anwendungs zertifikats angegeben werden.

    Wenn diese Links zu einer bestimmten Aktivität weiterleiten sollen, müssen Sie einen Intent-Filter in Ihrer AndroidManifest.xml Datei konfigurieren. Der Intent Filter sollte E‑Mail-Links Ihrer Domain abfangen. In AndroidManifest.xml:

    <intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data
    android:scheme="https"
    android:host="<PROJECT_ID>.firebaseapp.com or your custom domain"
    android:pathPrefix="/__/auth/links" />
</intent-filter>

    Wenn Nutzer einen Hosting-Link mit dem /__/auth/links Pfad und dem von Ihnen angegebenen Schema und Host öffnen, startet Ihre App die Aktivität mit diesem Intent Filter, um den Link zu verarbeiten.

Nachdem Sie den Link wie oben beschrieben erhalten haben, bestätigen Sie, dass er für die E‑Mail Link-Authentifizierung vorgesehen ist, und schließen Sie die Anmeldung ab.

Kotlin

val auth = Firebase.auth
val intent = intent
val emailLink = intent.data.toString()

// Confirm the link is a sign-in with email link.
if (auth.isSignInWithEmailLink(emailLink)) {
    // Retrieve this from wherever you stored it
    val email = "someemail@domain.com"

    // The client SDK will parse the code from the link for you.
    auth.signInWithEmailLink(email, emailLink)
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "Successfully signed in with email link!")
                val result = task.result
                // You can access the new user via result.getUser()
                // Additional user info profile *not* available via:
                // result.getAdditionalUserInfo().getProfile() == null
                // You can check if the user is new or existing:
                // result.getAdditionalUserInfo().isNewUser()
            } else {
                Log.e(TAG, "Error signing in with email link", task.exception)
            }
        }
}
MainActivity.kt

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
Intent intent = getIntent();
String emailLink = intent.getData().toString();

// Confirm the link is a sign-in with email link.
if (auth.isSignInWithEmailLink(emailLink)) {
    // Retrieve this from wherever you stored it
    String email = "someemail@domain.com";

    // The client SDK will parse the code from the link for you.
    auth.signInWithEmailLink(email, emailLink)
            .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
                @Override
                public void onComplete(@NonNull Task<AuthResult> task) {
                    if (task.isSuccessful()) {
                        Log.d(TAG, "Successfully signed in with email link!");
                        AuthResult result = task.getResult();
                        // You can access the new user via result.getUser()
                        // Additional user info profile *not* available via:
                        // result.getAdditionalUserInfo().getProfile() == null
                        // You can check if the user is new or existing:
                        // result.getAdditionalUserInfo().isNewUser()
                    } else {
                        Log.e(TAG, "Error signing in with email link", task.getException());
                    }
                }
            });
}
MainActivity.java

Weitere Informationen zum Umgang mit der Anmeldung per E‑Mail-Link in einer Apple-App, finden Sie im Leitfaden für Apple-Plattformen.

Informationen zum Umgang mit der Anmeldung per E‑Mail-Link in einer Webanwendung finden Sie in der Web-Anleitung.

Sie können diese Authentifizierungsmethode auch mit einem bestehenden Nutzer verknüpfen. Ein Nutzer, der sich zuvor mit einem anderen Anbieter authentifiziert hat, z. B. mit einer Telefonnummer, kann diese Anmeldemethode beispielsweise zu seinem bestehenden Konto hinzufügen.

Der Unterschied liegt in der zweiten Hälfte des Vorgangs:

Kotlin

// Construct the email link credential from the current URL.
val credential = EmailAuthProvider.getCredentialWithLink(email, emailLink)

// Link the credential to the current user.
Firebase.auth.currentUser!!.linkWithCredential(credential)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Successfully linked emailLink credential!")
            val result = task.result
            // You can access the new user via result.getUser()
            // Additional user info profile *not* available via:
            // result.getAdditionalUserInfo().getProfile() == null
            // You can check if the user is new or existing:
            // result.getAdditionalUserInfo().isNewUser()
        } else {
            Log.e(TAG, "Error linking emailLink credential", task.exception)
        }
    }
MainActivity.kt

Java

// Construct the email link credential from the current URL.
AuthCredential credential =
        EmailAuthProvider.getCredentialWithLink(email, emailLink);

// Link the credential to the current user.
auth.getCurrentUser().linkWithCredential(credential)
        .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Successfully linked emailLink credential!");
                    AuthResult result = task.getResult();
                    // You can access the new user via result.getUser()
                    // Additional user info profile *not* available via:
                    // result.getAdditionalUserInfo().getProfile() == null
                    // You can check if the user is new or existing:
                    // result.getAdditionalUserInfo().isNewUser()
                } else {
                    Log.e(TAG, "Error linking emailLink credential", task.getException());
                }
            }
        });
MainActivity.java

Dies kann auch verwendet werden, um einen E‑Mail-Link-Nutzer neu zu authentifizieren, bevor ein vertraulicher Vorgang ausgeführt wird.

Kotlin

// Construct the email link credential from the current URL.
val credential = EmailAuthProvider.getCredentialWithLink(email, emailLink)

// Re-authenticate the user with this credential.
Firebase.auth.currentUser!!.reauthenticateAndRetrieveData(credential)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            // User is now successfully reauthenticated
        } else {
            Log.e(TAG, "Error reauthenticating", task.exception)
        }
    }
MainActivity.kt

Java

// Construct the email link credential from the current URL.
AuthCredential credential =
        EmailAuthProvider.getCredentialWithLink(email, emailLink);

// Re-authenticate the user with this credential.
auth.getCurrentUser().reauthenticateAndRetrieveData(credential)
        .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // User is now successfully reauthenticated
                } else {
                    Log.e(TAG, "Error reauthenticating", task.getException());
                }
            }
        });
MainActivity.java

Da der Vorgang jedoch auf einem anderen Gerät enden könnte, auf dem der ursprüngliche Nutzer nicht angemeldet war, wird er möglicherweise nicht abgeschlossen. In diesem Fall kann dem Nutzer ein Fehler angezeigt werden, um ihn zu zwingen, den Link auf demselben Gerät zu öffnen. Im Link können einige Status weitergegeben werden, um Informationen zum Vorgangstyp und zur Nutzer-UID zu liefern.

Die E‑Mail-Link-Authentifizierung basierte zuvor auf Firebase Dynamic Links, die am 25. August 2025 eingestellt werden.

Wir haben eine alternative Lösung im Firebase Authentication Android SDK v23.2.0+ und Firebase BoM v33.9.0+ veröffentlicht.

Wenn Ihre App die alten Links verwendet, sollten Sie sie zum neuen Firebase Hosting basierten System migrieren.

Wenn Sie Ihr Projekt am oder nach dem 15. September 2023 erstellt haben, ist der Schutz vor E‑Mail-Enumeration standardmäßig aktiviert. Diese Funktion verbessert die Sicherheit der Nutzerkonten Ihres Projekts, deaktiviert jedoch die fetchSignInMethodsForEmail() Methode, die wir zuvor für die Implementierung von Abläufen empfohlen haben, bei denen die Kennung zuerst abgefragt wird.

Sie können den Schutz vor E‑Mail-Enumeration für Ihr Projekt deaktivieren, wir empfehlen dies jedoch nicht.

Weitere Informationen finden Sie in der Dokumentation zum Schutz vor E‑Mail-Enumeration.

Nächste Schritte

Wenn sich ein Nutzer zum ersten Mal anmeldet, 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 Telefon nummer 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 FirebaseUser 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 Authentifizierungs anbietern in Ihrer App anzumelden, indem Sie die Anmeldedaten des Authentifizierungsanbieters mit einem bestehenden Nutzerkonto verknüpfen.

Rufen Sie signOut auf, um einen Nutzer abzumelden:

Kotlin

Firebase.auth.signOut()
MainActivity.kt

Java

FirebaseAuth.getInstance().signOut();
MainActivity.java