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

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

إذا كنت تريد استخدام App Check مع مقدّمي الخدمات التلقائيين، اطّلِع على تفعيل App Check مع مقدّمي الخدمات التلقائيين في Unity.

قبل البدء

1- إضافة مكتبة App Check إلى تطبيقك

أدرِج مكتبة App Check في مجموعة التبعيات، باتّباع تعليمات الإعداد لتطبيق App Check.

2- تنفيذ واجهات App Check

عليك أولاً إنشاء صفوف تستخدم الواجهتين IAppCheckProvider وIAppCheckProviderFactory.

يجب أن تتضمن فئة AppCheckProvider طريقة GetTokenAsync()، التي تجمع أي معلومات يطلبها موفِّر App Check المخصّص كإثبات مصداقيتها، وترسلها إلى خدمة الحصول على الرموز المميّزة مقابل رمز App Check المميّز. تتعامل حزمة SDK لتطبيق App Check مع تخزين رمز الاعتماد، لذا يمكنك الحصول على رمز اعتماد جديد في كل مرة تُنفّذ فيها GetTokenAsync().

public class YourCustomAppCheckProvider : IAppCheckProvider {
  public Task<AppCheckToken> GetTokenAsync() {
    // Logic to exchange proof of authenticity for an App Check token and
    //   expiration time.
    // ...

    AppCheckToken appCheckToken = new AppCheckToken() {
      Token = tokenFromAbove,
      ExpireTime = DateTime.UtcNow.AddMinutes(60)
    };

    return Task<AppCheckToken>.FromResult(appCheckToken);
  }
};

نفِّذ أيضًا فئة AppCheckProviderFactory تنشئ نُسخًا من عملية تنفيذ AppCheckProvider:

public class YourCustomAppCheckProviderFactory : IAppCheckProviderFactory {
  IAppCheckProvider CreateProvider(FirebaseApp app) {
    // Create and return an AppCheckProvider object.
    return new YourCustomAppCheckProvider(app);
  }
}

3- بدء App Check

أضِف رمز الإعداد التالي إلى تطبيقك كي يتم تشغيله قبل استخدام أي حِزم تطوير برامج (SDK) أخرى لمنصّة Firebase:

FirebaseAppCheck.SetAppCheckProviderFactory(
  new YourCustomAppCheckProviderFactory());

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

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

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

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

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

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

تفعيل إجراءات تنفيذ App Check

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

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

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

راجِع مقالة استخدام App Check مع موفِّر تصحيح الأخطاء في Unity.