ตั้งค่า

หน้านี้อธิบายวิธีตั้งค่าแอป เกม หรือ SDK ให้ใช้ Play Integrity API หากต้องการผสานรวม API คุณต้องมีโปรเจ็กต์ Google Cloud ซึ่งจำเป็นสำหรับการเริ่มส่งคำขอ จากนั้นคุณจะลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ใน Google Play Console (สำหรับแอป) หรือ Google Play SDK Console (สำหรับ SDK) ได้ คุณต้องลิงก์โปรเจ็กต์เพื่อเข้าถึงตัวเลือกการกำหนดค่าเพิ่มเติม ฟีเจอร์การทดสอบ การรายงาน API และเพื่อขอเพิ่มโควต้าคำขอรายวัน

เปิดใช้ Play Integrity API

แอปหรือ SDK ทุกแอปที่เรียกใช้ Play Integrity API ต้องมีโปรเจ็กต์ Google Cloud เพื่อใช้ API และตรวจสอบการใช้งาน นี่เป็นขั้นตอนแรกที่จำเป็นสำหรับการผสานรวมทั้งหมด คุณสามารถเปิดใช้ Play Integrity API ในคอนโซล Google Cloud หรือจะข้ามไปลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์กับ Google Play โดยตรงก็ได้ แล้วระบบจะเปิดใช้ Play Integrity API ให้คุณ

ในคอนโซล Google Cloud ให้สร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่หรือเลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่มีอยู่ซึ่งคุณต้องการใช้กับ Play Integrity API

  1. ไปที่แอปและบริการ
  2. เลือกเปิดใช้ API และบริการ
  3. ค้นหา Play Integrity API
  4. คลิกเปิดใช้

ตอนนี้คุณผสานรวม Play Integrity API เข้ากับแอปได้แล้ว หากต้องการเข้าถึงฟีเจอร์ขั้นสูงและการเพิ่มโควต้า คุณต้องดำเนินการต่อในขั้นตอนการลิงก์

ลิงก์กับ Google Play (แนะนำ)

คุณสามารถลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google กับแอปหรือ SDK ได้โดยทำตามวิธีการเหล่านี้

สำหรับแอปและเกมใน Google Play

แอปที่เผยแพร่ใน Google Play ควรลิงก์โปรเจ็กต์ Google Cloud ใน Google Play Console เพื่อเปิดใช้ฟีเจอร์เพิ่มเติมและขอเพิ่มโควต้า API รายวัน

  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 เพื่อระบุแหล่งที่มาของการใช้งาน API ไปยัง SDK แทนแอปแต่ละแอปที่ใช้ SDK ดังกล่าว เปิดใช้ฟีเจอร์เพิ่มเติม และขอโควต้า API รายวันเพิ่มได้ โปรดทราบว่าสิทธิ์เข้าถึง Google Play SDK Console ขึ้นอยู่กับเกณฑ์การมีสิทธิ์

  1. เปิด Google Play SDK Console แล้วเลือก SDK ของคุณ
  2. ไปที่ความสมบูรณ์ของ SDK
  3. ในส่วน Play Integrity API ให้คลิกลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์
  4. เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่คุณวางแผนจะใช้กับ Play Integrity API หากโปรเจ็กต์ยังไม่ได้เปิดใช้ Play Integrity API ระบบจะเปิดใช้โดยอัตโนมัติเมื่อลิงก์

ทำความเข้าใจขีดจำกัดการใช้งาน Play Integrity API

แอปหรือ SDK ของคุณมีขีดจำกัดการใช้งานต่อวันเริ่มต้นที่คำขอทั้งหมด 10,000 รายการ ซึ่งเชื่อมโยงกับหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่เกี่ยวข้อง หากคาดว่าจะมีปริมาณสูงขึ้น คุณสามารถขอเพิ่มโควต้าได้

การทำงาน โควต้าประจำวัน หมายเหตุ
คำขอโทเค็น 10,000 แชร์ระหว่างคำขอแบบคลาสสิกและการเตรียมโทเค็นแบบมาตรฐาน
การถอดรหัสโทเค็นในเซิร์ฟเวอร์ของ Google 10,000 แชร์ระหว่างคำขอแบบคลาสสิกและคำขอมาตรฐาน

