Setup Android

Di Android, passkey bekerja dengan website Anda saat aplikasi dan domain relying-party terhubung melalui Digital Asset Links.

Apa yang ditangani plugin

After you add the plugin config and run bunx cap sync, plugin akan melakukan patch pada Android host project yang dihasilkan:

• menyuntikkan asset_statements metadata manifest
• menulis string resource yang dihasilkan yang dirujuk oleh metadata tersebut

Yang perlu Anda host

Anda harus mempublikasikan assetlinks.json pada domain relying-party:

https://signin.example.com/.well-known/assetlinks.json

Contoh:

[
  {
    "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"
      ]
    }
  }
]

Daftar Periksa

1. Atur origin dan domains di plugins.CapacitorPasskey di capacitor.config.*.
2. Jalankan bunx cap sync.
3. Gunakan nama package Android asli Anda di assetlinks.json.
4. Tambahkan semua fingerprint sertifikat signing yang diperlukan, termasuk kunci debug atau internal signing jika Anda menguji build tersebut.
5. Host file tersebut di domain yang sama dengan relying-party ID Anda.

Perbedaan perilaku penting dari browser

Dengan konfigurasi Digital Asset Links, Android dapat menggunakan relying party dan passkeys yang sama dengan website Anda. Perbedaan sisanya adalah origin literal yang dilaporkan di native clientDataJSON.

• Aplikasi Android biasa tidak berperilaku seperti browser yang memiliki hak akses khusus.
• Assertion origin dapat dihubungkan ke signature aplikasi Android, bukan ke origin website Anda.
• Jika backend Anda melakukan validasi ketat clientDataJSON.origin, terima origin aplikasi Android bersama dengan origin website.

Lanjutkan dari Setup Android

Jika Anda menggunakan Setup Android untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-passkey untuk kapabilitas native saat menggunakan @capgo/capacitor-passkey, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric, dan Autentikasi dua faktor untuk detail implementasi di autentikasi dua faktor.