Eseguire la migrazione dell'accesso tramite link email da Firebase Dynamic Links (Android)
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 nella versione 23.2.0 o successive dell'SDK Android e
nella versione 33.9.0 o successive. Se la tua app utilizza i link in stile precedente e
vuoi utilizzare un metodo alternativo per la migrazione, consulta
Autenticarsi con Firebase utilizzando il link via email in Android
per utilizzare il nuovo sistema basato su Firebase Hosting.Firebase AuthenticationFirebase BoM
Inoltre, se utilizzi l'SDK Android Firebase Authentication precedente alla versione 20.0.0 (o
Firebase BoM precedente alla versione 26.0.0) per gestire i flussi OAuth con Firebase Authentication,
dovrai eseguire l'aggiornamento all'ultima versione dell'SDK Authentication o BoM
(Authentication v20.0.0+ o BoM v26.0.0+) per continuare a gestire i flussi OAuth
in Firebase Authentication.
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 email alla tua app mobile.
Puoi seguire le istruzioni riportate in
Autenticarsi con Firebase utilizzando il link email in Android per aggiornare i link della tua app mobile
in modo da utilizzare il nuovo dominio predefinito Firebase Hosting di cui è stato eseguito il provisioning automatico.
Segui queste istruzioni per gestire i link del nuovo dominio e per
indicare a Firebase Authentication di iniziare a utilizzare il nuovo dominio 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 i passaggi corrispondenti al dominio che vuoi utilizzare. Nota: dopo aver completato le istruzioni nella sezione seguente, la funzionalità di deep linking sul tuo dominio personalizzato Firebase Dynamic Links verrà rimossa; rimarrà solo il dominio per la creazione di link email.
Configurare l'applicazione Android per gestire il link Firebase Hosting
Per gestire questi link dalla tua applicazione Android, il nome del pacchetto dell'app deve essere specificato nelle impostazioni del progetto della console Firebase. Inoltre, devono essere forniti SHA-1 e SHA-256 del certificato dell'applicazione.
Se vuoi che questi link Firebase Hosting reindirizzino a un'attività specifica, devi configurare un filtro per intent nel file AndroidManifest.xml. Il filtro per intent deve intercettare
i link Firebase Hosting del tuo dominio. In AndroidManifest.xml:
Quando gli utenti aprono un link di hosting con il percorso "/__/auth/links" e lo schema e l'host che specifichi, la tua app avvierà l'attività con questo filtro per intent per gestire il link.
Configurare il progetto in modo che utilizzi 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.
import{getAuth}from'firebase-admin/auth';constupdateEmailAuthDomain=async()=>{constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN',},};constprojectConfigManager=getAuth().projectConfigManager();try{constresponse=awaitprojectConfigManager.updateProjectConfig(updateRequest);// Updated project configconsole.log('Project configuration updated successfully:',response);}catch(error){console.error('Error updating the project:',error);}};
Inviare e utilizzare il link nell'email
Invia il link di accesso via email come prima. Quando l'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 possono essere reindirizzati a un app store se
l'app non è installata sul loro dispositivo).
Configura l'applicazione Android per gestire il link Firebase Hosting
(istruzioni nella sezione precedente).
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 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 Android SDK version 23.2.0+ and\nFirebase BoM version 33.9.0+. If your app uses the old style links and you\nwant to use an alternative method for migrating your app, see\n[Authenticate with Firebase using Email Link in Android](/docs/auth/android/email-link-auth)\nto use the new Firebase Hosting based system.\n\nAlso, if you're using the **Firebase Authentication Android SDK below v20.0.0 (or the\nFirebase BoM below v26.0.0) to manage OAuth flows** with Firebase Authentication,\nyou'll need to update to the latest Authentication SDK or BoM version\n(Authentication v20.0.0+ or BoM v26.0.0+) in order to continue managing OAuth\nflows in Firebase Authentication.\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 in Android](/docs/auth/android/email-link-auth) to update your mobile app links\nto use the new automatically provisioned Firebase Hosting default domain.\n\nUse the following instructions to handle links from the new domain and to\ninstruct Firebase Authentication to start using the new domain to generate mobile app\nlinks 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\ndomain, follow the steps that match the intended domain you'd like to use. Note\nthat after completing the instructions in the following section, the deep\nlinking feature on your Firebase Dynamic Links custom domain will be removed;\nonly the domain itself will remain for creating email links.\n\n1. **Configure your Android application to handle your Firebase Hosting link**\n\n 1. In order to handle these links from your Android application, your app's package name needs to be specified in the Firebase console project settings. In addition, the SHA-1 and SHA-256 of the application certificate need to be provided.\n 2. If you want these Firebase Hosting links to redirect to a specific\n activity, you will need to configure an intent filter in your\n `AndroidManifest.xml` file. The intent filter should catch\n Firebase Hosting links of your domain. In `AndroidManifest.xml`:\n\n \u003cintent-filter android:autoVerify=\"true\"\u003e\n \u003caction android:name=\"android.intent.action.VIEW\" /\u003e\n \u003ccategory android:name=\"android.intent.category.BROWSABLE\" /\u003e\n \u003ccategory android:name=\"android.intent.category.DEFAULT\" /\u003e\n \u003cdata\n android:scheme=\"https\"\n android:host=\"PROJECT_ID.firebaseapp.com or a custom hosting domain\"\n android:pathPrefix=\"/__/auth/links\" /\u003e\n \u003c/intent-filter\u003e\n\n When users open a hosting link with the \"/__/auth/links\" path and the\n scheme and host you specify, your app will start the activity with this\n intent filter to handle the link.\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\n the new Firebase Hosting domain. \n\n import { getAuth } from 'firebase-admin/auth';\n\n const updateEmailAuthDomain = async () =\u003e {\n const updateRequest = {\n mobileLinksConfig: {\n domain: 'HOSTING_DOMAIN',\n },\n };\n\n const projectConfigManager = getAuth().projectConfigManager();\n\n try {\n const response = await projectConfigManager.updateProjectConfig(updateRequest);\n // Updated project config\n console.log('Project configuration updated successfully:', response);\n } catch (error) {\n console.error('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 the end user clicks the link,\n they will be redirected to the app if installed to complete 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. Configure your Android application to handle your Firebase Hosting link. (instructions in previous section above).\n3. [Send an authentication link to the user's email\n address](/docs/auth/android/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 an app store if the app isn't installed on their device).\n2. Configure your Android application to handle your Firebase Hosting link (instructions in previous section above).\n3. [Send an authentication link to the user's email\n address](/docs/auth/android/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`."]]
