Pengaturan Android

Pada Android, passkeys berfungsi dengan situs web Anda ketika aplikasi dan domain yang dipercaya terkait melalui Digital Asset Links.

Apa yang plugin ini tangani

After you add the plugin config and run bunx cap sync, plugin ini memperbaiki proyek host Android yang dihasilkan:

• menambahkan asset_statements metadata manifest
• menulis string sumber daya yang dihasilkan yang dikaitkan dengan metadata tersebut

Apa yang masih perlu Anda host

Anda harus mempublikasikan assetlinks.json di domain yang dipercayai:

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

Checklist

1. Set origin context domains dan plugins.CapacitorPasskey dan capacitor.config.*.
2. di bunx cap sync.
3. Gunakan nama paket Android asli Anda assetlinks.json.
4. Tambahkan semua cap fingerprint yang Anda butuhkan, termasuk cap debug atau internal jika Anda menguji build tersebut.
5. Tampilkan file di domain yang sama yang Anda gunakan sebagai ID pihak yang bergantung.

Perbedaan perilaku penting dari browser

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

• Aplikasi Android normal tidak berperilaku seperti browser yang berkekuasaan.
• Asal klaim dapat dikaitkan dengan tanda tangan aplikasi Android daripada asal situs web Anda.
• Jika backend Anda secara ketat memvalidasi clientDataJSON.originterima asal aplikasi Android di samping asal situs web Anda.

Lanjutkan dari Pengaturan Android

Jika Anda menggunakan Pengaturan Android untuk merencanakan autentikasi dan aliran akun, hubungkannya dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan asli dalam Menggunakan @capgo/capacitor-passkey, @capgo/capacitor-login Sosial untuk detail implementasi dalam @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi dalam @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi dalam @capgo/capacitor-native-biometric, dan Autentikasi dua faktor untuk detail implementasi dalam Autentikasi dua faktor.