تنظیم

این صفحه نحوه راه‌اندازی برنامه، بازی، یا کیت توسعه نرم‌افزار را برای استفاده از Play Integrity API توضیح می‌دهد. برای ادغام کردن API، باید پروژه Google Cloud داشته باشید که برای شروع درخواست‌ها ضروری است. سپس می‌توانید پروژه Google Cloud خود را در «کنسول Google Play» (برای برنامه‌ها) یا «کنسول کیت توسعه نرم‌افزار Google Play» (برای کیت‌های توسعه نرم‌افزار) پیوند دهید. پیوند دادن پروژه برای دسترسی به گزینه‌های پیکربندی بیشتر، ویژگی‌های آزمایشی، گزارش‌دهی API، و درخواست افزایش سهمیه درخواست روزانه الزامی است.

فعال کردن Play Integrity API

هر برنامه یا کیت توسعه نرم‌افزاری که Play Integrity API را فراخوانی می‌کند باید پروژه Google Cloud داشته باشد تا بتواند از API استفاده کند و بر استفاده نظارت کند. این اولین گام اجباری برای همه ادغام‌ها است. می‌توانید Play Integrity API را در «کنسول Google Cloud» فعال کنید یا می‌توانید مستقیماً به پیوند دادن پروژه Cloud به Google Play بروید و Play Integrity API برای شما فعال خواهد شد.

در کنسول Google Cloud، پروژه Cloud جدیدی ایجاد کنید یا پروژه Cloud موجودی را که می‌خواهید با Play Integrity API استفاده کنید انتخاب کنید.

1. به میاناهای برنامه‌سازی کاربردی و سرویس‌ها بروید.
2. فعال کردن میاناهای برنامه‌سازی کاربردی و سرویس‌ها را انتخاب کنید.
3. Play Integrity API را جستجو کنید.
4. روی Enable کلیک کنید؛

اکنون می‌توانید Play Integrity API را در برنامه‌تان ادغام کنید. برای دسترسی به ویژگی‌های پیشرفته و افزایش سهمیه، باید به مرحله پیوند دادن بروید.

توجه: پروژه‌هایی که در «کنسول Google Cloud» فعال شده‌اند اما در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» پیوند نشده‌اند، واجدشرایط گزینه‌های پیکربندی اضافی یا افزایش سهمیه نیستند.

پیوند به Google Play (توصیه می‌شود)

بااستفاده از این دستورالعمل‌ها می‌توانید پروژه Google Cloud خود را به برنامه یا کیت توسعه نرم‌افزارتان پیوند دهید.

برای برنامه‌ها و بازی‌ها در Google Play

برنامه‌های توزیع‌شده در Google Play باید پروژه Google Cloud خود را در «کنسول Google Play» پیوند دهند تا بتوانند ویژگی‌های بیشتری را فعال کنند و افزایش سهمیه روزانه میانای برنامه‌سازی کاربردی را درخواست کنند.

1. کنسول Google Play را باز کنید و برنامه‌تان را انتخاب کنید.
2. به محافظت‌شده با Play بروید.
3. در کنار Play Integrity API، دکمه شروع به کار را انتخاب کنید تا به تنظیمات Play Integrity API بروید.
4. روی دکمه پیوند دادن پروژه ابری کلیک کنید.
5. پروژه Google Cloud را که می‌خواهید با Play Integrity API استفاده کنید انتخاب کنید. اگر Play Integrity API ازقبل برای پروژه فعال نشده باشد، پس‌از پیوند دادن به‌طور خودکار فعال خواهد شد.

برای ارائه‌دهندگان کیت توسعه نرم‌افزار در «کنسول کیت توسعه نرم‌افزار Play»

