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

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

Bằng cách định cấu hình các miền tuỳ chỉnh cho email xác thực, người dùng sẽ thấy cùng một miền 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 mẫu email của bạn trong bảng điều khiển của 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 của Firebase, hãy mở trang Mẫu của phần Xác thực.

  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 để xác minh rằng 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 DNS TXT và CNAME được cung cấp trong bảng điều khiển của 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 các địa chỉ email đó th��nh một bản ghi.

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

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

Nếu đã nâng cấp lên tính năng Xác thực Firebase bằng Nền tảng nhận dạng và bật tính năng nhiều đối tượng thuê, bạn cần cập nhật siêu dữ liệu đối tượng thuê để cho phép đối tượng 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 đã được 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 trong thông báo qua email Xác thực. 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ê của dự á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