إنشاء مفاتيح reCAPTCHA المستندة إلى النتائج

كجزء من تسجيل تطبيقك في وحدة تحكّم Firebase لاستخدام موفّر reCAPTCHA Enterprise، عليك تقديم مفتاح reCAPTCHA لتطبيقك. تستخدم App Check مفاتيح reCAPTCHA مستندة إلى النتائج، ما يجعلها غير مرئية للمستخدمين. وهذا يعني أنّ موفّر خدمة reCAPTCHA Enterprise لن يطلب من المستخدمين حلّ أي تحدٍّ في أي وقت.

توضّح هذه الصفحة كيفية إنشاء هذه المفاتيح المستندة إلى النتائج لاستخدامها مع المنصات التالية: الويب وAndroid وApple. يمكنك أيضًا العثور على تعليمات أكثر تفصيلاً في reCAPTCHA Enterpriseالمستندات الخاصة بتطبيقات الويب والتطبيقات المتوافقة مع الأجهزة الجوّالة.

بالنسبة إلى Flutter، يمكنك اتّباع التعليمات الخاصة بالمنصات التي يستهدفها مشروعك.

قبل البدء

راجِع هذه المتطلبات والاقتراحات قبل إنشاء مفاتيح تستند إلى النتيجة reCAPTCHA للتطبيقات على المنصات التالية: الويب وAndroid وApple.

أذونات "إدارة الهوية وإمكانية الوصول" المطلوبة

تأكَّد من أنّ لديك دور "إدارة الهوية وإمكانية الوصول" التالي: مشرف reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).

الاقتراحات العامة

ليس هناك حدّ أقصى لعدد reCAPTCHA المفاتيح التي يمكنك إنشاؤها لمشروع Firebase. في ما يلي اقتراحات عامة لإنشاء reCAPTCHA مفاتيح لإعدادات Firebase الشائعة:

• أنشئ مفتاحًا واحدًا لكل تطبيق من تطبيقات Firebase المسجّلة. على سبيل المثال:

  • إذا كان لديك تطبيق على iOS وAndroid وتطبيق على الويب يشتركان في مشروع Firebase نفسه، يجب أن يتضمّن مشروعك ثلاثة مفاتيح.

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

• إنشاء مفاتيح منفصلة لتطبيقات التطوير والتنظيم والإنتاج (يجب أن يستخدم كل من هذه الأنواع مشروع Firebase منفصلاً). وإلا، فإنّك تخاطر بتشويه تحليل المخاطر reCAPTCHA Enterprise ببيانات من بيئات غير إنتاجية.

الويب

لإنشاء مفتاح مستند إلى النتيجة، يمكنك استخدام وحدة تحكّم Google Cloud أو gcloud CLI أو REST API.

بالنسبة إلى المواقع الإلكترونية، يكون المفتاح reCAPTCHA فريدًا للنطاقات والنطاقات الفرعية التي تحدّدها. يمكنك تحديد أكثر من نطاق واحد إذا كنت تعرض موقعك الإلكتروني من نطاقات متعددة. إذا حدّدت نطاقًا (مثل examplepetstore.com)، لن تحتاج إلى تحديد نطاقاته الفرعية (مثل subdomain.examplepetstore.com).

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

Google Cloud وحدة التحكّم

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة الحماية من الاحتيال (حيث يمكنك إعداد مفاتيح reCAPTCHA).

2. تأكَّد من أنّك في المشروع الصحيح (راجِع أداة اختيار المشروع في أعلى الشاشة).

3. انقر على إنشاء مفتاح.

4. في حقل الاسم المعروض، أدخِل اسمًا معروضًا للمفتاح.

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

6. لحماية مفتاح نطاقك ونطاقاته الفرعية، تأكَّد من إيقاف خيار إيقاف إثبات ملكية النطاق.

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

7. في قسم قائمة النطاقات، اتّبِع الخطوات التالية:

   1. انقر على إضافة نطاق.

   2. في الحقل النطاق، أدخِل اسم نطاقك.

   3. (اختياري) لإضافة نطاق آخر، انقر على إضافة نطاق وأدخِل اسم نطاق آخر.

      • App Check لا يتيح استخدام تطبيقات الويب التي تعمل على أكثر من 250 نطاقًا.

      • لا تُضِف localhost أبدًا كنطاق إلى مفتاح reCAPTCHA مستخدَم (أو سيتم استخدامه) في الإنتاج.

