الإعداد

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

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

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

الإعداد في Google Play Console (يُنصح به)

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

الإعداد في Google Cloud Console

في Google Cloud Console، أنشئ حسابًا جديدًا مشروع على Google Cloud أو اختيار مشروع حالي على السحابة الإلكترونية تريد استخدامه مع واجهة Play Integrity API انتقِل إلى واجهات برمجة التطبيقات والخدمات. اختيار تفعيل واجهات برمجة التطبيقات والخدمات. ابحث عن واجهة برمجة التطبيقات Play Integrity API. ثم تفعيلها. يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في التطبيق.

تعليمات الإعداد لموفّري حِزم تطوير البرامج (SDK)

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

لدى مطوّري حِزم SDK خياران لإعداد واجهة برمجة التطبيقات Play Integrity API، وهي SDK Console أو Google Cloud Console.

استخدام Google Play SDK Console (خيار يُنصَح به)

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

استخدام Google Cloud Console

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

زيادة الطلبات اليومية لواجهة برمجة التطبيقات Play Integrity API بشأن حزمة تطوير البرامج (SDK)

على موفِّري حِزم SDK الذين يريدون زيادة الحد الأقصى للطلبات اليومية إكمالها طلب حصة النموذج. ضِمن قسم التعليقات المفتوح، عليك تحديد أنّك تقدّم طلب حزمة تطوير برامج (SDK) وتضمين إحداثيات Maven (groupId:artifactId) أو عنوان URL إلى حزمة SDK

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

سيخضع إجمالي عدد الطلبات لكل تطبيق في اليوم إلى 10,000 طلب كحد أقصى. يمكنك طلب زيادة هذا الحد الأقصى اليومي إذا كان تطبيقك يحتاج إلى معالجة زيادة عدد المستخدمين باتباع التعليمات الواردة أدناه.

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

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

لطلب زيادة الحد الأقصى اليومي للطلبات، عليك إجراء ما يلي: التالي:

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

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

سيتم تلقائيًا تطبيق زيادة حصة الطلبات الكلاسيكية على كلا العميل. استدعاء إنشاء رموز للسلامة واستدعاء الخادم لفك التشفير والتحقُّق منها من رموز السلامة. يتم تطبيق زيادة حصة الطلبات العادية على الخادم لفك تشفير رموز السلامة والتحقق منها.

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

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

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

Kotlin أو Java

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

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

الانسجام

تثبيت المكوّن الإضافي Google Play Integrity Plugin for Unity 1.3.0 أو أعلى. للحصول على التعليمات، يمكنك الاطّلاع على كيفية تثبيت حزم Google الانسجام:

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

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

ثبِّت الإصدار 1.13.0 من Play Core Native SDK أو إصدار أحدث. بالنسبة يُرجى الاطّلاع على إعداد بيئة تطوير Play Core Native. الدليل.

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

تتضمّن استجابة واجهة برمجة التطبيقات البيانات التلقائية التي يتم عرضها في كل طلب. في حال ضبط عملية دمج واجهة برمجة التطبيقات Play Integrity API في Play Console، يمكنك تخصيص ردّ من واجهة برمجة التطبيقات

الردود التلقائية

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

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

الردود الشرطية

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

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

ردود اختيارية

في حال إعداد عملية دمج واجهة برمجة التطبيقات Play Integrity API في Play Console أو Play SDK Console، يمكنك الموافقة على تلقّي المعلومات في ردّ واجهة برمجة التطبيقات.

لإجراء تغييرات على الردود من واجهة برمجة التطبيقات، انتقِل إلى Play Console وانتقِل إلى الإصدار > سلامة التطبيق: ضمن الردود، عدِّل التغييرات.

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

معلومات اختيارية عن الجهاز

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

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