ارائه‌دهندگان کیت توسعه نرم‌افزار که از کنسول کیت توسعه نرم‌افزار Google Play استفاده می‌کنند می‌توانند پروژه Google Cloud خود را پیوند دهند تا استفاده از میانای برنامه‌سازی کاربردی را به‌جای برنامه‌هایی که از آن استفاده می‌کنند به کیت توسعه نرم‌افزار نسبت دهند، ویژگی‌های بیشتری را فعال کنند، و درخواست افزایش سهمیه روزانه میانای برنامه‌سازی کاربردی کنند. توجه داشته باشید که دسترسی به «کنسول کیت توسعه نرم‌افزار Google Play» تابع معیارهای واجدشرایط بودن است.

1. کنسول کیت توسعه نرم‌افزار Google Play را باز کنید و کیت توسعه نرم‌افزارتان را انتخاب کنید.
2. به تمامیت کیت توسعه نرم‌افزار بروید
3. در بخش Play Integrity API، روی پیوند دادن پروژه Cloud کلیک کنید.
4. پروژه Google Cloud را که قصد دارید با Play Integrity API استفاده کنید انتخاب کنید؛ اگر Play Integrity API ازقبل برای پروژه فعال نشده باشد، پس‌از پیوند دادن به‌طور خودکار فعال خواهد شد.

توجه: می‌توانید حداکثر پنج پروژه Google Cloud را به برنامه یا کیت توسعه نرم‌افزارتان پیوند دهید. اگر لازم است از محیط‌های مختلفی برای آزمایش و تولید پشتیبانی کنید، باید پیوند دادن چند پروژه را مدنظر قرار دهید.

آشنایی با حدود استفاده از Play Integrity API

برنامه یا کیت توسعه نرم‌افزار شما حد روزانه پیش‌فرض ۱۰٬۰۰۰ درخواست کل دارد که به «شماره پروژه Cloud» مربوطه مرتبط است. اگر حجم بالاتری را پیش‌بینی می‌کنید، می‌توانید درخواست افزایش سهمیه کنید.

کنش	سهمیه روزانه	یادداشت‌ها
درخواست‌های داده‌واحد (توکن)	۱۰٫۰۰۰	بین درخواست‌های کلاسیک و آماده‌سازی‌های داده‌واحد (توکن) استاندارد هم‌رسانی شده است
رمزگشایی‌های رمزه در سرورهای Google	۱۰٫۰۰۰	بین درخواست‌های کلاسیک و استاندارد هم‌رسانی شده است

افزایش حداکثر تعداد درخواست‌های روزانه

افزایش سهمیه منوط به معیارهای واجدشرایط بودن است. افزایش سهمیه هم برای تولید کد سمت کارخواه و هم برای فراخوانی‌های رمزگشایی سمت سرور اعمال می‌شود. پردازش درخواست‌ها ممکن است تا یک هفته طول بکشد. توصیه می‌کنیم استفاده از Play Integrity API را در «کنسول Google Cloud» خود پایش کنید و هشدارهای سهمیه را تنظیم کنید تا از ایجاد وقفه در سرویس خود جلوگیری کنید.

حتی با سهمیه بالاتر، همچنان درخواست‌های کلاسیک را به کنش‌های نادر و باارزش محدود کنید تا مصرف باتری و داده کاربر حفظ شود.

احتیاط: تغییرات با حجم بسیار بالا باید به‌تدریج عرضه شوند. افزایش ناگهانی ترافیک ممکن است باعث محدود شدن سرعت شود.

برای برنامه‌ها و بازی‌ها در Google Play

برای واجدشرایط بودن برای افزایش سهمیه، برنامه‌تان باید علاوه‌بر هر کانال توزیع دیگری، در Google Play نیز دردسترس باشد. باید پروژه Google Cloud خود را در کنسول Play به برنامه‌تان پیوند دهید. درخواست‌های سهمیه از پروژه‌های لغو پیوندشده رد خواهد شد.

برای درخواست افزایش:

1. پروژه Google Cloud مربوطه را در کنسول Play پیوند دهید.
2. تأیید کنید که منطق میانای برنامه‌سازی کاربردی را به‌درستی پیاده‌سازی کرده‌اید، ازجمله راهبردهای مناسب برای امتحان مجدد.
3. فرم درخواست سهمیه را ارسال کنید.

