Usa un dominio personalizado para los correos electrónicos de autenticación

Si usas un dominio personalizado en tu proyecto, considera también utilizarlo en los correos electrónicos enviados para los eventos de autenticación, como la verificación por correo electrónico, los cambios de dirección y los flujos de recuperación de contraseña. Puedes configurar el proyecto para que use el dominio personalizado en el campo From y en los vínculos de acción de los correos electrónicos.

Si configuras dominios personalizados para los correos electrónicos de autenticación, los usuarios verán el mismo dominio en tu dirección web y en los correos electrónicos de administración de usuarios.

En términos generales, existen dos pasos para configurar esta opción:

  • Agregar el dominio a tus plantillas de correo electrónico en Firebase console
  • Agregar registros DNS al registro de tu dominio para verificar el dominio.

Agrega el dominio a tus plantillas de correo electrónico

  1. En Firebase console, abre la página Plantillas de la sección Authentication.

  2. Para cada plantilla de correo electrónico, haz lo siguiente:

    1. Haz clic en el ícono de edición ().
    2. Haz clic en Personalizar dominio.
    3. Ingresa el dominio que quieres usar.

Verás una tabla de registros DNS para agregarla a tu registrador de dominios a fin de verificar que eres el propietario del dominio.

Verifica el dominio

Agrega o actualiza los registros DNS TXT y CNAME que se proporcionan en Firebase console. El procedimiento para hacerlo depende del registrador.

Solo puedes tener un registro TXT v=spf1... para un dominio en particular. Si necesitas especificar varias direcciones de correo electrónico, combínalas en un solo registro.

La verificación del dominio puede tardar hasta 24 horas. Cuando esté lista, la página Plantillas de Firebase console mostrará el mensaje “Verificación completada” en color verde. Luego, puedes hacer clic en el botón Aplicar dominio personalizado para implementar los cambios.

Proyectos multiusuario

Si actualizaste a Firebase Authentication con Identity Platform y habilitaste la función multiusuario, debes actualizar los metadatos del usuario para permitir que herede los dominios personalizados, las plantillas de correo electrónico y la configuración personalizada de SMTP. De lo contrario, los usuarios seguirán recibiendo correos electrónicos del dominio predeterminado, incluso si el dominio personalizado se verificó y aplicó correctamente.

Puedes verificar si la función multiusuario está habilitada si examinas la URL incluida en los mensajes de correo electrónico de Auth. Si la URL incluye un parámetro tenant, debes actualizar los metadatos del usuario de tu proyecto.

Para ello, ejecuta el siguiente comando:

curl -X PATCH -d "{'inheritance':{'emailSendingConfig': true}}" \
  -H "X-Goog-User-Project: PROJECT_ID"                          \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
  -H 'Content-Type:application/json'                            \
  https://identitytoolkit.googleapis.com/v2/projects/PROJECT_ID/tenants/TENANT_ID?updateMask=inheritance.emailSendingConfig