Anmeldung über E-Mail-Link von Firebase Dynamic Links migrieren (iOS)
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 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.
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 des Ziels und fügen Sie die Firebase Hosting-Domains aus dem vorherigen Schritt der Funktion „Associated 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.
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.
constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN'}}constupdateProjectConfig=()=>{projectConfigManager.updateProjectConfig(updateRequest).then((response)=>{// updated project config}).catch((error)=>{console.log('Error updating the project:',error);});}
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.
Mobile Links anpassen
Sie können eine benutzerdefinierte Firebase Hosting-Domain verwenden oder Ihre benutzerdefinierte Firebase Dynamic Links-Domain als neue Domain für mobile Links wiederverwenden.
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.
[null,null,["Zuletzt aktualisiert: 2025-08-16 (UTC)."],[],[],null,["Email link authentication previously relied on Firebase Dynamic Links, which will be\n[shut down on August 25, 2025](/support/dynamic-links-faq). We've published an\nalternative solution in the Firebase Authentication iOS SDK version 11.8.0+. If your\napp uses Firebase Dynamic Links, you should migrate your app to the new\nFirebase Hosting based system.\n\nMigrate your associated Firebase Dynamic Links domain to a Firebase Hosting domain\n\nMoving forward, rather than using a Firebase Dynamic Links domain, Firebase Authentication\nwill use the Firebase Hosting default domain for your project to create\nlinks for email link and other out-of-band link actions in mobile apps. This\nmeans that your app will also need to be updated to use this default domain as\nthe associated domain for email authentication links to your mobile app.\n\nYou can follow the instructions in\n[Authenticate with Firebase Using Email Link on Apple Platforms](/docs/auth/ios/email-link-auth)\nto update your app to use the new automatically provisioned Firebase Hosting\ndefault domain.\n\nUse the following instructions to handle links from the new domain and to\ninstruct Firebase Authentication to start using the Firebase Hosting domain to\ngenerate mobile app links going forward.\n\nIf you'd like to continue using any of your custom Firebase Hosting domains\nor even your custom Firebase Dynamic Links domain to be your new associated domain,\nusing the instructions in the [Customize Mobile Links](#customize-mobile-links)\nsection, adapt the steps to match the intended domain you'd like to use.\n\n1. **Link Firebase Hosting domain to your app associated domain.**\n\n You'll need to configure the selected domain as an Associated Domain for\n app links. To set up the entitlement in your app, open the target's\n **Signing \\& Capabilities** tab in Xcode and add Firebase Hosting domains\n from the previous step to the Associated Domains capability. If using the\n default Firebase Hosting domain, this will be\n `applinks:`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com`.\n\n See [Supporting associated domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains)\n on Apple's documentation site for more information.\n\n An associated domain file has been deployed under all your\n Firebase Hosting domains. To access it, navigate to\n \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com/.well-known/apple-app-site-association`.\n This AASA file can be overwritten; see\n [Create and host your Universal Links configuration files](/support/guides/app-links-universal-links#create_and_host_your_universal_links_configuration_files_on_your_new_hosting_domain)\n for more information.\n | **Important:** To ensure a seamless rollback, we recommend keeping your existing intent filter that handles Firebase Dynamic Links while trying out the Firebase Hosting link solution. The Firebase Dynamic Links solution will be available until August 25, 2025.\n2. **Configure your project to use the new links.**\n\n When you're ready to handle the new domain links, you can use the\n [Firebase Admin SDK](/docs/admin/setup) to update how you want email links\n to be generated and instruct our backend to start generating links using the\n new Firebase Hosting domain. \n\n const updateRequest = {\n mobileLinksConfig: {\n domain: 'HOSTING_DOMAIN'\n }\n }\n const updateProjectConfig = () =\u003e {\n projectConfigManager.updateProjectConfig(updateRequest)\n .then((response) =\u003e {\n // updated project config\n }).catch((error) =\u003e {\n console.log('Error updating the project:', error);\n });\n }\n\n | **Important:** To rollback to the Firebase Dynamic Links while implementing and testing the backup solution, you should set the domain back to `FIREBASE_DYNAMIC_LINK`. The Firebase Dynamic Links solution will be available until August 25, 2025.\n3. **Send and redeem the email link.**\n\n Send the email sign-in link as before. When an end user clicks on the link,\n they will be redirected to the app if installed to finish the sign in.\n\nCustomize your mobile links\n\nYou can use a custom Firebase Hosting domain or reuse your custom\nFirebase Dynamic Links domain to be your new mobile links domain.\n\nUse a custom Firebase Hosting domain\n\n1. Follow the [Firebase Hosting guide](/docs/hosting/custom-domain) to set up a custom domain.\n2. Link the custom domain to your app associated domain.\n3. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`.\n\nRe-use your custom Firebase Dynamic Links domain\n\n1. You can re-use any of your Firebase Dynamic Links domains as your custom domain. However, any Firebase Dynamic Links functionality will no longer be supported (for example, users cannot be redirected to the app store if app isn't installed on their device).\n2. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`."]]
