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

const mfaWebAuthnRoamingChallengeManager = new MfaWebAuthnRoamingChallenge();

​
Constructeurs

​
MfaWebAuthnRoamingChallenge
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

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

​
Méthodes

​
getErrors
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.
​
reportWebAuthnError
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);
}
​
tryAnotherMethod
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);
}
​
verify
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.
}