Catatan Backend

Backend Anda masih mengontrol upacara WebAuthn normal:

• menghasilkan tantangan registrasi dan autentikasi
• verifikasi responsi pengakuan dan klaim
• menggunakan ID dan validasi tantangan pihak yang bergantung
• menyimpan kreditel dan penghitung sama seperti yang Anda lakukan untuk aliran browser

Apa yang tetap sama

Plugin ini dirancang untuk mempertahankan bentuk depan dari WebAuthn code yang sudah ada Anda.

• Pada web, ia mengalihkan ke WebAuthn API browser yang sebenarnya.
• Pada native Capacitor, ia mengembalikan objek kreditel browser yang mirip dengan native passkey API.
• Backend Anda dapat menjaga aliran tantangan dan verifikasi yang sama.

Apa yang berubah pada Android

Passkey native Android tidak identik dengan model kepercayaan browser.

• Digital Asset Links memungkinkan Android untuk berbagi pihak yang dipercaya dan ekosistem kredit yang sama dengan situs web Anda.
• The literal clientDataJSON.origin nilai literal masih dapat berbeda dari asal situs web.
• If server Anda menolak apa pun except https://your-domainAndroid native assertions dapat gagal bahkan ketika passkey lainnya valid.

Rekomendasi aturan backend

Biarkan asal browser yang diharapkan dan asal aplikasi Android yang diharapkan untuk pihak yang dipercaya yang sama ketika Anda mendukung passkey Android native.

Yang memberikan Anda:

• support browser untuk situs web
• support passkey native di aplikasi Capacitor
• ekosistem passkey yang sama untuk domain pihak yang dipercaya yang sama

Jika Anda memerlukan panggilan JSON-aman langsung

Jika backend Anda sudah mengembalikan PublicKeyCredentialCreationOptionsJSON dan PublicKeyCredentialRequestOptionsJSON, Anda juga dapat menggunakan plugin langsung API daripada shim gaya 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 Catatan Backend

Jika Anda menggunakan Catatan Backend untuk merencanakan alur autentikasi dan akun, hubungkannya dengan Menggunakan @capgo/capacitor-passkey untuk kemampuan asli di Menggunakan @capgo/capacitor-passkey, /capgo/capacitor-login Sosial 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 Dua faktor autentikasi untuk detail implementasi di Dua faktor autentikasi.