@ capgo/ 电容- device- 整齐

在您的 Capacitor app 中收集设备完整性和欺诈信号: 在 Android , App Attest 和 iOS 上的设备检查上播放完整性和威德文指纹. 您的后端可以验证证明和设备检查符并使用威德文指纹作为风险信号.

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-device-integrity 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 加入@capgo/capor-device-integrity 到我的Capacitor app,并把它接上。" 代理设置指南 • 妇女 主机磁共振

主要特点

• 证明数字 : prepareAttestation() 准备土生土长的证明,然后 createAttestation() 从您的后端创建一个与挑战相关的符号 .
• 要求的断言数字 : createAssertion() 签署服务器侧检查请求的有效载荷.
• 宽度指纹数字 : getWidevineFingerprint() 返回稳定的Android DRM衍生的ID.
• 设备检查数字 : getDeviceCheckToken() 为欺诈状态检查创建 iOS 令牌 .
• 能力数字 : getCapabilities() 报告当前平台所支持的内容.
• 平台: iOS和Android. 互联网档案馆的存檔,存档日期2013-12-21. 在网上不可用.

Capacitor 的设备完整性和欺诈信号 :

• Android: Widevine DRM指纹和Play完整性标准API验证.
• iOS: App App Attest and Device Check. (原始内容存档于2018-09-29).
• Web: 不支持的后退报告没有本地能力.

安保模式

这个插件是为了发现欺诈和滥用行为而设计的. 它本身并不使客户端的价值观值得信赖.

• 在您的后端验证 App Attest 并播放完整性标志 .
• 将 Widevine 值视为敏感的标识符 .
• 在您的隐私政策中披露标识符的使用 .
• 不使用Android Widevine值进行广告或交叉应用跟踪.
• 不要尝试iOS指纹. 苹果公司不为这个使用案例提供公共审查安全的稳定设备ID.

兼容性

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-device-integrity` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-device-integrity
npx cap sync

平台设置

机器人

宽宽指纹不需要额外权限.

Play Google Play 需要 Google Play 服务和一个 Cloud 项目编号:

// capacitor.config.ts
plugins: {
  DeviceIntegrity: {
    cloudProjectNumber: '123456789012'
  }
}

也可以通过 cloudProjectNumber 直接到证明方法.

iOS系统

启用 Xcode 中的 App Attest 能力 :

1. 打开你的应用目标.
2. 转到签名能力( C) .
3. 添加 App Attest 选项 .
4. 验证真实的 App Attest 和 Device 行为时对物理设备进行测试 .

使用量

import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';

const capabilities = await DeviceIntegrity.getCapabilities();

if (capabilities.platform === 'android' && capabilities.widevine.fingerprintAvailable) {
  const widevine = await DeviceIntegrity.getWidevineFingerprint();
  await api.saveDeviceSignal({
    widevineIdSha256: widevine.widevineIdSha256,
    fingerprint: widevine.fingerprint,
    securityLevel: widevine.securityLevel,
  });
}

if (capabilities.appAttest.supported || capabilities.playIntegrity.supported) {
  const prepared = await DeviceIntegrity.prepareAttestation();
  const challenge = await api.createDeviceChallenge();

  const attestation = await DeviceIntegrity.createAttestation({
    keyId: prepared.keyId,
    challenge,
  });

  await api.verifyDeviceAttestation(attestation);
}

if (capabilities.deviceCheck.supported) {
  const deviceCheck = await DeviceIntegrity.getDeviceCheckToken();
  await api.verifyDeviceCheckToken(deviceCheck.token);
}

后端处理

仅在服务器侧面检查后将平台特定证据存储到用户记录中 :

• Android Widevine: 存储器 widevineIdSha256 生的,可以随意选择 widevineIdBase64 只有在你明确需要的时候.
• Android Play Guide:用Google的服务器API来解码返回的令牌并验证请求散列,包名,证书摘要,以及设备/应用完整性判断.
• iOS App Attest:对照苹果的App Attest规则,应用身份,非ce,公用密钥,和计数器验证验证验证对象/批发.
• iOS 设备检查: 向 Apple 的设备检查服务器 API 发送令牌, 并在您的后端维护欺诈位.

API 密码

• getCapabilities()
• getWidevineFingerprint(...)
• prepareAttestation(...)
• createAttestation(...)
• createAssertion(...)
• getDeviceCheckToken()
• 接口
• 类型异名

获取能力( )

getCapabilities() => Promise<DeviceIntegrityCapabilities>

返回当前平台上可用的本土完整性能力.

回返情况: Promise<DeviceIntegrityCapabilities>

获取Widevine Fingerprint (...)

getWidevineFingerprint(options?: WidevineFingerprintOptions | undefined) => Promise<WidevineFingerprintResult>

返回一个来自Android Widevine的指纹.

默认 fingerprint 是SHA -256 在威德文设备上 独一无二的ID和盐. 若为 hashSalt 未提供,Android使用应用程序包名作为盐.

原始的 Widevine ID 敏感,只有在 includeRawId 这是真的.

回返情况: Promise<WidevineFingerprintResult>

准备 Attestation (...)

prepareAttestation(options?: PrepareAttestationOptions | undefined) => Promise<PrepareAttestationResult>

准备本地验证状态并返回密钥/ 提供者控件 .

iOS:创建 App Attest 密钥. Android:准备一个Play完整性标准代号提供者.

回返情况: Promise<PrepareAttestationResult>

创建 Atterstation (...)

createAttestation(options: CreateAttestationOptions) => Promise<AttestationTokenResult>

创建绑定在后端所发挑战的注册验证符 .

回返情况: Promise<AttestationTokenResult>

创建 Assertion (...)

createAssertion(options: CreateAssertionOptions) => Promise<AttestationTokenResult>

创建与请求的有效载荷相绑定的请求断言符号.

回返情况: Promise<AttestationTokenResult>

获取Device检查托肯 ()

getDeviceCheckToken() => Promise<DeviceCheckTokenResult>

为服务器侧欺诈状态检查创建 iOS 设备检查符 .

回返情况: Promise<DeviceCheckTokenResult>

接口

设备集成能力

宽宽能力

支助现状

宽宽指纹

宽宽字体打印选项

准备Attestation再现

准备自动站选项

证明 托肯结果

创建 Attestation 选项

创建代理选项

设备检查托肯结果

类型异名

设备集成格式

'android' | 'ios' | 'web'

证明格式

'apple-app-attest' | 'google-play-integrity-standard'