Lompat ke konten

Pengaturan iOS

GitHub

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

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

  • menambahkan webcredentials: masukan domain terkait untuk domain yang dikonfigurasi
  • Kabel CODE_SIGN_ENTITLEMENTS ketika aplikasi yang dihasilkan tidak sudah menunjuk ke file hak istimewa

Anda harus mempublikasikan apple-app-site-association pada domain pihak yang bergantung:

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

Contoh:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. Konfigurasi origin dan domains di plugins.CapacitorPasskey di capacitor.config.*.
  2. Jalankan bunx cap sync.
  3. Konfirmasi ID Tim Apple Anda dan ID aplikasi bundle, kemudian bangun TEAMID.bundleId nilai untuk file asosiasi.
  4. Host apple-app-site-association dengan HTTP 200 dan tidak .json ekstensi.
  5. Pastikan ID pihak yang tergantung yang digunakan oleh backend Anda sesuai dengan domain yang terkait.
  • File website harus disajikan dari domain pasword yang tepat yang Anda gunakan sebagai ID pihak yang bergantung.
  • Pada iOS 17.4 dan lebih baru, plugin menggunakan klien data browser-style 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 di domain Anda.

Jika Anda menggunakan Pengaturan iOS untuk merencanakan autentikasi dan alur akun, hubungkannya dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan native di Menggunakan @capgo/capacitor-passkey, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-login-sosial, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-biometrik-native untuk detail implementasi di @capgo/capacitor-biometrik-native, dan Autentikasi dua faktor untuk detail implementasi di Autentikasi dua faktor.