الإعداد

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

تفعيل Play Integrity API

يجب أن يكون لكل تطبيق أو حزمة SDK تستدعي واجهة Play Integrity API مشروع على Google Cloud لاستخدام واجهة برمجة التطبيقات ومراقبة الاستخدام. هذه هي الخطوة الأولى الإلزامية لجميع عمليات الدمج. يمكنك تفعيل واجهة Play Integrity API في Google Cloud Console أو يمكنك الانتقال مباشرةً إلى ربط مشروعك على السحابة الإلكترونية بـ Google Play وسيتم تفعيل واجهة Play Integrity API لك.

في Google Cloud Console، أنشئ مشروعًا جديدًا على Cloud أو اختَر مشروعًا حاليًا على Cloud تريد استخدامه مع Play Integrity API.

  1. انتقِل إلى واجهات برمجة التطبيقات والخدمات.
  2. انقر على تفعيل واجهات برمجة التطبيقات والخدمات.
  3. ابحث عن Play Integrity API.
  4. انقر على تمكين.

يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك. للوصول إلى الميزات المتقدّمة وزيادة الحصة، عليك الانتقال إلى خطوة الربط.

الربط بـ Google Play (يُنصح به)

يمكنك ربط مشروعك على Google Cloud بتطبيقك أو حزمة SDK باتّباع هذه التعليمات.

للتطبيقات والألعاب على Google Play

يجب أن تربط التطبيقات التي يتم توزيعها على Google Play مشروعها على Google Cloud في Google Play Console لتفعيل الميزات الإضافية وطلب زيادة الحصة اليومية من واجهة برمجة التطبيقات.

  1. افتح Google Play Console واختَر تطبيقك.
  2. انتقِل إلى صفحة محمي من خلال Google Play.
  3. بجانب Play Integrity API، انقر على الزر البدء للانتقال إلى إعدادات Play Integrity API.
  4. انقر على الزر ربط مشروع على السحابة الإلكترونية.
  5. اختَر مشروع Google Cloud الذي تخطّط لاستخدامه مع Play Integrity API. إذا لم تكن واجهة Play Integrity API مفعَّلة للمشروع، فسيتم تفعيلها تلقائيًا عند الربط.

لموفّري حِزم SDK على Play SDK Console

يمكن لموفّري حِزم تطوير البرامج (SDK) الذين يستخدمون Google Play SDK Console ربط مشروعهم على Google Cloud لتحديد مصدر استخدام واجهة برمجة التطبيقات في حزمة SDK بدلاً من التطبيقات الفردية التي تستخدمها، وتفعيل ميزات إضافية، وطلب زيادة حصة واجهة برمجة التطبيقات اليومية. يُرجى العِلم أنّ الوصول إلى Google Play SDK Console يخضع لمعايير الأهلية.

  1. افتح Google Play SDK Console واختَر حزمة SDK.
  2. الانتقال إلى صفحة صحة بيانات حزمة تطوير البرامج (SDK)
  3. ضمن Play Integrity API، انقر على ربط مشروع على السحابة الإلكترونية.
  4. اختَر مشروع Google Cloud الذي تخطّط لاستخدامه مع واجهة Play Integrity API. إذا لم تكن واجهة Play Integrity API مفعَّلة للمشروع، سيتم تفعيلها تلقائيًا عند الربط.

التعرّف على حدود استخدام Play Integrity API

يبلغ الحد الأقصى التلقائي لعدد الطلبات اليومية في تطبيقك أو حزمة SDK‏ 10,000 طلب، وهو مرتبط برقم المشروع على السحابة الإلكترونية. إذا كنت تتوقع حجمًا أكبر، يمكنك طلب زيادة الحصة.

الإجراء الحصة اليومية ملاحظات
طلبات الرموز المميّزة 10,000 مشترَكة بين الطلبات الكلاسيكية وعمليات إعداد الرموز المميّزة العادية
عمليات فك تشفير الرموز المميّزة على خوادم Google 10,000 تتم مشاركتها بين الطلبات الكلاسيكية والعادية

زيادة الحد الأقصى لعدد الطلبات اليومية

