Getting Started

インストール

Capgoの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.

__CAPGO_KEEP_0__の場合、プラグインをインストールするには、以下のコマンドを実行し、下記のプラットフォーム固有の説明を参照してください:

1. __CAPGO_KEEP_0__をインストールする

   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. 起動時にシムをインストールする

   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: primary HTTPS relying-party origin used by the shim and direct API
• domains: 同期中にネイティブの設定にパッチする追加の依存先のホスト名
• autoShim: 初期値は true でネイティブの cap sync 自動設定のハック

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

当あなたが実行する bunx cap sync、プラグインは生成されたネイティブホストプロジェクトを更新します：

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

hookはあなたのウェブサイトの信頼ファイルを公開するのをあなたに任せることはありません。 あなたはまだホストする必要があります：

• 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_0__/__CAPGO_KEEP_1__-passkey 「@capgo/capacitor-passkey」を使用するnative capability 「@capgo/capacitor-social-login」を使用する 「@capgo/capacitor-social-login」の実装詳細 「@capgo/capacitor-passkey」を使用する @capgo/capacitor-passkey @capgo/capacitor-passkeyの実装詳細について @capgo/capacitor-native-biometric @capgo/capacitor-native-biometricの実装詳細について、そして 2要素認証 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometricの実装詳細について2要素認証