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

بدء استخدام فحص التطبيقات مع reCAPTCHA Enterprise على منصات Apple

اختيار النظام الأساسي:

iOS+ Android Web Flutter

تعرض هذه الصفحة كيفية إعداد App Check في تطبيق على منصات Apple، باستخدام موفّر reCAPTCHA Enterprise. App Check تساعد في ضمان إمكانية وصول تطبيقك فقط إلى موارد الخلفية في مشروعك. لمزيد من المعلومات، راجِع نظرتنا العامة حول App Check.

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

إذا كانت حالة الاستخدام تتطلّب ميزات reCAPTCHA Enterprise غير المضمّنة في App Check، أو إذا كنت تريد استخدام App Check مع موفّر مخصّص ، راجِع مقالة تنفيذ موفّر مخصّص لـ App Check.

تحذير: عند استخدام reCAPTCHA Enterprise مع تطبيق على الأجهزة الجوّالة، تضيف حزمة Firebase App Check تبعية على حزمة reCAPTCHA Mobile SDK. يُرجى العِلم أنّ حزمة reCAPTCHA Mobile SDK تتضمّن جدولاً زمنيًا للإيقاف النهائي قد يكون أكثر تكرارًا من ال جدول الزمني للإيقاف النهائي في Firebase. ويعني ذلك أنّ حزمة App Check SDK لـ reCAPTCHA Enterprise قد تتضمّن تغييرات غير متوافقة مع الأنظمة القديمة أكثر تكرارًا من مكتبات Firebase الأخرى. مزيد من المعلومات حول سياسة الإيقاف النهائي والإغلاق لحزمة reCAPTCHA Mobile SDK.

1. إعداد مشروع Firebase

إذا لم يسبق لك ذلك، أضِف Firebase إلى مشروعك على Apple.
في Google Cloud console، انتقِل إلى صفحة Fraud Defense، ونفِّذ ما يلي لموفّر reCAPTCHA Enterprise:
1. تأكَّد من أنّك في المشروع الصحيح (راجِع أداة اختيار المشاريع في أعلى الشاشة).
2. إذا طُلب منك ذلك، فعِّل reCAPTCHA Enterprise API.
3. أنشئ مفتاحًا من نوع iOS، وحدِّد رقم تعريف حزمة تطبيقك (مثلاً، com.example.my_app).
  - تأكَّد من إدخال معرِّف الحزمة نفسه الذي قدّمته عند إنشاء تطبيق Firebase Apple في مشروع Firebase. قيمة رقم تعريف الحزمة حسّاسة لحالة الأحرف.
  - بالنسبة إلى App Check، يمكن أن يتطابق كل رقم تعريف حزمة مع مفتاح واحد reCAPTCHA فقط.
  للحصول على تعليمات مفصّلة، راجِع مقالة إنشاء مفاتيح reCAPTCHA المستندة إلى النتائج.
4. دوِّن هذا المفتاح. ستحتاج إلى إضافته إلى مسار التسجيل في Firebase Console.
في Firebase Console، انتقِل إلى الأمان > فحص التطبيقات.
في علامة التبويب التطبيقات ، سجِّل تطبيقاتك على منصات Apple لاستخدام App Check مع الموفّر reCAPTCHA Enterprise. عليك تقديم المفتاح الذي حصلت عليه في الـ Google Cloud console.

ملاحظة مهمة: احرص على تسجيل جميع تطبيقات مشروعك باستخدام موفّر شهادات (مثل reCAPTCHA Enterprise). بعد تفعيل التنفيذ لإحدى الخدمات، لن تتمكّن سوى التطبيقات المسجّلة من الوصول إلى الخدمة.
اختياري: اضبط مدة بقاء الرمز المميز.

في إعدادات تسجيل التطبيق، اضبط مدة بقاء مخصّصة App Check للرموز المميّزة لميزة "التحقّق من التطبيق" التي يصدرها الموفّر. يمكنك ضبط مدة البقاء على أي قيمة تتراوح بين 30 دقيقة و7 أيام. عند تغيير هذه القيمة، يُرجى العِلم بالمقايضات التالية:
- الأمان: توفّر مدة البقاء الأقصر أمانًا أقوى، لأنّها تقلّل من الفترة التي يمكن للمهاجم فيها إساءة استخدام رمز مميّز تم تسريبه أو اعتراضه.
- الأداء: تعني مدة البقاء الأقصر أنّ تطبيقك سيُجري عملية التحقّق من الشهادة بشكلٍ أكثر تكرارًا. بما أنّ عملية التحقّق من شهادة التطبيق تضيف وقت استجابة لطلبات الشبكة في كل مرة يتم فيها تنفيذها، يمكن أن تؤثّر مدة البقاء القصيرة في أداء تطبيقك.
- الحصة والتكلفة: تؤدي مدة البقاء الأقصر وعمليات إعادة التحقّق من الشهادة المتكرّرة إلى استنفاد حصتك بشكلٍ أسرع، وقد تزيد التكلفة للخدمات المدفوعة. راجِع الحصص والحدود.
تُعدّ مدة البقاء التلقائية البالغة ساعة واحدة مناسبة لمعظم التطبيقات. يُرجى العِلم أنّ مكتبة App Check تُجدّد الرموز المميّزة في نصف مدة البقاء تقريبًا.
اختياري: اضبط الإعدادات المتقدّمة.
انقر على حفظ.