8. (اختياري) إذا كنت بصدد إنشاء مفتاح اختبار لتطبيقك غير العلني، وإذا أردت تحديد نتيجة يريد المفتاح عرضها عند إنشاء أي تقييمات له، اتّبِع الخطوات التالية:

   1. انقر على الخطوة التالية (اختيارية) للوصول إلى خطوة الإعدادات الإضافية.

   2. لا تفعِّل زر التبديل بجانب هل ستستخدم الاختبارات؟.

   3. فعِّل زر التبديل بجانب هل تنشئ هذا المفتاح لأغراض الاختبار فقط؟، ثم استخدِم شريط تمرير ضبط النتيجة لتحديد نتيجة تتراوح بين 0 و1.0.

      ملاحظة مهمة: لا ترسِل مفتاح الاختبار إلى مستودع عام، ولا تضمِّن المفتاح في إصدارات تطبيقك.
      
      بالإضافة إلى ذلك، يمكنك استخدام مفاتيح الاختبار مع إصدارات غير إنتاجية من تطبيقك فقط. إذا كنت بحاجة إلى إجراء عمليات تطوير واختبار محلية لإصدار إنتاجي من تطبيقك يستخدم مفتاح reCAPTCHA إنتاجي، عليك استخدام App Check مقدّم خدمة تصحيح الأخطاء بدلاً من ذلك.

9. انقر على إنشاء مفتاح.

يتم إدراج المفتاح الذي تم إنشاؤه حديثًا في صفحة reCAPTCHA المفاتيح في وحدة تحكّم Google Cloud.

gcloud CLI

لإنشاء مفتاح مستند إلى النتيجة باستخدام gcloud CLI، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.

REST

لإنشاء مفتاح مستند إلى النتيجة باستخدام REST API، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.

Android

لإنشاء مفتاح مستند إلى النتيجة، يمكنك استخدام وحدة تحكّم Google Cloud أو gcloud CLI أو REST API.

Google Cloud وحدة التحكّم

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة الحماية من الاحتيال (حيث يمكنك إعداد مفاتيح reCAPTCHA).

2. تأكَّد من أنّك في المشروع الصحيح (راجِع أداة اختيار المشروع في أعلى الشاشة).

3. انقر على إنشاء مفتاح.

4. في حقل الاسم المعروض، أدخِل اسمًا معروضًا للمفتاح.

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

6. لحماية مفتاح تطبيق Android، تأكَّد من إيقاف خيار إيقاف التحقّق من اسم الحزمة.

   ملاحظة مهمة: يشكّل إيقاف ميزة التحقّق من اسم الحزمة خطرًا أمنيًا لأنّه لا توجد قيود على التطبيق، وبالتالي يمكن لأي مستخدم الوصول إلى مفتاحك واستخدامه.

7. في قسم قائمة حزمة Android، اتّبِع الخطوات التالية:

   1. انقر على إضافة حزمة Android.

   2. في حقل حزمة Android، أدخِل اسم حزمة تطبيق Android (على سبيل المثال، com.example.my_app).

      • تأكَّد من إدخال اسم الحزمة نفسه الذي قدّمته عند إنشاء تطبيق Android على Firebase في مشروعك على Firebase. قيمة اسم الحزمة حسّاسة لحالة الأحرف.

      • بالنسبة إلى App Check، يمكن أن يتطابق كل اسم حزمة مع مفتاح reCAPTCHA واحد فقط.

8. إذا أردت إنشاء مفتاح لتطبيق متاح على متاجر تطبيقات أخرى بالإضافة إلى Google Play Store، فعِّل خيار السماح بالتطبيقات الموزَّعة خارج "متجر Google Play".

9. (اختياري) إذا كنت بصدد إنشاء مفتاح اختبار لتطبيقك غير العلني، وإذا أردت تحديد نتيجة يريد المفتاح عرضها عند إنشاء أي تقييمات له، اتّبِع الخطوات التالية:

   1. انقر على الخطوة التالية (اختيارية) للوصول إلى خطوة الإعدادات الإضافية.

   2. لا تفعِّل زر التبديل بجانب هل ستستخدم الاختبارات؟.

   3. فعِّل زر التبديل بجانب هل تنشئ هذا المفتاح لأغراض الاختبار فقط؟، ثم استخدِم شريط تمرير ضبط النتيجة لتحديد نتيجة تتراوح بين 0 و1.0.

      ملاحظة مهمة: لا ترسِل مفتاح الاختبار إلى مستودع عام، ولا تضمِّن المفتاح في إصدارات تطبيقك.
      
      بالإضافة إلى ذلك، يمكنك استخدام مفاتيح الاختبار مع إصدارات غير إنتاجية من تطبيقك فقط. إذا كنت بحاجة إلى إجراء عمليات تطوير واختبار محلية لإصدار إنتاجي من تطبيقك يستخدم مفتاح reCAPTCHA إنتاجي، عليك استخدام App Check مقدّم خدمة تصحيح الأخطاء بدلاً من ذلك.

