跳转到正文

@capgo/capacitor-device-integrity

借助 Widevine、Play Integrity、App Attest 和 DeviceCheck 获取设备完整性与欺诈信号

借助 Widevine、Play Integrity、App Attest 和 DeviceCheck 获取设备完整性与欺诈信号

从 getCapabilities() 以及下方列出的其他核心方法。

平台支持备注
iOS是原生
Android是原生
Web 端部分支持查看入门指南
  • getCapabilities - 返回当前平台可用的完整性功能。
  • getWidevineFingerprint - 返回基于 Android Widevine 的设备指纹。
  • prepareAttestation - 准备 App Attest 或 Play Integrity 状态,并返回密钥或 provider 句柄。
  • createAttestation - 创建与后端 challenge 绑定的注册证明 token。
  • createAssertion - 创建与后端 payload 绑定的请求断言 token。
  • getDeviceCheckToken - 创建 iOS DeviceCheck token,用于服务端欺诈查询。
方法描述
getCapabilities返回该设备对 Widevine、App Attest、DeviceCheck 和 Play Integrity 的支持情况。
getWidevineFingerprint仅限 Android。返回加盐的 SHA-256 指纹及可选的 Widevine 元数据。
prepareAttestation准备原生证明并返回 keyId 加 format.
createAttestation为后端签发的内容创建注册 token challenge.
createAssertion为后端签发的内容创建断言 token payload.
getDeviceCheckToken仅限 iOS。返回 base64 编码的 DeviceCheck token。

Android Play Integrity 可在 中使用全局 Cloud 项目编号 capacitor.config.ts:

plugins: {
DeviceIntegrity: {
cloudProjectNumber: '123456789012',
},
},

您也可以传入 cloudProjectNumber 改为 prepareAttestation, createAttestation,以及 createAssertion.

此参考文档同步自 src/definitions.ts 中的 capacitor-device-integrity.

如果你正在使用 @capgo/capacitor-device-integrity 来规划安全与合规,请结合 使用 @capgo/capacitor-device-integrity 在“使用 @capgo/capacitor-device-integrity”中,用于原生功能 使用 @capgo/capacitor-app-attest 用于相关的证明流程 @capgo/capacitor-app-attest 关于实现细节, Capgo 安全扫描器 用于 Capgo Security Scanner 中的产品工作流,以及 Capgo 安全 用于 Capgo Security 中的产品工作流。