الأسئلة الشائعة حول المصادقة وتحديد المشاكل وحلّها

كيف يمكنني منع إساءة استخدام الرسائل القصيرة عند استخدام مصادقة الهاتف؟

للمساعدة في حماية مشروعك من زيادة عدد الزيارات إلى الرسائل القصيرة وإساءة استخدام واجهة برمجة التطبيقات، اتّخِذ الخطوات التالية:

ننصحك بضبط سياسة منطقة الرسائل القصيرة

1. الاطّلاع على استخدامك للرسائل القصيرة SMS على مستوى منطقة معيّنة

   ابحث عن المناطق التي تم فيها إرسال عدد كبير جدًا من رسائل SMS ولم يتم فيها التحقّق من أي رسائل SMS (أو تم التحقّق من عدد قليل جدًا منها). نسبة الرسائل التي تم إثبات ملكيتها إلى الرسائل المُرسَلة هي معدّل النجاح. تتراوح معدّلات النجاح الصحية عادةً بين %70 و%85، لأنّ الرسائل القصيرة ليست بروتوكول تسليم مضمونًا، وقد تحدث إساءة استخدام في بعض المناطق. تشير معدّلات النجاح الأقل من% 50 إلى إرسال العديد من رسائل SMS ولكن تسجيل الدخول بنجاح مرات قليلة، وهو مؤشر شائع على الجهات الضارة وتضخيم عدد الزيارات إلى الرسائل القصيرة.

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

قصر نطاقات المصادقة المُصرّح بها

استخدِم لوحة بيانات إعدادات المصادقة لإدارة النطاقات المسموح بها. يتم تلقائيًا إضافة النطاق localhost إلى نطاقات المصادقة الموافَق عليها لتسهيل عملية التطوير. ننصحك بإزالة localhost من النطاقات المسموح بها في مشروعك الخاص بالإنتاج لمنع الجهات المسيئة من تنفيذ الرموز البرمجية على localhost الخاصة بها للوصول إلى مشروعك الخاص بالإنتاج.

تفعيل App Check وفرضه

فعِّل App Check للمساعدة في حماية مشروعك من إساءة استخدام واجهة برمجة التطبيقات من خلال إثبات أنّ الطلبات لا تأتي إلا من التطبيقات المرتبطة بمشروعك.

لاستخدام App Check مع Firebase Authentication، يجب الترقية إلى Firebase Authentication with Identity Platform.

يُرجى العِلم أنّه عليك فرض App Check على Authentication في وحدة تحكّمFirebase (ننصحك بمراقبة عدد الزيارات قبل فرضها). يُرجى أيضًا التحقّق من قائمة المواقع الإلكترونية المعتمدة في reCAPTCHA Enterprise للتأكّد من أنّها تتضمّن مواقعك الإلكترونية المباشرة فقط، ومن أنّ قائمة التطبيقات المسجّلة في مشروعك على App Check دقيقة.

يُرجى العِلم أنّ App Check تساعد في الحماية من الهجمات الآلية من خلال التأكّد من أنّ المكالمة واردة من أحد تطبيقاتك المسجّلة. ولا يمنع المستخدمين من استخدام تطبيقك بطرق غير مقصودة (على سبيل المثال، بدء عمليات تسجيل الدخول وعدم إكمالها مطلقًا لإنشاء رسائل SMS مرسَلة).

هل يمكن نقل أرقام الهواتف إلى مشغّل شبكة جوّال جديد يتوافق مع ميزة "مصادقة الهاتف"؟

في الوقت الحالي، سيؤدي نقل الأرقام بين شركات الاتصالات إلى تعذُّر تسليم جميع الرسائل القصيرة إلى المستخدمين النهائيين. ليس هناك حل بديل، ويعمل فريق Firebase على حلّ هذه المشكلة.

في تطبيق Android الخاص بي، لماذا تظهر لي رسالة الخطأ التالية:
Google sign in failed؟

اتّبِع خطوات تحديد المشاكل وحلّها الواردة في الأسئلة الشائعة هذه إذا ظهر لك الخطأ التالي:

GoogleFragment: Google sign in failed
    com.google.android.gms.common.api.ApiException: 13: Unable to get token.
        at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)

1. تأكَّد من تفعيل تسجيل الدخول باستخدام Google بشكل صحيح كموفّر مصادقة:

   1. في وحدة تحكّم Firebase، افتح قسم Authentication.

   2. في علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول باستخدام Google ثم أعِد تفعيلها (حتى إذا كانت مفعَّلة):

      1. افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.

      2. أعِد فتح طريقة تسجيل الدخول باستخدام Google وفعِّلها، ثم انقر على حفظ.

