نمای کلی Play Integrity API

‫Play Integrity API به شما کمک می‌کند بررسی کنید کنش‌های کاربر و درخواست‌های سرور از برنامه واقعی شما که ازطریق Google Play نصب شده است و در دستگاه واقعی و تأییدشده با پشتیبانی Android اجرا می‌شود نشئت گرفته باشند. با شناسایی تعاملات پرخطر (مانند تعاملات ناشی از نسخه‌های دستکاری‌شده برنامه، دستگاه‌های غیرقابل‌اعتماد، یا محیط‌های شبیه‌سازی‌شده)، سرور زیرینه شما می‌تواند با کنش‌های مناسب برای جلوگیری از سوءاستفاده و دسترسی غیرمجاز، مبارزه با کلاهبرداری، مقابله با تقلب، و محافظت از کاربران دربرابر حملات پاسخ دهد.

جریان نمای کلی Play Integrity API

این میانای برنامه‌سازی کاربردی حکم‌هایی را برمی‌گرداند که به شما کمک می‌کند تهدیدهای احتمالی را شناسایی کنید، ازجمله:

  • دسترسی غیرمجاز: حکم accountDetails به شما کمک می‌کند تعیین کنید کاربر برنامه یا بازی‌تان را نصب یا هزینه آن را در Google Play پرداخت کرده است یا نه.
  • دستکاری کد: حکم appIntegrity به شما کمک می‌کند تعیین کنید با دودویی تغییرنیافته خود که Google Play آن را تشخیص می‌دهد تعامل دارید یا نه.
  • دستگاه‌های پرخطر و محیط‌های شبیه‌سازی‌شده: حکم deviceIntegrity به شما کمک می‌کند تشخیص دهید که برنامه‌تان در دستگاه واقعی دارای گواهینامه با پشتیبانی Android یا نمونه واقعی «بازی‌های Google Play ویژه رایانه» اجرا می‌شود یا نه.

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

  • دستگاه‌های وصله‌نشده: پاسخ MEETS_STRONG_INTEGRITY در حکم deviceIntegrity به شما کمک می‌کند تشخیص دهید آیا دستگاه به‌روزرسانی‌های امنیتی اخیر را اعمال کرده است یا نه (برای دستگاه‌های دارای Android 13 و بالاتر).
  • دسترسی پرخطر توسط برنامه‌های دیگر: appAccessRiskVerdict به شما کمک می‌کند تشخیص دهید آیا برنامه‌هایی درحال اجرا هستند که بتوان از آن‌ها برای ضبط صفحه‌نمایش، نمایش رونهاد، یا کنترل دستگاه (برای مثال، با سوءاستفاده از اجازه دسترس‌پذیری) استفاده کرد یا نه.
  • بدافزار شناخته‌شده: playProtectVerdict به شما کمک می‌کند تشخیص دهید که آیا «سپر ایمنی Google Play» روشن است یا نه و آیا برنامه‌های مخاطره‌آمیز یا خطرناک نصب‌شده در دستگاه را پیدا کرده است یا نه.
  • بیش‌فعالی: سطح recentDeviceActivity به شما کمک می‌کند تشخیص دهید آیا دستگاهی اخیراً حجم درخواست‌های به‌طور ناهنجار بالایی داشته است یا نه، که می‌تواند نشان‌دهنده ترافیک خودکارسازی‌شده و نشانه‌ای از حمله باشد.
  • سوءاستفاده مکرر و دستگاه‌های دوباره استفاده‌شده: deviceRecall (نسخه بتا) به شما کمک می‌کند تشخیص دهید که آیا با دستگاهی تعامل دارید که قبلاً آن را پرچم‌گذاری کرده‌اید، حتی اگر برنامه‌تان بازنصب شده باشد یا دستگاه بازنشانی شده باشد.

از این میانای برنامه‌سازی کاربردی می‌توان در انواع ابعاد Android ازجمله تلفن، رایانه لوحی، دستگاه تاشو، Android Auto،‏ Android TV،‏ Android XR،‏ ChromeOS،‏ Wear OS، و در «بازی‌های Google Play» برای رایانه استفاده کرد.

