ResetPasswordMfaWebAuthnPlatformChallenge

Describe todas las propiedades y métodos disponibles para personalizar la pantalla reset-password-mfa-webauthn-platform-challenge de Universal Login.

La clase ResetPasswordMfaWebAuthnPlatformChallenge implementa la funcionalidad de la pantalla reset-password-mfa-webauthn-platform-challenge. Esta pantalla solicita al usuario que verifique su identidad mediante un autenticador de plataforma (como Touch ID o Windows Hello) como parte del paso de MFA en un flujo de restablecimiento de contraseña.

​

Constructores

Cree una instancia del administrador de la pantalla ResetPasswordMfaWebAuthnPlatformChallenge:

Example

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

​

Propiedades

branding · BrandingMembers

Proporciona configuraciones relacionadas con la marca, como el tema y otros ajustes de marca.

client · ClientMembers

Proporciona configuraciones relacionadas con el cliente, como id, name y logoUrl, para la pantalla reset-password-mfa-webauthn-platform-challenge.

organization · OrganizationMembers

Proporciona información sobre la organización del usuario, como id y name.

prompt · PromptMembers

Contiene datos sobre la pantalla actual del flujo de autenticación.

screen · ScreenMembersOnResetPasswordMfaWebAuthnPlatformChallenge

Contiene detalles específicos de la pantalla reset-password-mfa-webauthn-platform-challenge, incluida su configuración y contexto.

tenant · TenantMembers

Contiene datos relacionados con el inquilino, como id y los metadatos asociados.

transaction · TransactionMembers

Proporciona datos específicos de la transacción para la pantalla reset-password-mfa-webauthn-platform-challenge, como identificadores activos y estados del flujo.

untrustedData · UntrustedDataMembers

Contiene datos no confiables que se pasan al SDK, como la entrada del usuario durante el flujo de desafío de MFA.

user · UserMembers

Contiene detalles del usuario activo, incluidos username, email y roles.

​

Métodos

changeLanguage · Promise<void>

Este método cambia el idioma de visualización de la página de Universal Login.

Example

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

Parámetros del método

Mostrar Parámetros

options

LanguageChangeOptions.

language · string · requerido

El código de configuración regional del idioma deseado (por ejemplo, 'en', 'fr', 'es').

persist? · "session"

Cuando se establece en 'session', el idioma seleccionado se mantiene durante toda la sesión.

continueWithPasskey · Promise<void>

Este método inicia el desafío del autenticador de plataforma de WebAuthn y envía la credencial resultante para completar el paso de MFA durante el flujo de restablecimiento de contraseña. Si el navegador genera una DOMException (como cuando el usuario cancela), capture el error y llame a reportBrowserError para notificar a 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 },
    });
  }
}

Parámetros del método

Mostrar Parámetros

options

ResetPasswordMfaWebAuthnPlatformChallengeContinueOptions.

rememberDevice? · boolean

Cuando es true, marca el dispositivo como de confianza para que no se le vuelva a solicitar MFA al usuario en este dispositivo.

getErrors · Error []

Este método recupera la lista de errores de la transacción desde el contexto, o una lista vacía si no hay ninguno.

reportBrowserError · Promise<void>

Este método informa a Auth0 sobre un error de WebAuthn del lado del navegador, como la cancelación por parte del usuario (NotAllowedError) o un timeout 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 },
});

Parámetros del método

Mostrar Parámetros

options

ResetPasswordMfaWebAuthnPlatformChallengeReportErrorOptions.

error · WebAuthnErrorDetails · requerido

El objeto de error de la API de WebAuthn (navigator.credentials.get()) que se va a informar.

name · string · requerido

El nombre del error (por ejemplo, 'NotAllowedError').

message · string · requerido

El mensaje de error que describe el problema.

tryAnotherMethod · Promise<void>

Este método permite al usuario seleccionar otro método de MFA para completar el desafío.

Example

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