استفاده از دامنه سفارشی برای ایمیل‌های «اصالت‌سنجی»

اگر در پروژه‌تان از دامنه سفارشی استفاده می‌کنید، در ایمیل‌های ارسالی برای رویدادهای اصالت‌سنجی، مثل جریان‌های درستی‌سنجی ایمیل، تغییر نشانی، و بازیابی گذرواژه، از دامنه سفارشی‌تان نیز استفاده کنید. می‌توانید پروژه‌تان را پیکربندی کنید تا از دامنه سفارشی‌تان در فیلد From ایمیل‌ها و پیوندهای کنش استفاده کند.

با پیکربندی دامنه‌های سفارشی برای ایمیل‌های اصالت‌سنجی، کاربران دامنه یکسانی برای نشانی وب و ایمیل‌های مدیریت کاربر خواهند دید.

به‌طور کلی دو مرحله برای راه‌اندازی این کار وجود دارد:

  • دامنه را به الگوهای ایمیل در کنسول Firebase اضافه کنید.
  • با افزودن سوابق ساناد در ثبت‌کننده دامنه، دامنه‌تان را درستی‌سنجی کنید.

درحال افزودن دامنه به الگوهای ایمیل

  1. در کنسول Firebase، به امنیت > اصالت‌سنجی > برگه الگوها بروید.

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

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

سپس جدولی از گزارش‌های ساناد را می‌بینید که باید به ثبت‌کننده دامنه‌تان اضافه کنید تا مالکیت دامنه را درستی‌سنجی کنید.

تأیید دامنه

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

فقط می‌توانید یک v=spf1... گزارش نوشتاری برای یک دامنه خاص داشته باشید. اگر نیاز دارید چند نشانی ایمیل را مشخص کنید، آن‌ها را در یک گزارش ترکیب کنید.

ممکن است تا ۲۴ ساعت طول بکشد تا دامنه درستی‌سنجی شود. وقتی تأیید شد، زبانه الگوها در کنسول Firebase پیام سبز «تأیید کامل شد» را نشان می‌دهد. سپس، می‌توانید روی دکمه اعمال دامنه سفارشی کلیک کنید تا تغییراتتان اعمال شود.

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

اگر به Firebase Authentication with Identity Platform ارتقا داده‌اید و چند مستأجری را فعال کرده‌اید، باید فراداده مستأجر را به‌روزرسانی کنید تا به مستأجر اجازه دهید دامنه‌های سفارشی، الگوهای ایمیل، و تنظیمات سفارشی SMTP را به‌ارث ببرد. درغیراین‌صورت، کاربران همچنان ایمیل‌ها را از دامنه پیش‌فرض دریافت می‌کنند، حتی اگر دامنه سفارشی با موفقیت درستی‌سنجی و اعمال شده باشد.

با بررسی نشانی وب موجود در پیام‌های ایمیل Auth می‌توانید بررسی کنید که چند مستأجری فعال است یا نه. اگر نشانی وب شامل پارامتر 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