اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

استخدام ميزة "فحص التطبيقات" لتأمين مفتاح واجهة برمجة التطبيقات

توفّر ميزة فحص التطبيقات من Firebase الحماية للطلبات الواردة من تطبيقك إلى "منصة خرائط Google" من خلال حظر الزيارات الواردة من مصادر أخرى غير التطبيقات المشروعة. ويتم ذلك من خلال البحث عن رمز مميّز من مقدّم خدمة المصادقة، مثل Play Integrity. يساعد دمج تطبيقاتك مع ميزة "فحص التطبيقات" في الحماية من الطلبات الضارة، وبالتالي لن يتم تحصيل رسوم منك مقابل طلبات البيانات غير المصرّح بها من واجهة برمجة التطبيقات.

هل ميزة "فحص التطبيقات" مناسبة لي؟

ننصح باستخدام ميزة "فحص التطبيقات" في معظم الحالات، ولكنّها غير مطلوبة أو غير متاحة في الحالات التالية:

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

نظرة عامة على خطوات التنفيذ

في ما يلي الخطوات التي يجب اتّباعها لدمج تطبيقك مع ميزة "فحص التطبيقات":

1. أضِف Firebase إلى تطبيقك.
2. أضِف مكتبة فحص التطبيقات وابدأها.
3. أضِف مقدّم الرمز المميّز.
4. فعِّل تصحيح الأخطاء.
5. مراقبة طلبات تطبيقك واتّخاذ قرار بشأن إجراءات التنفيذ

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

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

ملاحظة: لا يتم تفعيل إجراءات تنفيذ ميزة "فحص التطبيقات" تلقائيًا.

الاعتبارات الواجب مراعاتها عند التخطيط لدمج ميزة "فحص التطبيقات"

في ما يلي بعض الأمور التي يجب مراعاتها عند التخطيط لعملية الدمج:

• يفرض مقدّم خدمة المصادقة الذي ننصح به، وهو Play Integrity، حدًا أقصى يوميًا لعدد الطلبات في فئة الاستخدام العادية لواجهة برمجة التطبيقات. لمزيد من المعلومات حول حدود الطلبات، يُرجى الاطّلاع على صفحة الإعداد في مستندات المطوّرين حول Google Play Integrity.

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

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

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

دمج تطبيقك مع ميزة "فحص التطبيقات"

ملاحظة: يمكنك الحصول على المساعدة بشكل أسرع. للحصول على الدعم بشأن الأجزاء المتعلّقة بمنصة Firebase في هذه العملية، يُرجى الاطّلاع على دعم Firebase. للحصول على الدعم بشأن حزمة تطوير البرامج (SDK) لأماكن Google على Android، يُرجى الاطّلاع على دعم "منصة خرائط Google".

المتطلبات الأساسية والمتطلبات

• تطبيق يتضمّن الإصدار 4.1 أو إصدار أحدث من حزمة Places SDK.
• الملف المرجعي لشهادة SHA-256 الخاصة بتطبيقك
• اسم حزمة تطبيقك
• يجب أن تكون مالك التطبيق في Cloud Console.
• ستحتاج إلى رقم تعريف مشروع التطبيق من Cloud Console

الخطوة 1: إضافة Firebase إلى تطبيقك

اتّبِع التعليمات الواردة في مستندات مطوّري Firebase لإضافة Firebase إلى تطبيقك.

الخطوة 2: إضافة مكتبة فحص التطبيقات وإعداد فحص التطبيقات

للحصول على معلومات حول استخدام Play Integrity، وهو مقدّم خدمة المصادقة التلقائي، يُرجى الاطّلاع على مقالة بدء استخدام ميزة "فحص التطبيقات" مع Play Integrity على Android.

1. ادمج حزمة تطوير البرامج (SDK) للأماكن في تطبيقك إذا لم يسبق لك إجراء ذلك.

2. بعد ذلك، عليك إعداد فحص التطبيقات وعميل "الأماكن".

   // Initialize App Check
   FirebaseApp.initializeApp(/* context= */ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           PlayIntegrityAppCheckProviderFactory.getInstance());
     
   // Initialize Places SDK
   Places.initializeWithNewPlacesApiEnabled(context, API_KEY);
   PlacesClient client = Places.createClient(context);.

الخطوة 3: إضافة موفِّر الرمز المميّز

بعد إعداد Places API، يمكنك طلب setPlacesAppCheckTokenProvider() لضبط PlacesAppCheckTokenProvider.

Places.initializeWithNewPlacesApiEnabled(context, API_KEY);
Places.setPlacesAppCheckTokenProvider(new TokenProvider());
PlacesClient client = Places.createClient(context);.

في ما يلي نموذج لتنفيذ واجهة جلب الرموز المميّزة:

  /** Sample client implementation of App Check token fetcher interface. */
  static class TokenProvider implements PlacesAppCheckTokenProvider {
    @Override
    public ListenableFuture<String> fetchAppCheckToken() {
      SettableFuture<String> future = SettableFuture.create();
      FirebaseAppCheck.getInstance()
          .getAppCheckToken(false)
          .addOnSuccessListener(
              appCheckToken -> {
                future.set(appCheckToken.getToken());
              })
          .addOnFailureListener(
              ex -> {
                future.setException(ex);
              });

      return future;
    }
  }

الخطوة 4: تفعيل تصحيح الأخطاء (اختياري)

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

لتشغيل تطبيقك في محاكي أو على جهاز اختباري:

• أضِف مكتبة فحص التطبيقات إلى ملف build.gradle.
• اضبط ميزة "فحص التطبيقات" لاستخدام مصنع مقدِّم خدمة تصحيح الأخطاء في الإصدار المخصّص لتصحيح الأخطاء.
• شغِّل التطبيق، وسيؤدي ذلك إلى إنشاء رمز مميّز لتصحيح الأخطاء على الجهاز. أضِف هذا الرمز المميّز إلى وحدة تحكُّم Firebase.
• لمزيد من المعلومات والتعليمات، يُرجى الاطّلاع على مستندات ميزة "فحص التطبيقات".

لتشغيل تطبيقك في بيئة CI، اتّبِع الخطوات التالية:

• أنشئ رمز تصحيح أخطاء في وحدة تحكُّم Firebase وأضِفه إلى مخزن المفاتيح الآمن في نظام CI.
• أضِف مكتبة فحص التطبيقات إلى ملف build.gradle.
• اضبط تنويعة تصميم CI لاستخدام الرمز المميّز لتصحيح الأخطاء.
• يمكنك تضمين الرمز البرمجي في فئات الاختبار التي تحتاج إلى رمز مميّز لميزة "فحص التطبيقات" باستخدام DebugAppCheckTestHelper.
• لمزيد من المعلومات والتعليمات، يُرجى الاطّلاع على مستندات ميزة "فحص التطبيقات".

الخطوة 5: مراقبة طلبات تطبيقك واتخاذ قرار بشأن إجراءات التنفيذ

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

لمزيد من المعلومات والتعليمات، يُرجى الاطّلاع على مستندات ميزة "فحص التطبيقات من Firebase".

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