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 của mình, hãy cân nhắc sử dụng miền tuỳ chỉnh đó trong email được gửi cho các 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 và các đường liên kết đến hành động của email.

Bằng cách định cấu hình 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 và email quản lý người dùng của bạn.

Nhìn chung, có 2 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 Firebase.
  • Xác minh miền bằng cách thêm bản ghi DNS vào nhà đăng ký tên miền.

Thêm miền vào mẫu email

  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 để 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 bản ghi DNS TXT và CNAME được cung cấp trong bảng điều khiển Firebase. Quy trình thực hiện việc này tuỳ thuộc vào nhà đăng ký.

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

Có thể mất đến 24 giờ để xác minh miền. Khi đó, trang Mẫu trong bảng điều khiển Firebase sẽ hiển thị thông báo màu xanh lục "Đã hoàn tất quy trình xác minh". 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 đa khách hàng

Nếu đã nâng cấp lên Firebase Authentication with Identity Platform 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 tính năng nhiều đối tượng thuê đã được bật hay chưa bằng cách kiểm tra URL có trong thư Auth. Nếu URL có tham số tenant, bạn cần cập nhật siêu dữ liệu đố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