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

Die Authentifizierung per E-Mail-Link basierte bisher auf Firebase Dynamic Links, das am 25. August 2025 eingestellt wird. Wir haben eine alternative Lösung im Firebase Authentication iOS SDK ab Version 11.8.0 veröffentlicht. Wenn in Ihrer App Firebase Dynamic Links verwendet wird, sollten Sie sie auf das neue Firebase Hosting-basierte System migrieren.

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

In Zukunft wird Firebase Authentication anstelle einer Firebase Dynamic Links-Domain die Standarddomain Firebase Hosting für Ihr Projekt verwenden, um Links für E-Mail-Links und andere Out-of-Band-Linkaktionen in mobilen Apps zu erstellen. Das bedeutet, dass Ihre App ebenfalls 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 Standarddomain Firebase Hosting verwendet wird.

Folge der Anleitung unten, um Links von der neuen Domain zu verarbeiten und Firebase Authentication anzuweisen, ab sofort die Domain Firebase Hosting zu verwenden, um Links für mobile Apps zu generieren.

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

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

    Sie müssen die ausgewählte Domain als verknüpfte Domain für App-Links konfigurieren. Wenn Sie die Berechtigung in Ihrer App einrichten möchten, öffnen Sie in Xcode den Tab Signing & Capabilities des Ziels und fügen Sie die Firebase Hosting-Domains aus dem vorherigen Schritt zur Funktion „Associated Domains“ hinzu. Wenn Sie die Standarddomain Firebase Hosting verwenden, ist dies applinks:PROJECT_ID.firebaseapp.com.

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

    Eine verknüpfte Domaindatei wurde unter allen Ihren Firebase Hosting-Domains bereitgestellt. Rufen Sie dazu PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association auf. Diese AASA-Datei kann überschrieben werden. Weitere Informationen finden Sie unter Konfigurationsdateien für universelle Links erstellen und hosten.

  2. Konfigurieren Sie Ihr Projekt so, dass die neuen Links verwendet werden.

    Wenn Sie bereit sind, die neuen Domainlinks zu verarbeiten, können Sie mit dem Firebase Admin SDK die Generierung von E‑Mail-Links aktualisieren und unser Backend anweisen, Links mit der neuen Domain Firebase Hosting 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. Senden Sie den E‑Mail-Link und lösen Sie ihn ein.

    Senden Sie den Anmeldelink per E‑Mail wie zuvor. Wenn ein Endnutzer auf den Link klickt, wird er zur App weitergeleitet, sofern 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 mit Ihrer App verknüpften Domain.
  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 jede Ihrer Firebase Dynamic Links-Domains als benutzerdefinierte Domain wiederverwenden. Firebase Dynamic Links-Funktionen werden jedoch nicht mehr unterstützt. Nutzer können beispielsweise nicht zum App-Shop 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.