(اختياري) ضبط الإعدادات المتقدّمة

عندما يفتح المستخدم تطبيقك، reCAPTCHA Enterprise يقيّم مستوى المخاطر التي يشكّلها تفاعل المستخدم ضمن المفتاح، ويعرض نتيجة تتراوح بين 0.0 و1.0، بزيادات قدرها 0.1.

تشير النتيجة 0.0 إلى أنّ التفاعل يشكّل خطرًا كبيرًا وقد يكون احتياليًا.
تشير النتيجة 1.0 إلى أنّ التفاعل يشكّل خطرًا منخفضًا ومن المرجّح جدًا أن يكون مشروعًا.

App Check تتيح لك ضبط معيار تحديد مخاطر التطبيق لتعديل مستوى تحمّلك لهذا الخطر.

بالنسبة إلى معظم حالات الاستخدام، ننصح باستخدام قيمة المعيار التلقائية 0.5. إذا كانت حالة الاستخدام تتطلّب إجراء تعديل، يمكنك ضبط هذه القيمة لكل تطبيق من تطبيقاتك في Firebase Console (انتقِل إلى الأمان > فحص التطبيقات). احرص على توسيع بعض الاعتبارات المهمة حول ضبط معيار تحديد مخاطر التطبيق ومراجعتها أدناه.

الاطّلاع على الاعتبارات المهمة حول معيار تحديد مخاطر التطبيق

تستخدم App Check معيار تحديد مخاطر التطبيق الذي ضبطته كأدنى reCAPTCHA Enterprise نتيجة مطلوبة لكي يُعتبر تفاعل المستخدم مشروعًا. سيتم رفض جميع نتائج reCAPTCHA Enterprise الأقل من معيار تحديد المخاطر الذي ضبطته. عند تعديل معيار تحديد مخاطر التطبيق، يُرجى العِلم بما يلي:

إذا كان مشروع Firebase الخاص بك ضمن خطة Spark الأساسية المجانية، فلن تتوفّر من بين مستويات النتائج الـ 11reCAPTCHA Enterprise المحتملة سوى مستويات النتائج الأربعة التالية: 0.1 و0.3 و0.7 و0.9.

خلال هذه الفترة، لن تسمح App Check إلا بقيم معيار تحديد مخاطر التطبيق 0.1 و0.3 و0.5 و0.7 و0.9. ننصحك باستخدام قيمة معيار تحديد مخاطر التطبيق 0.5 لمعظم حالات الاستخدام.
- لتفعيل جميع مستويات نتائج الـ 11 reCAPTCHA Enterprise، اربط حسابًا على Cloud Billing بمشروع Firebase (ما يعني ترقية مشروع Firebase إلى خطة Blaze المَرِنة بنظام الدفع حسب الاستخدام). بعد ترقية مشروعك، ستتيح لك ميزة App Check ضبط أي قيم لمعيار تحديد مخاطر التطبيق تتراوح بين 0.0 و1.0، بزيادات قدرها 0.1.
  
  ملاحظة: بعد ربط حساب Cloud Billing بمشروعك، يتم إجراء مراجعة أمان تلقائية لمشروعك. لمزيد من المعلومات، راجِع reCAPTCHA Enterprise المستندات.
لمراقبة توزيع نتائج reCAPTCHA Enterprise المرتفعة والمنخفضة لتطبيقك، انتقِل إلى صفحة reCAPTCHA Enterprise في Google Cloud Console، واختَر المفتاح الذي يستخدمه تطبيقك.
اضبط معيار تحديد مخاطر التطبيق بشكلٍ مناسب لمستوى تحمّلك:
- إذا كان لديك مستوى تحمّل مرتفع لمخاطر التطبيق، حرِّك شريط التمرير إلى اليسار لتقليل معيار تحديد مخاطر التطبيق.
  - لا ننصح باستخدام القيمة 0.0، لأنّ هذا الإعداد يوقف الحماية من إساءة الاستخدام.