เพิ่มจำนวนคำขอสูงสุดต่อวัน

การเพิ่มโควต้าขึ้นอยู่กับเกณฑ์การมีสิทธิ์ การเพิ่มโควต้าจะมีผลกับการเรียกใช้ทั้งการสร้างโทเค็นฝั่งไคลเอ็นต์และการถอดรหัสฝั่งเซิร์ฟเวอร์ การประมวลผลคำขออาจใช้เวลาถึง 1 สัปดาห์ เราขอแนะนำให้ตรวจสอบการใช้งาน Play Integrity API ในคอนโซล Google Cloud และตั้งค่าการแจ้งเตือนโควต้าเพื่อหลีกเลี่ยงการหยุดชะงักของบริการ

แม้จะมีโควต้าสูงขึ้น แต่ก็ยังคงจำกัดคำขอแบบคลาสสิกไว้สำหรับการดำเนินการที่มีมูลค่าสูงซึ่งเกิดขึ้นนานๆ ครั้งเพื่อประหยัดแบตเตอรี่และการใช้อินเทอร์เน็ตมือถือของผู้ใช้

สำหรับแอปและเกมใน Google Play

แอปของคุณต้องพร้อมให้บริการใน Google Play นอกเหนือจากช่องทางการเผยแพร่อื่นๆ จึงจะมีสิทธิ์ขอเพิ่มโควต้า คุณต้องลิงก์โปรเจ็กต์ Google Cloud กับแอปใน Play Console คำขอโควต้าจากโปรเจ็กต์ที่ไม่ได้ลิงก์จะถูกปฏิเสธ

วิธีขอเพิ่มมีดังนี้

  1. ลิงก์โปรเจ็กต์ Google Cloud ที่เกี่ยวข้องใน Play Console
  2. ยืนยันว่าคุณได้ใช้ตรรกะ API อย่างถูกต้องแล้ว ซึ่งรวมถึงกลยุทธ์การลองใหม่ที่เหมาะสม
  3. ส่งแบบฟอร์มคำขอโควต้า

สำหรับผู้ให้บริการ SDK ใน Play SDK Console

หากต้องการมีสิทธิ์เพิ่มโควต้า คุณต้องอ้างสิทธิ์ SDK ใน Google Play SDK Console และลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์กับ SDK ในคอนโซลดังกล่าว การเข้าถึง Google Play SDK Console ขึ้นอยู่กับเกณฑ์การมีสิทธิ์

วิธีขอเพิ่มมีดังนี้

  1. ลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ใน Google Play SDK Console
  2. กรอกแบบฟอร์มสนับสนุนนักพัฒนาแอป

ในความคิดเห็นแบบเปิด ให้ระบุรายละเอียด SDK, อธิบาย Use Case, ประเภทคำขอ API ที่คุณทำ (มาตรฐาน, คลาสสิก หรือทั้ง 2 อย่าง), ความถี่ในการส่งคำขอ และจำนวนคำขอสูงสุดต่อวันที่คุณต้องการ

ผสานรวม Play Integrity API ลงในแอป

หากต้องการผสานรวม Play Integrity API เข้ากับแอปหรือ SDK ให้ทำอย่างใดอย่างหนึ่งต่อไปนี้ โดยขึ้นอยู่กับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ของคุณ

Kotlin หรือ Java

ไลบรารี Android ล่าสุดสำหรับ Play Integrity API พร้อมใช้งานจากที่เก็บ Maven ของ Google เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ 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 Edit > Project Settings > Package Manager

  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 Assets > Import package > Custom Package แล้วนำเข้ารายการทั้งหมด

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 แล้วคลิกแก้ไข → ปลั๊กอิน

  4. ค้นหา Google Play แล้วเลือกช่องทำเครื่องหมายเปิดใช้

  5. รีสตาร์ทโปรเจ็กต์เกมและทริกเกอร์บิลด์

  6. เปิดไฟล์ Build.cs ของโปรเจ็กต์ แล้วเพิ่มโมดูล PlayIntegrity ลงใน PublicDependencyModuleNames:

    using UnrealBuildTool;

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

    PublicDependencyModuleNames.Add("PlayIntegrity");

    // ...
  }
}

