اگر در پروژه خود از یک دامنه سفارشی استفاده میکنید، استفاده از دامنه سفارشی خود را در ایمیلهای ارسالی برای رویدادهای احراز هویت، مانند تأیید ایمیل، تغییر آدرس و بازیابی رمز عبور، نیز در نظر بگیرید. میتوانید پروژه خود را طوری پیکربندی کنید که از دامنه سفارشی شما در فیلد « From » ایمیلها و لینکهای اقدام استفاده کند.
با پیکربندی دامنههای سفارشی برای ایمیلهای احراز هویت، کاربران دامنه یکسانی را برای آدرس وب شما و ایمیلهای مدیریت کاربر مشاهده خواهند کرد.
به طور کلی دو مرحله برای تنظیم این مورد وجود دارد:
- دامنه را به قالبهای ایمیل خود در کنسول Firebase اضافه کنید.
- دامنه خود را با اضافه کردن رکوردهای DNS در ثبت دامنه خود تأیید کنید.
افزودن دامنه به قالبهای ایمیل شما
در کنسول Firebase ، صفحه قالبها (Templates) از بخش Authentication را باز کنید.
برای هر قالب ایمیل، موارد زیر را انجام دهید:
- روی آیکون ویرایش ( ) کلیک کنید.
- روی سفارشیسازی دامنه کلیک کنید.
- دامنهای که میخواهید استفاده کنید را وارد کنید.
سپس جدولی از رکوردهای DNS را مشاهده خواهید کرد که باید به ثبتکننده دامنه خود اضافه کنید تا تأیید شود که مالک دامنه هستید.
دامنه را تأیید کنید
رکوردهای DNS مربوط به TXT و CNAME که در کنسول Firebase ارائه شدهاند را اضافه یا بهروزرسانی کنید. روش انجام این کار به ثبتکننده بستگی دارد.
شما فقط میتوانید یک رکورد v=spf1... TXT برای یک دامنه خاص داشته باشید. اگر نیاز به مشخص کردن چندین آدرس ایمیل دارید، آنها را در یک رکورد ترکیب کنید.
تأیید دامنه میتواند تا ۲۴ ساعت طول بکشد. وقتی این اتفاق افتاد، صفحه قالبها در کنسول Firebase پیام سبز "تأیید کامل شد" را نشان میدهد. سپس میتوانید روی دکمه اعمال دامنه سفارشی کلیک کنید تا تغییرات شما اعمال شود.
پروژههای چند مستاجری
اگر به Firebase Authentication with Identity Platform ارتقا دادهاید و قابلیت چند مستاجری (multi-tenancy) را فعال کردهاید، باید فرادادههای مستاجر را بهروزرسانی کنید تا به مستاجر اجازه دهید دامنههای سفارشی، قالبهای ایمیل و تنظیمات SMTP سفارشی را به ارث ببرد. در غیر این صورت، کاربران حتی اگر دامنه سفارشی با موفقیت تأیید و اعمال شود، همچنان ایمیلهایی از دامنه پیشفرض دریافت میکنند.
شما میتوانید با بررسی URL موجود در پیامهای ایمیل Auth، فعال بودن قابلیت چند مستاجری را بررسی کنید. اگر URL شامل پارامتر tenant باشد، باید فراداده مستاجر پروژه خود را بهروزرسانی کنید.
برای انجام این کار، دستور زیر را اجرا کنید:
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