ملاحظات امنیتی

اگر این شیوه‌های توصیه‌شده را دنبال کنید، Play Integrity API بیشترین ارزش را برای برنامه‌تان فراهم می‌کند:

استراتژی ضدسوءاستفاده داشته باشید

‫Play Integrity API زمانی بهترین عملکرد را دارد که به‌موازات سیگنال‌های دیگر به‌عنوان بخشی از استراتژی کلی ضد سوءاستفاده و نه به‌عنوان یک مکانیسم ضدسوءاستفاده واحد استفاده شود. از این میانای برنامه‌سازی کاربردی در کنار دیگر روال‌های مطلوب امنیتی مناسب برای برنامه‌تان استفاده کنید. به‌طور پیش‌فرض، برنامه‌تان می‌تواند درمجموع حداکثر ۱۰٬۰۰۰ درخواست در روز در همه نصب‌ها ارائه دهد. می‌توانید درخواست کنید حداکثر روزانه شما افزایش یابد.

قبل‌از اقدام کردن، دورسنجی را جمع‌آوری کنید و مخاطبانتان را بشناسید

قبل‌از اینکه نحوه رفتار برنامه‌تان را براساس حکم‌های Play Integrity API تغییر دهید، می‌توانید با پیاده‌سازی این میانای برنامه‌سازی کاربردی بدون اعمال اجباری، وضعیت فعلی را با مخاطبان موجود خود درک کنید. وقتی بدانید پایگاه نصب فعلی‌تان چه رأی‌هایی برمی‌گرداند، می‌توانید تأثیر هرگونه اجرایی را که برنامه‌ریزی می‌کنید برآورد کنید و استراتژی ضدسوءاستفاده‌تان را براساس آن تنظیم کنید.

تصمیم بگیرید که چگونه حکم‌های تمامیت را درخواست خواهید کرد

‫Play Integrity API دو گزینه برای درخواست و دریافت حکم‌های تمامیت ارائه می‌دهد. چه درخواست‌های استاندارد، چه درخواست‌های قدیمی، یا ترکیبی از هردو نوع درخواست را ارائه دهید، پاسخ حکم یکپارچگی در همان قالب برگردانده خواهد شد.

درخواست‌های استاندارد API برای هر برنامه یا بازی مناسب است و می‌توان آن‌ها را به‌صورت درخواستی انجام داد تا بررسی شود که هر کنش کاربر یا درخواست سرور واقعی است. درخواست‌های استاندارد کمترین تأخیر (به‌طور میانگین چند صد میلی‌ثانیه) و قابلیت اطمینان بالایی برای دریافت حکم قابل‌استفاده دارند. درخواست‌های استاندارد از حافظه نهان هوشمند درون‌دستگاهی استفاده می‌کنند و درعین‌حال محافظت دربرابر انواع خاصی از حملات را به Google Play واگذار می‌کنند.

درخواست‌های Classic API، روش اصلی برای درخواست کردن حکم‌های تمامیت، نیز همچنان دردسترس است. درخواست‌های کلاسیک تأخیر بیشتری دارند (به‌طور میانگین چند ثانیه) و شما مسئول کاهش خطر انواع خاصی از حملات هستید. درخواست‌های کلاسیک نسبت‌به درخواست‌های استاندارد از داده و باتری بیشتری استفاده می‌کنند زیرا ارزیابی جدیدی را آغاز می‌کنند و بنابراین باید به‌ندرت و به‌صورت یک‌باره انجام شوند تا بررسی شود که آیا کنش بسیار حساس یا ارزشمند واقعی است یا نه. اگر قصد دارید درخواست کلاسیک ایجاد کنید و آن را برای استفاده در آینده ذخیره کنید، باید به‌جای آن درخواست استاندارد ایجاد کنید تا خطر حملات کاهش یابد.

جدول زیر برخی‌از تفاوت‌های کلیدی بین این دو نوع درخواست را برجسته می‌کند:

