Anmeldung über E-Mail-Link von Firebase Dynamic Links migrieren (iOS)

Die E-Mail-Link-Authentifizierung basierte bisher auf Firebase Dynamic Links, die am 25. August 2025 eingestellt werden. Wir haben eine alternative Lösung in Version 11.8.0 oder höher des Firebase Authentication iOS SDK veröffentlicht. Wenn Ihre App Firebase Dynamic Links verwendet, sollten Sie sie zum neuen Firebase Hosting basierten System migrieren.

Verknüpfte Firebase Dynamic Links Domain zu einer Firebase Hosting Domain migrieren

Anstelle einer Firebase Dynamic Links Domain verwendet Firebase Authentication künftig die Firebase Hosting standardmäßige Domain für Ihr Projekt, um Links für E-Mail-Links und andere Out-of-Band-Link-Aktionen in mobilen Apps zu erstellen. Das bedeutet, dass Ihre App auch aktualisiert werden muss, damit diese Standarddomain als verknüpfte Domain für E-Mail-Authentifizierungslinks zu Ihrer mobilen App verwendet wird.

Folgen Sie der Anleitung unter Mit Firebase über einen E-Mail-Link auf Apple-Plattformen authentifizieren , um Ihre App so zu aktualisieren, dass die neue automatisch bereitgestellte Firebase Hosting standardmäßige Domain verwendet wird.

Folgen Sie der Anleitung, um Links von der neuen Domain zu verarbeiten und Firebase Authentication anzuweisen, künftig die Firebase Hosting Domain zum Generieren von Links für mobile Apps zu verwenden.

Wenn Sie eine Ihrer benutzerdefinierten Firebase Hosting Domains oder sogar Ihre benutzerdefinierte Firebase Dynamic Links Domain als neue verknüpfte Domain verwenden möchten, passen Sie die Schritte in der Anleitung im Abschnitt Mobile Links anpassen an die gewünschte Domain an.

  1. Domain Firebase Hosting mit der verknüpften Domain Ihrer App verknüpfen

    Sie müssen die ausgewählte Domain als verknüpfte Domain für App-Links konfigurieren. Öffnen Sie dazu in Xcode den Tab Signieren & Funktionen des Ziels und fügen Sie die Firebase Hosting Domains aus dem vorherigen Schritt der Funktion „Verknüpfte Domains“ hinzu. Wenn Sie die Standard-Firebase HostingDomain verwenden, lautet sie applinks:PROJECT_ID.firebaseapp.com.

    Weitere Informationen finden Sie in der Dokumentation von Apple unter Supporting associated domains.

    Eine Datei mit verknüpften Domains wurde unter allen Ihren Firebase Hosting Domains bereitgestellt. Sie können sie unter PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association aufrufen. Diese AASA-Datei kann überschrieben werden. Weitere Informationen finden Sie unter Konfigurationsdateien für universelle Links erstellen und hosten .

  2. Projekt für die Verwendung der neuen Links konfigurieren

    Wenn Sie bereit sind, die neuen Domain-Links zu verarbeiten, können Sie mit dem Firebase Admin SDK festlegen, wie E-Mail-Links generiert werden sollen, und unser Back-End anweisen, Links mit der neuen Firebase Hosting Domain zu generieren.

    import { getAuth } from 'firebase-admin/auth';

const updateEmailAuthDomain = async () => {
    const updateRequest = {
        mobileLinksConfig: {
            domain: 'HOSTING_DOMAIN',
        },
    };

    const projectConfigManager = getAuth().projectConfigManager();

    try {
        const response = await projectConfigManager.updateProjectConfig(updateRequest);
        // Updated project config
        console.log('Project configuration updated successfully:', response);
    } catch (error) {
        console.error('Error updating the project:', error);
    }
};

  3. E-Mail-Link senden und einlösen

    Senden Sie den E-Mail-Anmeldelink wie zuvor. Wenn ein Endnutzer auf den Link klickt, wird er zur App weitergeleitet, falls sie installiert ist, um die Anmeldung abzuschließen.

Sie können eine benutzerdefinierte Firebase Hosting Domain verwenden oder Ihre benutzerdefinierte Firebase Dynamic Links Domain als neue Domain für mobile Links wiederverwenden.

Benutzerdefinierte Firebase Hosting Domain verwenden

  1. Folgen Sie der Firebase Hosting Anleitung um eine benutzerdefinierte Domain einzurichten.
  2. Verknüpfen Sie die benutzerdefinierte Domain mit der verknüpften Domain Ihrer App.
  3. Senden Sie einen Authentifizierungslink an die E-Mail-Adresse des Nutzers mit einem aktualisierten ActionCodeSettings Objekt mit einer benutzerdefinierten Domain als linkDomain.
  1. Sie können eine Ihrer Firebase Dynamic Links Domains als benutzerdefinierte Domain wiederverwenden. Allerdings werden dann keine Firebase Dynamic Links Funktionen mehr unterstützt. Nutzer können beispielsweise nicht zum App-Store weitergeleitet werden, wenn die App nicht auf ihrem Gerät installiert ist.
  2. Senden Sie einen Authentifizierungslink an die E-Mail-Adresse des Nutzers mit einem aktualisierten ActionCodeSettings Objekt mit einer benutzerdefinierten Domain als linkDomain.