- إذا كان لديك مستوى تحمّل منخفض لمخاطر التطبيق، حرِّك شريط التمرير إلى اليسار لزيادة معيار تحديد مخاطر التطبيق.
  - لا ننصح باستخدام القيمة 1.0، لأنّ هذا الإعداد يمكن أن يمنع أيضًا المستخدمين الشرعيين الذين لا يستوفون معيار الثقة المرتفع هذا من الوصول إلى التطبيق.
  تحذير: لتجنُّب إيقاف المستخدمين الشرعيين، عليك زيادة معيار تحديد مخاطر التطبيق تدريجيًا عند فرض App Check عليك دائمًا مراقبة مقاييس طلبات App Checkللتأكّد من عدم انقطاع الزيارات.

لمزيد من التفاصيل، راجِع مستندات reCAPTCHA Enterprise.

2. إضافة حزمة App Check SDK إلى تطبيقك

استخدِم Swift Package Manager (SPM) لتثبيت تبعيات Firebase وإدارتها. إذا كنت تستخدم Firebase حاليًا، تأكَّد من أنّ حزمة Firebase هي الإصدار 12.17.0 أو إصدار أحدث.

في Xcode، افتح مشروع تطبيقك.
أضِف مكتبة Firebase:
1. انتقِل إلى ملف > إضافة حِزم.
2. عندما يُطلب منك ذلك، أضِف مستودع Firebase Apple Platforms SDK:
```
https://github.com/firebase/firebase-ios-sdk
```
3. اختَر أحدث إصدار من حزمة SDK (الإصدار 12.17.0 أو إصدار أحدث).
4. اختَر مكتبة FirebaseAppCheck.
5. انقر على إضافة حزمة. سيحلّ Xcode التبعيات وينزّلها.
6. عندما يُطلب منك ذلك، أضِف المكتبة إلى هدف تطبيقك.
أضِف مكتبة reCAPTCHA Enterprise:
1. ارجِع إلى ملف > إضافة حِزم
2. عندما يُطلب منك ذلك، أضِف مستودع reCAPTCHA Enterprise SDK:
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. اختَر مكتبة RecaptchaEnterprise.
4. انقر على إضافة حزمة. عندما يُطلب منك ذلك، أضِف المكتبة إلى هدف تطبيقك.

3. إعداد App Check

في تطبيقك، عليك إعداد ميزة App Check قبل استخدام أي خدمات أخرى من Firebase.

أنشئ مثيلاً من RecaptchaProviderFactory، وأدخِل مفتاح reCAPTCHA، ثم اضبط App Check لاستخدامه:

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. مراقبة المقاييس وتفعيل التنفيذ

بعد إعداد App Check في تطبيقك، ابدأ بتوزيع التطبيق المعدَّل على المستخدمين.

سيبدأ تطبيق العميل المعدَّل بإرسال App Check الرموز المميّزة مع كل طلب يرسله إلى Firebase. ومع ذلك، App Check لن تحظر الطلبات التي تتضمّن رموزًا مميّزة غير صالحة إلى أن يتم فرض App Check.

مراقبة المقاييس

_**قبل تفعيل التنفيذ**_، تأكَّد من أنّ ذلك لن يؤدي إلى إيقاف المستخدمين الشرعيين الحاليين. ومع ذلك، إذا كنت تلاحظ استخدامًا مشبوهًا لموارد تطبيقك، قد تحتاج إلى تفعيل التنفيذ في وقت أقرب.

للمساعدة في اتخاذ هذا القرار، يمكنك مراجعة App Check مقاييس للـ خدمات التي تستخدمها:

مراقبة مقاييس طلبات App Check لـ Firebase AI Logic وSQL Connect وRealtime Database وCloud Firestore وCloud Storage وAuthentication وGoogle Identity for iOS وMaps JavaScript API وPlaces API (جديد).
مراقبة مقاييس طلبات App CheckCloud Functions.

تفعيل فرض ميزة App Check

عندما تفهم تأثير App Check في المستخدمين وتكون مستعدًا للمتابعة، يمكنك تفعيل فرض App Check:

تفعيل App Check إجراء التنفيذ لـ Firebase AI Logic وSQL Connect وRealtime Database وCloud Firestore وCloud Storage وAuthentication وGoogle Identity for iOS وMaps JavaScript API وPlaces API (جديد).
تفعيل فرض ميزة App CheckCloud Functions.

استخدام App Check في بيئات تصحيح الأخطاء

App Check تصنّف بعض البيئات على أنّها غير صالحة، مثل الطلبات الواردة من محاكي أثناء التطوير أو من بيئة تكامل مستمر (CI).

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

لمزيد من التفاصيل، راجِع مقالة استخدام App Check مع مقدّم خدمة تصحيح الأخطاء على منصات Apple.

الأسعار

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

تلقائيًا، سيُجدّد تطبيقك هذا الرمز المميّز مرّتين كل ساعة واحدة. للتحكّم في معدّل تجديد تطبيقك للرموز المميّزة App Check (وبالتالي معدّل إنشاء التقييمات الجديدة)، يمكنك ضبط مدة بقاء الرمز المميّز.