Thiết lập

Trang này giải thích cách thiết lập ứng dụng, trò chơi hoặc SDK để sử dụng API Tính toàn vẹn của Play. Để tích hợp API, bạn phải có một dự án Google Cloud. Đây là điều kiện cần thiết để bắt đầu đưa ra yêu cầu. Sau đó, bạn có thể liên kết dự án trên Google Cloud trong Google Play Console (đối với ứng dụng) hoặc Google Play SDK Console (đối với SDK). Bạn cần liên kết dự án của mình để sử dụng các lựa chọn cấu hình, tính năng kiểm thử, báo cáo API bổ sung và để yêu cầu tăng hạn mức yêu cầu hằng ngày.

Bật Play Integrity API

Mọi ứng dụng hoặc SDK gọi API Tính toàn vẹn của Play đều phải có một dự án Google Cloud để sử dụng API và giám sát mức sử dụng. Đây là bước đầu tiên bắt buộc đối với mọi quy trình tích hợp. Bạn có thể bật Play Integrity API trong Google Cloud Console hoặc có thể bỏ qua trực tiếp để liên kết dự án trên đám mây của bạn với Google Play và Play Integrity API sẽ được bật cho bạn.

Trong Google Cloud Console, hãy tạo một dự án trên đám mây mới hoặc chọn một dự án trên đám mây hiện có bạn muốn sử dụng cùng với Play Integrity API.

  1. Chuyển đến phần API và dịch vụ.
  2. Chọn Bật API và dịch vụ.
  3. Tìm kiếm Play Integrity API (API Tính toàn vẹn của Play).
  4. Nhấp vào Bật.

Lúc này, bạn có thể tích hợp Play Integrity API vào ứng dụng. Để sử dụng các tính năng nâng cao và tăng hạn mức, bạn phải chuyển sang bước liên kết.

Liên kết với Google Play (nên dùng)

Bạn có thể liên kết dự án Google Cloud với ứng dụng hoặc SDK của mình theo hướng dẫn này.

Đối với ứng dụng và trò chơi trên Google Play

Các ứng dụng được phân phối trên Google Play nên liên kết dự án Google Cloud của họ trong Google Play Console để bật các tính năng bổ sung và yêu cầu tăng hạn mức API hằng ngày.

  1. Mở Google Play Console rồi chọn ứng dụng của bạn.
  2. Chuyển đến trang Được bảo vệ bằng Play.
  3. Bên cạnh Play Integrity API, hãy chọn nút Bắt đầu để chuyển đến Chế độ cài đặt Play Integrity API.
  4. Nhấp vào nút Liên kết dự án trên đám mây.
  5. Chọn dự án trên Google Cloud mà bạn dự định sử dụng với Play Integrity API. Nếu Play Integrity API chưa được bật cho dự án, thì API này sẽ tự động được bật khi liên kết.

Dành cho nhà cung cấp SDK trên Play SDK Console

Nhà cung cấp SDK sử dụng Google Play SDK Console có thể liên kết dự án trên đám mây của họ để phân bổ mức sử dụng API cho SDK thay vì cho từng ứng dụng sử dụng SDK đó, bật các tính năng bổ sung và yêu cầu tăng hạn mức API hằng ngày. Xin lưu ý rằng quyền truy cập vào Google Play SDK Console phải tuân theo tiêu chí đủ điều kiện.

  1. Mở Google Play SDK Console rồi chọn SDK của bạn.
  2. Chuyển đến phần Tính toàn vẹn của SDK
  3. Trong API Tính toàn vẹn của Play, hãy nhấp vào Liên kết với một dự án Google Cloud.
  4. Chọn dự án trên đám mây của Google Cloud mà bạn dự định sử dụng với Play Integrity API; nếu Play Integrity API chưa được bật cho dự án, thì API này sẽ tự động được bật khi liên kết.

Tìm hiểu hạn mức sử dụng Play Integrity API

Ứng dụng hoặc SDK của bạn có giới hạn mặc định hằng ngày là tổng cộng 10.000 yêu cầu, gắn liền với Số dự án trên Cloud được liên kết. Nếu dự đoán mức sử dụng sẽ cao hơn, bạn có thể yêu cầu tăng hạn mức.

