Android セットアップ

Androidでは、Digital Asset Linksを通じてアプリとRP（Relying Party）ドメインが連携されている場合、パスキーはウェブサイトと連動して動作します。

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

プラグイン設定を追加して実行すると、 bunx cap syncプラグインは、生成されたAndroidのホストプロジェクトに以下をパッチ適用します：

• 以下を注入します： asset_statements manifestのメタデータ
• そのメタデータが参照する生成済み文字列リソースを書き込みます

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

以下を公開する必要があります assetlinks.json RP（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"
      ]
    }
  }
]

チェックリスト

1. 設定 origin と domains における plugins.CapacitorPasskey における capacitor.config.*.
2. 実行 bunx cap sync.
3. Androidの実際のパッケージ名を assetlinks.json.
4. デバッグ用や内部テスト用の署名キーを使用している場合は、それらを含め、必要なすべての署名証明書のフィンガープリントを追加してください。
5. Relying Party IDとして使用しているドメインと同じドメインにファイルをホストしてください。

ブラウザとの重要な動作の違い

Digital Asset Linksが設定されていれば、Androidはウェブサイトと同じRelying PartyおよびPasskeyを使用できます。残る違いは、ネイティブ環境で報告されるオリジンそのものです。 clientDataJSON.

• 通常のAndroidアプリは、権限を持つブラウザのように動作するわけではありません。
• Assertion originは、ウェブサイトのオリジンではなく、Androidアプリの署名に関連付けることができます。
• バックエンドで厳密なバリデーションを行っている場合は、 clientDataJSON.originウェブサイトのオリジンに加えて、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要素認証 二要素認証の実装の詳細については。