@capgo/capacitor-device-integrity

概览

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

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

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	部分支持	查看入门指南

核心功能

• getCapabilities - 返回当前平台可用的完整性功能。
• getWidevineFingerprint - 返回基于 Android Widevine 的设备指纹。
• prepareAttestation - 准备 App Attest 或 Play Integrity 状态，并返回密钥或 provider 句柄。
• createAttestation - 创建与后端 challenge 绑定的注册证明 (attestation) token。
• createAssertion - 创建与后端 payload 绑定的请求断言 (assertion) token。
• getDeviceCheckToken - 创建用于服务端欺诈查询的 iOS DeviceCheck token。

公开 API

方法	描述
getCapabilities	返回该设备支持的 Widevine、App Attest、DeviceCheck 和 Play Integrity。
getWidevineFingerprint	仅限 Android。返回加盐的 SHA-256 指纹及可选的 Widevine 元数据。
prepareAttestation	准备原生证明 (native attestation) 并返回 keyId 加 format.
createAttestation	为后端签发的注册请求创建 token challenge.
createAssertion	为后端签发的断言令牌 (assertion token) 创建 payload.
getDeviceCheckToken	仅限 iOS。返回 base64 格式的 DeviceCheck 令牌。

配置

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-device-integrity 中的原生能力， 使用 @capgo/capacitor-app-attest 用于相关的证明流程， @capgo/capacitor-app-attest 有关实现细节， Capgo 安全扫描器 用于 Capgo Security Scanner 中的产品工作流，以及 Capgo 安全 用于 Capgo Security 中的产品工作流。