Hành động Hạn mức hằng ngày Ghi chú
Yêu cầu mã thông báo 10.000 Được chia sẻ giữa yêu cầu kiểu cũ và quy trình chuẩn bị mã thông báo chuẩn
Giải mã mã thông báo trên máy chủ của Google 10.000 Được chia sẻ giữa yêu cầu kiểu cũ và yêu cầu thông thường

Tăng mức tối đa hằng ngày cho số lượng yêu cầu

Việc tăng hạn mức phụ thuộc vào các tiêu chí đủ điều kiện. Mức tăng hạn mức áp dụng cho cả lệnh gọi tạo mã thông báo phía máy khách và lệnh gọi giải mã phía máy chủ. Quá trình xử lý yêu cầu có thể mất đến một tuần. Bạn nên theo dõi mức sử dụng API Tính toàn vẹn của Play trong Google Cloud Console và thiết lập cảnh báo hạn mức để tránh bị gián đoạn dịch vụ.

Ngay cả khi có hạn mức cao hơn, hãy tiếp tục giới hạn các yêu cầu kiểu cũ đối với các hành động không thường xuyên và có giá trị cao để duy trì mức sử dụng pin và dữ liệu của người dùng.

Đối với ứng dụng và trò chơi trên Google Play

Để đủ điều kiện tăng hạn mức, thì ngoài các kênh phân phối khác, ứng dụng của bạn phải có mặt trên Google Play. Bạn phải liên kết dự án Google Cloud với ứng dụng của mình trong Play Console. Yêu cầu về hạn mức từ các dự án chưa liên kết sẽ bị từ chối.

Cách yêu cầu tăng hạn mức:

  1. Liên kết dự án trên đám mây của Google Cloud có liên quan trong Play Console.
  2. Xác minh rằng bạn đã triển khai chính xác logic API, bao gồm cả chiến lược thử lại phù hợp.
  3. Gửi biểu mẫu yêu cầu tăng hạn mức.

Dành cho nhà cung cấp SDK trên Play SDK Console

Để đủ điều kiện được tăng hạn mức, SDK của bạn phải được xác nhận quyền sở hữu trên Google Play SDK Console và dự án trên đám mây của bạn phải được liên kết với SDK của bạn tại đó. Quyền truy cập vào Google Play SDK Console phải tuân theo tiêu chí đủ điều kiện.

Cách yêu cầu tăng hạn mức:

  1. Liên kết dự án trên đám mây của bạn trong Google Play SDK Console.
  2. Hoàn tất biểu mẫu hỗ trợ nhà phát triển.

Trong phần nhận xét chưa giải quyết, hãy cung cấp thông tin chi tiết về SDK, mô tả trường hợp sử dụng, loại yêu cầu API mà bạn đang thực hiện (tiêu chuẩn, cổ điển hoặc cả hai), tần suất bạn thực hiện yêu cầu và số lượng yêu cầu tối đa hằng ngày mà bạn muốn.

Tích hợp API Tính toàn vẹn của Play vào ứng dụng

Để tích hợp API Tính toàn vẹn của Play vào ứng dụng hoặc SDK, tuỳ vào môi trường phát triển, hãy thực hiện một trong những cách sau đây:

Kotlin hoặc Java

Thư viện Android mới nhất cho Play Integrity API hiện có trong Kho lưu trữ Maven của Google. Thêm phần phụ thuộc sau vào tệp build.gradle của ứng dụng:

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

Unity

Các phần sau đây mô tả cách tích hợp và thiết lập API Tính toàn vẹn của Google Play cho các dự án Unity, bao gồm cả các phiên bản Unity được hỗ trợ, phương thức cài đặt và cách thiết lập môi trường.

Các phiên bản Unity được hỗ trợ

  • Mọi phiên bản 2019.x, 2020.x trở lên đều được hỗ trợ.
  • Nếu bạn sử dụng Unity 2018.x, thì phiên bản 2018.4 trở lên sẽ được hỗ trợ.
  • Phiên bản 2017.x trở xuống không được hỗ trợ.