تخضع زيادة الحصة لمعايير الأهلية. تنطبق الزيادات في الحصة على كل من عمليات إنشاء الرموز المميّزة من جهة العميل وطلبات فك التشفير من جهة الخادم. قد تستغرق معالجة الطلبات مدة تصل إلى أسبوع. ننصحك بمراقبة استخدامك لواجهة Play Integrity API في Google Cloud Console وضبط تنبيهات بشأن الحصص لتجنُّب انقطاع الخدمة.

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

للتطبيقات والألعاب على Google Play

لكي تكون مؤهَّلاً لزيادة الحصة، يجب أن يكون تطبيقك متاحًا على Google Play بالإضافة إلى أي قنوات توزيع أخرى. يجب ربط مشروعك على Google Cloud بتطبيقك في Play Console. سيتم رفض طلبات الحصص من المشاريع غير المرتبطة.

لطلب زيادة الحدّ الأقصى:

  1. اربط مشروع Google Cloud ذي الصلة في Play Console.
  2. تأكَّد من تنفيذ منطق واجهة برمجة التطبيقات بشكل صحيح، بما في ذلك استراتيجيات إعادة المحاولة المناسبة.
  3. أرسِل نموذج طلب الحصة.

لموفّري حِزم SDK على Play SDK Console

لكي تكون مؤهلاً لزيادة الحصة، يجب المطالبة بحزمة SDK في Google Play SDK Console وربط مشروعك على السحابة الإلكترونية بحزمة SDK في هذه الأداة. يخضع الوصول إلى Google Play SDK Console لمعايير الأهلية.

لطلب زيادة الحدّ الأقصى:

  1. اربط مشروعك على Google Cloud في Google Play SDK Console.
  2. املأ نموذج دعم المطوّرين.

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

دمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك

لدمج واجهة Play Integrity API في تطبيقك أو حزمة تطوير البرامج (SDK)، اتّبِع إحدى الخطوات التالية حسب بيئة التطوير:

‫Kotlin أو Java

تتوفّر أحدث مكتبة Android لواجهة Play Integrity API من خلال مستودع Maven من Google. أضِف التبعية التالية إلى ملف build.gradle في تطبيقك:

implementation 'com.google.android.play:integrity:1.6.0'

Unity

توضّح الأقسام التالية كيفية دمج وإعداد واجهة Google Play Integrity API لمشاريع Unity، وتتناول إصدارات Unity المتوافقة وطرق التثبيت وإعداد البيئة.

إصدارات Unity المتوافقة

  • تتوافق جميع الإصدارات ‎2019.x و‎2020.x والإصدارات الأحدث.
  • إذا كنت تستخدم Unity 2018.x، يتوافق الإصدار 2018.4 أو الإصدارات الأحدث.
  • الإصدار Unity 2017.x والإصدارات الأقدم غير متوافقة.

إعداد بيئة التطوير

OpenUPM-CLI

إذا كان لديك OpenUPM CLI مثبّتًا، يمكنك تثبيت سجلّ OpenUPM باستخدام الأمر التالي:

openupm add com.google.play.integrity

OpenUPM

  1. افتح إعدادات مدير الحِزم من خلال تحديد خيار قائمة Unity تعديل > إعدادات المشروع > مدير الحِزم.

  2. أضِف OpenUPM كسجلّ محدد النطاق إلى نافذة "مدير الحزم" (Package Manager):

    Name: package.openupm.com
URL: https://package.openupm.com
Scopes: com.google.external-dependency-manager
  com.google.play.common
  com.google.play.core
  com.google.play.integrity

  3. افتح قائمة إدارة الحِزم من خلال تحديد خيار قائمة Unity‏ Window > Package Manager.

  4. اضبط القائمة المنسدلة لنطاق المدير لاختيار سجلّاتي.

  5. اختَر حزمة المكوّن الإضافي Google Play Integrity في Unity من قائمة الحزم، ثم انقر على تثبيت.

الاستيراد من GitHub

  1. نزِّل أحدث إصدار من .unitypackage من GitHub.

  2. استورِد ملف .unitypackage من خلال تحديد خيار قائمة Unity مواد العرض > استيراد الحزمة > حزمة مخصّصة واستيراد جميع العناصر.

Unreal Engine

توضّح الأقسام التالية كيفية دمج واجهة Google Play Integrity API وإعدادها لمشاريع Unreal Engine.

