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

Si vous utilisez un domaine personnalisé dans votre projet, envisagez également d'utiliser votre domaine personnalisé dans les e-mails envoyés pour les événements d'authentification, tels que les flux de vérification des e-mails, de changement d'adresse et de récupération de mot de passe. Vous pouvez configurer votre projet pour utiliser votre domaine personnalisé dans le champ From et les liens d'action des e-mails.

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.

Il y a en gros deux étapes pour configurer cela :

  • Ajoutez le domaine à vos modèles d'e-mail dans la console Firebase.
  • Vérifiez votre domaine en ajoutant des enregistrements DNS dans votre registraire de domaine.

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

  1. Dans la console Firebase, ouvrez la page Modèles de la section Authentification.

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

    1. Cliquez sur l'icône d'édition ( ).
    2. Cliquez sur personnaliser le domaine .
    3. Entrez le domaine que vous souhaitez utiliser.

Vous verrez alors un tableau des enregistrements DNS à ajouter à votre registraire de domaine pour vérifier que vous possédez le domaine.

Vérifier le domaine

Ajoutez ou mettez à jour les enregistrements DNS TXT et CNAME fournis dans la console Firebase. La procédure à suivre dépend du registraire.

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

La vérification du domaine peut prendre jusqu'à 24 heures. Lorsque c'est le cas, la page Modèles de la console Firebase affichera un message vert « Vérification terminée ». Ensuite, vous pouvez cliquer sur le bouton Appliquer le domaine personnalisé pour appliquer vos modifications.

Projets multi-locataires

Si vous avez effectué une mise à niveau vers l'authentification Firebase avec Identity Platform et activé la multilocation , vous devez mettre à jour les métadonnées du locataire pour permettre au locataire d'hériter de domaines personnalisés, de modèles de courrier électronique et de paramètres SMTP personnalisés. Sinon, les utilisateurs reçoivent toujours des e-mails du domaine par défaut même si le domaine personnalisé est vérifié et appliqué avec succès.

Vous pouvez vérifier si la multilocation est activée en examinant 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 du 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