將自訂網域用於驗證電子郵件

如果專案使用自訂網域，建議您也在驗證事件 (例如電子郵件驗證、地址變更和密碼復原流程) 傳送的電子郵件中使用自訂網域。您可以設定專案，在電子郵件的 From 欄位和動作連結中使用自訂網域。

為驗證電子郵件設定自訂網域後，使用者會看到網址和使用者管理電子郵件採用相同網域。

設定這項功能大致可分為兩個步驟：

  • 在 Firebase 控制台中，將網域新增至電子郵件範本。
  • 在網域註冊商服務中新增 DNS 記錄，驗證網域。

將網域新增至電子郵件範本

  1. 在 Firebase 控制台中，開啟 Authentication 區段的「範本」頁面。

  2. 針對每個電子郵件範本執行下列操作：

    1. 按一下「編輯」圖示 ()。
    2. 按一下「自訂網域」。
    3. 輸入要使用的網域。

接著，您會看到 DNS 記錄表，請將這些記錄新增至網域註冊商，以驗證網域擁有權。

驗證網域

新增或更新 Firebase 控制台提供的 TXT 和 CNAME DNS 記錄。 具體程序取決於註冊機構。

特定網域只能有一筆 v=spf1... TXT 記錄。如要指定多個電子郵件地址，請將這些地址合併為一筆記錄。

網域驗證作業最多可能需要 24 小時。完成後，Firebase 控制台的「範本」頁面會顯示綠色的「驗證完成」訊息。然後按一下「套用自訂網域」按鈕，即可讓變更生效。

多租戶專案

如果您已升級至 Firebase Authentication with Identity Platform 並啟用多重租戶，則需要更新租戶中繼資料，允許租戶沿用自訂網域、電子郵件範本和自訂 SMTP 設定。否則，即使自訂網域已成功驗證並套用，使用者仍會收到來自預設網域的電子郵件。

您可以檢查驗證電子郵件訊息中包含的網址，確認是否已啟用多重租戶。如果網址包含 tenant 參數，您需要更新專案的租戶中繼資料。

如要進行此操作，請執行以下指令：

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