Play 完整性 API

Last published : Oct 21, 2026
Play Integrity API 有助于保护您的应用和游戏免受潜在的风险和欺诈性交互（例如作弊和未经授权的访问）的影响，从而使您能够采取适当措施来防止攻击并减少滥用。有关详细信息，请参阅 Play Integrity API。
Related information
设备管理

启用 Play 完整性 API

请按照以下步骤切换到 Play Integrity API。
  1. 为指定的 Citrix Endpoint Management 服务器启用 afw.safetynet.attestation.api. 弃用功能标志。
  2. 在 Citrix Endpoint Management 控制台中，从“设置”页面中选择“Android PlayIntegrity”。
    启用 Play 完整性
  3. 在“证明计划”的小时字段中输入一个值。这是 PlayIntegrity 证明 API 评估您设备的时间间隔。最小值为 24 小时，最大值为 1000 小时。默认值为 24 小时。单击“保存”。
  4. 升级到 Citrix Secure Hub Android 版本 23.7.0。从您的设备注销，然后登录 Citrix Secure Hub 以通过 Play Integrity API 触发证明。

查看和分析 Play Integrity API 证明结果

  1. 在 Citrix Endpoint Management 控制台中，转至“管理 > 设备”。
  2. 选择要查看 Play Integrity API 证明结果的设备。单击“显示更多”。
  3. 在“设备”选项卡中，选择“属性”。结果将显示在“安全信息”部分中。
    分析 Play 完整性
  4. Play Integrity API 证明返回以下状态：
    • 如果 PlayIntegrity Device Recognition Verdict 字段为 “MEETS_BASIC_INTEGRITY”，则表示设备上运行的 Citrix Secure Hub 至少通过了基本的系统完整性检查。
    • 如果 PlayIntegrity Device Recognition Verdict 字段不为 “MEETS_BASIC_INTEGRITY”，则表示设备上的 Citrix Secure Hub 可能在未经识别的 Android 版本上运行，可能具有已解锁的引导加载程序，或者可能未经制造商认证。
    • 如果 PlayIntegrity last known status 为 Success，则表示 PlayIntegrity API 证明已成功运行。
    • 如果 PlayIntegrity last known status 为 Failure，则表示 PlayIntegrity API 证明未能运行。
注意：
在 SafetyNet Attestation 最终关闭（2023 年 11 月底）之前，管理员可以清除允许您使用 SafetyNet 的功能标志。

限制

  1. 新注册的 COSU 设备和 DO 设备被标记为不合规，即使设备是合规的。
    在 DO 注册期间，Play Integrity API 首次证明返回空值，这使得设备看起来不合规。此限制是 Google 的一个已知问题。DPC Support Lib 20230418 已发布以修复此问题。
    该修复程序从 23.9.0 版本开始可用。在此之前，请使用以下步骤作为解决方法：
    • 清除功能标志，并继续使用 SafetyNet API 以继续使用 SafetyNet Attestation API。
    • 注销并重新登录以在注册后触发证明。您也可以等待下一次定期证明，默认为 24 小时。
    此问题仅在注册期间发生。注册后，Play Integrity API 运行良好。
  2. 新注册的 WPCOD 设备被标记为不合规，即使设备是合规的。Google 正在审查此问题。