برای ارائه‌دهندگان کیت توسعه نرم‌افزار در «کنسول کیت توسعه نرم‌افزار Play»

برای واجدشرایط بودن برای افزایش سهمیه، کیت توسعه نرم‌افزار شما باید در «کنسول کیت توسعه نرم‌افزار Google Play» مطالبه شود و پروژه Cloud شما باید در آنجا به کیت توسعه نرم‌افزار شما پیوند داده شود. دسترسی به «کنسول کیت توسعه نرم‌افزار Google Play» منوط به معیارهای واجدشرایط بودن است.

برای درخواست افزایش:

1. پروژه Google Cloud خود را در کنسول کیت توسعه نرم‌افزار Google Play پیوند دهید.
2. فرم پشتیبانی توسعه‌دهنده را تکمیل کنید.

در نظرات باز، جزئیات کیت توسعه نرم‌افزارتان را ارائه دهید، مورد استفاده‌تان را شرح دهید، نوع درخواست‌های API که ایجاد می‌کنید (استاندارد، کلاسیک، یا هر دو)، دفعاتی که درخواست ایجاد می‌کنید، و حداکثر درخواست‌های روزانه‌ای را که می‌خواهید شرح دهید.

ادغام کردن Play Integrity API در برنامه

برای ادغام کردن Play Integrity API در برنامه یا کیت توسعه نرم‌افزارتان، بسته به محیط توسعه نرم‌افزارتان یکی از کارهای زیر را انجام دهید:

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 استفاده می‌کنید، نسخه ۲۰۱۸.۴ یا جدیدتر پشتیبانی می‌شود.
• از Unity 2017.x و نسخه‌های قدیمی‌تر پشتیبانی نمی‌شود.

راه‌اندازی محیط توسعه نرم‌افزار

OpenUPM-CLI

اگر OpenUPM CLI را نصب کرده‌اید، می‌توانید با دستور زیر، دفتر ثبت OpenUPM را نصب کنید:

openupm add com.google.play.integrity

OpenUPM

1. با انتخاب گزینه منو Unity ویرایش > تنظیمات پروژه > مدیر بسته، تنظیمات مدیر بسته را باز کنید.

2. OpenUPM را به‌عنوان یک دفتر ثبت محدودشده به پنجره «مدیر بسته» اضافه کنید:

   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 پنجره > مدیر بسته باز کنید.

4. منوِ کرکره‌ای دامنه مدیر را روی ثبت‌های من تنظیم کنید.

5. بسته افزونه Google Play Integrity برای Unity را از فهرست بسته‌ها انتخاب کنید و نصب را فشار دهید.

وارد کردن از GitHub

1. جدیدترین نسخه .unitypackage را از GitHub بارگیری کنید.

2. فایل .unitypackage را با انتخاب گزینه منو Unity دارایی‌ها > وارد کردن بسته > بسته سفارشی و وارد کردن همه موارد وارد کنید.

توجه: با بارگیری و استفاده از «افزایه‌های Unity در Google Play»، با شرایط خدمات کیت توسعه نرم‌افزار Play Core موافقت می‌کنید.

Unreal Engine

بخش‌های زیر نحوه ادغام و راه‌اندازی Google Play Integrity API را برای پروژه‌های Unreal Engine شرح می‌دهند.

نسخه‌های پشتیبانی‌شده Unreal Engine

این افزایه از Unreal Engine 5.0 و همه نسخه‌های بعدی پشتیبانی می‌کند.

راه‌اندازی محیط توسعه نرم‌افزار

توجه: اگر قبلاً از افزونه‌های «مرورهای درون‌برنامه» یا «به‌روزرسانی‌های درون‌برنامه» در Unreal Engine استفاده کرده‌اید، می‌توانید به مرحله آخر بروید.

1. افزایه Play Unreal Engine را از مخزن GitHub بارگیری کنید.

2. پوشه GooglePlay را در پوشه Plugins در پروژه Unreal Engine خود کپی کنید.

