Saltar al contenido

@capgo/capacitor-passkey

Mantén tu code WebAuthn estilo navegador en una app Capacitor mientras el plugin gestiona las llamadas de passkey y el patching del host nativo.

API estilo navegador

Mantén navigator.credentials.create() y navigator.credentials.get() en tu app en lugar de reescribir tu flujo de passkeys con un API personalizado.

Cambios mínimos en la app

Configura el plugin una vez, llama a CapacitorPasskey.autoShimWebAuthn() durante el bootstrap y mantén el resto de tu code de WebAuthn similar a la implementación del navegador.

Vinculación nativa en tiempo de build

El plugin parchea los proyectos host de iOS y Android generados durante el sync para que no tengas que editarlos a mano.

  • shimWebAuthn(options?) instala el shim estilo navegador de inmediato, con una opción para sobrescribir el origen HTTPS.
  • getConfiguration() lee la configuración de runtime resuelta desde plugins.CapacitorPasskey.
  • autoShimWebAuthn(options?) lee esa configuración e instala el shim en un solo paso durante el arranque de la app.
  • createCredential(options) y getCredential(options) llama las APIs nativas de passkey directamente con payloads de WebAuthn compatibles con JSON.
  • isSupported() informa la disponibilidad en runtime y getPluginVersion() devuelve el marcador de la versión de la implementación nativa.

Si estás usando @capgo/capacitor-passkey 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-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores, y SSO (Enterprise) para el detalle de implementación en SSO (Enterprise).