2. تأكَّد من أنّ تطبيقك يستخدم ملف الإعداد الحالي في Firebase (google-services.json).
   الحصول على ملف الإعداد الخاص بتطبيقك

3. تحقَّق مما إذا كان الخطأ لا يزال يظهر. إذا كان الأمر كذلك، انتقِل إلى خطوة تحديد المشاكل وحلّها التالية.

4. تأكَّد من توفّر برامج OAuth 2.0 الأساسية المطلوبة.

   1. في صفحة بيانات الاعتماد ضمن وحدة تحكّم Google Cloud، ابحث في قسم معرّفات عميل OAuth 2.0.

   2. إذا لم تكن برامج OAuth 2.0 متاحة (واتّبعت جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يُرجى التواصل مع فريق الدعم.

في تطبيق منصة Apple، لماذا تظهر لي رسالة الخطأ التالية:
You must specify <clientID> in <GIDConfiguration>؟

اتّبِع خطوات تحديد المشاكل وحلّها الواردة في الأسئلة الشائعة هذه إذا ظهر لك الخطأ التالي:

You must specify |clientID| in |GIDConfiguration|

1. تأكَّد من تفعيل تسجيل الدخول باستخدام Google بشكل صحيح كموفّر مصادقة:

   1. في وحدة تحكّم Firebase، افتح قسم Authentication.

   2. في علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول باستخدام Google ثم أعِد تفعيلها (حتى إذا كانت مفعَّلة):

      1. افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.

      2. أعِد فتح طريقة تسجيل الدخول باستخدام Google وفعِّلها، ثم انقر على حفظ.

2. تأكَّد من أنّ تطبيقك يستخدم ملف الإعداد الحالي في Firebase (GoogleService-Info.plist).
   الحصول على ملف الإعداد الخاص بتطبيقك

3. تحقَّق مما إذا كان الخطأ لا يزال يظهر. إذا كان الأمر كذلك، انتقِل إلى خطوة تحديد المشاكل وحلّها التالية.

4. تأكَّد من توفّر برامج OAuth 2.0 الأساسية المطلوبة.

   1. في صفحة بيانات الاعتماد ضمن وحدة تحكّم Google Cloud، ابحث في قسم معرّفات عميل OAuth 2.0.

   2. إذا لم تكن برامج OAuth 2.0 متاحة (واتّبعت جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يُرجى التواصل مع فريق الدعم.

في تطبيق الويب الخاص بي، لماذا يظهر لي الخطأ التالي:
AuthErrorCode.INVALID_OAUTH_CLIENT_ID؟

اتّبِع خطوات تحديد المشاكل وحلّها الواردة في الأسئلة الشائعة هذه إذا ظهر لك الخطأ التالي:

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

1. تأكَّد من تفعيل تسجيل الدخول باستخدام Google بشكل صحيح كموفّر مصادقة:

   1. في وحدة تحكّم Firebase، افتح قسم Authentication.

   2. في علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول باستخدام Google ثم أعِد تفعيلها (حتى إذا كانت مفعَّلة):

      1. افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.

      2. أعِد فتح طريقة تسجيل الدخول باستخدام Google وفعِّلها، ثم انقر على حفظ.

2. في إعدادات موفّر تسجيل الدخول Google ضمن قسم Authentication، تأكَّد أيضًا من تطابُق معرّف عميل OAuth وسر العميل مع عميل الويب المعروض في صفحة بيانات الاعتماد في وحدة تحكّم Google Cloud (ابحث في قسم معرّفات العميل لبروتوكول OAuth 2.0).

في تطبيق الويب الخاص بي، لماذا يتعذّر تسجيل الدخول باستخدام عمليات إعادة التوجيه مع ظهور الخطأ التالي:
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation؟

اتّبِع خطوات تحديد المشاكل وحلّها الواردة في الأسئلة الشائعة هذه إذا ظهر لك الخطأ التالي:

This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.

من المرجّح أنّ سبب هذا الخطأ هو أنّ نطاق إعادة التوجيه غير مدرَج كنطاق معتمَد لخدمة Firebase Authentication، أو أنّ مفتاح واجهة برمجة التطبيقات الذي تستخدمه مع خدمة Firebase Authentication غير صالح.

عليك أولاً التأكّد من أنّ YOUR_REDIRECT_DOMAIN مدرَج في قائمة النطاقات المسموح بها لمشروع Firebase. إذا كان نطاق إعادة التوجيه مُدرَجًا هناك، تابِع تحديد المشاكل وحلّها المتعلّقة بمفتاح واجهة برمجة التطبيقات غير الصالح.

تعتمد حزمة تطوير البرامج (SDK) في Firebase Authentication JS تلقائيًا على مفتاح واجهة برمجة التطبيقات لمشروعك على Firebase الذي يحمل التصنيف Browser key، وتستخدم هذا المفتاح للتحقّق من أنّ عنوان URL لإعادة التوجيه عند تسجيل الدخول صالح وفقًا لقائمة النطاقات المصرّح بها. تحصل Authentication على مفتاح واجهة برمجة التطبيقات هذا استنادًا إلى طريقة وصولك إلى حزمة تطوير البرامج (SDK) الخاصة بـ Authentication:

• إذا كنت تستخدم Hostingأدوات مساعدة Auth التي توفّرها لتسجيل دخول المستخدمين باستخدام حزمة تطوير البرامج (SDK) Authentication JS، يحصل Firebase تلقائيًا على مفتاح واجهة برمجة التطبيقات مع بقية إعدادات Firebase في كل مرة تنشر فيها إلى Firebase Hosting. تأكَّد من أنّ authDomain في تطبيق الويب firebaseConfig تم إعداده بشكل صحيح لاستخدام أحد النطاقات الخاصة بموقع Hosting. يمكنك التأكّد من ذلك من خلال الانتقال إلى https://authDomain__/firebase/init.json والتأكّد من أنّ projectId يتطابق مع firebaseConfig.

• إذا كنت تستضيف رمز تسجيل الدخول بنفسك، يمكنك استخدام ملف __/firebase/init.json لتوفير إعدادات Firebase لأداة المساعدة في إعادة التوجيه Authentication JS SDK المستضافة ذاتيًا. يجب أن يتطابق مفتاح واجهة برمجة التطبيقات وprojectId المدرَجان في ملف الإعداد هذا مع تطبيق الويب firebaseConfig.

تأكَّد من عدم حذف مفتاح واجهة برمجة التطبيقات هذا: انتقِل إلى لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة تحكّم Google Cloud حيث يتم إدراج جميع مفاتيح واجهة برمجة التطبيقات الخاصة بمشروعك.

• إذا لم يتم حذف Browser key، يُرجى التحقّق مما يلي:

  • تأكَّد من أنّ واجهة برمجة التطبيقات Firebase Authentication مدرَجة في قائمة واجهات برمجة التطبيقات المسموح بها للمفتاح كي يتمكّن من الوصول إليها (مزيد من المعلومات حول قيود واجهة برمجة التطبيقات لمفاتيح واجهة برمجة التطبيقات).

  • إذا كنت تستضيف رمز تسجيل الدخول بنفسك، تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المُدرَج في ملف __/firebase/init.json يتطابق مع مفتاح واجهة برمجة التطبيقات في وحدة تحكّم Google Cloud. صحِّح المفتاح في الملف إذا لزم الأمر، ثم أعِد نشر تطبيقك.

  • إذا تم حذف Browser key، يمكنك أن تطلب من Firebase إنشاء مفتاح API جديد لك: في وحدة تحكّم Firebase، انتقِل إلى settings > إعدادات المشروع، ثمّ في قسم تطبيقاتك، انقر على تطبيق الويب. يؤدي هذا الإجراء إلى إنشاء مفتاح API تلقائيًا يمكنك الاطّلاع عليه في قسم إعداد حزمة تطوير البرامج (SDK) وضبطها لتطبيق الويب.

  يُرجى العِلم أنّه في وحدة تحكّم Google Cloud، لن يُطلق على مفتاح واجهة برمجة التطبيقات الجديد هذا الاسم Browser key، بل سيكون الاسم هو نفسه الاسم المستعار لتطبيق الويب على Firebase. إذا قررت إضافة قيود على واجهة برمجة التطبيقات إلى مفتاح واجهة برمجة التطبيقات الجديد هذا، تأكَّد من أنّ واجهة برمجة التطبيقات Firebase Authentication مدرَجة في قائمة واجهات برمجة التطبيقات المسموح بها.

  بعد إنشاء مفتاح واجهة برمجة التطبيقات الجديد، أكمِل الخطوات التالية:

  • إذا كنت تستخدم عناوين URL Hostingمحجوزة، أعِد نشر تطبيقك على Firebase ليتمكّن من الحصول تلقائيًا على مفتاح واجهة برمجة التطبيقات الجديد مع بقية إعدادات Firebase.

  • إذا كنت تستضيف رمز تسجيل الدخول بنفسك، انسخ مفتاح واجهة برمجة التطبيقات الجديد وأضِفه إلى ملف __/firebase/init.json، ثم أعِد نشر تطبيقك.

كيف يمكنني إنشاء عميل OAuth على الويب يدويًا؟

1. افتح صفحة بيانات الاعتماد في وحدة تحكّم Google Cloud.

2. في أعلى الصفحة، انقر على إنشاء بيانات اعتماد > معرّف عميل OAuth.

3. إذا طُلب منك ضبط شاشة طلب الموافقة، اتّبِع التعليمات الظاهرة على الشاشة، ثم واصِل تنفيذ الخطوات التالية في هذا السؤال الشائع.

4. إنشاء عميل OAuth على الويب:

   1. في حقل نوع التطبيق، اختَر تطبيق الويب.

   2. في الحقل مصادر JavaScript المسموح بها، أضِف ما يلي:

      • http://localhost
      • http://localhost:5000
      • https://PROJECT_ID.firebaseapp.com
      • https://PROJECT_ID.web.app

   3. بالنسبة إلى معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، أضِف ما يلي:

      • https://PROJECT_ID.firebaseapp.com/__/auth/handler
      • https://PROJECT_ID.web.app/__/auth/handler

   4. احفظ عميل OAuth.

5. انسخ معرّف عميل OAuth الجديد وسر العميل إلى الحافظة.

6. في وحدة تحكّم Firebase، افتح قسم Authentication.

7. ضمن علامة التبويب طريقة تسجيل الدخول، افتح موفّر تسجيل الدخول باستخدام Google، ثم الصِق رقم تعريف العميل وسرّ خادم الويب اللذين أنشأتهما ونسختهما من وحدة تحكّم Google Cloud. انقر على حفظ.

كيف يتم تحديد قيمة %APP_NAME% لنموذج الرسالة الإلكترونية الخاص برسالة التأكيد التي يمكن إرسالها إلى المستخدم عند الاشتراك باستخدام عنوان بريد إلكتروني وكلمة مرور؟

قبل ديسمبر 2022، كانت القيمة %APP_NAME% في نموذج الرسالة الإلكترونية تتم تعبئتها باسم العلامة التجارية لبروتوكول OAuth الذي يتم توفيره تلقائيًا عند تسجيل تطبيق Android في مشروع Firebase. بما أنّ العلامة التجارية OAuth لا يتم توفيرها إلا عند تفعيل ميزة "تسجيل الدخول باستخدام حساب Google"، يوضّح ما يلي كيفية تحديد قيمة %APP_NAME%:

• إذا كان اسم العلامة التجارية لبروتوكول OAuth متاحًا، سيتم عرض %APP_NAME% في نموذج الرسالة الإلكترونية كاسم العلامة التجارية لبروتوكول OAuth (كما كان يحدث قبل كانون الأول (ديسمبر) 2022).

• إذا كان اسم العلامة التجارية الخاصة ببروتوكول OAuth غير متاح، إليك كيفية تحديد %APP_NAME% في نموذج الرسالة الإلكترونية:

  • بالنسبة إلى تطبيقات الويب، سيكون %APP_NAME% هو اسم الموقع الإلكتروني Firebase Hosting التلقائي (القيمة التي تسبق .firebaseapp.com و.web.app، وهي عادةً رقم تعريف مشروع Firebase).

  • بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة:

    • إذا كان اسم حزمة Android أو معرّف حزمة iOS متوفّرًا في الطلب، فسيكون %APP_NAME% هو اسم التطبيق المستخدَم في متجر Google Play أو App Store (على التوالي).

    • في ما عدا ذلك، سيكون %APP_NAME% هو اسم الموقع الإلكتروني Firebase Hostingالتلقائي (القيمة التي تسبق .firebaseapp.com و.web.app، وهي عادةً رقم تعريف مشروع Firebase).

  يُرجى العِلم أنّه في حال تعذُّر البحث عن اسم الموقع الإلكتروني التلقائي Firebase Hosting، سيتم استخدام رقم تعريف مشروع Firebase كاسم احتياطي نهائي %APP_NAME%.