3. پروژه Unreal Engine را باز کنید و روی ویرایش ← افزایه‌ها کلیک کنید.

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 مراجعه کنید.

پیکربندی پاسخ‌های میانای برنامه‌سازی کاربردی (اختیاری)

پاسخ میانای برنامه‌سازی کاربردی شامل حکم‌های پیش‌فرضی است که در هر درخواست برگردانده می‌شود. اگر پروژه Cloud خود را در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» پیوند داده‌اید، می‌توانید پاسخ میانای برنامه‌سازی کاربردی خود را سفارشی‌سازی کنید تا اطلاعات بیشتری را دربرگیرد.

حکم‌های تمامیت پیش‌فرض

حکم‌های یکپارچگی زیر به‌طور پیش‌فرض در پاسخ 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 نسخه ۱۳ و بالاتر، مدرک پشتیبانی‌شده سخت‌افزاری وجود دارد که راه‌انداز سیستم دستگاه قفل است و سیستم‌عامل Android بارشده تصویر سازنده دستگاه دارای گواهینامه است.
	خالی (مقدار خالی)	برنامه در دستگاهی اجرا می‌شود که نشانه‌هایی از حمله (مانند قلاب‌اندازی میانای برنامه‌سازی کاربردی) یا به‌خطر افتادن سیستم (مانند ریشه‌یابی شدن) دارد، یا برنامه در دستگاه فیزیکی اجرا نمی‌شود (مانند شبیه‌سازی که در بررسی‌های یکپارچگی Google Play موفق عمل نمی‌کند).

«بازی‌های Google Play» برای رایانه

اگر در بازی‌های Google Play برای رایانه توزیع می‌کنید، به‌طور خودکار موافقت می‌کنید که برچسب دیگری در حکم تمامیت دستگاه دریافت کنید:

فیلد پاسخ	برچسب	شرح
یکپارچگی دستگاه	MEETS_VIRTUAL_INTEGRITY	برنامه در شبیه‌ساز Android با پشتیبانی خدمات Google Play اجرا می‌شود. شبیه‌ساز بررسی‌های تمامیت سیستم را با موفقیت پشت سر می‌گذارد و الزامات سازگاری اصلی Android را برآورده می‌کند.

حکم‌های تمامیت اختیاری

اگر پروژه Cloud خود را در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» پیوند داده‌اید، می‌توانید برای دریافت اطلاعات بیشتر موافقت کنید.

برای ایجاد تغییر، به «کنسول Play» بروید و به محافظت‌شده با Play پیمایش کنید. در کنار Play Integrity API، روی مدیریت کلیک کنید. روی تغییر پاسخ‌ها کلیک کنید، تغییرات را ویرایش و ذخیره کنید.

احتیاط: تغییرات انجام‌شده در پاسخ‌های تمامیت بلافاصله اعمال می‌شود، ازجمله برای برنامه‌ها و کیت‌های توسعه نرم‌افزار در دسته هدف تولید. قبل‌از ذخیره کردن تغییرات، مطمئن شوید سرورتان برای پذیرفتن پاسخ‌های جدید آماده است.

اطلاعات دستگاه

برچسب‌های اضافی دستگاه در حکم deviceIntegrity اطلاعات بیشتری درباره محیط دستگاهی که برنامه در آن اجرا می‌شود به شما می‌دهد. اگر دستگاهی معیارهای چند برچسب را داشته باشد، چند برچسب برای آن برگردانده می‌شود. می‌توانید از این برچسب‌ها برای ایجاد استراتژی اجرای چندسطحی استفاده کنید. برای مثال، ممکن است تصمیم بگیرید به دستگاهی که سه برچسب (MEETS_STRONG_INTEGRITY، MEETS_DEVICE_INTEGRITY، و MEETS_BASIC_INTEGRITY) برمی‌گرداند بیشتر از دستگاهی که فقط یک برچسب (MEETS_BASIC_INTEGRITY) برمی‌گرداند اعتماد کنید.

