Migra el acceso con vínculo de correo electrónico desde Firebase Dynamic Links (Android)
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La autenticación mediante vínculos de correo electrónico antes dependía de Firebase Dynamic Links, que dejará de estar disponible el 25 de agosto de 2025. Publicamos una
solución alternativa en la versión 23.2.0 del SDK de Firebase Authentication para Android y versiones posteriores, y
la versión 33.9.0 de Firebase BoM y versiones posteriores. Si tu app usa vínculos del estilo anterior y
quieres usar un método alternativo para migrar tu app, consulta
Cómo autenticarse con Firebase mediante un vínculo de correo electrónico en Android
para usar el nuevo sistema basado en Firebase Hosting.
Además, si usas el SDK de Android Firebase Authentication anterior a la versión 20.0.0 (o Firebase BoM anterior a la versión 26.0.0) para administrar flujos de OAuth con Firebase Authentication, deberás actualizar a la versión más reciente del SDK de Authentication o de BoM (Authentication 20.0.0 o una versión superior, o BoM 26.0.0 o una versión superior) para seguir administrando flujos de OAuth en Firebase Authentication.
Migra tu dominio de Firebase Dynamic Links asociado a un dominio de Firebase Hosting
En el futuro, en lugar de usar un dominio de Firebase Dynamic Links, Firebase Authentication
usará el dominio predeterminado de Firebase Hosting de tu proyecto para crear
vínculos para el vínculo de correo electrónico y otras acciones de vínculo fuera de banda en apps para dispositivos móviles. Esto significa que tu app también deberá actualizarse para usar este dominio predeterminado como el dominio asociado para los vínculos de autenticación de correo electrónico a tu app para dispositivos móviles.
Usa las siguientes instrucciones para controlar los vínculos del dominio nuevo y para indicarle a Firebase Authentication que comience a usar el dominio nuevo para generar vínculos de apps para dispositivos móviles en el futuro.
Si deseas seguir usando cualquiera de tus dominios de Firebase Hosting personalizados
o incluso tu dominio de Firebase Dynamic Links personalizado como tu nuevo dominio
asociado, sigue los pasos que coincidan con el dominio que deseas usar. Ten en cuenta que, después de completar las instrucciones de la siguiente sección, se quitará la función de vinculación directa de tu dominio personalizado de Firebase Dynamic Links. Solo quedará el dominio para crear vínculos de correo electrónico.
Configura tu aplicación para Android para que controle tu vínculo de Firebase Hosting
Para manejar estos vínculos desde la aplicación para Android, es necesario especificar el nombre del paquete de la app en la configuración del proyecto de Firebase console. Además, es necesario proporcionar el SHA-1 y el SHA-256 del certificado de aplicación.
Si deseas que estos vínculos de Firebase Hosting redireccionen a una actividad específica, deberás configurar un filtro de intents en el archivo AndroidManifest.xml. El filtro de intents debe capturar vínculos de Firebase Hosting de tu dominio. En AndroidManifest.xml:
Cuando los usuarios abren un vínculo de hosting con la ruta de acceso "/__/auth/links" y el esquema y el host que especificaste, tu app iniciará la actividad con este filtro de intents para controlar el vínculo.
Configura tu proyecto para usar los vínculos nuevos
Cuando tengas todo listo para controlar los vínculos del nuevo dominio, puedes usar el
SDK de Firebase Admin para actualizar la forma en que deseas que se generen los vínculos
de correo electrónico y ordenarle a nuestro backend que comience a generar vínculos con el
nuevo dominio de 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);}};
Envía y canjea el vínculo del correo electrónico
Envía el vínculo de acceso por correo electrónico como antes. Cuando el usuario final haga clic en el vínculo, se lo redireccionará a la app, si está instalada, para que complete el acceso.
Personaliza tus vínculos para dispositivos móviles
Puedes usar un dominio Firebase Hosting personalizado o reutilizar tu dominio de Firebase Dynamic Links personalizado para que sea tu nuevo dominio de vínculos para dispositivos móviles.
Vuelve a usar tu dominio personalizado de Firebase Dynamic Links
Puedes volver a usar cualquiera de tus dominios de Firebase Dynamic Links como tu dominio personalizado. Sin embargo, ya no se admitirá ninguna funcionalidad de Firebase Dynamic Links (por ejemplo, no se puede redireccionar a los usuarios a una tienda de aplicaciones si la app no está instalada en su dispositivo).
Configura tu aplicación para Android para que controle tu vínculo de Firebase Hosting (consulta las instrucciones en la sección anterior).
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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`."]]
