> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ResetPasswordMfaWebAuthnRoamingChallenge
> Describes all the properties and methods available to customize the Universal Login `reset-password-mfa-webauthn-roaming-challenge` screen.
The ResetPasswordMfaWebAuthnRoamingChallenge class implements the `reset-password-mfa-webauthn-roaming-challenge` screen functionality. This screen prompts the user to verify their identity using a roaming security key (such as a FIDO2 USB key) as part of the MFA step during a password reset flow.
## Constructors
Create an instance of ResetPasswordMfaWebAuthnRoamingChallenge screen manager:
```typescript Example theme={null}
import ResetPasswordMfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-roaming-challenge';
const resetPasswordMfaWebAuthnRoamingChallengeManager = new ResetPasswordMfaWebAuthnRoamingChallenge();
try {
await resetPasswordMfaWebAuthnRoamingChallengeManager.useSecurityKey({
rememberDevice: true,
});
} catch (error) {
if (error instanceof DOMException) {
await resetPasswordMfaWebAuthnRoamingChallengeManager.showError({
error: { name: error.name, message: error.message },
});
}
}
```
## Properties
BrandingMembers}>
Provides branding-related configurations, such as branding theme and settings.
ClientMembers}>
Provides client-related configurations, such as `id`, `name`, and `logoUrl`, for the `reset-password-mfa-webauthn-roaming-challenge` screen.
OrganizationMembers}>
Provides information about the user's Organization, such as `id` and `name`.
PromptMembers}>
Contains data about the current prompt in the authentication flow.
ScreenMembersOnResetPasswordMfaWebAuthnRoamingChallenge}>
Contains details specific to the `reset-password-mfa-webauthn-roaming-challenge` screen, including its configuration and context.
TenantMembers}>
Contains data related to the tenant, such as `id` and associated metadata.
TransactionMembers}>
Provides transaction-specific data for the `reset-password-mfa-webauthn-roaming-challenge` screen, such as active identifiers and flow states.
UntrustedDataMembers}>
Handles untrusted data passed to the SDK, such as user input during the MFA challenge flow.
UserMembers}>
Details of the active user, including `username`, `email`, and `roles`.
## Methods
This method changes the display language of the Universal Login page.
```typescript Example theme={null}
import ResetPasswordMfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-roaming-challenge';
const resetPasswordMfaWebAuthnRoamingChallengeManager = new ResetPasswordMfaWebAuthnRoamingChallenge();
resetPasswordMfaWebAuthnRoamingChallengeManager.changeLanguage({
language: 'fr',
});
```
**Method Parameters**
[LanguageChangeOptions](/docs/libraries/acul/js-sdk/Screens/interfaces/LanguageChangeOptions).
The locale code for the desired language (for example, `'en'`, `'fr'`, `'es'`).
When set to `'session'`, the selected language persists for the duration of the session.
Error[]}>
This method retrieves the array of transaction errors from the context, or an empty array if none exist.
This method reports a browser-side WebAuthn error to Auth0, such as user cancellation (`NotAllowedError`) or a timeout from `navigator.credentials.get()`.
```typescript Example theme={null}
import ResetPasswordMfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-roaming-challenge';
const resetPasswordMfaWebAuthnRoamingChallengeManager = new ResetPasswordMfaWebAuthnRoamingChallenge();
await resetPasswordMfaWebAuthnRoamingChallengeManager.showError({
error: { name: error.name, message: error.message },
});
```
**Method Parameters**
[ResetPasswordMfaWebAuthnRoamingChallengeShowErrorOptions](/docs/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeShowErrorOptions).
WebAuthnErrorDetails} required>
The error object from the WebAuthn API (`navigator.credentials.get()`) to be reported.
The name of the error (e.g., `'NotAllowedError'`).
The error message describing what went wrong.
When `true`, preserves the remember-device preference alongside the error report.
This method allows the user to select a different MFA method to complete the challenge.
```typescript Example theme={null}
import ResetPasswordMfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-roaming-challenge';
const resetPasswordMfaWebAuthnRoamingChallengeManager = new ResetPasswordMfaWebAuthnRoamingChallenge();
await resetPasswordMfaWebAuthnRoamingChallengeManager.tryAnotherMethod();
```
**Method Parameters**
[ResetPasswordMfaWebAuthnRoamingChallengeTryAnotherMethodOptions](/docs/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeTryAnotherMethodOptions).
When `true`, preserves the remember-device preference when switching methods.
This method initiates the WebAuthn security key challenge and submits the resulting credential to complete the MFA step during the password reset flow. If the browser throws a `DOMException` (such as user cancellation), catch the error and call `showError` to notify Auth0.
```typescript Example theme={null}
import ResetPasswordMfaWebAuthnRoamingChallenge from '@auth0/auth0-acul-js/reset-password-mfa-webauthn-roaming-challenge';
const resetPasswordMfaWebAuthnRoamingChallengeManager = new ResetPasswordMfaWebAuthnRoamingChallenge();
try {
await resetPasswordMfaWebAuthnRoamingChallengeManager.useSecurityKey({
rememberDevice: true,
});
} catch (error) {
if (error instanceof DOMException) {
await resetPasswordMfaWebAuthnRoamingChallengeManager.showError({
error: { name: error.name, message: error.message },
});
}
}
```
**Method Parameters**
[ResetPasswordMfaWebAuthnRoamingChallengeUseSecurityKeyOptions](/docs/libraries/acul/js-sdk/Screens/interfaces/ResetPasswordMfaWebAuthnRoamingChallengeUseSecurityKeyOptions).
When `true`, marks the device as trusted so the user is not prompted for MFA again on this device.