Thiết lập môi trường phát triển

OpenUPM-CLI

Nếu đã cài đặt OpenUPM CLI, bạn có thể cài đặt sổ đăng ký OpenUPM bằng lệnh sau:

openupm add com.google.play.integrity

OpenUPM

  1. Mở package manager settings (cài đặt trình quản lý gói) bằng cách chọn mục Edit > Project Settings > Package Manager (Chỉnh sửa > Cài đặt dự án > Trình quản lý gói) trong trình đơn Unity.

  2. Thêm OpenUPM làm sổ đăng ký trong phạm vi vào cửa sổ Trình quản lý gói:

    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. Mở trình đơn trình quản lý gói bằng cách chọn mục Window > Package Manager (Cửa sổ > Trình quản lý gói) trong trình đơn Unity.

  4. Đặt trình đơn thả xuống phạm vi của trình quản lý để chọn My Registries (Sổ đăng ký của tôi).

  5. Chọn gói Trình bổ trợ Google Play Integrity cho Unity trong danh sách gói rồi nhấn vào Install (Cài đặt).

Nhập từ GitHub

  1. Tải bản phát hành .unitypackage mới nhất xuống từ GitHub.

  2. Nhập tệp .unitypackage bằng cách chọn mục trong trình đơn Unity Assets > Import package > Custom Package (Nội dung > Nhập gói > Tuỳ chỉnh gói) và nhập tất cả các mục.

Unreal Engine

Các phần sau đây mô tả cách tích hợp và thiết lập API Tính toàn vẹn của Google Play cho các dự án Unreal Engine.

Các phiên bản Unreal Engine được hỗ trợ

Trình bổ trợ này hỗ trợ Unreal Engine 5.0 và tất cả các phiên bản tiếp theo.

Thiết lập môi trường phát triển

  1. Tải Trình bổ trợ Play Unreal Engine xuống từ kho lưu trữ GitHub.

  2. Sao chép thư mục GooglePlay vào thư mục Plugins trong dự án Unreal Engine.

  3. Mở dự án Unreal Engine rồi nhấp vào Edit → Plugins (Chỉnh sửa → Trình bổ trợ).

  4. Tìm Google Play rồi đánh dấu vào hộp Đã bật.

  5. Khởi động lại dự án trò chơi và kích hoạt một bản dựng.

  6. Mở tệp Build.cs của dự án rồi thêm mô-đun PlayIntegrity vào PublicDependencyModuleNames:

    using UnrealBuildTool;
    
    public class MyGame : ModuleRules
    {
      public MyGame(ReadOnlyTargetRules Target) : base(Target)
      {
        // ...
    
        PublicDependencyModuleNames.Add("PlayIntegrity");
    
        // ...
      }
    }
    

Mã gốc

Làm theo hướng dẫn thiết lập quảng cáo gốc. Để biết thêm thông tin, hãy xem tài liệu tham khảo API gốc của Play Integrity.

Định cấu hình tính năng phản hồi của API (không bắt buộc)

Phản hồi của API bao gồm các kết quả mặc định được trả về trong mỗi yêu cầu. Nếu đã liên kết dự án trên đám mây trong Play Console hoặc Play SDK Console, thì bạn có thể tuỳ chỉnh phản hồi của API để thêm thông tin bổ sung.

Kết quả mặc định về tính toàn vẹn

Theo mặc định, các kết quả về tính toàn vẹn sau đây được trả về trong phản hồi của API Tính toàn vẹn của Play:

Trường phản hồi Giá trị Mô tả
Thông tin tài khoản Play LICENSED Người dùng có quyền sử dụng ứng dụng. Nói cách khác, người dùng đã cài đặt hoặc cập nhật ứng dụng của bạn từ Google Play trên thiết bị của họ.
UNLICENSED Người dùng không có quyền sử dụng ứng dụng. Chẳng hạn như khi người dùng cài đặt ứng dụng của bạn không qua cửa hàng ứng dụng hoặc có được ứng dụng thông qua một bên khác không phải là Google Play.
UNEVALUATED Thông tin cấp phép chưa được đánh giá vì thiếu một yêu cầu. Điều này có thể xảy ra vì một vài lý do như sau:
  • Thiết bị không đủ tin cậy.
  • Người dùng chưa đăng nhập vào Google Play.
  • Google Play không xác định được phiên bản ứng dụng của bạn đã cài đặt trên thiết bị.