درخواست استاندارد میانای برنامه‌سازی کاربردی درخواست کلاسیک میانای برنامه‌سازی کاربردی
حداقل کیت توسعه نرم‌افزار Android موردنیاز* ‫Android نسخه ۶.۰ (سطح میانای برنامه‌سازی کاربردی ۲۳) یا بالاتر ‫Android نسخه ۶.۰ (سطح میانای برنامه‌سازی کاربردی ۲۳) یا بالاتر
گرم کردن میانای برنامه‌سازی کاربردی لازم است ✔️ (چند ثانیه) ❌
تأخیر درخواست معمول چند صد میلی‌ثانیه چند ثانیه
بسامد درخواست احتمالی مکرر (بررسی درصورت درخواست برای هرگونه کنش یا درخواست) به‌ندرت (بررسی یک‌باره برای کنش‌های دارای بالاترین ارزش یا حساس‌ترین درخواست‌ها)
کاهش دادن حملات بازپخش و حملات مشابه کاهش خودکار توسط Google Play استفاده از فیلد nonce با منطق سمت سرور

* برای کتابخانه Play Integrity API نسخه ۱.۴.۰ و جدیدتر، حداقل کیت توسعه نرم‌افزار Android پشتیبانی‌شده برای هر دو نوع درخواست یکسان است و توسط minSdkVersion کتابخانه تعیین می‌شود. برای v1.3.0 و نسخه‌های قبلی، حداقل کیت توسعه نرم‌افزار Android موردنیاز برای درخواست‌های Standard API،‏ Android 5.0 (سطح میانای برنامه‌سازی کاربردی ۲۱) و برای درخواست‌های Classic API،‏ Android 4.4 (سطح میانای برنامه‌سازی کاربردی ۱۹) است.

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

درخواست حکم تمامیت در لحظه مناسب

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

درخواست‌های میانای برنامه‌سازی کاربردی خود را به‌گونه‌ای بسازید که تکرار آن‌ها دشوار باشد

درخواست‌های Standard API فیلدی به‌نام requestHash دارند که برای محافظت دربرابر دست‌کاری و حملات مشابه استفاده می‌شود. در این فیلد، باید خلاصه‌ای از همه مقادیر مربوطه از درخواست برنامه‌تان را اضافه کنید. برای محافظت از درخواست‌های استاندارد برنامه‌تان، راهنمای نحوه استفاده از اتصال محتوا را دنبال کنید.

درخواست‌های Classic API فیلدی به‌نام nonce (مخفف number once) دارند که برای محافظت دربرابر انواع خاصی از حملات، مانند حملات تکرار و دست‌کاری، استفاده می‌شود. برای محافظت از درخواست‌های کلاسیک برنامه‌تان، راهنمای نحوه تولید nonce را دنبال کنید.

از ذخیره کردن حکم‌های تمامیت در حافظه نهان خودداری کنید

ذخیره کردن حکم‌های یکپارچگی در حافظه نهان خطر پروکسی کردن را افزایش می‌دهد. پروکسی کردن نوعی حمله است که در آن عامل مخرب از حکم دستگاهی خوب برای اهداف سوءاستفاده‌جویانه در محیطی دیگر استفاده می‌کند. به‌جای ذخیره کردن پاسخ‌ها در حافظه نهان، می‌توانید درخواست API استاندارد برای دریافت حکم درصورت درخواست ارائه دهید.

استراتژی اجرای چندسطحی داشته باشید

حکم تمامیت Play Integrity API گستره‌ای از پاسخ‌های ممکن دارد که امکان ساخت استراتژی ضدسوءاستفاده با چندین سطح اجرایی را ممکن می‌سازد. برای این کار می‌توانید سرور زیرینه برنامه‌تان را به‌گونه‌ای پیکربندی کنید که بسته به هر پاسخ احتمالی یا گروهی از پاسخ‌ها رفتار متفاوتی داشته باشد.