حقل الردّ	التصنيف	الوصف
سلامة الجهاز	MEETS_BASIC_INTEGRITY	يعمل التطبيق على أي جهاز يجتاز عمليات التأكّد الأساسية من سلامة النظام. قد لا يستوفي الجهاز متطلّبات التوافق مع نظام Android، وقد لا يحصل على موافقة لتفعيل "خدمات Google Play". على سبيل المثال، قد يعمل الجهاز بإصدار غير معروف من نظام Android، أو ربما يتضمّن برنامج إقلاع مفتوحًا، أو ربما لم تعتمده الشركة المصنِّعة.
	MEETS_STRONG_INTEGRITY	يعمل التطبيق على جهاز Android متوافق مع "خدمات Google Play"، ويوفّر ضمانًا قويًا على سلامة النظام، مثل إثبات سلامة التشغيل المستند إلى الجهاز. يجتاز الجهاز عمليات التأكّد من سلامة النظام ويفي بمتطلّبات التوافق مع نظام التشغيل Android.
أحدث نشاط للجهاز		طلبات الرموز المميّزة العادية لسلامة واجهة برمجة التطبيقات على هذا الجهاز خلال الساعة الأخيرة لكل تطبيق	طلبات الرموز المميّزة الكلاسيكية لسلامة واجهة برمجة التطبيقات على هذا الجهاز خلال الساعة الأخيرة لكل تطبيق
	LEVEL_1 (الأدنى)	10 أو أقل	5 أو أقل
	LEVEL_2	بين 11 و25	بين 6 و10
	LEVEL_3	بين 26 و50	بين 11 و15
	LEVEL_4 (الأعلى)	أكثر من 50	أكثر من 15
	UNEVALUATED	لم يتم تقييم أنشطة الجهاز الأخيرة. يمكن أن بسبب: الجهاز غير موثوق بالقدر الكافي لم يتعرّف Google على إصدار التطبيق المثبّت على الجهاز اللعب. حدثت مشاكل فنية على الجهاز.

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

ويمكن للتطبيقات الموافقة على تلقّي بيانات إضافية بشأن البيئة. الوصول إلى التطبيق معرفة ما إذا كانت هناك تطبيقات أخرى قيد التشغيل يمكنها التقاط صور للشاشة، أو عرض التراكبات أو التحكم في الجهاز. يتيح لك بيان "Play للحماية" معرفة ما إذا كانت خدمة "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	تطبيقات أخرى قيد التشغيل (لم يتم تثبيتها من خلال Play أو محمّلة مسبقًا على الجهاز) ويمكن استخدامها للتحكّم في الجهاز ومدخلات ومخرجات التطبيق الذي يقدّم الطلب، مثل التحكّم في التطبيقات عن بُعد
	UNKNOWN_OVERLAYS	تطبيقات أخرى قيد التشغيل (غير مثبّتة من خلال Play أو محمّلة مسبقًا على الجهاز) قد تعرض عناصر مركّبة على التطبيق الذي يقدّم الطلب.
	EMPTY (قيمة فارغة)	لا يتم تقييم مخاطر الوصول إلى التطبيق في حال عدم استيفاء أحد المتطلّبات الضرورية. ضِمن في هذه الحالة، يكون الحقل appAccessRiskVerdict فارغًا. يمكن أن يحدث هذا لعدة أسباب، منها ما يلي: الجهاز غير موثوق بالقدر الكافي شكل الجهاز ليس هاتفًا أو جهازًا لوحيًا أو هاتفًا قابلاً للطيّ. لا يعمل الجهاز بنظام التشغيل Android 6 (المستوى 23 لواجهة برمجة التطبيقات) أو بإصدار أحدث. لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز إصدار "متجر Google Play" المثبَّت على الجهاز قديم. الألعاب فقط: لا يملك حساب المستخدم ترخيص Play للعبة. تم استخدام طلب عادي مع معلَمة verdictOptOut. تم استخدام طلب عادي مع إصدار مكتبة واجهة برمجة التطبيقات Play Integrity API، والذي لا يوفّر بعد إمكانية الوصول إلى التطبيق في ما يتعلّق بالطلبات العادية.
