Sử dụng miền tùy chỉnh cho email xác thực

Nếu bạn sử dụng miền tùy chỉnh trong dự án của mình, hãy cân nhắc sử dụng miền tùy chỉnh trong các email được gửi cho các 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 của mình để sử dụng miền tùy chỉnh trong các liên kết From động và trường Từ của email.

Bằng cách định cấu hình miền tùy 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.

Nói chung có hai bước để thiết lập điều này:

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

Thêm tên 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 phần Xác thực.

  2. Đối với mỗi mẫu email, hãy thực hiện như sau:

    1. Nhấn vào biểu tượng chỉnh sửa ( ).
    2. Nhấp vào tùy chỉnh tên miền .
    3. Nhập tên 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 để thêm vào công ty đăng ký tên miền của mình nhằm xác minh rằng bạn sở hữu tên miền.

Xác minh tên miền

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

Bạn chỉ có thể có một bản ghi v=spf1... TXT cho một tên 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.

Có thể mất tới 24 giờ để miền được xác minh. Khi đó, trang Mẫu trong bảng điều khiển 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 tùy chỉnh để các thay đổi của bạn có hiệu lực.

Dự án có nhiều người thuê

Nếu bạn đã nâng cấp lên Xác thực Firebase với Nền tảng nhận dạng và bật 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 tùy chỉnh, mẫu email và cài đặt SMTP tùy chỉnh. Ngược lại, người dùng vẫn nhận được email từ miền mặc định ngay cả khi miền tùy chỉnh được xác minh và áp dụng thành công.

Bạn có thể kiểm tra xem tính năng nhiều bên thuê có được bật hay không bằng cách kiểm tra URL có trong thông báo email Xác thực. Nếu URL bao gồm tham số tenant , bạn cần cập nhật siêu dữ liệu đối tượng thuê của dự án.

Để làm như vậ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