关于 SafetyNet Attestation API 的弃用

Google 最近宣布了 Play Integrity API,该 API 将多个完整性服务(包括 SafetyNet Attestation 完整性结果)整合到单个 API 中。

我们计划从 2024 年 1 月开始逐步停用 SafetyNet Attestation API。我们已延长了时间表,为您迁移到新的 Play Integrity API 并避免业务中断提供足够的时间。

Play Integrity API 包含 SafetyNet Attestation 提供的所有完整性信号以及更多功能,例如 Google Play 用户许可和更好的错误消息。新 API 以面向未来的方式设计,因此您可以轻松获得新功能,而升级所需的构建时间很少。

SafetyNet Attestation 弃用时间表

日期 里程碑 这对您意味着什么?
2022 年 6 月 公告 您应尽快开始集成 Play Integrity API。同时,SafetyNet Attestation 将继续为您的应用工作。
2022 年 11 月 弃用信息字段 已将 `deprecationInformation` 字段添加到 SafetyNet Attestation 响应中。它包含有关弃用的开发者信息。
2023 年 1 月 新的开发者注册结束 2023 年 1 月 31 日之后,新用户将无法再注册 SafetyNet Attestation API。这包括通过 SDK 注册的新开发者。
2024 年 1 月底 迁移截止日期(时间表已延长) 如果您已迁移到 Play Integrity API,SafetyNet Attestation 将继续在您应用的旧版本上运行。您仍然可以使用旧版本应用检测有风险的互动。如果您尚未迁移,SafetyNet Attestation 将不再为您的应用(包括旧版本)工作,并将返回错误。如果您的应用在生产环境中调用 Play Integrity API,我们将认为您已迁移。
2025 年 1 月底 完全停用(时间表已延长) SafetyNet Attestation 将不再适用于您应用的任何版本。您的应用将收到错误。

设置您的应用以使用 Play Integrity API

我们建议您在弃用时间表的第一个年度迁移到 Play Integrity API,以避免在检测与您的应用相关的有风险互动和打击滥用方面出现任何中断。

这两个 API 在概念上是相似的,因此,如果您已经定义了反滥用策略并且已经使用 SafetyNet Attestation,则迁移非常简单。您可以按照 迁移指南开始设置 通过您的 Play Console 设置 Play Integrity API。

如果您不是通过 Google Play 发布应用,您仍然可以通过 Google Cloud Console 使用 Play Integrity API,而无需创建 Play 开发者帐号或在 Google Play Console 中发布版本,方法是按照以下 步骤 操作。

弃用信息字段

SafetyNet Attestation 团队已将新字段 deprecationInformation 添加到 SafetyNet Attestation 响应中。该字段包含有关弃用的信息,以提醒开发者迁移到新的 Play Integrity API。它还包含有关您的应用迁移状态的信息。对于已迁移的应用,它将显示“应用已列入允许使用 SafetyNet Attestation API 的名单,直到完全停用”。

完全停用

SafetyNet Attestation API 将从 2025 年 1 月 31 日起逐步停止服务。 attest API 返回的任务将始终调用 失败监听器,并返回 ApiException状态码 的值为 7 (NETWORK_ERROR)。已发布使用 Play Integrity API 的应用版本的开发者应指导用户更新其应用。

获取帮助和分享反馈

我们将确保您顺利迁移。如果您有任何问题,请访问 Play Console 帮助中心

我们也希望听到您对构建更完善的完整性服务的意见,因此请在您的 Play Console 中分享功能请求和反馈。为此,请点击 Play Console 右上角的问号图标,然后点击下拉菜单中的“发送反馈”。

在完全停止服务前接收响应

如果您尚未迁移到 Play Integrity API 或在迁移截止日期 (2024 年 1 月 31 日) 前移除 SafetyNet Attestation,您可以填写 此表格 以申请延期。如果延期申请获批,您的应用将继续接收来自 SafetyNet Attestation 的响应,直到完全停止服务的截止日期 (2025 年 1 月 31 日)。