Tính toàn vẹn của ứng dụng PLAY_RECOGNIZED Ứng dụng và chứng chỉ khớp với các phiên bản do Google Play phân phối.
UNRECOGNIZED_VERSION Chứng chỉ hoặc tên gói không khớp với bản ghi của Google Play.
UNEVALUATED Tính toàn vẹn của ứng dụng chưa được đánh giá. Thiếu một yêu cầu cần thiết, chẳng hạn như thiết bị không đủ tin cậy.
Tính toàn vẹn của thiết bị MEETS_DEVICE_INTEGRITY Ứng dụng đang chạy trên một thiết bị Android chính hãng và được chứng nhận. Trên Android 13 trở lên, có bằng chứng dựa trên phần cứng cho thấy trình tải khởi động của thiết bị đã bị khoá và hệ điều hành Android được tải là hình ảnh của nhà sản xuất thiết bị được chứng nhận.
Trống (giá trị trống) Ứng dụng đang chạy trên một thiết bị có dấu hiệu bị tấn công (chẳng hạn như hook API) hoặc bị xâm phạm hệ thống (chẳng hạn như đã bị can thiệp vào hệ thống) hoặc ứng dụng không chạy trên thiết bị thực tế (chẳng hạn như trình mô phỏng không vượt qua được quy trình kiểm tra tính toàn vẹn của Google Play).

Google Play Games dành cho máy tính

Nếu phân phối tới Google Play Games dành cho máy tính, thì bạn sẽ tự động chọn nhận một nhãn bổ sung trong kết quả về tính toàn vẹn của thiết bị:

Trường phản hồi Nhãn Phần mô tả
Tính toàn vẹn của thiết bị MEETS_VIRTUAL_INTEGRITY Ứng dụng này đang chạy trên một trình mô phỏng Android sử dụng các dịch vụ Google Play. Trình mô phỏng này vượt qua quy trình kiểm tra tính toàn vẹn của hệ thống và đáp ứng các yêu cầu chính về khả năng tương thích với Android.

Kết quả không bắt buộc về tính toàn vẹn

Nếu đã liên kết dự án trên đám mây trong Play Console hoặc Play SDK Console, thì bạn có thể chọn nhận thêm thông tin.

Để thay đổi, hãy truy cập Play Console rồi chuyển đến phần Được bảo vệ bằng Play. Bên cạnh Play Integrity API, hãy nhấp vào Quản lý. Nhấp vào Thay đổi phản hồi, chỉnh sửa rồi lưu các thay đổi.

Thông tin thiết bị

Nhãn thiết bị bổ sung trong kết quả deviceIntegrity cho bạn biết thêm về môi trường thiết bị mà ứng dụng đang chạy. Một thiết bị sẽ trả về nhiều nhãn nếu đáp ứng tiêu chí cho từng nhãn. Bạn có thể sử dụng các nhãn này để tạo chiến lược thực thi theo cấp. Ví dụ: bạn có thể chọn tin tưởng một thiết bị trả về 3 nhãn (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY và MEETS_BASIC_INTEGRITY) hơn so với một thiết bị chỉ trả về một nhãn (MEETS_BASIC_INTEGRITY).

Thuộc tính thiết bị cho bạn biết phiên bản SDK Android của hệ điều hành Android trên thiết bị. Trong tương lai, thuộc tính này có thể được mở rộng với các thuộc tính thiết bị khác.

Hoạt động gần đây trên thiết bị trả về một cấp độ từ LEVEL_1 (số lượng yêu cầu ít) đến LEVEL_4 (số lượng yêu cầu lớn). Cấp độ hoạt động cao có thể cho biết một thiết bị đang được dùng để tạo quá nhiều mã thông báo nhằm phân phối sai trái cho các thiết bị không đáng tin cậy.

