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

Android セットアップ

GitHub

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"
]
}
}
]
  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とパスキーを使用できます。残る違いは、ネイティブで報告されるリテラルなオリジンだけです。 clientDataJSON.

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