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

Die E‑Mail-Link-Authentifizierung 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 Ihre App Firebase Dynamic Links verwendet, sollten Sie Ihre App auf das neue Firebase Hosting-basierte System umstellen.

Zugehörige Firebase Dynamic Links-Domain zu einer Firebase Hosting-Domain migrieren

Anstelle einer Firebase Dynamic Links-Domain wird Firebase Authentication künftig die Firebase Hosting-Standarddomain für Ihr Projekt verwenden, 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 zugehörige Domain für E‑Mail-Authentifizierungslinks zu Ihrer mobilen App verwendet wird.

Folgen Sie der Anleitung unter Mit Firebase über E-Mail-Link auf Apple-Plattformen authentifizieren, um Ihre App für die Verwendung der neuen automatisch bereitgestellten Firebase Hosting-Standarddomain zu aktualisieren.

Folgen Sie der Anleitung unten, um Links von der neuen Domain zu verarbeiten und Firebase Authentication anzuweisen, ab sofort die Domain Firebase Hosting 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. Verknüpfen Sie die Firebase Hosting-Domain mit der zu Ihrer App gehörenden Domain.

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

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

    Eine zugehörige Domaindatei wurde für alle Ihre Firebase Hosting-Domains bereitgestellt. Rufen Sie PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association auf, um darauf zuzugreifen. Diese AASA-Datei kann überschrieben werden. Weitere Informationen finden Sie unter Konfigurationsdateien für Universal Links erstellen und hosten.

  2. Konfigurieren Sie Ihr Projekt für die Verwendung der neuen Links.

    Wenn Sie bereit sind, die neuen Domainlinks zu verarbeiten, können Sie das Firebase Admin SDK verwenden, um festzulegen, wie E-Mail-Links generiert werden sollen. Außerdem können Sie unser Backend anweisen, Links mit der neuen Firebase Hosting-Domain zu generieren.

    const updateRequest = {
mobileLinksConfig: {
    domain: 'HOSTING_DOMAIN'
}
}
const updateProjectConfig = () => {
projectConfigManager.updateProjectConfig(updateRequest)
.then((response) => {
    // updated project config
}).catch((error) => {
    console.log('Error updating the project:', error);
});
}

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

    Senden Sie den Anmeldelink per E-Mail wie bisher. 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 Domain, die Ihrer App zugeordnet ist.
  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 z. B. 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.