Catatan Backend

Backend Anda tetap menangani proses WebAuthn standar:

• generate tantangan registrasi dan autentikasi
• verifikasi respons attestation dan assertion
• validasi relying-party ID dan challenge
• simpan kredensial dan counter dengan cara yang sama seperti pada alur browser

Hal yang tetap sama

Plugin ini dirancang untuk mempertahankan struktur front-end code WebAuthn Anda yang sudah ada.

• Di web, plugin ini meneruskan ke API WebAuthn browser asli.
• Pada Capacitor native, ia mengembalikan objek kredensial mirip browser yang didukung oleh API passkey native.
• Backend Anda dapat tetap menggunakan challenge dan pipeline verifikasi yang sama.

Apa yang berubah di Android

Passkey native Android tidak identik dengan model trust browser.

• Digital Asset Links memungkinkan Android berbagi ekosistem relying party dan kredensial yang sama dengan website Anda.
• Nilai clientDataJSON.origin literal masih bisa berbeda dari origin website.
• Jika server Anda menolak apa pun kecuali https://your-domain, asersi native Android bisa gagal meskipun passkey tersebut sebenarnya valid.

Aturan backend yang direkomendasikan

Izinkan browser origin dan Android app origin yang sesuai untuk relying party yang sama saat mendukung passkey native Android.

Ini akan memberikan Anda:

• dukungan browser untuk website
• dukungan passkey native di aplikasi Capacitor
• satu ekosistem passkey untuk domain relying-party yang sama

Jika Anda butuh pemanggilan JSON-safe langsung

Jika backend Anda sudah mengembalikan PublicKeyCredentialCreationOptionsJSON dan PublicKeyCredentialRequestOptionsJSON, Anda juga bisa menggunakan plugin langsung API 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

Jika Anda menggunakan Catatan Backend untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-passkey untuk kapabilitas native di Using @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.