ResetPasswordMfaWebAuthnPlatformChallenge

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

La classe ResetPasswordMfaWebAuthnPlatformChallenge implémente la fonctionnalité de l’écran reset-password-mfa-webauthn-platform-challenge. Cet écran invite l’utilisateur à vérifier son identité à l’aide d’un authentificateur de plateforme (comme Touch ID ou Windows Hello) à l’étape d’AMF du processus de réinitialisation du mot de passe.

​

Constructeurs

Créez une instance du gestionnaire d’écran ResetPasswordMfaWebAuthnPlatformChallenge :

Example

import ResetPasswordMfaWebAuthnPlatformChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-platform-challenge';
const resetPasswordMfaWebAuthnPlatformChallengeManager = new ResetPasswordMfaWebAuthnPlatformChallenge();
await resetPasswordMfaWebAuthnPlatformChallengeManager.continueWithPasskey({
  rememberDevice: true,
});

​

Propriétés

branding · BrandingMembers

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

client · ClientMembers

Fournit des configurations liées au client, comme id, name et logoUrl, pour l’écran reset-password-mfa-webauthn-platform-challenge.

organization · OrganizationMembers

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

prompt · PromptMembers

Contient des données sur le prompt en cours dans le flux d’authentification.

screen · ScreenMembersOnResetPasswordMfaWebAuthnPlatformChallenge

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

tenant · TenantMembers

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

transaction · TransactionMembers

Fournit des données propres à la transaction pour l’écran reset-password-mfa-webauthn-platform-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 de l’utilisateur pendant le flux de défi AMF.

user · UserMembers

Détails de l’utilisateur actif, y compris username, email et roles.

​

Méthodes

changeLanguage · Promise<void>

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

Example

import ResetPasswordMfaWebAuthnPlatformChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-platform-challenge';
const resetPasswordMfaWebAuthnPlatformChallengeManager = new ResetPasswordMfaWebAuthnPlatformChallenge();
resetPasswordMfaWebAuthnPlatformChallengeManager.changeLanguage({
  language: 'fr',
});

Paramètres de la méthode

Afficher Paramètres

options

LanguageChangeOptions.

language · string · requis

Le code de locale de la langue souhaitée (par exemple, 'en', 'fr', 'es').

persist? · "session"

Lorsque défini à 'session', la langue sélectionnée est enregistrée pour la durée de la session.

continueWithPasskey · Promise<void>

Cette méthode lance le défi d’authentification par authentificateur de plateforme WebAuthn et soumet l’information d’authentification obtenue pour terminer l’AMF pendant le processus de réinitialisation du mot de passe. Si le navigateur lance une DOMException (comme une annulation par l’utilisateur), interceptez l’erreur et appelez reportBrowserError pour en aviser Auth0.

Example

import ResetPasswordMfaWebAuthnPlatformChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-platform-challenge';
const resetPasswordMfaWebAuthnPlatformChallengeManager = new ResetPasswordMfaWebAuthnPlatformChallenge();
try {
  await resetPasswordMfaWebAuthnPlatformChallengeManager.continueWithPasskey({
    rememberDevice: true,
  });
} catch (error) {
  if (error instanceof DOMException) {
    await resetPasswordMfaWebAuthnPlatformChallengeManager.reportBrowserError({
      error: { name: error.name, message: error.message },
    });
  }
}

Paramètres de la méthode

Afficher Paramètres

options

ResetPasswordMfaWebAuthnPlatformChallengeContinueOptions.

rememberDevice? · boolean

Lorsque true, marque l’appareil comme fiable afin que l’utilisateur ne soit pas invité à refaire l’AMF sur cet appareil.

getErrors · Error []

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

reportBrowserError · Promise<void>

Cette méthode signale à Auth0 une erreur WebAuthn côté navigateur, comme une annulation par l’utilisateur (NotAllowedError) ou un délai d’expiration de navigator.credentials.get().

Example

import ResetPasswordMfaWebAuthnPlatformChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-platform-challenge';
const resetPasswordMfaWebAuthnPlatformChallengeManager = new ResetPasswordMfaWebAuthnPlatformChallenge();
await resetPasswordMfaWebAuthnPlatformChallengeManager.reportBrowserError({
  error: { name: error.name, message: error.message },
});

Paramètres de la méthode

Afficher Paramètres

options

ResetPasswordMfaWebAuthnPlatformChallengeReportErrorOptions.

error · WebAuthnErrorDetails · requis

L’objet d’erreur provenant 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 de choisir une autre méthode d’AMF pour effectuer le défi.

Example

import ResetPasswordMfaWebAuthnPlatformChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-platform-challenge';
const resetPasswordMfaWebAuthnPlatformChallengeManager = new ResetPasswordMfaWebAuthnPlatformChallenge();
await resetPasswordMfaWebAuthnPlatformChallengeManager.tryAnotherMethod();