مشخصه‌های دستگاه نسخه کیت توسعه نرم‌افزار Android سیستم‌عامل Android را در دستگاه به شما می‌گوید. در آینده، ممکن است با مشخصه‌های دستگاه دیگر گسترش یابد.

فعالیت اخیر دستگاه سطحی را برمی‌گرداند که از LEVEL_1 (تعداد کم درخواست‌ها) تا LEVEL_4 (تعداد زیاد درخواست‌ها) متغیر است. سطوح بالای فعالیت ممکن است نشان‌دهنده این باشد که از دستگاه برای تولید بیش‌ازحد توکن‌ها برای توزیع سوءاستفاده‌آمیز به دستگاه‌های نامطمئن استفاده می‌شود.

فراخوانی دستگاه به شما امکان می‌دهد برخی‌از داده‌های سفارشی هر دستگاه را با دستگاه‌های خاصی ذخیره کنید تا بتوانید وقتی برنامه‌تان بعداً در همان دستگاه دوباره نصب شد، آن‌ها را بااطمینان بازیابی کنید.

توجه: به‌خاطرآوری دستگاه در نسخه بتا برای برنامه‌ها دردسترس است و ممکن است تغییر کند. پس‌از انتشار عمومی، ممکن است قیمت‌گذاری برای استفاده در مقیاس بالا اعمال شود. کیت‌های توسعه نرم‌افزار نمی‌توانند از «به‌یادآوری دستگاه» استفاده کنند.

پس‌از اینکه با ارائه اطلاعات اختیاری موافقت کردید، پاسخ میانای برنامه‌سازی کاربردی شما شامل فیلدها و پاسخ‌های جدیدی در حکم خواهد بود:

فیلد پاسخ	برچسب	شرح
یکپارچگی دستگاه	MEETS_BASIC_INTEGRITY	برنامه در دستگاهی اجرا می‌شود که در بررسی‌های یکپارچگی سیستم موفق عمل می‌کند. راه‌انداز سیستم دستگاه می‌تواند قفل یا باز باشد، و وضعیت راه‌اندازی می‌تواند درستی‌سنجی‌شده یا درستی‌سنجی‌نشده باشد. ممکن است دستگاه گواهی نداشته باشد، که در این صورت Google نمی‌تواند هیچ‌گونه تضمینی برای امنیت، حریم خصوصی، یا سازگاری برنامه ارائه دهد. در Android 13 و نسخه‌های بالاتر، حکم MEETS_BASIC_INTEGRITY مستلزم آن است که ریشه اعتماد گواهی را Google ارائه کرده باشد.
	MEETS_STRONG_INTEGRITY	برنامه در دستگاه Android واقعی و دارای گواهینامه با به‌روزرسانی امنیتی اخیر اجرا می‌شود. در Android نسخه ۱۳ و بالاتر، حکم MEETS_STRONG_INTEGRITY به MEETS_DEVICE_INTEGRITY و به‌روزرسانی‌های امنیتی در سال گذشته برای همه بخش‌های دستگاه، ازجمله وصله بخش سیستم‌عامل Android و وصله بخش فروشنده نیاز دارد. در Android 12 و نسخه‌های پایین‌تر، حکم MEETS_STRONG_INTEGRITY فقط به اثبات با پشتیبانی سخت‌افزار برای یکپارچگی راه‌اندازی نیاز دارد و نیازی به داشتن به‌روزرسانی امنیتی اخیر در دستگاه ندارد. بنابراین، هنگام استفاده از MEETS_STRONG_INTEGRITY، توصیه می‌شود نسخه کیت توسعه نرم‌افزار Android را نیز در فیلد deviceAttributes درنظر بگیرید.