เนทีฟ

ทำตามคู่มือการตั้งค่าโฆษณาเนทีฟ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารอ้างอิง API แบบเนทีฟของ Play Integrity

กำหนดค่าการตอบกลับจาก API (ไม่บังคับ)

การตอบกลับจาก API จะรวมผลการตัดสินเริ่มต้นที่แสดงผลในทุกคำขอ หากลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Play Console หรือ Play SDK Console แล้ว คุณจะปรับแต่งการตอบกลับจาก API เพื่อรวมข้อมูลเพิ่มเติมได้

การตัดสินความสมบูรณ์เริ่มต้น

ระบบจะแสดงผลการตัดสินความสมบูรณ์ต่อไปนี้ในการตอบกลับจาก 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 ขึ้นไป จะมีหลักฐานที่อิงฮาร์ดแวร์ว่า Bootloader ของอุปกรณ์ล็อกอยู่ และระบบปฏิบัติการ Android ที่โหลดเป็นอิมเมจของผู้ผลิตอุปกรณ์ที่ผ่านการรับรอง
ว่างเปล่า (ค่าว่าง) แอปกําลังทํางานในอุปกรณ์ที่มีสัญญาณการโจมตี (เช่น การฮุก API) หรือการบุกรุกระบบ (เช่น การรูท) หรือแอปไม่ทํางานในอุปกรณ์จริง (เช่น โปรแกรมจําลองที่ไม่ผ่านการตรวจสอบความน่าเชื่อถือของ Google Play)

Google Play Games สำหรับ PC

หากคุณเผยแพร่แอปไปยัง Google Play Games สำหรับ PC ระบบจะเลือกรับป้ายกำกับเพิ่มเติมในคำตัดสินความสมบูรณ์ของอุปกรณ์ให้คุณโดยอัตโนมัติ

ช่องคำตอบ ป้ายกำกับ คำอธิบาย
ความสมบูรณ์ของอุปกรณ์ MEETS_VIRTUAL_INTEGRITY แอปกำลังทำงานบนโปรแกรมจำลองของ Android ที่ขับเคลื่อนโดยบริการ Google Play โปรแกรมจำลองผ่านการตรวจสอบความสมบูรณ์ของระบบและเป็นไปตามข้อกำหนดหลักด้านความเข้ากันได้ของ Android

การตัดสินความสมบูรณ์ที่ไม่บังคับ

หากลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Play Console หรือ Play SDK Console แล้ว คุณสามารถเลือกรับข้อมูลเพิ่มเติมได้

หากต้องการเปลี่ยนแปลง ให้ไปที่ Play Console แล้วไปที่ได้รับการปกป้องด้วย Play คลิกจัดการข้าง Play Integrity API คลิกเปลี่ยนการตอบกลับ แก้ไข และบันทึกการเปลี่ยนแปลง

ข้อมูลอุปกรณ์

ป้ายกำกับอุปกรณ์เพิ่มเติมในคำตัดสิน deviceIntegrity จะบอกข้อมูลเพิ่มเติมเกี่ยวกับสภาพแวดล้อมของอุปกรณ์ที่แอปทำงานอยู่ อุปกรณ์เครื่องเดียวจะแสดงป้ายกำกับหลายรายการหากตรงตามเกณฑ์ของแต่ละป้ายกำกับ คุณสามารถใช้ป้ายกำกับเหล่านี้เพื่อสร้างกลยุทธ์การบังคับใช้แบบเป็นระดับชั้นได้ ตัวอย่างเช่น คุณอาจเลือกที่จะเชื่อถืออุปกรณ์ที่แสดงป้ายกำกับ 3 รายการ (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY และ MEETS_BASIC_INTEGRITY) มากกว่าอุปกรณ์ที่แสดงป้ายกำกับเพียงรายการเดียว (MEETS_BASIC_INTEGRITY)