10. انقر على إنشاء مفتاح.

يتم إدراج المفتاح الذي تم إنشاؤه حديثًا في صفحة reCAPTCHA المفاتيح في وحدة تحكّم Google Cloud.

gcloud CLI

لإنشاء مفتاح مستند إلى النتيجة باستخدام gcloud CLI، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.

REST

لإنشاء مفتاح مستند إلى النتيجة باستخدام REST API، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.

منصات Apple

لإنشاء مفتاح مستند إلى النتيجة، يمكنك استخدام وحدة تحكّم Google Cloud أو gcloud CLI أو REST API.

Google Cloud وحدة التحكّم

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة الحماية من الاحتيال (حيث يمكنك إعداد مفاتيح reCAPTCHA).

2. تأكَّد من أنّك في المشروع الصحيح (راجِع أداة اختيار المشروع في أعلى الشاشة).

3. انقر على إنشاء مفتاح.

4. في حقل الاسم المعروض، أدخِل اسمًا معروضًا للمفتاح.

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

6. لحماية مفتاح تطبيقك على منصات Apple، تأكَّد من إيقاف خيار إيقاف التحقّق من معرّف الحزمة.

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

7. في قسم قائمة قائمة معرّفات حِزم iOS، اتّبِع الخطوات التالية:

   1. انقر على إضافة معرّف حزمة iOS.

   2. في حقل معرّف الحزمة، أدخِل معرّف حزمة تطبيقك (على سبيل المثال، com.example.my_app).

      • تأكَّد من إدخال رقم تعريف الحزمة نفسه الذي قدّمته عند إنشاء تطبيق Apple على Firebase في مشروعك على Firebase. قيمة معرّف الحزمة حسّاسة لحالة الأحرف.

      • بالنسبة إلى App Check، يمكن أن يتوافق كل معرّف حزمة مع مفتاح reCAPTCHA واحد فقط.

   3. (اختياري) لإضافة معرّف حزمة آخر، انقر على إضافة معرّف حزمة iOS وأدخِل معرّف حزمة آخر.

8. قدِّم إعدادات المطوّر في Apple.

   ننصحك بشدة بتقديم هذه البيانات لأنّها تتيح لخدمة reCAPTCHA Enterprise تقديم نتائج أكثر دقة بشأن مستوى المخاطر المرتبط بزياراتك.

   أدخِل المعلومات التالية:

   • المفتاح الخاص (.p8): يتم إنشاء هذا المفتاح في Apple Developer Center ضمن Certificates, Identifiers & Profiles (الشهادات والمعرّفات والملفات الشخصية).

   • معرّف المفتاح: معرّف مفتاح مطوّر Apple (سلسلة من 10 أحرف).

   • معرّف الفريق: هو معرّف فريق Apple (سلسلة تتألف من 10 أحرف) الذي يملك ملف الإعداد الذي يتم استخدامه لإنشاء تطبيقك.

9. (اختياري) إذا كنت بصدد إنشاء مفتاح اختبار لتطبيقك غير العلني، وإذا أردت تحديد نتيجة يريد المفتاح عرضها عند إنشاء أي تقييمات له، اتّبِع الخطوات التالية:

   1. انقر على الخطوة التالية (اختيارية) للوصول إلى خطوة الإعدادات الإضافية.

   2. لا تفعِّل زر التبديل بجانب هل ستستخدم الاختبارات؟.

   3. فعِّل زر التبديل بجانب هل تنشئ هذا المفتاح لأغراض الاختبار فقط؟، ثم استخدِم شريط تمرير ضبط النتيجة لتحديد نتيجة تتراوح بين 0 و1.0.

      ملاحظة مهمة: لا ترسِل مفتاح الاختبار إلى مستودع عام، ولا تضمِّن المفتاح في إصدارات تطبيقك.
      
      بالإضافة إلى ذلك، يمكنك استخدام مفاتيح الاختبار مع إصدارات غير إنتاجية من تطبيقك فقط. إذا كنت بحاجة إلى إجراء عمليات تطوير واختبار محلية لإصدار إنتاجي من تطبيقك يستخدم مفتاح reCAPTCHA إنتاجي، عليك استخدام App Check مقدّم خدمة تصحيح الأخطاء بدلاً من ذلك.

10. انقر على إنشاء مفتاح.

يتم إدراج المفتاح الذي تم إنشاؤه حديثًا في صفحة reCAPTCHA المفاتيح في وحدة تحكّم Google Cloud.

gcloud CLI

لإنشاء مفتاح مستند إلى النتيجة باستخدام gcloud CLI، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.

REST

لإنشاء مفتاح مستند إلى النتيجة باستخدام REST API، اتّبِع التعليمات الواردة في مستندات reCAPTCHA Enterprise.