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

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

إذا أردت استخدام App Check مع الموفّرين التلقائيين، يمكنك الاطّلاع على مقالة تفعيل App Check مع الموفّرين التلقائيين باستخدام C++.

قبل البدء

1. أضِف مكتبة App Check إلى تطبيقك

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

2. نفِّذ واجهات App Check

أولاً، عليك إنشاء فئتَين تنفّذان واجهتَي AppCheckProvider و AppCheckProviderFactory.

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

class YourCustomAppCheckProvider : public AppCheckProvider {
  void GetToken(std::function<void(AppCheckToken, int, const std::string&)>
      completion_callback) {
    // Logic to exchange proof of authenticity for an App Check token and
    //   expiration time.
    // ...

    // Create AppCheckToken object.
    AppCheckToken appCheckToken;
    appCheckToken.token = token;
    appCheckToken.expire_time_millis = expireTime;

    completion_callback(appCheckToken, 0, "");

    // Or, if needing to return an error
    //completion_callback({}, error_code, "Error description");
  }
};

نفِّذ أيضًا فئة AppCheckProviderFactory التي تنشئ مثيلات لتنفيذ AppCheckProvider لديك:

class YourCustomAppCheckProviderFactory : public AppCheckProviderFactory {
  AppCheckProvider* CreateProvider(App* app) {
    // Create and return an AppCheckProvider object.
    return new YourCustomAppCheckProvider(app);
  }
}

3. ابدأ App Check

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

firebase::app_check::AppCheck::SetAppCheckProviderFactory(
    YourCustomAppCheckProviderFactory::GetInstance());

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

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

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

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

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

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

تفعيل ميزة "التحقّق من التطبيق" App Check

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

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

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

يمكنك الاطّلاع على مقالة استخدام App Check مع موفّر تصحيح الأخطاء باستخدام C++.