قبل‌از ارزیابی قابل‌اعتماد بودن دستگاه، بررسی سایر سیگنال‌های اصلی در پاسخ میانای برنامه‌سازی کاربردی ضروری است:

  • جزئیات درخواست: مطمئن شوید requestDetails با مقادیر موردانتظارتان مطابقت داشته باشد، به‌ویژه requestHash یا nonce را درستی‌سنجی کنید تا از حملات بازپخش جلوگیری شود.
  • تمامیت برنامه: بررسی کنید که appRecognitionVerdict برابر با PLAY_RECOGNIZED باشد، که تأیید می‌کند گواهی امضای برنامه توسط Play شناسایی شده است و دستکاری نشده است.
  • جزئیات حساب: بررسی کنید که appLicensingVerdict برابر با LICENSED باشد، که تأیید می‌کند کاربر برنامه را از Google Play نصب یا به‌روزرسانی کرده است.

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

پس‌از اینکه بررسی‌های پایه با موفقیت انجام شد، می‌توانید استراتژی اجرایی‌تان را براساس قابل‌اعتماد بودن دستگاه با موافقت با دریافت برچسب‌های اضافی دستگاه در پاسخ API از «کنسول Play» رده‌بندی کنید. هر دستگاه همه برچسب‌هایی را که با معیارهای آن مطابقت دارد برمی‌گرداند. برای دریافت نسخه کیت توسعه نرم‌افزار Android، باید از فیلد deviceAttributes موجود در پاسخ میانای برنامه‌سازی کاربردی استفاده کنید. گستره سطوح اعتماد دستگاه از دستگاه‌های مطمئن‌تر تا دستگاه‌های کمتر مطمئن را دربرمی‌گیرد:

  • MEETS_STRONG_INTEGRITY (Android 13 و بالاتر): بالاترین سطح اعتماد دستگاه، که به سیگنال‌های امنیتی با پشتیبانی سخت‌افزار و وصله امنیتی اخیر نیاز دارد.
  • MEETS_DEVICE_INTEGRITY (Android 13+) و 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 برای پیدا کردن دستگاه‌هایی که تعداد زیادی کد تمامیت درخواست می‌کنند استفاده کنید. سوءاستفاده‌کنندگان با فعالیت‌های با حجم بالا معمولاً نتایج تصدیق معتبری از دستگاه‌های واقعی تولید می‌کنند و آن‌ها را به روبات‌ها ارائه می‌دهند تا حملات به دستگاه‌های ریشه‌دار و شبیه‌سازها را خودکار کنند. می‌توانید از سطح فعالیت اخیر دستگاه برای بررسی تعداد گواهی‌های تولیدشده توسط برنامه‌تان در آن دستگاه در ساعت گذشته استفاده کنید.

نمایش پیام‌های خطای قابل‌اجرا

هرگاه ممکن باشد، پیام‌های خطای مفید به کاربران ارائه دهید و به آن‌ها امکان دهید با نحوه رفع آن آشنا شوند؛ مثلاً امتحان مجدد، فعال کردن اتصال اینترنت، یا بررسی به‌روز بودن برنامه «فروشگاه Play».

برای مشکلات یا قطعی‌های غیرمنتظره برنامه‌ریزی کنید

داشبورد وضعیت Play اطلاعاتی درباره وضعیت سرویس Play Integrity API به‌همراه اطلاعاتی درباره هرگونه اختلال و قطعی نشان می‌دهد. باید ازقبل برنامه‌ریزی کنید که درصورت وقوع رویداد غیرمحتمل قطعی گسترده Play Integrity API، سرور زیرینه شما چگونه عمل کند. توجه داشته باشید که سرور نهایی شما باید برای عملکرد در شرایطی که کلیدهای «تصدیق کلید پلاتفرم Android» مختص دستگاه‌ها لغو شده‌اند نیز آماده باشد.

راه‌حل‌های کلاهبرداری سازمانی سرتاسر را درنظر بگیرید

مشتریان سازمانی که به‌دنبال راه‌حل کامل مدیریت کلاهبرداری و روبات هستند می‌توانند reCAPTCHA Enterprise را برای تلفن همراه خریداری کنند که شامل کیت‌های توسعه نرم‌افزار برای 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 ببینید.