Pengaturan iOS

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

Apa yang plugin ini tangani

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: masukan domain terkait untuk domain yang telah dikonfigurasi
• menghubungkan CODE_SIGN_ENTITLEMENTS ketika target aplikasi yang dihasilkan tidak sudah menunjuk ke file entititlements

Apa yang masih perlu Anda host

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

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 ID Tim Apple Anda dan ID aplikasi bundle, lalu bangun nilai untuk file asosiasi. TEAMID.bundleId Host
4. dengan HTTP apple-app-site-association dan tidak 200 tanda .json ekstensi.
5. Pastikan ID pihak yang tergantung yang digunakan oleh backend Anda sesuai dengan domain yang terkait.

Catatan

• File website harus disajikan dari domain pasword yang tepat Anda gunakan sebagai ID pihak yang tergantung.
• Pada iOS 17.4 dan versi yang 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 pada domain Anda.