Langsung ke konten

Catatan Backend

GitHub

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

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.

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.origin masih bisa berbeda dari origin website.
  • Jika server Anda menolak apa pun kecuali https://your-domain, asersi native Android bisa gagal meskipun passkey tersebut valid.

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,
});

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.