Tính năng ghi nhớ thiết bị cho phép bạn lưu trữ một số dữ liệu tuỳ chỉnh trên từng thiết bị với các thiết bị cụ thể mà bạn có thể truy xuất một cách đáng tin cậy khi ứng dụng được cài đặt lại sau này trên cùng một thiết bị.

Sau khi bạn chọn nhận thông tin không bắt buộc, phản hồi của API sẽ bao gồm các trường và phản hồi mới trong kết quả:

Trường phản hồi Nhãn Phần mô tả
Tính toàn vẹn của thiết bị MEETS_BASIC_INTEGRITY Ứng dụng này đang chạy trên một thiết bị đã vượt qua quy trình kiểm tra cơ bản về tính toàn vẹn của hệ thống. Trình tải khởi động của thiết bị có thể bị khoá hoặc mở khoá, và trạng thái khởi động có thể là đã xác minh hoặc chưa xác minh. Thiết bị có thể chưa được chứng nhận, trong trường hợp đó, Google không thể đảm bảo về tính bảo mật, quyền riêng tư hoặc khả năng tương thích của ứng dụng. Trên Android 13 trở lên, kết quả MEETS_BASIC_INTEGRITY yêu cầu Google cung cấp gốc tin cậy của chứng thực.
MEETS_STRONG_INTEGRITY Ứng dụng này đang chạy trên một thiết bị Android chính hãng và được chứng nhận, có bản cập nhật bảo mật gần đây.
  • Trên Android 13 trở lên, MEETS_STRONG_INTEGRITY kết luận yêu cầu MEETS_DEVICE_INTEGRITY và các bản cập nhật bảo mật trong năm qua cho tất cả phân vùng của thiết bị, bao gồm cả bản vá phân vùng Hệ điều hành Android và bản vá phân vùng của nhà cung cấp.
  • Trên Android 12 trở xuống, kết quả MEETS_STRONG_INTEGRITY chỉ yêu cầu bằng chứng dựa trên phần cứng về tính toàn vẹn khi khởi động và không yêu cầu thiết bị phải có bản cập nhật bảo mật gần đây. Do đó, khi sử dụng MEETS_STRONG_INTEGRITY, bạn cũng nên tính đến phiên bản SDK Android trong trường deviceAttributes.
Thuộc tính thiết bị sdkVersion: 19, 20, ..., 37 Phiên bản SDK của hệ điều hành Android đang chạy trên thiết bị. Số được trả về liên kết với Build.VERSION_CODES.
Trống (giá trị trống) Phiên bản SDK không được đánh giá vì thiếu một yêu cầu cần thiết. Trong trường hợp này, trường sdkVersion không được đặt; do đó, trường deviceAttributes trống. Điều này có thể là do:
  • Thiết bị không đủ tin cậy.
  • Có vấn đề kỹ thuật trên thiết bị.
Yêu cầu mã thông báo về tính toàn vẹn của API tiêu chuẩn trên thiết bị này trong 1 giờ qua cho mỗi ứng dụng Yêu cầu mã thông báo về tính toàn vẹn của API kiểu cũ trên thiết bị này trong 1 giờ qua cho mỗi ứng dụng
Hoạt động gần đây trên thiết bị LEVEL_1 (thấp nhất) 10 video trở xuống 5 hoặc ít hơn
LEVEL_2 Từ 11 đến 25 Từ 6 đến 10
LEVEL_3 Từ 26 đến 50 Từ 11 đến 15 tuổi
LEVEL_4 (cao nhất) Hơn 50 Hơn 15
UNEVALUATED Hoạt động gần đây trên thiết bị chưa được đánh giá. Điều này có thể xảy ra vì:
  • Thiết bị không đủ tin cậy.
  • Google Play không xác định được phiên bản ứng dụng của bạn đã cài đặt trên thiết bị.
  • Có vấn đề kỹ thuật trên thiết bị.
