استخدام نطاق خاص للرسائل الإلكترونية للمصادقة

إذا كنت تستخدم نطاقًا مخصّصًا في مشروعك، ننصحك أيضًا باستخدام نطاقك المخصّص في الرسائل الإلكترونية المُرسَلة لأحداث المصادقة، مثل التحقّق من عنوان البريد الإلكتروني وتغيير العنوان وعمليات استرداد كلمة المرور. يمكنك ضبط مشروعك لاستخدام نطاقك الخاص في حقل From وروابط الإجراءات في الرسائل الإلكترونية.

من خلال ضبط نطاقات مخصّصة لرسائل تأكيد الحساب، سيظهر للمستخدمين النطاق نفسه في عنوان الويب ورسائل البريد الإلكتروني الخاصة بإدارة المستخدمين.

هناك خطوتان بشكل عام لإعداد ذلك:

  • أضِف النطاق إلى نماذج الرسائل الإلكترونية في وحدة تحكّم Firebase.
  • أثبِت ملكية نطاقك من خلال إضافة سجلّات نظام أسماء النطاقات في موقع تسجيل النطاقات.

إضافة النطاق إلى نماذج الرسائل الإلكترونية

  1. في وحدة تحكّم Firebase، افتح صفحة النماذج ضمن قسم Authentication.

  2. لكل نموذج رسالة إلكترونية، اتّبِع الخطوات التالية:

    1. انقر على رمز التعديل ().
    2. انقر على تخصيص النطاق.
    3. أدخِل النطاق الذي تريد استخدامه.

سيظهر لك بعد ذلك جدول بسجلات نظام أسماء النطاقات التي يجب إضافتها إلى جهة تسجيل النطاق لإثبات ملكيتك للنطاق.

تأكيد النطاق

أضِف سجلّات TXT وCNAME لنظام أسماء النطاقات أو عدِّلها كما هو موضّح في وحدة تحكّم Firebase. وتعتمد إجراءات ذلك على جهة التسجيل.

يمكنك إضافة سجلّ v=spf1... TXT واحد فقط لنطاق معيّن. إذا كنت بحاجة إلى تحديد عناوين بريد إلكتروني متعددة، ادمجها في سجلّ واحد.

قد يستغرق إثبات ملكية النطاق مدة تصل إلى 24 ساعة. وعندما يتم ذلك، ستعرض صفحة "النماذج" في وحدة تحكّم Firebase رسالة خضراء تفيد بأنّ "عملية التحقّق اكتملت". بعد ذلك، يمكنك النقر على الزر تطبيق النطاق المخصّص لتنفيذ التغييرات.

المشاريع التي تضمّ مستأجرين متعدّدين

إذا تمت الترقية إلى 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