iOSのセットアップ
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
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"] }}チェックリスト
セクション「チェックリスト」- 設定
originとdomainsにおけるplugins.CapacitorPasskeyにおけるcapacitor.config.*. - 実行
bunx cap sync. - Apple Team IDとアプリのbundle IDを確認してから、
TEAMID.bundleIdアソシエーションファイル用の値を作成します。 - ホスト
apple-app-site-associationをHTTPで200、拡張子.jsonなしで。 - バックエンドで使用するrelying-party IDがAssociated Domainと一致していることを確認してください。
- ウェブサイトファイルは、relying-party ID として使用するパスキーのドメインから正確に配信される必要があります。
- iOS 17.4 以降では、プラグインはブラウザ形式の client-data API を使用するため、設定された HTTPS オリジンが反映されます
clientDataJSON. - このプラグインは sync 時にネイティブプロジェクトファイルをパッチ適用できますが、ドメイン上でウェブサイト関連付けファイルを作成またはホストすることはできません。
iOSセットアップから続行
「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要素認証 二要素認証の実装の詳細については。