MfaWebAuthnRoamingChallenge

Example

import MfaWebAuthnRoamingChallenge from "@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge";

const mfaWebAuthnRoamingChallengeManager = new MfaWebAuthnRoamingChallenge();

Constructeurs

Constructor

Initialise une nouvelle instance de la classe MfaWebAuthnRoamingChallenge.

Exceptions

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

Propriétés

string

static

Méthodes

Récupère le tableau des erreurs de transaction à partir du contexte, ou un tableau vide s’il n’en existe aucune.Un tableau d’objets d’erreur provenant du contexte de la transaction.

Promise<void>

Signale une erreur spécifique de l’API WebAuthn à Auth0. Cette méthode doit être utilisée si navigator.credentials.get() échoue d’une façon que verify() ne gère pas automatiquement, ou si le développeur souhaite explicitement signaler une erreur avant d’essayer une autre action. Elle envoie les détails de l’erreur avec action: "showError::{errorDetails}".Une promesse qui se résout lorsque le rapport d’erreur est soumis.

Lève

Lève une erreur si l’envoi du formulaire échoue.

Example

// En supposant que "sdk" est une instance de MfaWebAuthnRoamingChallenge
// Et que webAuthnError est un objet d’erreur provenant d’un appel navigator.credentials.get() ayant échoué.
try {
  await sdk.reportWebAuthnError({
    error: { name: webAuthnError.name, message: webAuthnError.message }
  });
} catch (submitError) {
  console.error("Failed to report WebAuthn error:", submitError);
}

Afficher Paramètres

Contient l’objet error avec name et message provenant de l’API WebAuthn, ainsi que tout autre paramètre personnalisé.Propriétés

L’objet d’erreur de l’API WebAuthn à signaler.

Promise<void>

Permet à l’utilisateur de se soustraire au défi WebAuthn et de sélectionner une autre méthode d’authentification multifacteur (AMF). Cette action soumet action: "pick-authenticator" à Auth0, ce qui doit amener l’utilisateur à un écran de sélection de facteur AMF.Une promesse qui se résout lorsque l’action est soumise.

Lève

Lève une erreur si l’envoi du formulaire échoue.

Example

// En supposant que "sdk" est une instance de MfaWebAuthnRoamingChallenge
try {
  await sdk.tryAnotherMethod();
  // En cas de réussite, Auth0 gère la redirection vers la sélection AMF.
} catch (error) {
  console.error("Failed to switch MFA method:", error);
}

Afficher Paramètres

Paramètres personnalisés facultatifs pour la requête.

Promise<void>

Initie le défi WebAuthn en appelant navigator.credentials.get() avec les options fournies dans screen.data.publicKeyChallengeOptions. En cas de réussite, elle soumet les informations d’identification obtenues à Auth0 avec action: "default". Si navigator.credentials.get() échoue avec une erreur connue de l’API WebAuthn (comme NotAllowedError), cette méthode appellera en interne reportWebAuthnError pour informer Auth0.Une promesse qui se résout lorsque la tentative de vérification est soumise. Elle ne renvoie pas directement de données, car une opération réussie se traduit généralement par une redirection.

Lève

Lève une erreur si screen.data.publicKeyChallengeOptions est manquante, si navigator.credentials.get() échoue avec une erreur inattendue, ou si l’envoi du formulaire à Auth0 échoue.

Example

// En supposant que "sdk" est une instance de MfaWebAuthnRoamingChallenge
try {
  await sdk.verify({ rememberDevice: true });
  // En cas de réussite, Auth0 gère la redirection.
} catch (error) {
  console.error("Security key verification failed:", error);
  // Vérifiez sdk.transaction.errors pour les messages de validation côté serveur si la page est rechargée.
}

Afficher Paramètres

Propriétés

boolean

​Constructeurs

​Exceptions

​Propriétés

​Méthodes

​Lève

​Lève

​Lève

Constructeurs

Exceptions

Propriétés

Méthodes

Lève

Lève

Lève