Lebih cepat ke konten

Pengaturan Android

GitHub

Pada Android, passkey berfungsi dengan situs web Anda ketika aplikasi dan domain pihak yang dipercaya terhubung melalui Digital Asset Links.

Setelah Anda menambahkan konfigurasi plugin dan menjalankan bunx cap sync, plugin ini memperbaiki proyek host Android yang dihasilkan:

  • Menginjeksikan asset_statements metadata manifest
  • Menghasilkan string sumber daya yang diacu oleh metadata tersebut

Anda harus mempublikasikan assetlinks.json pada domain pihak yang bergantung:

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"
]
}
}
]
  1. Konfigurasi origin dan domains di plugins.CapacitorPasskey di capacitor.config.*.
  2. Jalankan bunx cap sync.
  3. Pakai nama paket Android asli Anda di assetlinks.json.
  4. Tambahkan setiap sidik jari sertifikat yang dibutuhkan, termasuk debug atau internal signing keys jika Anda menguji build-build tersebut.
  5. Tampilkan file tersebut di domain yang sama yang Anda gunakan sebagai ID pihak yang dipercaya.

Dengan Digital Asset Links yang dikonfigurasi, Android dapat menggunakan pihak yang dipercaya dan kunci pasword yang sama dengan situs web Anda. Perbedaan yang tersisa adalah asal literal yang dilaporkan di native clientDataJSON.

  • Sebuah aplikasi Android normal tidak berperilaku seperti browser yang berwenang.
  • Assertion asal dapat diikat ke tanda tangan aplikasi Android daripada asal situs web Anda.
  • Jika backend Anda secara ketat memvalidasi clientDataJSON.originTerima asal aplikasi Android bersamaan dengan asal situs web.

Jika Anda menggunakan Pengaturan Android untuk merencanakan alur autentikasi dan akun, hubungkannya dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan asli dalam Menggunakan @capgo/capacitor-passkey, @capgo/capacitor-social-login untuk detail implementasi dalam @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