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

اگر از یک دامنه سفارشی در پروژه خود استفاده می کنید، در ایمیل های ارسال شده برای رویدادهای احراز هویت، مانند تأیید ایمیل، تغییر آدرس و جریان های بازیابی رمز عبور، از دامنه سفارشی خود نیز استفاده کنید. می توانید پروژه خود را طوری پیکربندی کنید که از دامنه سفارشی خود در فیلد 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 with 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