Nếu bạn sử dụng một 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 của email và các đường liên kết đến hành động.
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.
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 trong bảng điều khiển Firebase.
- Xác minh miền bằng cách thêm bản ghi DNS trong trình đăng ký miền.
Thêm miền vào mẫu email
Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Security (Bảo mật) > Authentication (Xác thực) > Templates (Mẫu).
Đối với mỗi mẫu email, hãy làm như sau:
- Nhấp vào biểu tượng chỉnh sửa ().
- Nhấp vào customize domain (tuỳ chỉnh miền).
- 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 phụ thuộc vào nhà đăng ký tên miền.
Bạn chỉ có thể 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ỉ đó thành một bản ghi.
Quá trình xác minh miền có thể mất đến 24 giờ. Khi miền được xác minh, thẻ Templates trong bảng điều khiển Firebase sẽ hiển thị thông báo màu xanh lục "Verification complete" (Đã hoàn tất quá trình xác minh). Sau đó, bạn có thể nhấp vào nút Apply Custom Domain (Áp dụng miền tuỳ chỉnh) để áp dụng các thay đổi.
Dự án nhiều đối tượng thuê
Nếu bạn đã nâng cấp lên Firebase Authentication with Identity Platform và bật tính năng nhiều đối tượng thuê, thì 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ó được bật hay không bằng cách xem xét URL có trong thông báo email 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.
Để 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