Notas del backend

Tu backend sigue gestionando el flujo normal de WebAuthn:

• generar los challenges de registro y autenticación
• verificar las respuestas de attestation y assertion
• validar el relying-party ID y el challenge
• almacenar credenciales y contadores como en un flujo de navegador

Lo que se mantiene igual

El plugin está diseñado para preservar la estructura front-end de tu code de WebAuthn actual.

• En la web, redirige al API de WebAuthn real del navegador.
• En Capacitor nativo, devuelve objetos de credenciales similares a los del navegador mediante las APIs nativas de passkeys.
• Tu backend puede mantener el mismo challenge y pipeline de verificación.

Qué cambia en Android

Las passkeys nativas de Android no son idénticas al modelo de confianza de un navegador.

• Digital Asset Links permite que Android comparta el mismo ecosistema de relying party y credenciales que tu sitio web.
• El clientDataJSON.origin valor literal aún puede diferir del origen del sitio web.
• Si tu servidor rechaza cualquier cosa excepto https://your-domain, las aserciones nativas de Android pueden fallar aunque la passkey sea válida.

Regla de backend recomendada

Permite el origen del navegador y el origen de la app de Android esperados para la misma relying party cuando soportes passkeys nativas en Android.

Esto te ofrece:

• soporte de navegador para el sitio web
• soporte de passkey nativa en la app Capacitor
• un ecosistema de passkeys para el mismo dominio de relying-party

Si necesitas llamadas directas seguras para JSON

Si tu backend ya devuelve PublicKeyCredentialCreationOptionsJSON y PublicKeyCredentialRequestOptionsJSON, también puedes usar el plugin directo API en lugar del shim estilo navegador:

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

Continúa desde Backend Notes

Si estás usando Notas del backend para planificar los flujos de autenticación y de cuenta, conéctalo con Uso de @capgo/capacitor-passkey para la capacidad nativa en Uso de @capgo/capacitor-passkey, @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, y Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores.