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

اختيار المنصة: iOS+ Android الويب Flutter


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

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

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

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

  1. أضِف Firebase إلى مشروع Apple الخاص بك، في حال لم يسبق لك إجراء ذلك.

  2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة "الحماية من الاحتيال"، واتّبِع الخطوات التالية لمقدّم الخدمة reCAPTCHA Enterprise:

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

    2. فعِّل واجهة برمجة التطبيقات reCAPTCHA Enterprise إذا طُلب منك ذلك.

    3. أنشئ مفتاحًا من نوع iOS، وحدِّد معرّف حزمة تطبيقك (على سبيل المثال، com.example.my_app).

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

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

      للحصول على تعليمات مفصّلة، يُرجى الاطّلاع على مقالة إنشاء مفاتيح reCAPTCHA مستندة إلى النتائج.

    4. دوِّن هذا المفتاح. عليك إضافته إلى مسار التسجيل في وحدة تحكّم "Firebase".

  3. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات.

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

  5. اختياري: اضبط مدة بقاء الرمز المميّز (TTL).

    في إعدادات تسجيل التطبيق، اضبط مدة بقاء (TTL) مخصّصة لرموز App Check المميّزة التي يصدرها مقدّم الخدمة. يمكنك ضبط مدة الصلاحية على أي قيمة تتراوح بين 30 دقيقة و7 أيام. عند تغيير هذه القيمة، يجب مراعاة المفاضلات التالية:

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

    إنّ مدة الصلاحية التلقائية التي تبلغ ساعة واحدة مناسبة لمعظم التطبيقات. يُرجى العِلم أنّ مكتبة App Check تعيد تحميل الرموز المميزة في نصف مدة البقاء تقريبًا.

  6. اختياري: اضبط الإعدادات المتقدّمة.

  7. انقر على حفظ.

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

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

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

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

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

2. إضافة حزمة تطوير البرامج (SDK) لـ "App Check" إلى تطبيقك

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

  1. في Xcode، افتح مشروع تطبيقك.

  2. أضِف مكتبة Firebase:

    1. انتقِل إلى ملف > إضافة حِزم (File > Add Packages).

    2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple في Firebase:

      https://github.com/firebase/firebase-ios-sdk

    3. اختَر أحدث إصدار من حزمة SDK (الإصدار 12.17.0 أو إصدار أحدث).

    4. اختَر مكتبة "FirebaseAppCheck".

    5. انقر على إضافة حزمة. سيحلّ Xcode التبعيات وينزّلها.

    6. عندما يُطلب منك ذلك، أضِف المكتبة إلى هدف تطبيقك.

  3. أضِف مكتبة reCAPTCHA Enterprise:

    1. ارجع إلى ملف > إضافة حِزم (File > Add Packages)

    2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لخدمة reCAPTCHA Enterprise:

      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

عندما تفهم كيف سيؤثر App Check في المستخدمين وتكون مستعدًا للمتابعة، يمكنك تفعيل إجراء تنفيذ App Check:

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

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

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

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

الأسعار

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

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