Migra el acceso con vínculo de correo electrónico desde Firebase Dynamic Links (iOS)

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 11.8.0 o posterior del SDK de Firebase Authentication para iOS. Si tu app usa Firebase Dynamic Links, debes migrar tu app al nuevo sistema basado en Firebase Hosting.

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.

Puedes seguir las instrucciones que se indican en Autentica con Firebase mediante un vínculo de correo electrónico en plataformas de Apple para actualizar tu app y usar el nuevo dominio predeterminado Firebase Hosting aprovisionado automáticamente.

Usa las siguientes instrucciones para controlar los vínculos del dominio nuevo y para indicarle a Firebase Authentication que comience a usar el dominio de Firebase Hosting 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 las instrucciones de la sección Cómo personalizar los vínculos para dispositivos móviles y adapta los pasos para que coincidan con el dominio que deseas usar.

  1. Vincula el dominio de Firebase Hosting al dominio asociado de tu app

    Deberás configurar el dominio seleccionado como un dominio asociado para los vínculos de apps. Para configurar el derecho en tu app, abre la pestaña Signing & Capabilities del destino en Xcode y agrega los dominios de Firebase Hosting del paso anterior a la función de dominios asociados. Si usas el dominio de Firebase Hosting predeterminado, será applinks:PROJECT_ID.firebaseapp.com.

    Consulta Cómo admitir dominios asociados en el sitio de documentación de Apple para obtener más información.

    Se implementó un archivo de dominio asociado en todos tus dominios de Firebase Hosting. Para acceder a él, navega a PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Este archivo AASA se puede reemplazar. Para obtener más información, consulta Crea y aloja tus archivos de configuración de vínculos universales.

  2. 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.

    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. 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 un usuario final haga clic en el vínculo, se lo redireccionará a la app si está instalada para que finalice el acceso.

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.

Usa un dominio personalizado de Firebase Hosting

  1. Sigue la guía de Firebase Hosting para configurar un dominio personalizado.
  2. Vincula el dominio personalizado al dominio asociado de tu app.
  3. Envía un vínculo de autenticación a la dirección de correo electrónico del usuario con un objeto ActionCodeSettings actualizado con un dominio personalizado como linkDomain.
  1. 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 la tienda de aplicaciones si la app no está instalada en su dispositivo).
  2. Envía un vínculo de autenticación a la dirección de correo electrónico del usuario con un objeto ActionCodeSettings actualizado con un dominio personalizado como linkDomain.