Eseguire la migrazione dell'accesso tramite link email da Firebase Dynamic Links (iOS)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'autenticazione tramite link via email si basava in precedenza su Firebase Dynamic Links, che verrà
ritirato il 25 agosto 2025. Abbiamo pubblicato una
soluzione alternativa nell'SDK iOS Firebase Authentication versione 11.8.0 o successive. Se la tua
app utilizza Firebase Dynamic Links, devi eseguire la migrazione dell'app al nuovo
sistema basato su Firebase Hosting.
Eseguire la migrazione del dominio Firebase Dynamic Links associato a un dominio Firebase Hosting
In futuro, anziché utilizzare un dominio Firebase Dynamic Links, Firebase Authentication
utilizzerà il dominio predefinito Firebase Hosting per il tuo progetto per creare
link per i link email e altre azioni di link out-of-band nelle app mobile. Ciò
significa che anche la tua app dovrà essere aggiornata per utilizzare questo dominio predefinito come
dominio associato per i link di autenticazione delle email alla tua app mobile.
Segui le istruzioni riportate di seguito per gestire i link del nuovo dominio e per
indicare a Firebase Authentication di iniziare a utilizzare il dominio Firebase Hosting per
generare link per app mobile in futuro.
Se vuoi continuare a utilizzare uno dei tuoi domini Firebase Hosting personalizzati
o anche il tuo dominio Firebase Dynamic Links personalizzato come nuovo dominio associato,
segui le istruzioni nella sezione Personalizzare i link per il mobile
e adatta i passaggi in modo che corrispondano al dominio che vuoi utilizzare.
Collega il dominio Firebase Hosting al dominio associato alla tua app.
Devi configurare il dominio selezionato come dominio associato per i link
dell'app. Per configurare il diritto nella tua app, apri la scheda
Firma e funzionalità del target in Xcode e aggiungi i domini Firebase Hosting
del passaggio precedente alla funzionalità Domini associati. Se utilizzi il dominio Firebase Hosting predefinito, questo sarà applinks:PROJECT_ID.firebaseapp.com.
Un file di dominio associato è stato implementato in tutti i tuoi
domini Firebase Hosting. Per accedervi, vai a
PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association.
Questo file AASA può essere sovrascritto. Per ulteriori informazioni, consulta la sezione
Creare e ospitare i file di configurazione dei link universali.
Configura il progetto in modo da utilizzare i nuovi link.
Quando è tutto pronto per gestire i nuovi link di dominio, puoi utilizzare l'SDK Firebase Admin per aggiornare la modalità di generazione dei link email e indicare al nostro backend di iniziare a generare link utilizzando il nuovo dominio Firebase Hosting.
constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN'}}constupdateProjectConfig=()=>{projectConfigManager.updateProjectConfig(updateRequest).then((response)=>{// updated project config}).catch((error)=>{console.log('Error updating the project:',error);});}
Invia e utilizza il link nell'email.
Invia il link di accesso via email come prima. Quando un utente finale fa clic sul link,
viene reindirizzato all'app, se installata, per completare l'accesso.
Personalizzare i link per il mobile
Puoi utilizzare un dominio Firebase Hosting personalizzato o riutilizzare il tuo dominio
Firebase Dynamic Links personalizzato come nuovo dominio dei link mobile.
Utilizzare un dominio Firebase Hosting personalizzato
Riutilizzare il dominio personalizzato Firebase Dynamic Links
Puoi riutilizzare uno qualsiasi dei tuoi domini Firebase Dynamic Links come dominio personalizzato. Tuttavia, qualsiasi funzionalità Firebase Dynamic Links non sarà più
supportata (ad esempio, gli utenti non potranno essere reindirizzati all'app store se l'app
non è installata sul loro dispositivo).
[null,null,["Ultimo aggiornamento 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`."]]
