Passer au contenu principal
Example
import MfaWebAuthnPlatformChallenge from "@auth0/auth0-acul-js/mfa-webauthn-platform-challenge";

const mfaWebAuthnPlatformChallengeManager = new MfaWebAuthnPlatformChallenge();

Constructeurs

MfaWebAuthnPlatformChallenge
Constructor
Initialise une nouvelle instance de la classe MfaWebAuthnPlatformChallenge. Récupère le contexte nécessaire (écran, transaction, etc.) à partir du universal_login_context global.

Lève

Si le contexte Universal Login n’est pas disponible ou si le nom de l’écran dans le contexte ne correspond pas à MfaWebAuthnPlatformChallenge.screenIdentifier.

Propriétés

branding
client
organization
prompt
screen
tenant
transaction
untrustedData
user
screenIdentifier
string
static

Méthodes

getErrors
Récupère le tableau des erreurs de la transaction à partir du contexte, ou un tableau vide si aucune n’existe.Un tableau d’objets d’erreur provenant du contexte de transaction.
reportBrowserError
Promise<void>
Signale une erreur côté navigateur rencontrée pendant l’opération WebAuthn navigator.credentials.get(). Cette méthode doit être appelée lorsque verify() échoue en raison d’une erreur de l’API WebAuthn (par exemple, annulation par l’utilisateur). Elle envoie les détails de l’erreur au serveur avec un format d’action spécifique.Une promesse résolue lorsque le rapport d’erreur est soumis avec succès.

Lève

Lève une erreur si l’envoi du formulaire échoue (par exemple, problème de réseau, state invalide).
tryAnotherMethod
Promise<void>
Permet à l’utilisateur de se soustraire au défi de la plateforme WebAuthn et de sélectionner une autre méthode d’AMF (MFA). Cette action soumet action: "pick-authenticator" à Auth0, ce qui devrait amener l’utilisateur vers un écran de sélection de facteur AMF.Une promesse résolue lorsque l’action pick-authenticator est soumise.

Lève

Lève une erreur si l’envoi du formulaire échoue (par exemple, erreur réseau, state invalide).
verify
Promise<void>
Initie le défi de l’authentificateur de plateforme WebAuthn. En interne, cette méthode récupère les options de défi à partir de this.screen.publicKey, appelle navigator.credentials.get() (via l’utilitaire getPasskeyCredentials), puis soumet l’assertion d’identification résultante au serveur Auth0.Une promesse résolue lorsque l’envoi des justificatifs est initié. Une opération réussie entraîne généralement une redirection côté serveur.

Lève

Lève une erreur si this.screen.publicKey n’est pas disponible (ce qui indique que les options de défi sont manquantes), si getPasskeyCredentials (et donc navigator.credentials.get()) échoue (par exemple, annulation par l’utilisateur, aucun authentificateur trouvé, erreur matérielle), ou si l’envoi final du formulaire à Auth0 échoue. Il est crucial d’intercepter les erreurs renvoyées par cette méthode. Les erreurs de l’API WebAuthn (comme NotAllowedError) devraient idéalement être signalées en utilisant this.reportBrowserError().