Notes Backend

Votre backend conserve toujours la cérémonie WebAuthn normale :

• Générer des défis de registration et d'authentification
• Vérifier les réponses d'attestation et d'assertion
• Appliquer la validation de l'ID de partie dépendante et du défi
• stockez les informations de connexion et les comptes à la même manière que vous le feriez pour un flux de navigateur

Qu'est-ce qui reste le même

Le plugin est conçu pour préserver la forme frontale de votre flux WebAuthn existant code.

• Sur le web, il redirige vers le vrai navigateur WebAuthn API.
• Sur native Capacitor, il retourne des objets de connexion de type navigateur, soutenus par les API de passkey natives.
• Votre backend peut conserver la même pipeline de défi et de vérification.

Qu'est-ce qui change sur Android

Les passkeys natives d'Android ne sont pas identiques au modèle de confiance d'un navigateur.

• Les liens d'actif numérique permettent à Android de partager le même partenaire de confiance et l'écosystème de crédits que votre site web.
• La littéralité clientDataJSON.origin La valeur peut toujours différer de l'origine du site web.
• Si votre serveur rejette uniquement https://your-domainLes assertions natives Android peuvent échouer même lorsque la clé de passe est autrement valide.

Règle de backend recommandée

Autorisez l'origine du navigateur attendue et l'origine de l'application Android attendue pour le même partenaire de confiance lorsque vous supportez les clés de passe natives Android.

Cela vous donne :

• la prise en charge du navigateur pour le site web
• la prise en charge des clés de passe natives dans l'application Capacitor
• un écosystème de clés de passe unique pour le même domaine de partenaire de confiance

Si vous avez besoin d'appels JSON-sûrs directs

If votre backend retourne déjà PublicKeyCredentialCreationOptionsJSON et PublicKeyCredentialRequestOptionsJSON, vous pouvez également utiliser le plugin direct API au lieu du shim de style navigateur :

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

Continuez de la section Notes de l'arrière-plan

Si vous utilisez Notes de l'arrière-plan pour planifier les flux d'authentification et de comptes, connectez-l’avec En utilisant @capgo/capacitor-passkey pour la capacité native dans En utilisant @capgo/capacitor-passkey, @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-login-social @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-biométrique-natif pour les détails d'implémentation dans @capgo/capacitor-biométrique-natif, et l'authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs.