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

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

1. إعداد مشروعك على Firebase

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

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

  3. في علامة التبويب التطبيقات ، سجِّل تطبيقاتك لاستخدام App Check مع موفّري الخدمة Play Integrity أو DeviceCheck أو App Attest.

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

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

  4. اختياري: في إعدادات تسجيل التطبيق، اضبط مدة بقاء مخصّصة (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.