نظرة عامة حول Play Integrity API

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

نظرة عامة على Play Integrity API
flow

تعرض واجهة برمجة التطبيقات بيانات سلامة تساعدك في رصد التهديدات المحتملة، بما في ذلك:

  • الوصول غير المصرَّح به: يساعدك بيان السلامة accountDetails في تحديد ما إذا كان المستخدم قد ثبَّت تطبيقك أو لعبتك أو دفع رسومهما على Google Play.
  • التلاعب بالرمز: يساعدك بيان السلامة appIntegrity في تحديد ما إذا كنت تتفاعل مع برنامجك الثنائي غير المعدّل الذي يتعرّف عليه Google Play.
  • الأجهزة المحفوفة بالمخاطر والبيئات المحاكية: يساعدك بيان السلامة deviceIntegrity في تحديد ما إذا كان تطبيقك يعمل على جهاز Android معتمَد حقيقي أو نسخة حقيقية من برنامج "ألعاب Google Play" على الكمبيوتر.

يمكن لمطوّري Google Play أيضًا الموافقة على تلقّي بيانات سلامة إضافية لرصد مجموعة أوسع من التهديدات المحتملة، بما في ذلك:

  • الأجهزة غير المحدّثة أمنيًا: تساعدك الاستجابة MEETS_STRONG_INTEGRITY ضمن بيان السلامة deviceIntegrity على تحديد ما إذا كان الجهاز قد طبّق تحديثات أمان حديثة (للأجهزة التي تعمل بالإصدار 13 من نظام التشغيل Android والإصدارات الأحدث).
  • الوصول الخطير من قِبل تطبيقات أخرى: تساعدك appAccessRiskVerdict في تحديد ما إذا كانت هناك تطبيقات قيد التشغيل يمكن استخدامها لأخذ لقطات للشاشة أو عرض المحتوى على سطح الصفحة أو التحكم في الجهاز (على سبيل المثال، من خلال إساءة استخدام إذن تسهيل الاستخدام).
  • برامج ضارة معروفة: يساعدك playProtectVerdict في تحديد ما إذا كانت خدمة "Google Play للحماية" مفعَّلة وإذا ما اكتشفت تطبيقات خطيرة أو ضارة تم تثبيتها على الجهاز.
  • النشاط المفرط: يساعدك مستوى recentDeviceActivity في تحديد ما إذا كان الجهاز قد أجرى عددًا كبيرًا بشكل غير طبيعي من الطلبات مؤخرًا، ما قد يشير إلى زيارات مبرمَجة وقد يكون علامة على وجود هجوم.
  • إساءة الاستخدام المتكرّرة والأجهزة المعاد استخدامها: تساعدك نتيجة deviceRecall (إصدار تجريبي) في تحديد ما إذا كنت تتفاعل مع جهاز سبق أن أبلغت عنه، حتى إذا تمت إعادة تثبيت تطبيقك أو إعادة ضبط الجهاز.

يمكن استخدام واجهة برمجة التطبيقات على جميع أشكال أجهزة Android، بما في ذلك الهواتف والأجهزة اللوحية والأجهزة القابلة للطي وAndroid Auto وAndroid TV وAndroid XR وChromeOS وWear OS وعلى "ألعاب Google Play على الكمبيوتر".

الاعتبارات الأمنية

توفّر واجهة Play Integrity API أكبر قيمة لتطبيقك عند اتّباع الممارسات المقترَحة التالية:

وضع استراتيجية لمكافحة إساءة الاستخدام

تعمل واجهة Play Integrity API بشكل أفضل عند استخدامها مع إشارات أخرى كجزء من استراتيجيتك الشاملة لمكافحة إساءة الاستخدام وليس كآلية وحيدة لمكافحة إساءة الاستخدام. استخدِم واجهة برمجة التطبيقات هذه مع أفضل ممارسات الأمان الأخرى المناسبة لتطبيقك. يمكن لتطبيقك تلقائيًا إرسال ما يصل إلى 10,000 طلب في اليوم على مستوى جميع عمليات التثبيت. يمكنك طلب زيادة الحد الأقصى اليومي.

جمع بيانات القياس عن بُعد وفهم جمهورك قبل اتخاذ الإجراءات

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

تحديد كيفية طلب بيانات السلامة

توفّر واجهة Play Integrity API خيارَين لطلب بيانات السلامة وتلقّيها. سواء كنت تستخدم الطلبات العادية أو الكلاسيكية أو مزيجًا من النوعين، سيتم عرض ردّ بيان السلامة بالتنسيق نفسه.

طلبات البيانات العادية من واجهة برمجة التطبيقات مناسبة لأي تطبيق أو لعبة ويمكن إجراؤها عند الطلب للتحقّق من أنّ أي إجراء للمستخدم أو طلب من الخادم هو طلب حقيقي. تتميّز الطلبات العادية بسرعة الاستجابة (بضع مئات من الملّي ثانية في المتوسط) وموثوقية عالية في الحصول على بيانات سلامة قابلة للاستخدام. تستفيد الطلبات العادية من ميزة التخزين المؤقت الذكي على الجهاز فقط، مع تفويض Google Play بمهمة الحماية من أنواع معيّنة من الهجمات.

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

