از یک دامنه سفارشی برای ایمیل های احراز هویت استفاده کنید

اگر از یک دامنه سفارشی در پروژه خود استفاده می کنید، در ایمیل های ارسال شده برای رویدادهای احراز هویت، مانند تأیید ایمیل، تغییر آدرس و جریان های بازیابی رمز عبور، از دامنه سفارشی خود نیز استفاده کنید. می توانید پروژه خود را طوری پیکربندی کنید که از دامنه سفارشی خود در فیلد From ایمیل ها و پیوندهای اقدام استفاده کند.

با پیکربندی دامنه های سفارشی برای ایمیل های احراز هویت، کاربران همان دامنه را برای آدرس وب شما و ایمیل های مدیریت کاربر مشاهده خواهند کرد.

به طور کلی دو مرحله برای تنظیم این وجود دارد:

  • دامنه را به قالب های ایمیل خود در کنسول Firebase اضافه کنید.
  • دامنه خود را با افزودن رکوردهای DNS در ثبت کننده دامنه خود تأیید کنید.

افزودن دامنه به قالب های ایمیل شما

  1. در کنسول Firebase، صفحه Templates بخش Authentication را باز کنید.

  2. برای هر قالب ایمیل، موارد زیر را انجام دهید:

    1. روی نماد ویرایش ( ) کلیک کنید.
    2. روی سفارشی کردن دامنه کلیک کنید.
    3. دامنه ای را که می خواهید استفاده کنید وارد کنید.

سپس جدولی از سوابق DNS را مشاهده خواهید کرد که باید به ثبت کننده دامنه خود اضافه کنید تا تأیید کنید که مالک دامنه هستید.

دامنه را تأیید کنید

رکوردهای TXT و CNAME DNS ارائه شده در کنسول Firebase را اضافه یا به روز کنید. روش انجام این کار به ثبت کننده بستگی دارد.

شما می توانید تنها یک رکورد v=spf1... TXT برای یک دامنه خاص داشته باشید. اگر نیاز به تعیین چندین آدرس ایمیل دارید، آنها را در یک رکورد ترکیب کنید.

ممکن است تا 24 ساعت طول بکشد تا دامنه تأیید شود. وقتی اینطور باشد، صفحه Templates در کنسول Firebase یک پیام سبز رنگ "Verification Complete" نشان می دهد. سپس، می توانید روی دکمه Apply Custom Domain کلیک کنید تا تغییرات خود را اعمال کنید.

پروژه های چند مستاجر

اگر به Firebase Authentication با Identity Platform ارتقا داده اید و چند اجاره ای را فعال کرده اید، باید متادیتای مستاجر را به روز کنید تا به مستاجر اجازه دهید دامنه های سفارشی، الگوهای ایمیل و تنظیمات سفارشی 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