إصدارات Unreal Engine المتوافقة

يتوافق المكوّن الإضافي مع Unreal Engine 5.0 وجميع الإصدارات اللاحقة.

إعداد بيئة التطوير

  1. نزِّل المكوّن الإضافي Play Unreal Engine من مستودع GitHub.

  2. انسخ مجلد GooglePlay داخل مجلد Plugins في مشروعك على Unreal Engine.

  3. افتح مشروعك في Unreal Engine وانقر على Edit (تعديل) ← Plugins (المكوّنات الإضافية).

  4. ابحث عن Google Play وضَع علامة في المربّع مفعَّل.

  5. أعِد تشغيل مشروع اللعبة وابدأ عملية إنشاء الإصدار.

  6. افتح ملف Build.cs الخاص بمشروعك وأضِف وحدة PlayIntegrity إلى PublicDependencyModuleNames:

    using UnrealBuildTool;

public class MyGame : ModuleRules
{
  public MyGame(ReadOnlyTargetRules Target) : base(Target)
  {
    // ...

    PublicDependencyModuleNames.Add("PlayIntegrity");

    // ...
  }
}

الإعلانات المدمجة مع المحتوى

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

ضبط الردود من واجهة برمجة التطبيقات (اختياري)

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

بيانات السلامة التلقائية

يتم تلقائيًا عرض بيانات السلامة التالية في الردّ من واجهة برمجة التطبيقات Play Integrity API:

حقل الردّ القيمة الوصف
تفاصيل حساب Play LICENSED يملك المستخدِم إذن الوصول إلى التطبيق. بمعنى آخر، ثبَّت المستخدم تطبيقك أو حدّثه من Google Play على جهازه.
UNLICENSED لا يملك المستخدِم إذنًا للوصول إلى التطبيق. ويحدث ذلك مثلاً في حال ثبَّت المستخدم تطبيقك من مصدر غير معروف أو لم يحصل عليه من Google Play.
UNEVALUATED لم يتم تقييم تفاصيل الترخيص بسبب عدم استيفاء أحد المتطلّبات. وقد يحدث ذلك لعدة أسباب، بما فيها ما يلي:
  • الجهاز غير موثوق بالقدر الكافي
  • لم يسجّل المستخدم الدخول إلى Google Play.
  • لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز
سلامة التطبيق PLAY_RECOGNIZED يتطابق التطبيق وشهادة التطبيق مع الإصدارات التي تم توزيعها من خلال Google Play.
UNRECOGNIZED_VERSION لا تتطابق شهادة التطبيق أو اسم حزمة التطبيق مع سجلّات Google Play
UNEVALUATED لم يتم تقييم سلامة التطبيق. ولم يتم استيفاء أحد المتطلّبات الضرورية، مثلاً أن يكون الجهاز غير موثوق بالقدر الكافي.
سلامة الجهاز MEETS_DEVICE_INTEGRITY يعمل التطبيق على جهاز Android أصلي ومعتمَد. على أجهزة Android 13 والإصدارات الأحدث، يتوفّر دليل مستند إلى الأجهزة على أنّ برنامج الإقلاع في الجهاز مقفل وأنّ نظام التشغيل Android الذي تم تحميله هو نسخة معتمَدة من الشركة المصنّعة للجهاز.
فارغ (قيمة فارغة) يعمل التطبيق على جهاز يتضمّن علامات تشير إلى تعرُّضه للهجوم (مثل اعتراض طلبات البيانات من واجهة برمجة التطبيقات) أو اختراق نظامه (مثل تزويده بإذن الوصول إلى الجذر)، أو لا يعمل التطبيق على جهاز فعلي (مثل المحاكي الذي لا يجتاز عمليات التأكّد من السلامة في Google Play).

"ألعاب Google Play" للكمبيوتر الشخصي

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

حقل الردّ التصنيف الوصف
سلامة الجهاز MEETS_VIRTUAL_INTEGRITY يعمل التطبيق على محاكي Android متوافق مع "خدمات Google Play". يجتاز المحاكي عمليات التأكّد من سلامة النظام ويستوفي متطلّبات التوافق الأساسية مع نظام Android.

بيانات السلامة الاختيارية

