MfaWebAuthnRoamingChallenge

Décrit toutes les propriétés et méthodes disponibles pour personnaliser l’écran mfa-webauthn-roaming-challenge dans Universal Login.

La classe MfaWebAuthnRoamingChallenge implémente le fonctionnement de l’écran mfa-webauthn-roaming-challenge. Cet écran s’affiche lorsque l’utilisateur doit vérifier son identité à l’aide d’un authentificateur itinérant, comme une clé de sécurité.

​

Constructeurs

Créez une instance du gestionnaire d’écran de défi MFA WebAuthn itinérant :

Example

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

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
await mfaWebAuthnRoamingChallenge.verify();

​

Propriétés

branding · BrandingMembers

Fournit des configurations liées à l’image de marque, comme le thème et les paramètres associés.

client · ClientMembers

Fournit des configurations liées à l’application, comme id, name et logoUrl, pour l’écran mfa-webauthn-roaming-challenge.

organization · OrganizationMembers

Fournit des renseignements sur l’Organisation de l’utilisateur, comme id et name.

prompt · PromptMembers

Contient des données sur l’invite courante dans le flux d’authentification.

screen · ScreenMembersOnMfaWebAuthnRoamingChallenge

Contient les détails propres à l’écran mfa-webauthn-roaming-challenge, y compris sa configuration et son contexte.

tenant · TenantMembers

Contient des données liées au locataire, comme id et les métadonnées associées.

transaction · TransactionMembers

Fournit des données propres à la transaction pour l’écran mfa-webauthn-roaming-challenge, comme les identifiants actifs et les états du flux.

untrustedData · UntrustedDataMembers

Gère les données non fiables transmises au SDK, comme les entrées utilisateur pendant le défi MFA WebAuthn avec authentificateur itinérant.

user · UserMembers

Contient les détails de l’utilisateur actif, y compris username, email et roles.

​

Méthodes

changeLanguage · Promise<void>

Cette méthode modifie la langue d’affichage de la page Universal Login.

Example

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

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
mfaWebAuthnRoamingChallenge.changeLanguage({
  language: 'fr',
});

Paramètres de la méthode

Afficher Paramètres

options

LanguageChangeOptions.

language · string · requis

Le code de paramètres régionaux de la langue souhaitée (par exemple, 'en', 'fr', 'es').

persist? · "session"

Si la valeur est définie sur 'session', la langue sélectionnée est conservée pendant toute la durée de la session.

getErrors · Error []

Cette méthode récupère le tableau des erreurs de la transaction à partir du contexte, ou un tableau vide s’il n’y en a aucune.

reportWebAuthnError · Promise<void>

Cette méthode signale une erreur de l’API WebAuthn survenue pendant l’opération navigator.credentials.get().

Example

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

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
await mfaWebAuthnRoamingChallenge.reportWebAuthnError({
  error: { name: 'NotAllowedError', message: 'The operation was not allowed.' },
});

Paramètres de la méthode

Afficher Paramètres

options

MfaWebAuthnRoamingChallengeReportErrorOptions.

error · WebAuthnErrorDetails · requis

L’objet d’erreur de l’API WebAuthn (navigator.credentials.get()) à signaler.

name · string · requis

Le nom de l’erreur (p. ex., 'NotAllowedError').

message · string · requis

Le message d’erreur décrivant le problème.

tryAnotherMethod · Promise<void>

Cette méthode permet à l’utilisateur d’essayer une autre méthode MFA.

Example

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

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
await mfaWebAuthnRoamingChallenge.tryAnotherMethod();

verify · Promise<void>

Cette méthode lance le défi WebAuthn à l’aide de la clé de sécurité.

Example

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

const mfaWebAuthnRoamingChallenge = new MfaWebAuthnRoamingChallenge();
await mfaWebAuthnRoamingChallenge.verify();

Paramètres de la méthode

Afficher Paramètres

options

CustomOptions.

rememberDevice? · boolean

Lorsque true, mémorise le navigateur pour les futurs défis MFA. S’applique uniquement si screen.showRememberDevice est true.