Ghi nhớ thiết bị values: bitFirst, bitSecond, bitThird Đây là các giá trị bit mà bạn đã đặt trước đây cho thiết bị cụ thể. Bạn quyết định ý nghĩa của từng bit. Ba giá trị bit này có giá trị mặc định là false.
writeDates: yyyymmFirst, yyyymmSecond, yyyymmThird Đây là ngày ghi giá trị bit theo giờ UTC, chính xác đến năm và tháng. Ngày ghi của bit thu hồi được cập nhật mỗi khi bit được đặt thành true và bị xoá khi bit được đặt thành false.

Thông tin chi tiết về môi trường

Tính năng đánh giá rủi ro truy cập ứng dụng cho bạn biết liệu có ứng dụng nào khác đang chạy có thể được dùng để chụp màn hình, hiển thị lớp phủ hoặc điều khiển thiết bị hay không. Các dịch vụ hỗ trợ tiếp cận đã xác minh mà Google Play biết sẽ tự động được loại trừ khỏi kết quả này.

Kết quả đánh giá của Play Protect cho bạn biết liệu Google Play Protect có được bật trên thiết bị hay không và liệu dịch vụ này có phát hiện thấy phần mềm độc hại đã biết hay không.

Sau khi bạn chọn nhận thông tin không bắt buộc, phản hồi của API sẽ bao gồm các trường và phản hồi mới trong kết quả:

Trường phản hồi Giá trị Mô tả
Kết quả đánh giá rủi ro truy cập ứng dụng KNOWN_INSTALLED Các ứng dụng do Google Play cài đặt hoặc do nhà sản xuất thiết bị tải trước lên phân vùng hệ thống.
KNOWN_CAPTURING Các ứng dụng do Google Play cài đặt hoặc được tải trước trên thiết bị đang chạy có thể dùng để đọc hoặc ghi lại dữ liệu đầu vào và đầu ra của ứng dụng yêu cầu, chẳng hạn như các trình ghi màn hình.
KNOWN_CONTROLLING Các ứng dụng do Google Play cài đặt hoặc được tải trước trên thiết bị đang chạy có thể dùng để điều khiển thiết bị cũng như đầu vào và đầu ra của ứng dụng yêu cầu, chẳng hạn như các ứng dụng điều khiển từ xa.
KNOWN_OVERLAYS Các ứng dụng do Google Play cài đặt hoặc được tải trước trên thiết bị đang chạy có thể hiển thị lớp phủ trên ứng dụng yêu cầu.
UNKNOWN_INSTALLED Các ứng dụng khác đã được cài đặt. Đây là những ứng dụng không phải do Google Play cài đặt hoặc không phải do nhà sản xuất thiết bị tải trước lên phân vùng hệ thống.
UNKNOWN_CAPTURING Các ứng dụng khác đang chạy (không phải do Play cài đặt hoặc không được tải trước trên thiết bị) có thể dùng để đọc hoặc ghi lại dữ liệu đầu vào và đầu ra của ứng dụng yêu cầu, chẳng hạn như các trình ghi màn hình.
UNKNOWN_CONTROLLING Các ứng dụng khác đang chạy (không phải do Play cài đặt hoặc không được tải trước trên thiết bị) có thể dùng để điều khiển thiết bị cũng như đầu vào và đầu ra của ứng dụng yêu cầu, chẳng hạn như các ứng dụng điều khiển từ xa.
UNKNOWN_OVERLAYS Các ứng dụng khác đang chạy (không phải do Play cài đặt hoặc không được tải trước trên thiết bị) có thể đang hiển thị lớp phủ trên ứng dụng yêu cầu.
Trống (giá trị trống) Rủi ro truy cập ứng dụng sẽ không được đánh giá nếu thiếu một yêu cầu cần thiết. Trong trường hợp này, trường appAccessRiskVerdict sẽ trống. Điều này có thể xảy ra vì một vài lý do như sau:
  • Thiết bị không đủ tin cậy.
  • Kiểu dáng thiết bị không phải là điện thoại, máy tính bảng hoặc thiết bị có thể gập lại.
  • Thiết bị không chạy Android 6 (cấp độ API 23) trở lên.
  • Google Play không xác định được phiên bản ứng dụng của bạn trên thiết bị đó.
  • Phiên bản Cửa hàng Google Play trên thiết bị đã lỗi thời.
  • Chỉ dành cho trò chơi: Tài khoản người dùng không có giấy phép Play cho trò chơi.
  • Một yêu cầu chuẩn đã được sử dụng với tham số verdictOptOut.
  • Một yêu cầu thông thường đã được sử dụng với phiên bản thư viện API Tính toàn vẹn của Play chưa hỗ trợ tính năng đánh giá rủi ro truy cập ứng dụng cho các yêu cầu thông thường.
