iOSのセットアップ

iOSでは、パスキーはアプリがウェブサイトと同じrelying partyドメインに関連付けられている場合にのみ動作します。

プラグインが対応する内容

プラグイン設定を追加して実行すると、 bunx cap syncプラグインが生成されたiOSホストプロジェクトにパッチを当てるので、手動で編集し続ける必要はありません：

• 以下を追加します： webcredentials: 設定済みドメインの Associated Domains エントリ
• 配線 CODE_SIGN_ENTITLEMENTS 生成されたアプリターゲットが既に entitlements ファイルを参照していない場合

自分でホストする必要があるもの

以下を公開する必要があります： apple-app-site-association RP（Relying Party）ドメイン上に：

https://signin.example.com/.well-known/apple-app-site-association

例:

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

チェックリスト

1. 設定 origin と domains における plugins.CapacitorPasskey における capacitor.config.*.
2. 実行 bunx cap sync.
3. Apple Team IDとアプリのbundle IDを確認してから、 TEAMID.bundleId アソシエーションファイル用の値を作成します。
4. ホスト apple-app-site-association をHTTPで 200 、拡張子 .json なしで。
5. バックエンドで使用するrelying-party IDがAssociated Domainと一致していることを確認してください。

備考

• ウェブサイトのファイルは、RP ID（Relying Party ID）として使用するパスキー用ドメインから直接配信される必要があります。
• iOS 17.4以降では、本プラグインはブラウザ形式のクライアントデータ API を使用するため、設定されたHTTPSオリジンが反映されます。 clientDataJSON.
• 本プラグインは同期時にネイティブプロジェクトのファイルをパッチできますが、ドメイン上にウェブサイトの関連付けファイルを生成またはホストすることはできません。

iOSセットアップから続行

使用している場合 iOSのセットアップ 認証とアカウントフローを計画するには、これを次と連携させてください @capgo/capacitor-passkey を使用する @capgo/capacitor-passkey を使用したネイティブ機能について @capgo/capacitor-social-login @capgo/capacitor-social-login の実装の詳細については、 @capgo/capacitor-passkey @capgo/capacitor-passkey の実装詳細については、 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric の実装の詳細、および 2要素認証 二要素認証の実装の詳細については。