Android セットアップ
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
Androidでは、アプリとリライイングパーティのドメインがDigital Asset Linksで接続されている場合、ウェブサイトと連携してパスキーが動作します。
プラグインが対応する内容
「プラグインが処理する内容」セクションプラグイン設定を追加して実行すると、 bunx cap sync、プラグインは生成された Android ホストプロジェクトにパッチを適用します:
- を注入します
asset_statementsマニフェストのメタデータ - そのメタデータが参照する生成済みの文字列リソースを書き込みます
自分でホストする必要があるもの
「まだ自分でホストする必要があるもの」というセクションを公開する必要があります assetlinks.json relying-party ドメインで:
https://signin.example.com/.well-known/assetlinks.json例:
[ { "relation": [ "delegate_permission/common.handle_all_urls", "delegate_permission/common.get_login_creds" ], "target": { "namespace": "android_app", "package_name": "app.capgo.passkey.example", "sha256_cert_fingerprints": [ "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99" ] } }]チェックリスト
セクション「チェックリスト」- 設定
originとdomainsにおけるplugins.CapacitorPasskeyにおけるcapacitor.config.*. - 実行
bunx cap sync. - 実際のAndroidパッケージ名を以下で使用してください
assetlinks.json. - デバッグ用や内部用の署名キーでビルドをテストする場合は、それらも含め、必要な署名証明書のフィンガープリントをすべて追加してください。
- Relying Party IDとして使用しているドメインと同じドメインにファイルをホストしてください。
ブラウザとの重要な動作の違い
「ブラウザとの重要な動作の違い」セクションDigital Asset Linksを設定すると、Androidはウェブサイトと同じRelying Partyとパスキーを使用できます。残る違いは、ネイティブで報告されるリテラルなオリジンだけです。 clientDataJSON.
- 通常のAndroidアプリは、権限を持つブラウザのような動作はしません。
- Assertion originは、ウェブサイトのオリジンではなくAndroidアプリの署名に紐付けられます。
- バックエンドで厳密なバリデーションを行っている場合は、
clientDataJSON.originウェブサイトのオリジンに加えて、Androidアプリのオリジンも許可してください。
Android セットアップから続ける
「Androidのセットアップから続ける」セクション使用している場合 Android セットアップ 認証とアカウントフローを計画するには、これを次と連携させてください @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要素認証 二要素認証の実装の詳細については。