Notas de Backend

Su backend sigue teniendo la ceremonia WebAuthn normal:

• generar desafíos de registro y autenticación
• verificar respuestas de verificación y afirmación
• Validar ID y desafío del proveedor de confianza
• almacenar credenciales y contras las mismas formas en que lo harías para un flujo de navegador

¿Qué sigue igual

El complemento está diseñado para preservar la forma de frente de su flujo de autenticación WebAuthn existente code.

• En la web, se envía a la autenticación WebAuthn real del navegador API.
• En nativo Capacitor, devuelve objetos de credenciales como del navegador respaldados por APIs de passkey nativas.
• Su servidor puede mantener el mismo pipeline de desafío y verificación.

¿Qué cambia en Android

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

• Digital Asset Links permiten a Android compartir el mismo partido de confianza y ecosistema de credenciales que su sitio web.
• El literal clientDataJSON.origin Si su servidor rechaza cualquier cosa excepto
• Si su servidor rechaza cualquier cosa excepto https://your-domain, las afirmaciones nativas de Android pueden fallar incluso cuando la clave de acceso es válida en sí.

Recomendación de regla de backend

Permita el origen de navegador esperado y el origen de la aplicación Android esperado para el mismo partido de confianza cuando apoye claves de Android nativas.

soporte del navegador para el sitio web

• soporte de passkey nativo en la aplicación __CAPGO_KEEP_0__
• Soporte de passkey nativo en la aplicación Capacitor.
• Un ecosistema de passkey para el mismo dominio de la parte que confía.

If necesitas llamadas JSON seguras directas

Si tu backend ya devuelve PublicKeyCredentialCreationOptionsJSON y PublicKeyCredentialRequestOptionsJSON, puedes utilizar también el plugin API en lugar de la capa de shim del 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,
});

Sigue adelante desde Notas de Backend

Si estás utilizando Notas de Backend para planificar flujos de autenticación y cuentas, conecta con Usando @capgo/capacitor-passkey para la capacidad nativa en Uso de @capgo/capacitor-passkey, @capgo/capacitor-login-social para el detalle de implementación en @capgo/capacitor-social-login, @capgo/capacitor-clave de paso para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-nativo-biomet́rico para el detalle de implementación en @capgo/capacitor-native-biometric, y autenticación en dos factores para el detalle de implementación en autenticación en dos factores.