Aller au contenu

@capgo/capacitor-passkey

Conservez votre code WebAuthn de type navigateur dans une app Capacitor pendant que le plugin gère les appels passkey natifs et le patch de l'hôte natif.

API de type navigateur

Conservez navigator.credentials.create() et navigator.credentials.get() dans votre application au lieu de réécrire votre flux de passkeys autour d'un API personnalisé.

Modifications minimales de l'app

Ajoutez la config du plugin une fois, appelez-la CapacitorPasskey.autoShimWebAuthn() pendant le bootstrap, et gardez le reste de votre code WebAuthn proche de l'implémentation du navigateur.

Câblage natif au build

Le plugin patche les projets hôtes iOS et Android générés pendant la sync pour vous éviter de modifier ces fichiers à la main.

  • shimWebAuthn(options?) installe immédiatement le shim de type navigateur, avec une option de remplacement de l'origine HTTPS.
  • getConfiguration() lit la configuration runtime résolue depuis plugins.CapacitorPasskey.
  • autoShimWebAuthn(options?) lit cette configuration et installe le shim en une seule étape lors du bootstrap de l'application.
  • createCredential(options) et getCredential(options) appeler directement les API passkey natives avec des payloads WebAuthn compatibles JSON.
  • isSupported() signale la disponibilité au runtime et getPluginVersion() renvoie le marqueur de version de l'implémentation native.

Si vous utilisez @capgo/capacitor-passkey pour planifier les flux d'authentification et de compte, le connecter à Utilisation de @capgo/capacitor-passkey pour la fonctionnalité native dans Utilisation de @capgo/capacitor-passkey, @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, Authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs, et SSO (Entreprise) pour les détails d'implémentation dans le SSO (Enterprise).