Setup iOS

Di iOS, passkey hanya berfungsi jika aplikasi terhubung dengan domain relying-party yang sama dengan situs webnya.

Apa yang ditangani plugin

After you add the plugin config and run bunx cap sync, plugin akan melakukan patch pada iOS host project yang dihasilkan sehingga Anda tidak perlu mengeditnya secara manual:

• menambahkan webcredentials: entri associated domains untuk domain yang dikonfigurasi
• kabel CODE_SIGN_ENTITLEMENTS ketika target aplikasi yang dibuat belum mengarah ke file entitlements

Hal yang masih perlu Anda host

Anda harus mempublikasikan apple-app-site-association pada domain relying-party:

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

Contoh:

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

Daftar Periksa

1. Atur origin dan domains di plugins.CapacitorPasskey di capacitor.config.*.
2. Jalankan bunx cap sync.
3. Konfirmasi Apple Team ID dan app bundle ID Anda, lalu build TEAMID.bundleId untuk file asosiasi tersebut.
4. Host apple-app-site-association dengan HTTP 200 dan tanpa .json ekstensi.
5. Pastikan relying-party ID yang digunakan backend Anda sesuai dengan domain terkait.

Catatan

• File website harus disajikan dari domain passkey yang sama dengan yang Anda gunakan sebagai relying-party ID.
• Pada iOS 17.4 ke atas, plugin menggunakan client-data API gaya browser sehingga HTTPS origin yang dikonfigurasi akan tercermin dalam clientDataJSON.
• Plugin dapat melakukan patch pada file proyek native saat sync, tetapi tidak dapat membuat atau menghosting file website association di domain Anda.

Lanjutkan dari Setup iOS

Jika Anda menggunakan Setup iOS untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-passkey untuk kapabilitas native 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 Autentikasi dua faktor untuk detail implementasi di autentikasi dua faktor.