メインコンテンツへスキップ

iOSのセットアップ

GitHub

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

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

  • 以下を追加します: webcredentials: 設定済みドメインの関連ドメインエントリ
  • wires CODE_SIGN_ENTITLEMENTS 生成されたアプリターゲットがすでにエントitlementsファイルを指していない場合

を公開する必要があります apple-app-site-association 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と一致していることを確認してください。
  • ウェブサイトファイルは、relying-party ID として使用するパスキーのドメインから正確に配信される必要があります。
  • iOS 17.4 以降では、プラグインはブラウザ形式の client-data API を使用するため、設定された HTTPS オリジンが反映されます clientDataJSON.
  • このプラグインは sync 時にネイティブプロジェクトファイルをパッチ適用できますが、ドメイン上でウェブサイト関連付けファイルを作成またはホストすることはできません。

使用している場合 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要素認証 二要素認証の実装の詳細については。