@capgo/capacitor-app-attest

概要

機密性の高い API 呼び出しを信頼する前に、リクエストが正規のアプリインストールから送信されたことを証明します。 prepare() と createAttestation() Apple App Attest フローに対応し、Android は Play Integrity Standard とオプションの Widevine fingerprint メソッドでカバーします。キー ID は組み込みヘルパーで安全に保存できます。

主な用途：不正防止、高額取引、ログインや出金エンドポイントでの改ざん検知。

プラットフォーム対応

プラットフォーム	サポート	備考
iOSと	はい	App Attest のキー、アサーション、DeviceCheck トークンヘルパー
Androidでは	はい	Play Integrity Standard、任意のWidevine fingerprint
Web	フォールバック	ネイティブAPIが利用できない場合のWebアテステーション形式

コア機能

• isSupported - このデバイスでネイティブアテステーションが利用可能か確認します。
• prepare - アテステーションの状態を準備し、後続の呼び出しで使用するキーハンドルを返します。
• createAttestation - バックエンドから発行されたチャレンジに紐付けられた、登録アテステーショントークンを作成します。
• createAssertion - リクエストペイロードに紐付けられた、リクエストアサーショントークンを作成します。

公開 API

メソッド	説明
isSupported	このデバイスでネイティブアテステーションが利用可能かどうかを確認します。
prepare	アテステーションの状態を準備し、以降の呼び出しで使用するキーハンドルを返します。
createAttestation	バックエンドが発行したチャレンジに紐付く登録用アテステーショントークンを作成します。
createAssertion	リクエストペイロードに紐付くリクエストアサーショントークンを作成します。
storeKeyId	再利用できるようキー識別子を保存/準備します。
getStoredKeyId	現在保存/準備されているキー識別子を返します。
clearStoredKeyId	保存/準備済みのキー識別子をクリアします。
generateKey	〜のレガシーエイリアス prepare().
attestKey	〜のレガシーエイリアス createAttestation().
generateAssertion	〜のレガシーエイリアス createAssertion().

Source of Truth

このリファレンスは以下から同期されています： src/definitions.ts における capacitor-app-attest.

@capgo/capacitor-app-attest から続ける

使用している場合 @capgo/capacitor-app-attest セキュリティとコンプライアンスを計画するには、これを以下と連携させてください @capgo/capacitor-app-attest の使用方法 「@capgo/capacitor-app-attest の使用」のネイティブ機能については、 暗号化 暗号化の実装詳細について コンプライアンス コンプライアンスの実装詳細について Capgo セキュリティスキャナー Capgo Security Scanner のプロダクトワークフローについては、 Capgo のセキュリティ Capgo Security におけるプロダクトワークフロー向けに。