ویژگی‌های دستگاه	sdkVersion: 19, 20, ..., 37	نسخه کیت توسعه نرم‌افزار سیستم‌عامل Android که در دستگاه اجرا می‌شود. عدد برگردانده‌شده به Build.VERSION_CODES نگاشت می‌شود.
	خالی (مقدار خالی)	نسخه کیت توسعه نرم‌افزار ارزیابی نشده است چون یکی از الزامات ضروری رعایت نشده است. در این مورد، فیلد sdkVersion تنظیم نشده است؛ بنابراین، فیلد deviceAttributes خالی است. این اتفاق ممکن است به دلایل زیر رخ دهد: دستگاه به‌اندازه کافی قابل‌اعتماد نیست. مشکلات فنی در دستگاه وجود داشت.
		درخواست‌های کد تمامیت میانای برنامه‌سازی کاربردی استاندارد در این دستگاه در ساعت گذشته به‌ازای هر برنامه	درخواست‌های کد تمامیت Classic API در این دستگاه در ساعت گذشته به‌ازای هر برنامه
فعالیت اخیر دستگاه	LEVEL_1 (پایین‌ترین)	10 یا کمتر	‫۵ یا کمتر
	LEVEL_2	بین ۱۱ تا ۲۵	بین ۶ تا ۱۰
	LEVEL_3	بین ۲۶ و ۵۰	بین ۱۱ تا ۱۵
	LEVEL_4 (بالاترین)	بیشتر از ۵۰	بیشتر از ۱۵
	UNEVALUATED	فعالیت اخیر دستگاه ارزیابی نشد. این اتفاق ممکن است به این دلیل رخ دهد: دستگاه به‌اندازه کافی قابل‌اعتماد نیست. نسخه برنامه‌تان که در دستگاه نصب شده است برای Google Play ناشناخته است. مشکلات فنی در دستگاه وجود داشت.
به‌یادآوری دستگاه	values: bitFirst, bitSecond, bitThird	این‌ها مقادیر بیتی هستند که در گذشته برای دستگاه خاصی تنظیم کرده‌اید. شما معنی هر بیت را تعیین می‌کنید. مقادیر سه بیت به‌طور پیش‌فرض نادرست هستند.
	writeDates: yyyymmFirst, yyyymmSecond, yyyymmThird	این‌ها تاریخ‌های نوشتن مقدار بیت در «ساعت هماهنگ جهانی» هستند که با دقت سال و ماه ارائه شده‌اند. تاریخ نوشتن بیت فراخوانی هربار که بیت روی درست تنظیم می‌شود به‌روز می‌شود و وقتی بیت روی نادرست تنظیم می‌شود برداشته می‌شود.

جزئیات محیط

خطر دسترسی به برنامه به شما می‌گوید آیا برنامه‌های دیگری درحال اجرا هستند که بتوان از آن‌ها برای ضبط صفحه‌نمایش، نمایش رونهاد، یا کنترل دستگاه استفاده کرد یا نه. سرویس‌های دسترس‌پذیری تأییدشده که برای Google Play شناخته‌شده هستند به‌طور خودکار از این حکم مستثنی می‌شوند.

حکم «سپر ایمنی 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	برنامه‌های دیگری درحال اجرا هستند (که توسط Play نصب نشده‌اند یا ازقبل در دستگاه بار شده‌اند) که می‌توان از آن‌ها برای کنترل دستگاه و ورودی‌ها و خروجی‌های برنامه درخواست‌کننده استفاده کرد، مثل برنامه‌های کنترل از راه دور.
	UNKNOWN_OVERLAYS	برنامه‌های دیگری درحال اجرا هستند (که توسط Play نصب نشده‌اند یا ازقبل در دستگاه بار شده‌اند) که ممکن است رونهادهایی را روی برنامه درخواست‌کننده نمایش دهند.
	خالی (مقدار خالی)	اگر یکی از پیش‌نیازهای ضروری وجود نداشته باشد، خطر دسترسی به برنامه ارزیابی نمی‌شود. در این مورد، فیلد appAccessRiskVerdict خالی است. این اتفاق ممکن است به دلایل مختلفی رخ دهد، ازجمله: دستگاه به‌اندازه کافی قابل‌اعتماد نیست. فرم فاکتور دستگاه تلفن، رایانه لوحی، یا دستگاه تاشو نیست. دستگاه Android نسخه ۶ (سطح میانای برنامه‌سازی کاربردی ۲۳) یا بالاتر را اجرا نمی‌کند. نسخه برنامه‌تان که در دستگاه نصب شده است برای 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 شناخته‌شده هستند معاف می‌کند. این سرویس‌ها باعث ایجاد پاسخ ضبط، کنترل، یا هم‌پوشانی نمی‌شوند، یعنی ابزارهای دسترس‌پذیری قانونی به‌عنوان خطر پرچم‌گذاری نمی‌شوند.

