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

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

Si vous configurez des domaines personnalisés pour les e-mails d'authentification, les utilisateurs auront accès pour votre adresse Web et les e-mails de gestion des utilisateurs.

La configuration s'effectue généralement en deux étapes:

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

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

  1. Dans la console Firebase, ouvrez le Page "Modèles" sur 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.

Un tableau des enregistrements DNS à ajouter à votre bureau d'enregistrement de noms de domaine pour valider s'affiche. que vous êtes propriétaire du domaine.

Valider le domaine

Ajoutez ou mettez à jour les enregistrements DNS TXT et CNAME fournis 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 dans un seul enregistrement.

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

Projets multilocataires

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

Vous pouvez vérifier si l'architecture mutualisée est activée en examinant l'URL incluse dans Auth e-mails. 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