แอตทริบิวต์อุปกรณ์จะบอกเวอร์ชัน Android SDK ของระบบปฏิบัติการ Android ในอุปกรณ์ ในอนาคต อาจมีการขยายการใช้งานไปยังแอตทริบิวต์อุปกรณ์อื่นๆ

กิจกรรมล่าสุดในอุปกรณ์จะแสดงระดับตั้งแต่ LEVEL_1 (คำขอจำนวนน้อย) ไปจนถึง LEVEL_4 (คำขอจำนวนมาก) ระดับกิจกรรมที่สูงอาจบ่งชี้ว่ามีการใช้อุปกรณ์เพื่อสร้างโทเค็นมากเกินไปสำหรับการแจกจ่ายที่ไม่เหมาะสมไปยังอุปกรณ์ที่ไม่น่าเชื่อถือ

การเรียกคืนของอุปกรณ์ช่วยให้คุณจัดเก็บข้อมูลที่กำหนดเองของแต่ละอุปกรณ์ไว้กับอุปกรณ์ที่เฉพาะเจาะจง ซึ่งคุณสามารถเรียกดูได้อย่างน่าเชื่อถือเมื่อติดตั้งแอปอีกครั้งในภายหลังบนอุปกรณ์เครื่องเดียวกัน

หลังจากเลือกรับข้อมูลที่ไม่บังคับแล้ว การตอบกลับจาก API จะมีช่องและการตอบกลับใหม่ในการตัดสินดังนี้

ช่องคำตอบ ป้ายกำกับ คำอธิบาย
ความสมบูรณ์ของอุปกรณ์ MEETS_BASIC_INTEGRITY แอปกำลังทำงานบนอุปกรณ์ที่ผ่านการตรวจสอบความสมบูรณ์ของระบบพื้นฐาน Bootloader ของอุปกรณ์อาจล็อกหรือปลดล็อกอยู่ก็ได้ และสถานะการเปิดเครื่องอาจได้รับการยืนยันหรือไม่ก็ได้ อุปกรณ์อาจไม่ผ่านการรับรอง ซึ่งในกรณีนี้ Google ไม่สามารถรับประกันความปลอดภัย ความเป็นส่วนตัว หรือความเข้ากันได้ของแอป ใน Android 13 ขึ้นไป การตัดสิน MEETS_BASIC_INTEGRITY กำหนดให้ Google เป็นผู้จัดหา รูทของความน่าเชื่อถือในการรับรอง
MEETS_STRONG_INTEGRITY แอปกำลังทำงานบนอุปกรณ์ Android ของแท้และผ่านการรับรองซึ่งมีการอัปเดตความปลอดภัยล่าสุด
  • ใน Android 13 ขึ้นไป MEETS_STRONG_INTEGRITY คำตัดสินต้องใช้ MEETS_DEVICE_INTEGRITY และการอัปเดตความปลอดภัย ในปีที่ผ่านมาสำหรับพาร์ติชันทั้งหมดของอุปกรณ์ ซึ่งรวมถึงแพตช์พาร์ติชันระบบปฏิบัติการ Android และแพตช์พาร์ติชันของผู้ให้บริการ
  • ใน Android 12 และต่ำกว่า ผลการตัดสิน MEETS_STRONG_INTEGRITY ต้องการเพียงหลักฐานความสมบูรณ์ของการเปิดเครื่องที่อิงฮาร์ดแวร์ และไม่กำหนดให้อุปกรณ์ต้องมีการอัปเดตความปลอดภัยล่าสุด ดังนั้นเมื่อใช้ MEETS_STRONG_INTEGRITY เราขอแนะนำให้พิจารณาเวอร์ชัน Android SDK ในช่อง deviceAttributes ด้วย
