Lebih cepat ke konten

Pengaturan iOS

GitHub

Pada iOS, passkeys hanya berfungsi ketika aplikasi terkait dengan domain yang sama sebagai website.

Setelah Anda menambahkan konfigurasi plugin dan menjalankan bunx cap sync, plugin ini memperbaiki proyek host iOS yang dihasilkan sehingga Anda tidak perlu mengeditnya secara manual:

  • menambahkan webcredentials: masukkan entri domain terkait untuk domain yang telah dikonfigurasi
  • menghubungkan CODE_SIGN_ENTITLEMENTS ketika target aplikasi yang dihasilkan tidak sudah menunjuk ke file entitikasi

Anda harus mempublikasikan apple-app-site-association di domain pihak yang memercayai:

https://signin.example.com/.well-known/apple-app-site-association

Contoh:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}

Daftar Periksa

Daftar Pemeriksaan
  1. Set origin dan domains di plugins.CapacitorPasskey di capacitor.config.*.
  2. Jalankan bunx cap sync.
  3. Konfirmasi ID Tim Apple dan ID Paket Aplikasi Anda, kemudian bangun file asosiasi. TEAMID.bundleId Tuan Rumah
  4. dengan HTTP apple-app-site-association dan tidak 200 berlapis .json ekstensi
  5. Pastikan ID pihak yang bergantung yang digunakan oleh backend Anda sesuai dengan domain yang terkait.
  • File website harus disajikan dari domain passkey yang tepat Anda gunakan sebagai ID pihak yang bergantung.
  • Pada iOS 17.4 dan versi yang lebih baru, plugin menggunakan klien-data gaya browser API sehingga asal HTTPS yang dikonfigurasi tercermin dalam clientDataJSON.
  • Plugin dapat memperbaiki file proyek native selama sinkronisasi, tetapi tidak dapat membuat atau menyimpan file asosiasi website pada domain Anda.

Jika Anda menggunakan Pengaturan iOS untuk merencanakan autentikasi dan aliran akun, hubungkannya dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan asli di 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 Dua faktor autentikasi untuk detail implementasi di Dua faktor autentikasi.