@capgo/capacitor-device-integrity

概要

Widevine、Play Integrity、App Attest、DeviceCheckによるデバイスの整合性と不正シグナル

まずは以下から始めましょう： getCapabilities() および、以下に記載されているその他の主要なメソッド。

プラットフォーム対応

プラットフォーム	サポート	備考
iOS	はい	ネイティブ
Android	はい	ネイティブ
Web	一部対応	Getting Started を参照

コア機能

• getCapabilities - 現在のプラットフォームで利用可能な整合性機能（integrity features）を返します。
• getWidevineFingerprint - AndroidのWidevine由来のデバイスフィンガープリントを返します。
• prepareAttestation - App Attest または Play Integrity の状態を準備し、キーまたはプロバイダーハンドルを返します。
• createAttestation - バックエンドのチャレンジに紐付けられた登録アテステーショントークンを作成します。
• createAssertion - バックエンドのペイロードに紐付けられたリクエストアサーショントークンを作成します。
• getDeviceCheckToken - サーバーサイドでの不正調査用iOS DeviceCheckトークンを作成します。

公開 API

メソッド	説明
getCapabilities	このデバイスにおけるWidevine、App Attest、DeviceCheck、およびPlay Integrityのサポート状況を返します。
getWidevineFingerprint	Androidのみ。ソルト付きSHA-256フィンガープリントと、オプションのWidevineメタデータを返します。
prepareAttestation	ネイティブのアテステーションを準備し、以下を返します： keyId および format.
createAttestation	バックエンドから発行された値に対する登録トークンを作成します challenge.
createAssertion	バックエンド発行の検証用アサーショントークンを作成します payload.
getDeviceCheckToken	iOSのみ。base64形式のDeviceCheckトークンを返します。

設定

Android Play Integrityでは、グローバルなCloudプロジェクト番号を capacitor.config.ts:

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

また、以下を渡すことも可能です cloudProjectNumber まで prepareAttestation, createAttestationや createAssertion.

信頼できる情報源 (Source Of Truth)

このリファレンスは以下から同期されています 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 Security Scanner を Capgo Security Scanner の製品ワークフローについては、また、 Capgo セキュリティ Capgo Security の製品ワークフローについては、