إذا ربطت مشروعك على السحابة الإلكترونية في Play Console أو Play SDK Console، يمكنك الموافقة على تلقّي معلومات إضافية.

لإجراء تغييرات، يُرجى الانتقال إلى Play Console والانتقال إلى صفحة محمي من خلال Google Play. بجانب Play Integrity API، انقر على إدارة. انقر على تغيير الردود، وعدِّل التغييرات واحفظها.

معلومات الجهاز

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

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

تعرض ميزة أنشطة الجهاز الأخيرة مستوى يتراوح بين LEVEL_1 (عدد منخفض من الطلبات) وLEVEL_4 (عدد مرتفع من الطلبات). قد تشير مستويات النشاط العالية إلى استخدام جهاز لإنشاء رموز مميّزة بشكل مفرط لتوزيعها بشكل مسيء على أجهزة غير موثوق بها.

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

بعد الموافقة على مشاركة المعلومات الاختيارية، سيتضمّن الردّ من واجهة برمجة التطبيقات حقولاً وردودًا جديدة في بيان السلامة:

حقل الردّ التصنيف الوصف
سلامة الجهاز MEETS_BASIC_INTEGRITY يعمل التطبيق على أي جهاز يجتاز عمليات التحقق الأساسية من سلامة النظام. يمكن أن يكون برنامج الإقلاع على الجهاز مقفلاً أو غير مقفل، ويمكن أن تكون حالة التشغيل متحقَّقًا منها أو غير متحقَّق منها. قد يكون الجهاز غير معتمَد، وفي هذه الحالة لا يمكن لـ Google تقديم أي ضمانات بشأن الأمان أو الخصوصية أو توافق التطبيقات. على نظام التشغيل Android 13 والإصدارات الأحدث، يتطلّب بيان MEETS_BASIC_INTEGRITY أن يكون جذر الثقة الخاص بالمصادقة مقدَّمًا من Google.
MEETS_STRONG_INTEGRITY يعمل التطبيق على جهاز Android أصلي ومعتمَد يحتوي على تحديث أمان حديث.
  • على الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث، يتطلب MEETS_STRONG_INTEGRITY القرار MEETS_DEVICE_INTEGRITY وتحديثات الأمان في العام الماضي لجميع أقسام الجهاز، بما في ذلك رمز تصحيح قسم نظام التشغيل Android ورمز تصحيح قسم المورّد.
  • في الإصدار 12 من نظام التشغيل Android والإصدارات الأقدم، يتطلّب بيان السلامة MEETS_STRONG_INTEGRITY فقط إثباتًا مستندًا إلى الأجهزة لسلامة عملية التشغيل ولا يتطلّب أن يكون الجهاز قد تلقّى تحديث أمان حديثًا. لذلك، عند استخدام MEETS_STRONG_INTEGRITY، ننصحك أيضًا بمراعاة إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android في حقل deviceAttributes.
سمات الجهاز sdkVersion: 19, 20, ..., 37 إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android الذي يعمل على الجهاز يرتبط الرقم الذي يتم عرضه بـ Build.VERSION_CODES.
فارغ (قيمة فارغة) لم يتم تقييم إصدار حزمة تطوير البرامج (SDK) بسبب عدم استيفاء أحد المتطلّبات الضرورية. في هذه الحالة، لا يتم ضبط الحقل sdkVersion، وبالتالي يكون الحقل deviceAttributes فارغًا. قد يحدث ذلك للأسباب التالية:
  • الجهاز غير موثوق بالقدر الكافي
  • حدثت مشاكل فنية على الجهاز.
طلبات الرموز المميّزة العادية لسلامة واجهة برمجة التطبيقات على هذا الجهاز خلال آخر ساعة لكل تطبيق طلبات الرموز المميّزة لسلامة واجهة برمجة التطبيقات الكلاسيكية على هذا الجهاز خلال آخر ساعة لكل تطبيق
أحدث نشاط للجهاز LEVEL_1 (الأدنى) 10 أو أقل 5 أو أقل
LEVEL_2 بين 11 و25 بين 6 و10
LEVEL_3 بين 26 و50 بين 11 و15
LEVEL_4 (الأعلى) أكثر من 50 أكثر من 15
UNEVALUATED لم يتم تقييم أنشطة الجهاز الأخيرة. قد يحدث ذلك للأسباب التالية:
  • الجهاز غير موثوق بالقدر الكافي
  • لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز.
  • حدثت مشاكل فنية على الجهاز.