پیکربندی تنظیمات درخواست کلاسیک (اختیاری)

اگر فقط قصد دارید درخواست‌های استاندارد API ایجاد کنید، از این بخش رد شوید.

به‌طور پیش‌فرض، Google Play رمزگذاری پاسخ را مدیریت می‌کند، یعنی زیرینه شما برای رمزگشایی حکم‌ها سرور Google را فراخوانی می‌کند. یا می‌توانید خودتان کلیدها را مدیریت کنید تا رمزگشایی به‌صورت محلی در محیط سرور امن شما انجام شود.

به Google اجازه دهید رمزگذاری پاسخ شما را مدیریت کند (توصیه می‌شود)

توصیه می‌کنیم به Google اجازه دهید کلیدها را تولید و مدیریت کند تا از امنیت برنامه‌تان محافظت شود. زیرینه شما سرور Google Play را برای رمزگشایی و درستی‌سنجی پاسخ‌ها فراخوانی می‌کند.

مدیریت کلیدهای رمزگذاری خودتان

برای رمزگشایی محلی در محیط سرور امن خودتان، می‌توانید کلیدهای رمزگذاری را از «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» بارگیری کنید. برای استفاده از این ویژگی، برنامه‌تان باید در Google Play دردسترس باشد.

پیش‌از تغییر دادن استراتژی مدیریت رمزگذاری پاسخ در «کنسول Play»، مطمئن شوید سرورتان به‌درستی پیکربندی شده است تا برای جلوگیری از اختلال، توکن‌های یکپارچگی را در سرورهای Google Play رمزگشایی و درستی‌سنجی کند.

احتیاط: هرگز توکن‌ها را رمزگشایی نکنید یا کلیدها را در برنامه کارخواهتان آشکار نکنید.

نکته: حتی هنگام مدیریت شخصی کلیدها، برنامه‌تان همچنان می‌تواند برای رمزگشایی به سرور Google Play برگردد.

جابه‌جایی بین کلیدهای رمزگذاری تحت مدیریت Google و تحت مدیریت خودتان

1. کنسول Play را باز کنید و برنامه‌تان را انتخاب کنید .
2. به محافظت‌شده با Play بروید.
3. در کنار Play Integrity API، روی مدیریت کلیک کنید.
4. در بخش درخواست‌های کلاسیک، در کنار رمزگذاری پاسخ، روی ویرایش کلیک کنید.

برای جابه‌جا شدن به کلیدهای خودمدیریت:

1. مدیریت و بارگیری کلیدهای رمزگذاری پاسخ را انتخاب کنید و کلید عمومی‌تان را بارگذاری کنید.
2. روی ذخیره کلیک کنید تا کلیدهای رمزگذاری‌شده به‌طور خودکار بارگیری شود.
3. سرور زیرینه ایمن خود را به‌روز کنید تا بااستفاده از این کلیدها به‌طور محلی رمزگشایی کند.

برای رفتن به کلیدهای مدیریت‌شده توسط Google:

1. به Google اجازه داده شود رمزگذاری پاسخ من را مدیریت کند (توصیه می‌شود) را انتخاب کنید.
2. روی ذخیره تغییرات کلیک کنید.

احتیاط: جابه‌جایی به رمزگذاری تحت مدیریت Google بلافاصله کلیدهای بارگیری‌شده قبلی را، حتی در تولید، نامعتبر می‌کند. قبل‌از تغییر، مطمئن شوید سرورتان برای مدیریت تغییر پیکربندی شده باشد تا از بروز اختلال جلوگیری شود.