メインコンテンツへスキップ
@capgo/capacitor-app-attest 認証とセキュリティ オープンソース

App Attest Capacitor プラグイン

Apple App Attest と Google Play Integrity Standard を使用した、クロスプラットフォーム対応のデバイスアテステーション用 Capacitor プラグイン

インストール

bun add @capgo/capacitor-app-attest bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-app-attest
  • pnpm add @capgo/capacitor-app-attest
  • yarn add @capgo/capacitor-app-attest

ガイド

App Attest を Capacitor で使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

App Attest プラグインのプレビューQR code

@capgo/capacitor-app-attest の使用方法

Capacitor 用の統合クロスプラットフォーム認証プラグイン

インストール

bun add @capgo/capacitor-app-attest
bunx cap sync

このプラグインで利用可能な機能

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

使用例

isSupported

このデバイスでネイティブアテステーションが利用可能かどうかを確認します。

import { AppAttestNative } from '@capgo/capacitor-app-attest';

const result = await AppAttestNative.isSupported();
console.log(result);

prepare

アテステーションの状態を準備し、以降の呼び出しで使用するキーハンドルを返します。

import { AppAttestNative } from '@capgo/capacitor-app-attest';

const result = await AppAttestNative.prepare();
console.log(result);

createAttestation

バックエンドが発行したチャレンジに紐付く登録用アテステーショントークンを作成します。

import { AppAttestNative } from '@capgo/capacitor-app-attest';

const result = await AppAttestNative.createAttestation({
  keyId: 'key-id-123',
  challenge: 'challenge',
});
// The result holds sensitive values: use it without logging it.

createAssertion

リクエストペイロードに紐付くリクエストアサーショントークンを作成します。

import { AppAttestNative } from '@capgo/capacitor-app-attest';

const result = await AppAttestNative.createAssertion({
  keyId: 'key-id-123',
  payload: 'payload',
});
// The result holds sensitive values: use it without logging it.

リファレンス全文

@capgo/capacitor-app-attest の使用方法の続き

使用している場合 @capgo/capacitor-app-attest の使用方法 セキュリティとコンプライアンスを計画するには、これを以下と連携させてください @capgo/capacitor-app-attest @capgo/capacitor-app-attest の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 暗号化 暗号化の実装詳細について コンプライアンス Compliance の実装の詳細については、また Capgo セキュリティスキャナー Capgo Security Scanner の製品ワークフローについては、

よくある質問

App Attest プラグイン FAQ

Capacitor アプリに App Attest プラグインをインストールするには?

"bun add @capgo/capacitor-app-attest"(または "npm install @capgo/capacitor-app-attest")を実行し、続けて "bunx cap sync" を実行すると、iOS と Android のプロジェクトにネイティブの code が反映されます。アプリの code で "@capgo/capacitor-app-attest" からインポートしてください。

@capgo/capacitor-app-attest は React、Vue、Angular で動作しますか?

はい。App Attest は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 上で動作するあらゆる Web フレームワークで使用可能です。

@capgo/capacitor-app-attest はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-app-attest は無料のオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-app-attest/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Attest を使用している code を、App Store の審査なしでアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリ審査を待たずに App Attest の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める