Utilizzare un dominio personalizzato per le email di autenticazione

Se utilizzi un dominio personalizzato nel tuo progetto, ti consigliamo di utilizzarlo anche nelle email inviate per gli eventi di autenticazione, come la verifica email, la modifica dell'indirizzo e i flussi di recupero della password. Puoi configurare il progetto utilizza il tuo dominio personalizzato nell'email From link a campi e azioni.

Configurando domini personalizzati per le email di autenticazione, gli utenti vedranno lo stesso dominio per il tuo indirizzo web e gli indirizzi email per la gestione degli utenti.

La configurazione prevede due passaggi:

  • Aggiungi il dominio ai tuoi modelli di email nella console Firebase.
  • Verifica il dominio aggiungendo i record DNS nel dominio registar.

Aggiunta del dominio ai modelli email

  1. Nella console Firebase, apri il Pagina Modelli di sezione Authentication.

  2. Per ogni modello email:

    1. Fai clic sull'icona di modifica ().
    2. Fai clic su Personalizza dominio.
    3. Inserisci il dominio che vuoi utilizzare.

Vedrai quindi una tabella dei record DNS da aggiungere al registrar di domini per la verifica che il dominio sia di tua proprietà.

Verifica il dominio

Aggiungi o aggiorna i record DNS TXT e CNAME forniti nella console Firebase. La procedura per farlo dipende dal registrar.

Puoi avere un solo record TXT v=spf1... per un determinato dominio. Se specificare più indirizzi email, combinarli in un unico record.

La verifica del dominio può richiedere fino a 24 ore. In questo caso, nella pagina Modelli della console Firebase verrà visualizzato il messaggio verde "Verifica completata". Quindi, puoi fare clic sul pulsante Applica dominio personalizzato per applicare l'applicazione delle modifiche.

Progetti multi-tenant

Se hai eseguito l'upgrade a Firebase Authentication with Identity Platform e hai attivato la multitenancy, devi aggiornare i metadati tenant per consentire al tenant di ereditare domini personalizzati, modelli di email e impostazioni SMTP personalizzate. In caso contrario, gli utenti continueranno a ricevere email dal dominio predefinito anche se il dominio personalizzato viene verificato e applicato correttamente.

Puoi verificare se la multitenancy è attiva esaminando l'URL incluso nei messaggi email di Auth. Se l'URL include un parametro tenant, devi aggiornare dei metadati tenant del progetto.

Per farlo, esegui il seguente 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