تذكُّر الجهاز values: bitFirst, bitSecond, bitThird وهذه هي قيم البت التي حدّدتها في السابق للجهاز المعنيّ. أنت من يقرر معنى كل بت. وتكون قيم البت الثلاث "خطأ" تلقائيًا.
writeDates: yyyymmFirst, yyyymmSecond, yyyymmThird هذه هي تواريخ كتابة قيمة البت بالتوقيت العالمي المنسق بدقة تصل إلى السنة والشهر. يتم تعديل تاريخ كتابة بت الإزالة في كل مرة يتم فيها ضبط قيمة البت على "صحيح"، وتتم إزالته عندما يتم ضبط قيمة البت على "خطأ".

تفاصيل البيئة

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

يتيح لك بيان "Google Play للحماية" معرفة ما إذا كانت خدمة "Google Play للحماية" مفعَّلة على الجهاز، وإذا كان قد تم اكتشاف برامج ضارة معروفة.

بعد الموافقة على مشاركة المعلومات الاختيارية، سيتضمّن الردّ من واجهة برمجة التطبيقات حقولاً وردودًا جديدة في بيان السلامة:

حقل الردّ القيمة الوصف
بيان خطورة الوصول إلى التطبيق KNOWN_INSTALLED يتم تثبيت التطبيقات من خلال Google Play أو تحميلها مسبقًا على قسم النظام من قِبل الشركة المصنّعة للجهاز.
KNOWN_CAPTURING هناك تطبيقات قيد التشغيل تم تثبيتها من خلال Google Play أو تم تحميلها مسبقًا على الجهاز، ويمكن استخدامها لقراءة أو تسجيل مدخلات ومخرجات التطبيق الذي يطلب الإذن، مثل تطبيقات تسجيل الشاشة.
KNOWN_CONTROLLING يتم تشغيل تطبيقات مثبّتة من خلال Google Play أو محمّلة مسبقًا على الجهاز، ويمكن استخدامها للتحكّم في الجهاز ومدخلات ومخرجات التطبيق الذي يطلب الإذن، مثل تطبيقات التحكّم عن بُعد.
KNOWN_OVERLAYS يتم تشغيل تطبيقات مثبَّتة من خلال Google Play أو محمَّلة مسبقًا على الجهاز، وقد تعرض هذه التطبيقات نوافذ فوق التطبيق الذي يطلب الإذن.
UNKNOWN_INSTALLED تم تثبيت تطبيقات أخرى لم يتم تثبيتها من خلال Google Play أو تحميلها مسبقًا على قسم النظام من قِبل الشركة المصنّعة للجهاز.
UNKNOWN_CAPTURING هناك تطبيقات أخرى قيد التشغيل (لم يتم تثبيتها من خلال Play أو لم يتم تحميلها مسبقًا على الجهاز) يمكن استخدامها لقراءة أو تسجيل مدخلات ومخرجات التطبيق الذي يطلب ذلك، مثل تطبيقات تسجيل الشاشة.
UNKNOWN_CONTROLLING هناك تطبيقات أخرى قيد التشغيل (لم يتم تثبيتها من خلال Google Play أو لم تكن مثبَّتة مسبقًا على الجهاز) يمكن استخدامها للتحكّم في الجهاز وفي مدخلات ومخرجات التطبيق الذي يطلب البيانات، مثل تطبيقات التحكّم عن بُعد.
UNKNOWN_OVERLAYS هناك تطبيقات أخرى قيد التشغيل (لم يتم تثبيتها من خلال Play أو لم يتم تحميلها مسبقًا على الجهاز) قد تعرض محتوى على سطح التطبيق الذي يطلب التحقّق.
فارغ (قيمة فارغة) لا يتم تقييم احتمالية اختراق التطبيق في حال عدم استيفاء أحد المتطلّبات الضرورية. وفي هذه الحالة، يكون حقل appAccessRiskVerdict فارغًا. وقد يحدث ذلك لعدة أسباب، بما فيها ما يلي:
  • الجهاز غير موثوق بالقدر الكافي
  • شكل الجهاز ليس هاتفًا أو جهازًا لوحيًا أو جهازًا قابلاً للطي.
  • لا يعمل الجهاز بنظام التشغيل Android 6 (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث.
  • لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز
  • إصدار "متجر Google Play" على الجهاز قديم.
  • الألعاب فقط: لا يملك حساب المستخدم ترخيصًا من Google Play للّعبة.
  • تم استخدام طلب عادي مع المَعلمة verdictOptOut.
  • تم استخدام طلب عادي مع إصدار من مكتبة Play Integrity API لا يتيح بعد استخدام ميزة "احتمالية اختراق التطبيق" للطلبات العادية.
بيان "Google Play للحماية" NO_ISSUES خدمة "Google Play للحماية" مفعَّلة ولم تعثر على أي مشاكل في التطبيقات على الجهاز.
NO_DATA خدمات "Google Play للحماية" مفعَّلة ولكن لم يتم إجراء أي فحص حتى الآن. إذا تمت إعادة ضبط الجهاز أو تطبيق "متجر Google Play" مؤخرًا.
POSSIBLE_RISK خدمات "Google Play للحماية" غير مفعَّلة.
MEDIUM_RISK خدمة "Google Play للحماية" مفعَّلة وعثرت على تطبيقات قد تتسبّب بضرر مثبَّتة على الجهاز.
HIGH_RISK خدمة "Play للحماية" مفعَّلة وعثرت على تطبيقات خطيرة مثبَّتة على الجهاز.
UNEVALUATED لم يتم تقييم بيان "Google Play للحماية". ولم يتم استيفاء أحد المتطلّبات الضرورية، مثلاً أن يكون الجهاز غير موثوق بالقدر الكافي.

ضبط إعدادات الطلبات الكلاسيكية (اختياري)

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

تُدير Google Play تلقائيًا عملية تشفير الردود، ما يعني أنّ خادم الخلفية يطلب من خادم Google فك تشفير بيانات التحقّق. بدلاً من ذلك، يمكنك إدارة المفاتيح بنفسك لفك التشفير محليًا ضمن بيئة الخادم الآمنة.

السماح لشركة Google بإدارة تشفير مفاتيحك الخاصة بتشفير الردود (خيار مُقترَح)

ننصحك بالسماح لـ Google بإنشاء المفاتيح وإدارتها لحماية أمان تطبيقك. وسيطلب الخادم الخلفي من خادم Google Play فك تشفير الردود والتحقُّق منها.

إدارة مفاتيح التشفير الخاصة بك

لفك التشفير محليًا داخل بيئة الخادم الآمنة، يمكنك تنزيل مفاتيح التشفير من Play Console أو Play SDK Console. يجب أن يكون تطبيقك متاحًا على Google Play لاستخدام هذه الميزة.

قبل تغيير استراتيجية إدارة تشفير الردود في Play Console، تأكَّد من ضبط الخادم بشكل صحيح لفك تشفير رموز التحقّق من السلامة والتحقّق منها على خوادم Google Play لتجنُّب حدوث أي انقطاع.

التبديل بين مفاتيح التشفير التي تُديرها Google ومفاتيح التشفير المُدارة ذاتيًا

  1. افتح Play Console واختَر تطبيقك .
  2. انتقِل إلى صفحة محمي من خلال Google Play.
  3. بجانب Play Integrity API، انقر على إدارة.
  4. ضمن الطلبات الكلاسيكية، بجانب تشفير الردود، انقر على تعديل.

للتبديل إلى المفاتيح المُدارة ذاتيًا، اتّبِع الخطوات التالية:

  1. اختَر إدارة وتنزيل مفاتيح تشفير الردود الخاصة بي وحمِّل مفتاحك العام.
  2. انقر على حفظ لتنزيل المفاتيح المشفّرة تلقائيًا.
  3. عدِّل خادم الخلفية الآمن لفك التشفير محليًا باستخدام هذه المفاتيح.

للتبديل إلى المفاتيح التي تديرها Google:

  1. اختَر السماح لشركة Google بإدارة تشفير مفاتيحي الخاصة بتشفير الردود (خيار مُقترَح).
  2. انقر على حفظ التغييرات.
السابق
تجريبي
التالي
تقديم طلب عادي