แอตทริบิวต์อุปกรณ์ sdkVersion: 19, 20, ..., 37 เวอร์ชัน SDK ของระบบปฏิบัติการ Android ที่ทำงานบนอุปกรณ์ ตัวเลขที่แสดงผลจะแมปกับ Build.VERSION_CODES
ว่างเปล่า (ค่าว่าง) ระบบไม่ได้ประเมินเวอร์ชัน SDK เนื่องจากไม่เป็นไปตามข้อกําหนดที่จําเป็น ในกรณีนี้ ระบบจะไม่ได้ตั้งค่าช่อง sdkVersion ดังนั้นช่อง deviceAttributes จึงว่างเปล่า ซึ่งอาจเกิดขึ้นเนื่องจากสาเหตุต่อไปนี้
  • อุปกรณ์ไม่น่าเชื่อถือพอ
  • เกิดปัญหาทางเทคนิคในอุปกรณ์
คำขอโทเค็นความสมบูรณ์ของ API มาตรฐานในอุปกรณ์นี้ ในช่วง 1 ชั่วโมงที่ผ่านมาต่อแอป คำขอโทเค็นความสมบูรณ์ของ API แบบคลาสสิกในอุปกรณ์นี้ในชั่วโมงที่ผ่านมาต่อแอป
กิจกรรมล่าสุดในอุปกรณ์ 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 ค่าเหล่านี้คือค่าบิตที่คุณตั้งค่าไว้ในอดีตสำหรับอุปกรณ์ที่เฉพาะเจาะจง คุณเป็นผู้กำหนดความหมายของแต่ละบิต ค่าบิตทั้ง 3 ค่าจะเป็นเท็จโดยค่าเริ่มต้น
writeDates: yyyymmFirst, yyyymmSecond, yyyymmThird ค่าเหล่านี้คือวันที่เขียนค่าบิตในรูปแบบ UTC ที่ถูกต้องตามปีและเดือน วันที่เขียนของบิตการเรียกคืนจะอัปเดตทุกครั้งที่มีการตั้งค่าบิตเป็น "จริง" และจะถูกนำออกเมื่อตั้งค่าบิตเป็น "เท็จ"

รายละเอียดสภาพแวดล้อม

ความเสี่ยงในการเข้าถึงแอปจะบอกว่ามีแอปอื่นๆ ทำงานอยู่ซึ่งอาจใช้เพื่อจับภาพหน้าจอ แสดงภาพซ้อนทับ หรือควบคุมอุปกรณ์หรือไม่ บริการการช่วยเหลือพิเศษที่ได้รับการยืนยันซึ่ง Google Play รู้จักจะได้รับการยกเว้นจากคำตัดสินนี้โดยอัตโนมัติ

ผลการตัดสินของ Play Protect จะบอกว่ามีการเปิดใช้ Google Play Protect ในอุปกรณ์หรือไม่ และตรวจพบมัลแวร์ที่รู้จักหรือไม่

หลังจากเลือกรับข้อมูลที่ไม่บังคับแล้ว การตอบกลับจาก API จะมีช่องและการตอบกลับใหม่ในการตัดสินดังนี้

