بدء استخدام ميزة "التحقّق من التطبيقات" في تطبيقات Unity

توضِّح هذه الصفحة كيفية تفعيل ميزة "فحص التطبيقات" في تطبيق Unity باستخدام موفِّري الخدمة التلقائيين: Play Integrity على Android وDevice Check أو App Attest على منصات Apple. عند تفعيل ميزة "فحص التطبيقات"، يمكنك المساعدة في ضمان إمكانية وصول تطبيقك فقط إلى موارد Firebase الخاصة بمشروعك. الاطّلاع على نظرة عامة حول هذه الميزة

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

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

  2. سجِّل تطبيقاتك لاستخدام ميزة "فحص التطبيقات" مع موفِّري الخدمة Play Integrity أو Device Check أو App Attest في قسم إعدادات المشروع > فحص التطبيقات في وحدة تحكّم Firebase.

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

    للحصول على تعليمات مفصّلة حول كيفية التسجيل لدى كل موفِّر خدمة، يُرجى الرجوع إلى المستندات الخاصة بمنصتَي Android وiOS.

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

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

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

2. إضافة مكتبة فحص التطبيقات إلى تطبيقك

ضَمِّن مكتبة "فحص التطبيقات" في مجموعة التبعيات، مع اتّباع تعليمات الإعداد لميزة "فحص التطبيقات".

3. تهيئة ميزة "التحقّق من التطبيق"

أضِف رمز التهيئة التالي إلى تطبيقك بحيث يتم تشغيله قبل استخدام أي من خدمات Firebase، بما في ذلك أي عملية إنشاء لتطبيقات Firebase.

Android

  1. أضِف بيان `using` لـ Firebase.AppCheck:

    using Firebase.AppCheck

  2. هيِّئ مكتبة "فحص التطبيقات" باستخدام موفِّر الخدمة Play Integrity:

    FirebaseAppCheck.SetAppCheckProviderFactory(
    PlayIntegrityProviderFactory.Instance);

iOS+

  1. أضِف بيان `using` لـ Firebase.AppCheck:

    using Firebase.AppCheck

  2. هيِّئ مكتبة "فحص التطبيقات" باستخدام موفِّر الخدمة Device Check أو App Attest:

    FirebaseAppCheck.SetAppCheckProviderFactory(
    DeviceCheckProviderFactory.Instance);

الخطوات التالية

بعد تثبيت مكتبة "فحص التطبيقات" في تطبيقك، ابدأ بتوزيع التطبيق المُعدَّل على المستخدمين.

سيبدأ تطبيق العميل المُعدَّل بإرسال رموز التحقّق من التطبيق مع كل طلب يرسله إلى Firebase، ولكن لن تتطلّب منتجات Firebase أن تكون الرموز المميزة صالحة إلى أن تفعِّل فرض ميزة "التحقّق من التطبيق" في قسم "التحقّق من التطبيق" في وحدة تحكّم Firebase.

مراقبة المقاييس وتفعيل فرض ميزة "التحقّق من التطبيق"

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

للمساعدة في اتّخاذ هذا القرار، يمكنك الاطّلاع على مقاييس "فحص التطبيقات" للخدمات التي تستخدمها:

تفعيل فرض ميزة "فحص التطبيقات"

عندما تفهم كيف ستؤثّر ميزة "فحص التطبيقات" في المستخدمين وتكون مستعدًا للمتابعة، يمكنك تفعيل فرض ميزة "فحص التطبيقات":

استخدام ميزة "فحص التطبيقات" في بيئات تصحيح الأخطاء

إذا أردت، بعد تسجيل تطبيقك في ميزة "فحص التطبيقات"، تشغيل تطبيقك في بيئة لا تصنّفها ميزة "فحص التطبيقات" عادةً على أنّها صالحة، مثل جهاز كمبيوتر مكتبي أو محاكي أثناء التطوير أو من بيئة تكامل مستمر (CI)، يمكنك إنشاء إصدار مخصص لتصحيح الأخطاء من تطبيقك يستخدم موفِّر خدمة تصحيح الأخطاء في ميزة "فحص التطبيقات" بدلاً من موفِّر خدمة إثبات الهوية الحقيقي.

الاطّلاع على مقالة استخدام ميزة "فحص التطبيقات" مع موفِّر خدمة تصحيح الأخطاء في تطبيقات Unity.