Getting Started

インストール

AI-Assisted セットアップを使用してプラグインをインストールできます。次のコマンドを使用して、AI ツールに Capgo スキルを追加します。

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

次のプロンプトを使用してください。

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

Manual セットアップを使用する場合は、次のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

1. パッケージのインストール

   bun add @capgo/capacitor-passkey

2. ネイティブ プロジェクトの同期

   bunx cap sync

3. プラグイン設定を追加

   import type { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     appId: 'app.capgo.passkey.example',
     appName: 'My App',
     webDir: 'dist',
     plugins: {
       CapacitorPasskey: {
         origin: 'https://signin.example.com',
         autoShim: true,
         domains: ['signin.example.com'],
       },
     },
   };
   
   export default config;

4. 起動時に shim をインストール

   import { CapacitorPasskey } from '@capgo/capacitor-passkey';
   
   await CapacitorPasskey.autoShimWebAuthn();

5. 正常な WebAuthn フローを維持

   const registration = await navigator.credentials.create({
     publicKey: registrationOptions,
   });
   
   const authentication = await navigator.credentials.get({
     publicKey: requestOptions,
   });

プラグイン設定の機能

設定は plugins.CapacitorPasskey から capacitor.config.*.

• origin: APIを使用する主 HTTPS の依存先の起点
• domains: 同期中にネイティブの構成にパッチする追加の依存先のホスト名
• autoShim: 初期値は true とネイティブの cap sync 自動構成のハック

あなたのためにsyncがパッチするもの

syncを実行すると bunx cap sync, プラグインは生成されたネイティブホストプロジェクトを更新します:

• iOS: 必要に応じて関連ドメインの特権とXcodeの特権のワイヤリング
• Android: asset_statements メタデータと生成されたリソースがマニフェストに使用される

__CAPGO_KEEP_0__はあなたのウェブサイトの信頼情報を公開しません。あなたは依然としてホストする必要があります：

• https://your-domain/.well-known/apple-app-site-association
• https://your-domain/.well-known/assetlinks.json

プラットフォームガイド

iOSのセットアップ

関連するドメインと apple-app-site-association.

Androidのセットアップ

デジタルアセットリンクと assetlinks.json.

バックエンドの注記

オリジン検証とAndroidの注意点です。

__CAPGO_KEEP_2__から始めて続けてください

あなたが使用している場合 はじめに Capgoを使用して認証とアカウントフローの計画を行い、__CAPGO_KEEP_0__に接続する @capgo/capacitor-パスキー native capability in Using @capgo/capacitor-passkey, @capgo/capacitor-ソーシャルログイン @capgo/capacitor-ソーシャルログインの実装詳細について @capgo/capacitor-パスキー @capgo/capacitor-パスキーセット @capgo/capacitor-native-biometric for the implementation detail in @capgo/capacitor-native-biometric, and 2要素認証 2要素認証の実装詳細についてです。