Benutzerdefinierte Domain für Authentifizierungs-E-Mails verwenden

Wenn Sie in Ihrem Projekt eine benutzerdefinierte Domain verwenden, sollten Sie auch Ihre benutzerdefinierte Domain verwenden. Domain in den E-Mails, die für Authentifizierungsereignisse wie E-Mail-Bestätigung, Abläufe bei der Adressänderung und der Passwortwiederherstellung. Sie können Ihr Projekt so konfigurieren, Ihre benutzerdefinierte Domain in den E-Mails verwenden Feld und Aktionslinks für From.

Wenn Sie benutzerdefinierte Domains für Authentifizierungs-E-Mails konfigurieren, sehen Nutzer dieselben Domain für Ihre Webadresse und die E-Mails zur Nutzerverwaltung an.

Die Einrichtung erfolgt grundsätzlich in zwei Schritten:

  • Fügen Sie die Domain Ihren E-Mail-Vorlagen in der Firebase-Konsole hinzu.
  • Bestätigen Sie Ihre Domain, indem Sie Ihrem Domain-Registrator DNS-Einträge hinzufügen.

Domain Ihren E-Mail-Vorlagen hinzufügen

  1. Öffnen Sie in der Firebase-Konsole das Vorlagenseite von Abschnitt Authentication.

  2. Gehen Sie für jede E-Mail-Vorlage folgendermaßen vor:

    1. Klicken Sie auf das Symbol „Bearbeiten“ ().
    2. Klicken Sie auf Domain anpassen.
    3. Geben Sie die Domain ein, die Sie verwenden möchten.

Daraufhin wird eine Tabelle mit DNS-Einträgen angezeigt, die Sie Ihrem Domain-Registrator zur Bestätigung hinzufügen müssen. dass die Domain Ihnen gehört.

Domain bestätigen

Fügen Sie die in der Firebase-Konsole angegebenen TXT- und CNAME-DNS-Einträge hinzu oder aktualisieren Sie sie. Wie das geht, hängt vom Registrar ab.

Sie können nur einen v=spf1...-TXT-Eintrag für eine bestimmte Domain haben. Wenn Sie mehrere E-Mail-Adressen angeben müssen, fassen Sie diese in einem Eintrag zusammen.

Es kann bis zu 24 Stunden dauern, bis die Domain bestätigt wurde. Wenn dies der Fall ist, Auf der Seite „Vorlagen“ in der Firebase-Konsole ist die grüne „Überprüfung“ zu sehen. abgeschlossen“ . Anschließend können Sie auf die Schaltfläche Apply Custom Domain (Benutzerdefinierte Domain anwenden) klicken, um in Kraft treten.

Mehrmandantenfähige Projekte

Wenn Sie ein Upgrade auf Firebase Authentication with Identity Platform ausgeführt und die Mehrmandantenfähigkeit aktiviert haben, gilt Folgendes: müssen Sie die Mandantenmetadaten aktualisieren , um dem Mandant zu erlauben, benutzerdefinierte Domains, E-Mail-Vorlagen und benutzerdefinierte SMTP-Einstellungen zu übernehmen. Andernfalls erhalten Nutzer weiterhin E-Mails von der Standarddomain, selbst wenn die benutzerdefinierte Domain überprüft und angewendet.

Sie können prüfen, ob die Mehrmandantenfähigkeit aktiviert ist, indem Sie die in Auth enthaltene URL prüfen E-Mail-Nachrichten. Wenn die URL den Parameter tenant enthält, müssen Sie die Mandantenmetadaten Ihres Projekts.

Dazu führen Sie den folgenden Befehl aus:

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