Catatan Backend
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Backend Anda tetap menangani proses WebAuthn standar:
- generate challenge registrasi dan autentikasi
- verifikasi respons attestation dan assertion
- terapkan validasi relying-party ID dan challenge
- simpan kredensial dan counter dengan cara yang sama seperti pada alur browser
Yang tetap sama
Bagian berjudul “Apa yang tetap sama”Plugin ini dirancang untuk mempertahankan bentuk front-end code WebAuthn Anda yang sudah ada.
- Di web, ia meneruskan ke API WebAuthn browser asli.
- Di Capacitor native, ia mengembalikan objek kredensial mirip browser yang didukung API passkey native.
- Backend Anda bisa tetap memakai pipeline challenge dan verifikasi yang sama.
Yang berubah di Android
Bagian berjudul “Apa yang berubah di Android”Passkey native Android tidak identik dengan model trust browser.
- Digital Asset Links memungkinkan Android berbagi relying party dan ekosistem kredensial yang sama dengan website Anda.
- Nilai literal
clientDataJSON.originmasih bisa berbeda dari origin website. - Jika server Anda menolak apa pun kecuali
https://your-domain, asersi native Android bisa gagal meskipun passkey tersebut valid.
Aturan backend yang direkomendasikan
Bagian berjudul “Aturan backend yang direkomendasikan”Izinkan origin browser dan origin aplikasi Android yang diharapkan untuk relying party yang sama saat Anda mendukung passkey native Android.
Hasilnya, Anda mendapatkan:
- dukungan browser untuk website
- dukungan passkey native di aplikasi Capacitor
- satu ekosistem passkey untuk domain relying-party yang sama
Jika Anda butuh panggilan JSON-safe langsung
Bagian berjudul “Jika Anda butuh panggilan JSON-safe langsung”Jika backend Anda sudah mengembalikan PublicKeyCredentialCreationOptionsJSON dan PublicKeyCredentialRequestOptionsJSON, Anda juga bisa memakai plugin API secara langsung alih-alih shim bergaya browser:
import { CapacitorPasskey } from '@capgo/capacitor-passkey';
const registration = await CapacitorPasskey.createCredential({ origin: 'https://signin.example.com', publicKey: registrationOptionsFromBackend,});
const authentication = await CapacitorPasskey.getCredential({ origin: 'https://signin.example.com', publicKey: requestOptionsFromBackend,});Lanjutkan dari Backend Notes
Bagian berjudul “Lanjutkan dari Backend Notes”Jika Anda menggunakan Catatan Backend untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan native dalam 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.