MfaSmsChallenge

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

La classe MfaSmsChallenge implémente la fonctionnalité de l’écran mfa-sms-challenge. Cet écran s’affiche lorsque l’utilisateur doit saisir un code SMS pour vérifier son identité.

​

Constructeurs

Créez une instance du gestionnaire de l’écran MFA SMS Challenge :

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.continueMfaSmsChallenge({
  code: '123456',
  rememberDevice: true,
});

​

Propriétés

branding · BrandingMembers

Fournit la configuration liée à l’image de marque, comme le thème et les paramètres visuels.

client · ClientMembers

Fournit la configuration liée à l’application, comme id, name et logoUrl, pour l’écran mfa-sms-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 active dans le flux d’authentification.

screen · ScreenMembersOnMfaSmsChallenge

Contient des détails propres à l’écran mfa-sms-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-sms-challenge, comme les identifiants actifs et les états du flux.

untrustedData · UntrustedDataMembersOnMfaSmsChallenge

Gère les données non fiables transmises au SDK, comme les entrées de l’utilisateur pendant le défi MFA par SMS.

user · UserMembers

Contient les détails sur 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 MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
mfaSmsChallenge.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"

Lorsque sa valeur est 'session', la langue sélectionnée est conservée pendant toute la durée de la session.

continueMfaSmsChallenge · Promise<void>

Cette méthode soumet le défi MFA par SMS avec le code fourni.

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.continueMfaSmsChallenge({
  code: '123456',
  rememberDevice: true,
});

Paramètres de la méthode

Afficher Paramètres

options

MfaSmsChallengeOptions.

code · string · requis

Le code SMS saisi par l’utilisateur.

rememberDevice? · boolean

Lorsque sa valeur est true, cet appareil est enregistré comme fiable afin que l’utilisateur n’ait pas à effectuer la MFA lors des connexions ultérieures depuis ce même appareil.

getACall · Promise<void>

Cette méthode bascule la méthode de vérification vers un appel vocal.

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.getACall();

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.

pickSms · Promise<void>

Cette méthode redirige vers l’écran où l’utilisateur peut choisir un autre numéro pour la réception des SMS.

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.pickSms();

resendCode · Promise<void>

Cette méthode renvoie le code de vérification par SMS à l’utilisateur.

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.resendCode();

resendManager · ResendControl

Cette méthode fournit une fonction de renvoi avec délai d’attente configurable et gestion de l’état.

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
const { startResend } = mfaSmsChallenge.resendManager({
  timeoutSeconds: 15,
  onStatusChange: (remainingSeconds, isDisabled) => {
    console.log(`Resend available in ${remainingSeconds}s, disabled: ${isDisabled}`);
  },
  onTimeout: () => {
    console.log('Resend is now available');
  },
});

startResend();

Paramètres de la méthode

Afficher Paramètres

options

StartResendOptions.

onStatusChange? · OnStatusChangeCallback

Fonction de rappel appelée chaque fois que l’état du renvoi change; elle reçoit le nombre de secondes restantes et indique si le renvoi est actuellement désactivé.

onTimeout? · () => void

Fonction de rappel appelée lorsque le délai d’attente du renvoi expire et que l’option de renvoi redevient disponible.

timeoutSeconds? · number

Le nombre de secondes à attendre avant que l’option de renvoi devienne disponible.

tryAnotherMethod · Promise<void>

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

Example

import MfaSmsChallenge from '@auth0/auth0-acul-js/mfa-sms-challenge';

const mfaSmsChallenge = new MfaSmsChallenge();
await mfaSmsChallenge.tryAnotherMethod();