Sử dụng miền tuỳ chỉnh cho email Xác thực

Nếu bạn sử dụng miền tuỳ chỉnh trong dự án, hãy cân nhắc việc sử dụng miền tuỳ chỉnh trong email được gửi cho sự kiện xác thực, chẳng hạn như xác minh email, thay đổi địa chỉ và quy trình khôi phục mật khẩu. Bạn có thể định cấu hình dự án để hãy sử dụng miền tuỳ chỉnh của bạn trong email Các đường liên kết đến trường và hành động From.

Khi bạn định cấu hình miền tuỳ chỉnh cho email xác thực, người dùng sẽ thấy cho địa chỉ web của bạn và email quản lý người dùng.

Nhìn chung, có hai bước để thiết lập tính năng này:

  • Thêm miền vào các mẫu email của bạn trong bảng điều khiển Firebase.
  • Xác minh miền của bạn bằng cách thêm bản ghi DNS vào tên miền đăng ký.

Thêm miền vào mẫu email của bạn

  1. Trong bảng điều khiển Firebase, hãy mở Trang mẫu của mục Authentication.

  2. Đối với mỗi mẫu email, hãy làm như sau:

    1. Nhấp vào biểu tượng chỉnh sửa ().
    2. Nhấp vào tuỳ chỉnh miền.
    3. Nhập miền bạn muốn sử dụng.

Sau đó, bạn sẽ thấy một bảng gồm các bản ghi DNS cần thêm vào nhà đăng ký tên miền của mình để xác minh mà bạn sở hữu miền.

Xác minh miền

Thêm hoặc cập nhật các bản ghi TXT và CNAME DNS được cung cấp trong bảng điều khiển Firebase. Quy trình thực hiện việc này phụ thuộc vào nhà đăng ký tên miền.

Bạn chỉ được có một bản ghi TXT v=spf1... cho một miền cụ thể. Nếu bạn cần chỉ định nhiều địa chỉ email, hãy kết hợp chúng thành một bản ghi.

Quá trình xác minh miền có thể mất đến 24 giờ. Trong trường hợp đó, Trang mẫu trong bảng điều khiển Firebase sẽ hiển thị thông báo "Xác minh" màu xanh lục hoàn thành" . Sau đó, bạn có thể nhấp vào nút Áp dụng miền tuỳ chỉnh để đặt để các thay đổi của bạn có hiệu lực.

Dự án nhiều khách hàng

Nếu bạn đã nâng cấp lên Firebase Authentication with Identity Platform và bật dịch vụ đa khách hàng, bạn cần cập nhật siêu dữ liệu về đối tượng thuê để cho phép người thuê kế thừa miền tuỳ chỉnh, mẫu email và chế độ cài đặt SMTP tuỳ chỉnh. Nếu không, người dùng vẫn nhận được email từ miền mặc định ngay cả khi miền tuỳ chỉnh là đã xác minh và áp dụng thành công.

Bạn có thể kiểm tra xem chế độ đa khách hàng có được bật hay không bằng cách kiểm tra URL có trong quy trình Xác thực email. Nếu URL chứa tham số tenant, bạn cần cập nhật siêu dữ liệu về đối tượng thuê trong dự án của bạn.

Để thực hiện việc này, hãy chạy lệnh sau:

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