Kết quả xác minh của Play Protect NO_ISSUES Play Protect đã bật và không phát hiện thấy bất kỳ vấn đề nào về ứng dụng trên thiết bị.
NO_DATA Play Protect đã bật nhưng chưa quét. Thiết bị hoặc ứng dụng Cửa hàng Play gần đây có thể đã được đặt lại.
POSSIBLE_RISK Play Protect đã bị tắt.
MEDIUM_RISK Play Protect đã bật và phát hiện thấy các ứng dụng có khả năng gây hại được cài đặt trên thiết bị này.
HIGH_RISK Play Protect đã bật và phát hiện thấy các ứng dụng nguy hiểm được cài đặt trên thiết bị này.
UNEVALUATED Kết quả xác minh của Play Protect chưa được đánh giá. Thiếu một yêu cầu cần thiết, chẳng hạn như thiết bị không đủ tin cậy.

Định cấu hình chế độ cài đặt cho yêu cầu kiểu cũ (không bắt buộc)

Hãy bỏ qua phần này nếu bạn chỉ định thực hiện các yêu cầu API thông thường.

Theo mặc định, Google Play quản lý quy trình mã hoá phản hồi, tức là phần phụ trợ của bạn sẽ gọi máy chủ của Google để giải mã kết quả. Ngoài ra, bạn có thể tự quản lý khoá để giải mã cục bộ trong môi trường máy chủ bảo mật của mình.

Cho phép Google quản lý quy trình mã hoá phản hồi của bạn (nên dùng)

Bạn nên cho phép Google tạo và quản lý khoá để bảo vệ ứng dụng của bạn. Phần phụ trợ của bạn sẽ gọi máy chủ của Google Play để giải mã và xác minh phản hồi.

Quản lý khoá mã hoá của riêng bạn

Để giải mã cục bộ trong môi trường máy chủ bảo mật của riêng mình, bạn có thể tải khoá mã hoá xuống từ Play Console hoặc Play SDK Console. Ứng dụng của bạn phải có trên Google Play thì bạn mới có thể sử dụng tính năng này.

Trước khi bạn thay đổi chiến lược quản lý mã hoá phản hồi trong Play Console, hãy đảm bảo rằng máy chủ của bạn được định cấu hình chính xác để giải mã và xác minh mã thông báo tính toàn vẹn trên các máy chủ của Google Play nhằm tránh bị gián đoạn.

Chuyển đổi giữa khoá mã hoá do Google quản lý và khoá mã hoá tự quản lý

  1. Mở Play Console rồi chọn ứng dụng của bạn .
  2. Chuyển đến trang Được bảo vệ bằng Play.
  3. Bên cạnh Play Integrity API, hãy nhấp vào Quản lý.
  4. Trong phần Yêu cầu kiểu cũ, bên cạnh Mã hoá phản hồi, hãy nhấp vào Chỉnh sửa.

Cách chuyển sang khoá tự quản lý:

  1. Chọn Quản lý và tải khoá mã hoá phản hồi của tôi xuống rồi tải khoá công khai của bạn lên.
  2. Nhấp vào Lưu để tự động tải các khoá mã hoá xuống.
  3. Cập nhật máy chủ phụ trợ bảo mật để giải mã cục bộ bằng các khoá này.

Cách chuyển sang khoá do Google quản lý:

  1. Chọn Cho phép Google quản lý quy trình mã hoá phản hồi của tôi (nên chọn).
  2. Nhấp vào Lưu thay đổi.