Utiliser un domaine personnalisé pour les e-mails d'authentification

Si vous utilisez un domaine personnalisé dans votre projet, pensez également à l'utiliser dans les e-mails envoyés pour les événements d'authentification, tels que les flux de validation d'adresse e-mail, de modification d'adresse et de récupération de mot de passe. Vous pouvez configurer votre projet pour qu'il utilise votre domaine personnalisé dans le champ From des e-mails et des liens d'action.

En configurant des domaines personnalisés pour les e-mails d'authentification, les utilisateurs verront le même domaine pour votre adresse Web et les e-mails de gestion des utilisateurs.

La configuration se déroule en deux étapes principales :

  • Ajoutez le domaine à vos modèles d'e-mail dans la console Firebase.
  • Validez votre domaine en ajoutant des enregistrements DNS dans votre bureau d'enregistrement de noms de domaine.

Ajouter le domaine à vos modèles d'e-mails

  1. Dans la consoleFirebase, ouvrez la page Modèles de la section Authentication.

  2. Pour chaque modèle d'e-mail, procédez comme suit :

    1. Cliquez sur l'icône Modifier ().
    2. Cliquez sur Personnaliser le domaine.
    3. Saisissez le domaine que vous souhaitez utiliser.

Vous verrez ensuite un tableau d'enregistrements DNS à ajouter à votre bureau d'enregistrement de noms de domaine pour valider que vous êtes bien propriétaire du domaine.

Valider le domaine

Ajoutez ou modifiez les enregistrements TXT et CNAME DNS indiqués dans la console Firebase. La procédure à suivre dépend du bureau d'enregistrement.

Vous ne pouvez avoir qu'un seul enregistrement TXT v=spf1... pour un domaine donné. Si vous devez spécifier plusieurs adresses e-mail, combinez-les en un seul enregistrement.

La validation du domaine peut prendre jusqu'à 24 heures. Si c'est le cas, la page "Modèles" de la console Firebase affichera le message vert "Validation terminée". Vous pouvez ensuite cliquer sur le bouton Appliquer le domaine personnalisé pour appliquer vos modifications.

Projets mutualisés

Si vous êtes passé à Firebase Authentication with Identity Platform et que vous avez activé la multitenance, vous devez mettre à jour les métadonnées du locataire pour lui permettre d'hériter des domaines personnalisés, des modèles d'e-mails et des paramètres SMTP personnalisés. Sinon, les utilisateurs continueront de recevoir des e-mails du domaine par défaut, même si le domaine personnalisé a été validé et appliqué.

Pour vérifier si le multitenancy est activé, examinez l'URL incluse dans les e-mails d'authentification. Si l'URL inclut un paramètre tenant, vous devez mettre à jour les métadonnées de locataire de votre projet.

Pour ce faire, exécutez la commande suivante :

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