Nota del Backend

Il tuo backend possiede ancora la cerimonia WebAuthn normale:

• Include installare, sincronizzare e la guida markdown completa.
• verifica le risposte di attestazione e di affermazione
• valida l'ID e la sfida del partner di fiducia
• memorizza le credenziali e i contatori nello stesso modo in cui faresti per un flusso di browser

Cosa rimane lo stesso

Il plugin è progettato per preservare la forma front-end del tuo flusso WebAuthn esistente code.

• Sul web, si reindirizza al reale browser WebAuthn API.
• Sul nativo Capacitor, restituisce oggetti di credenziali browser-like supportati da API native passkey.
• La tua backend può mantenere lo stesso pipeline di challenge e verifica.

Cosa cambia su Android

I passkey nativi Android non sono identici al modello di fiducia di un browser.

• I link digital asset per condividere lo stesso partito di fiducia e ecosistema delle credenziali con il tuo sito web.
• Il letterale clientDataJSON.origin Se il tuo server rifiuta qualsiasi cosa eccetto
• Se il tuo server rifiuta tutto eccetto https://your-domainLe dichiarazioni native Android possono fallire anche quando il passkey è altrimenti valido.

Sezione intitolata “Regola di backend raccomandata”

Consenti l'origine del browser previsto e l'origine dell'app Android prevista per lo stesso ente di fiducia quando supporti le chiavi passkey native per Android.

Ciò ti offre:

• supporto di passkey native nell'app __CAPGO_KEEP_0__
• supporto passkey nativo nell'app Capacitor
• Supporto di passkey native nell'app __CAPGO_KEEP_0__

Se hai bisogno di chiamate JSON sicure dirette

Se il tuo backend già restituisce PublicKeyCredentialCreationOptionsJSON e PublicKeyCredentialRequestOptionsJSONe puoi utilizzare anche il plugin API al posto dello shim del 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,
});

Continua da Backend Notes

Se stai utilizzando Nota del Backend per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-passkey per la capacità nativa in Utilizzo di @capgo/capacitor-passkey, @capgo/capacitor-login con social media per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-nativo-biometrico per il dettaglio di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.