بيان "Play للحماية"	NO_ISSUES	تم تفعيل خدمة "Play للحماية" ولم يتم رصد أي مشاكل في التطبيق على الجهاز.
	NO_DATA	تم تفعيل "Play للحماية" ولكن لم يتم إجراء أي فحص بعد. ربما تمت إعادة ضبط الجهاز أو تطبيق "متجر Play" مؤخرًا.
	POSSIBLE_RISK	تم إيقاف "Play للحماية".
	MEDIUM_RISK	تم تفعيل خدمة "Play للحماية" ورصدت تطبيقات قد تتسبّب بضرر تم تثبيتها على الجهاز.
	HIGH_RISK	تم تفعيل خدمة "Play للحماية" ورصدت تطبيقات خطيرة تم تثبيتها على الجهاز.
	UNEVALUATED	لم يتم تقييم بيان "Play للحماية". ولم يتم استيفاء أحد المتطلّبات الضرورية، مثلاً أن يكون الجهاز غير موثوق بالقدر الكافي.

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

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

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

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

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

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

إدارة وتنزيل مفاتيحي الخاصة بتشفير الردود

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

تذكَّر عدم فك تشفير الرمز المميّز الذي تم استلامه أو التحقق منه من داخل البرنامج. التطبيق ولا تكشف أبدًا عن أي مفاتيح فك تشفير لتطبيق العميل.

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

ملاحظة: عند إدارة وتنزيل مفاتيح تشفير الردود، سيتمكّن تطبيقك من إجراء ما يلي: الرجوع إلى خوادم Google Play لفك التشفير والتحقق من الاستجابة.

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

إذا كانت Google تدير حاليًا عملية تشفير الردود، وتريد التبديل إلى عليك إدارة مفاتيح تشفير الردود وتنزيلها بنفسك، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى Play Console.
2. اختَر تطبيقًا يستخدم واجهة برمجة التطبيقات Play Integrity API.
3. في قسم الإصدار في القائمة اليمنى، انتقِل إلى سلامة التطبيق.
4. بجانب واجهة برمجة التطبيقات Play Integrity API، انقر على الإعدادات.
5. في قسم الطلبات الكلاسيكية من الصفحة، بجانب تشفير الردود، انقر على تعديل.
6. في النافذة التي تظهر، انقر على إدارة وتنزيل مفاتيحي الخاصة بتشفير الردود
7. اتّبِع التعليمات لتحميل مفتاح عام.
8. بعد أن تُظهر النافذة أنّ عملية التحميل تمت بنجاح، انقر على حفظ سيتم تنزيل المفاتيح المشفّرة تلقائيًا.
9. تغيير منطق الخادم بحيث يتم فك تشفير الرموز المميّزة للأمان والتحقق منها محليا، في بيئة الخادم الآمنة الخاصة بك، باستخدام ردك ومفاتيح التشفير.
10. (اختياري) عندما تدير بنفسك مفاتيح تشفير الردود، يمكن لتطبيقك تنفيذ ما يلي: الرجوع إلى خادم Google Play لفك التشفير والتحقق من الاستجابة.

إذا كنت تدير مفاتيح تشفير الردود بنفسك، وتريد تفعيل ستدير Google عملية تشفير الردود، ويمكنك اتّباع الخطوات التالية:

1. غيّر منطق الخادم بحيث تكون فقط فك التشفير وإثبات الملكية على خوادم Google.
2. سجِّل الدخول إلى Play Console.
3. اختَر تطبيقًا يستخدم واجهة برمجة التطبيقات Play Integrity API.
4. في قسم الإصدار في القائمة اليمنى، انتقِل إلى سلامة التطبيق.
5. بجانب واجهة برمجة التطبيقات Play Integrity API، انقر على الإعدادات.
6. في قسم الطلبات الكلاسيكية من الصفحة، بجانب تشفير الردود، انقر على تعديل.
7. في النافذة التي تظهر، انقر على السماح لشركة Google بإدارة تشفير الردود (خيار مُقترَح)
8. انقر على حفظ التغييرات.

تنبيه: بعد إجراء التغيير في Play Console، ستظهر أي مفاتيح لتشفير الردود. الذي قمت بتنزيله لم يعد يعمل. يتم تطبيق التغيير على الفور، حتى عندما يكون التطبيق في مرحلة الإنتاج.