@auth0/auth0-acul-js - v1.0.0
    Preparing search index...

    Class MfaWebAuthnRoamingEnrollment

    Class implementing the mfa-webauthn-roaming-enrollment screen functionality. This screen is displayed when a user needs to enroll a WebAuthn roaming authenticator (like a security key).

    Hierarchy

    • BaseContext
      • MfaWebAuthnRoamingEnrollment

    Implements

    Index

    Constructors

    Properties

    screenIdentifier: string = ScreenIds.MFA_WEBAUTHN_ROAMING_ENROLLMENT

    Methods - Language

    • Utility Feature

      Changes the language/locale for the current authentication flow.

      This method triggers a language change by submitting the new locale preference to the server with the 'change-language' action. The language change will cause the current screen to re-render with the new locale.

      Parameters

      • options: Screens.LanguageChangeOptions

        Language change options including the target language code

        Options for changing the language/locale during the authentication flow

        • [key: string]: string | number | boolean | undefined

          Additional custom fields to be submitted along with the language change. Custom fields should be prefixed with 'ulp-'.

        • language: string

          Short language name (locale code) to be set (e.g., 'en', 'fr', 'es').

        • Optionalpersist?: "session"

          Defines persistence scope for the language preference. Currently only 'session' is supported.

          'session'
          

      Returns Promise<void>

      A promise that resolves when the form submission is complete

      import LoginId from "@auth0/auth0-acul-js/login-id";

      const loginManager = new LoginId();

      // Change language to French
      await loginManager.changeLanguage({
      language: 'fr',
      persist: 'session'
      });
      import LoginPassword from "@auth0/auth0-acul-js/login-password";

      const loginPasswordManager = new LoginPassword();

      // Change language to Spanish with additional custom data
      await loginPasswordManager.changeLanguage({
      language: 'es',
      persist: 'session',
      'ulp-custom-field': 'custom-value'
      });
      • This method is available on all screen instances that extend BaseContext
      • The language must be one of the enabled locales configured in your Auth0 tenant
      • The screen will automatically re-render with the new language after submission
      • Custom fields can be included and will be accessible in the Post Login Trigger

    Methods - Other

    • Initiates the WebAuthn credential creation and submits the result to the server. This corresponds to the user interacting with the FIDO Security Keys prompt.

      Parameters

      Returns Promise<void>

      import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

      const webauthnEnrollment = new MfaWebAuthnRoamingEnrollment();
      // Assuming you have obtained the WebAuthn credential response (e.g., from navigator.credentials.create)
      const credentialResponse = { /* ... serialized credential ... *&#x2F; };
      await webauthnEnrollment.enroll({ response: JSON.stringify(credentialResponse) });
    • Submits details about a WebAuthn browser error to the server. This is used when the browser's WebAuthn API encounters an error.

      Parameters

      Returns Promise<void>

      import MfaWebAuthnRoamingEnrollment from '@auth0/auth0-acul-js/mfa-webauthn-roaming-enrollment';

      const webauthnEnrollment = new MfaWebAuthnRoamingEnrollment();
      await webauthnEnrollment.showError({
      error: {
      name: 'NotAllowedError',
      message: 'The operation either timed out or was not allowed.',
      },
      });