يوضّح الجدول التالي بعض الاختلافات الرئيسية بين نوعَي الطلبات:

طلب بيانات عادي من واجهة برمجة التطبيقات طلب بيانات من واجهة برمجة التطبيقات الكلاسيكية
الحدّ الأدنى المطلوب لحزمة تطوير البرامج (SDK) لنظام التشغيل Android* ‫Android 6.0 (مستوى واجهة برمجة التطبيقات 23) أو الإصدارات الأحدث ‫Android 6.0 (مستوى واجهة برمجة التطبيقات 23) أو الإصدارات الأحدث
يجب تهيئة واجهة برمجة التطبيقات ✔️ (بضع ثوانٍ) ❌
وقت الاستجابة المعتاد للطلبات بضع مئات من المللي ثانية بضع ثوانٍ
معدّل تكرار الطلبات المحتملة متكرّر (التحقّق عند الطلب من أي إجراء أو طلب) نادرًا (التحقّق لمرة واحدة من الإجراءات ذات القيمة الأعلى أو الطلبات الأكثر حساسية)
الحدّ من هجمات إعادة الإرسال والهجمات المشابهة التخفيف التلقائي من قِبل Google Play استخدام حقل nonce مع منطق من جهة الخادم

* بالنسبة إلى الإصدار 1.4.0 والإصدارات الأحدث من مكتبة Play Integrity API، يكون الحد الأدنى لحزمة تطوير البرامج (SDK) لنظام التشغيل Android المتوافقة هو نفسه لكلا نوعَي الطلبات ويتم تحديده من خلال minSdkVersion في المكتبة. بالنسبة إلى الإصدار 1.3.0 والإصدارات الأقدم، فإنّ الحد الأدنى لحزمة تطوير البرامج (SDK) لنظام التشغيل Android المطلوب هو Android 5.0 (مستوى واجهة برمجة التطبيقات 21) لطلبات بيانات من واجهة برمجة التطبيقات العادية وAndroid 4.4 (مستوى واجهة برمجة التطبيقات 19) لطلبات بيانات من واجهة برمجة التطبيقات الكلاسيكية.

يمكنك الاطّلاع على جدول يتضمّن المزيد من الاختلافات في اعتبارات الطلبات الكلاسيكية.

طلب بيان السلامة في الوقت المناسب

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

صعِّب عملية تكرار طلبات البيانات من واجهة برمجة التطبيقات

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

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

تجنُّب تخزين بيانات السلامة مؤقتًا

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

وضع استراتيجية تنفيذ متعدّدة المستويات

يتضمّن بيان السلامة في Play Integrity API مجموعة من الردود المحتملة التي تتيح وضع استراتيجية لمكافحة إساءة الاستخدام من خلال مستويات متعددة من إجراءات التنفيذ. يمكنك إجراء ذلك من خلال ضبط خادم الخلفية في تطبيقك للعمل بشكل مختلف بناءً على كل ردّ أو مجموعة ردود محتملة.

قبل تقييم مدى موثوقية الجهاز، من الضروري التحقّق من الإشارات الأساسية الأخرى في الردّ من واجهة برمجة التطبيقات:

  • تفاصيل الطلب: تأكَّد من أنّ requestDetails تتطابق مع القيم المتوقّعة، وتحقَّق تحديدًا من requestHash أو nonce لمنع هجمات إعادة الإرسال.
  • سلامة التطبيق: تأكَّد من أنّ قيمة appRecognitionVerdict هي PLAY_RECOGNIZED، ما يؤكّد أنّ شهادة توقيع التطبيق معترَف بها من قِبل Play ولم يتم التلاعب بها.
  • تفاصيل الحساب: تأكَّد من أنّ قيمة appLicensingVerdict هي LICENSED، ما يؤكّد أنّ المستخدم ثبَّت التطبيق أو حدَّثه من Google Play.

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

بعد اجتياز عمليات التحقّق الأساسية، يمكنك تقسيم استراتيجية التنفيذ إلى مستويات بناءً على مدى موثوقية الجهاز من خلال الموافقة على تلقّي تصنيفات إضافية للأجهزة في الردّ من واجهة برمجة التطبيقات من Play Console. سيعرض كل جهاز جميع التصنيفات التي يستوفي معاييرها. للحصول على إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android، يجب استخدام الحقل deviceAttributes المضمّن في الردّ من واجهة برمجة التطبيقات. يتراوح نطاق مستويات الثقة في الأجهزة من الأجهزة الأكثر ثقة إلى الأجهزة الأقل ثقة:

  • MEETS_STRONG_INTEGRITY (الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث): أعلى مستوى ثقة للجهاز، ويتطلّب إشارات أمان مستندة إلى الأجهزة وتصحيحًا برمجيًا أمنيًا حديثًا.
  • MEETS_DEVICE_INTEGRITY (الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث) وMEETS_STRONG_INTEGRITY (الإصدارات الأقدم من Android 13): مستوى الثقة التالي ويعتمد كلاهما على إشارات الأمان المستندة إلى الأجهزة
  • ‫MEETS_DEVICE_INTEGRITY (الإصدارات الأقدم من Android 13): المستوى التالي، ويستخدم المصادقة المستندة إلى الأجهزة عند توفّرها والمصادقة المستندة إلى البرامج كحلّ احتياطي
  • ‫MEETS_BASIC_INTEGRITY: أدنى مستوى ثقة، قبل عدم تلقّي أي تصنيفات للأجهزة على الإطلاق