ช่องคำตอบ ค่า คำอธิบาย
คำตัดสินความเสี่ยงในการเข้าถึงแอป KNOWN_INSTALLED แอปได้รับการติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในพาร์ติชันระบบโดยผู้ผลิตอุปกรณ์
KNOWN_CAPTURING แอปที่ติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์กำลังทำงานอยู่ ซึ่งอาจใช้เพื่ออ่านหรือบันทึกอินพุตและเอาต์พุตของแอปที่ขอ เช่น โปรแกรมบันทึกหน้าจอ
KNOWN_CONTROLLING แอปที่ติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์กำลังทำงานอยู่ ซึ่งอาจใช้เพื่อควบคุมอุปกรณ์ รวมถึงอินพุตและเอาต์พุตของแอปที่ส่งคำขอ เช่น แอปควบคุมระยะไกล
KNOWN_OVERLAYS แอปที่ติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์กำลังทำงานอยู่ ซึ่งอาจแสดงการวางซ้อนในแอปที่ส่งคำขอ
UNKNOWN_INSTALLED มีการติดตั้งแอปอื่นๆ ซึ่งไม่ได้ติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในพาร์ติชันระบบโดยผู้ผลิตอุปกรณ์
UNKNOWN_CAPTURING แอปอื่นๆ กำลังทำงานอยู่ (ไม่ได้ติดตั้งโดย Google Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์) ซึ่งอาจใช้เพื่ออ่านหรือบันทึกอินพุตและเอาต์พุตของแอปที่ส่งคำขอ เช่น โปรแกรมบันทึกหน้าจอ
UNKNOWN_CONTROLLING แอปอื่นๆ กำลังทำงานอยู่ (ไม่ได้ติดตั้งโดย Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์) ซึ่งอาจใช้เพื่อควบคุมอุปกรณ์ รวมถึงอินพุตและเอาต์พุตของแอปที่ส่งคำขอ เช่น แอปควบคุมระยะไกล
UNKNOWN_OVERLAYS แอปอื่นๆ กำลังทำงานอยู่ (ไม่ได้ติดตั้งโดย Play หรือโหลดไว้ล่วงหน้าในอุปกรณ์) ซึ่งอาจแสดงการวางซ้อนในแอปที่ส่งคำขอ
ว่างเปล่า (ค่าว่าง) ระบบจะไม่ประเมินความเสี่ยงในการเข้าถึงแอปหากไม่เป็นไปตามข้อกําหนดที่จําเป็น ในกรณีนี้ ช่อง appAccessRiskVerdict จะว่างเปล่า ปัญหานี้อาจเกิดขึ้นได้จากหลายสาเหตุ เช่น
  • อุปกรณ์ไม่น่าเชื่อถือพอ
  • รูปแบบของอุปกรณ์ไม่ใช่โทรศัพท์ แท็บเล็ต หรืออุปกรณ์แบบพับได้
  • อุปกรณ์ไม่ได้ใช้ Android 6 (ระดับ API 23) ขึ้นไป
  • Google Play ไม่รู้จักเวอร์ชันของแอปที่ติดตั้งในอุปกรณ์
  • เวอร์ชันของ Google Play Store ในอุปกรณ์ล้าสมัย
  • เกมเท่านั้น: บัญชีผู้ใช้ไม่มีใบอนุญาต Play สำหรับเกม
  • มีการใช้คำขอมาตรฐานกับพารามิเตอร์ verdictOptOut
  • มีการใช้คำขอแบบมาตรฐานกับไลบรารี Play Integrity API เวอร์ชันที่ยังไม่รองรับความเสี่ยงในการเข้าถึงแอปสำหรับคำขอแบบมาตรฐาน
คำตัดสินของ Play Protect NO_ISSUES Play Protect เปิดอยู่และไม่พบปัญหาเกี่ยวกับแอปในอุปกรณ์
NO_DATA Play Protect เปิดอยู่ แต่ยังไม่มีการสแกน อุปกรณ์หรือแอป Play Store อาจเพิ่งได้รับการรีเซ็ตเมื่อเร็วๆ นี้
POSSIBLE_RISK Play Protect ปิดอยู่
MEDIUM_RISK Play Protect เปิดอยู่และพบแอปที่อาจเป็นอันตรายติดตั้งอยู่ในอุปกรณ์
HIGH_RISK Play Protect เปิดอยู่และพบแอปอันตรายที่ติดตั้งในอุปกรณ์
UNEVALUATED ระบบไม่ได้ประเมินคำตัดสินของ Play Protect ไม่เป็นไปตามข้อกําหนดที่จําเป็น เช่น อุปกรณ์ไม่น่าเชื่อถือพอ

กำหนดการตั้งค่าคำขอแบบคลาสสิก (ไม่บังคับ)

ข้ามส่วนนี้หากคุณวางแผนที่จะส่งเฉพาะคำขอ API มาตรฐาน

โดยค่าเริ่มต้น 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. คลิกบันทึกการเปลี่ยนแปลง
ก่อนหน้า
สาธิต
ถัดไป
สร้างคำขอมาตรฐาน