على سبيل المثال، بعد الموافقة على تلقّي جميع تصنيفات الأجهزة، يمكنك اختيار الوثوق بجهاز يعرض MEETS_STRONG_INTEGRITY وMEETS_DEVICE_INTEGRITY وMEETS_BASIC_INTEGRITY أكثر من جهاز يعرض MEETS_BASIC_INTEGRITY فقط. يمكنك الرد بشكل مختلف عن الخادم في كل سيناريو.

يمكنك بعد ذلك إضافة إشارات أخرى إلى استراتيجية التنفيذ المتعدّدة المستويات، مثل التعامل مع الأجهزة على أنّها أقل موثوقية إذا كانت تعرض مستويات أعلى في recentDeviceActivity.

إرسال مجموعة من الردود من الخادم إلى تطبيقك

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

رصد حالات إساءة الاستخدام المتكرّرة باستخدام ميزة "تذكُّر الجهاز" مع الحفاظ على خصوصية المستخدم

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

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

يُرجى أيضًا مراعاة المتطلبات الأساسية والاعتبارات الأخرى عند العمل على بيانات سحب الأجهزة.

رصد إساءة الاستخدام على نطاق واسع باستخدام أنشطة الجهاز الأخيرة

استخدِم ميزة أحدث نشاط للجهاز في Play Integrity API للعثور على الأجهزة التي تطلب أعدادًا كبيرة من الرموز المميّزة للسلامة. فالمسيئون استخدام النشاط العالي الحجم عادةً ما ينشئون نتائج مصادقة صالحة من أجهزة حقيقية ويقدّمونها إلى برامج التتبُّع لتنفيذ الهجمات آليًا على الأجهزة الجذر والمحاكيات. يمكنك استخدام مستوى نشاط الجهاز الأخير للتحقّق من عدد عمليات التحقّق التي أنشأها تطبيقك على هذا الجهاز في آخر ساعة.

عرض رسائل خطأ قابلة للتنفيذ

عند الإمكان، قدِّم رسائل خطأ مفيدة للمستخدم وأعلِمه بما يمكنه فعله لحلّ المشكلة، مثل إعادة المحاولة أو تفعيل الاتصال بالإنترنت أو التأكّد من أنّ تطبيق "متجر Google Play" محدَّث.

وضع خطة للمشاكل أو الانقطاعات غير المتوقعة

تعرض لوحة البيانات الخاصة بالحالة في Play معلومات عن حالة خدمة Play Integrity API، بالإضافة إلى معلومات عن أي انقطاعات أو توقُّفات في الخدمة. يجب التخطيط مسبقًا لكيفية عمل خادم الخلفية في حال حدوث انقطاع واسع النطاق في خدمة Play Integrity API، وهو أمر غير محتمل. يُرجى العِلم أنّ خادم الخلفية يجب أن يكون جاهزًا أيضًا للعمل في حال إبطال مفاتيح تصديق المفاتيح الخاصة بنظام Android الأساسي والمخصّصة للأجهزة.

استخدام حلول شاملة لمكافحة الاحتيال في المؤسسات

يمكن لعملاء المؤسسات الذين يبحثون عن حلّ كامل لإدارة عمليات الاحتيال وبرامج التتبُّع شراء reCAPTCHA Enterprise للأجهزة الجوّالة، والذي يتضمّن حِزم تطوير البرامج (SDK) لنظام التشغيل Android التي توفّر للمطوّرين نتائج تقييم مخاطر الاحتيال. يتضمّن reCAPTCHA Enterprise تلقائيًا إشارات Play Integrity API، ويجمعها مع إشارات شبكة وتطبيقات reCAPTCHA للعملاء، ما يوفّر حلّاً جاهزًا لإدارة عمليات الاحتيال بشكل سلس وغير مرئي. ويمكن أن توفّر أيضًا الحماية لتطبيقات Android التي لا تتوفّر فيها واجهة Play Integrity API.

تحدّي الزيارات الخطيرة عند الوصول إلى ميزات قيّمة أو حساسة

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

بنود الخدمة وأمان البيانات

إذا وصلت إلى واجهة برمجة التطبيقات Play Integrity API أو استخدمتها، فإن هذا يعني أنّك توافق على بنود خدمة واجهة برمجة التطبيقات Play Integrity API. يُرجى قراءة جميع البنود والسياسات السارية وفهمها قبل الوصول إلى واجهة برمجة التطبيقات.

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