Passer au contenu principal
ResetPasswordMfaWebAuthnPlatformChallenge
Example
// Assuming 'sdk' is an instance of ResetPasswordMfaWebAuthnPlatformChallenge
try {
  await sdk.continueWithPasskey({
    rememberDevice: true // si l'utilisateur a coché la case et que sdk.screen.showRememberDevice est à true
  });
  // On success, Auth0 handles redirection.
} catch (error) {
  console.error("Platform authenticator verification failed:", error);
  // If it's a WebAuthn API error (DOMException), report it
  if (error instanceof DOMException && error.name && error.message) { // DOMException check
    await sdk.reportBrowserError({ error: { name: error.name, message: error.message } });
  }
  // Check sdk.transaction.errors for server-side validation messages if the page reloads.
}

​
Constructeurs

​
ResetPasswordMfaWebAuthnPlatformChallenge
Constructor
Initialise une nouvelle instance de la classe ResetPasswordMfaWebAuthnPlatformChallenge. Elle récupère le contexte nécessaire (écran, transaction, etc.) à partir du contexte global universal_login_context et configure les propriétés spécifiques à l’écran au moyen de ScreenOverride.

​
Exceptions levées

Si le contexte Universal Login n’est pas disponible ou si le nom de l’écran dans le contexte ne correspond pas à ResetPasswordMfaWebAuthnPlatformChallenge.screenIdentifier.

​
Propriétés

​
branding
​
client
​
organization
​
prompt
​
screen
​
tenant
​
transaction
​
untrustedData
​
user
​
screenIdentifier
string
static

​
Méthodes

​
continueWithPasskey
Promise<void>
Initialise le challenge de l’authentificateur de plateforme WebAuthn en appelant navigator.credentials.get() à l’aide des options de challenge fournies dans screen.publicKey. En cas de réussite, il soumet à Auth0 l’assertion d’informations d’identification résultante avec action: "default".Une promesse qui se résout lorsque la tentative de vérification est envoyée. Une opération réussie entraîne généralement une redirection.

​
Exceptions levées

Lève une erreur si screen.publicKey est manquant, si navigator.credentials.get() échoue (p. ex., annulation par l’utilisateur (NotAllowedError)), ou si l’envoi du formulaire à Auth0 échoue. Si navigator.credentials.get() échoue avec une DOMException, il est recommandé d’intercepter cette erreur et d’appeler reportBrowserError.
Example
// En supposant que 'sdk' est une instance de ResetPasswordMfaWebAuthnPlatformChallenge
try {
  await sdk.continueWithPasskey({
    rememberDevice: true // si l’utilisateur a coché la case et que sdk.screen.showRememberDevice est true
  });
  // En cas de succès, Auth0 gère la redirection.
} catch (error) {
  console.error("Échec de la vérification de l’authentificateur de plateforme :", error);
  // S'il s'agit d'une erreur de l'API WebAuthn (DOMException), signalez-la
  if (error instanceof DOMException && error.name && error.message) { // vérification DOMException
    await sdk.reportBrowserError({ error: { name: error.name, message: error.message } });
  }
  // Vérifiez sdk.transaction.errors pour les messages de validation côté serveur si la page se recharge.
}
​
getErrors
Récupère le tableau des erreurs de transaction à partir du contexte, ou un tableau vide s’il n’en existe aucune.Un tableau d’objets d’erreur provenant du contexte de transaction.
​
reportBrowserError
Promise<void>
Signale une erreur côté navigateur survenue pendant l’appel à l’API navigator.credentials.get(). Ceci est utilisé pour informer Auth0 de problèmes tels que l’annulation par l’utilisateur (NotAllowedError), un délai d’attente ou d’autres erreurs propres à l’API WebAuthn. Il soumet les détails de l’erreur avec action: "showError::{errorDetailsJsonString}".Une promesse qui se résout lorsque le rapport d’erreur est soumis avec succès.

​
Exceptions levées

Si l’envoi du formulaire échoue (p. ex., erreur réseau, état non valide).
Example
// Dans votre composant d’interface utilisateur, dans le bloc catch de navigator.credentials.get() :
// } catch (webAuthnError) {
//   if (webAuthnError instanceof DOMException) {
//     await sdk.reportBrowserError({
//       error: { name: webAuthnError.name, message: webAuthnError.message }
//     });
//   } else {
//     // Gérer d'autres types d'erreurs
//   }
// }
​
tryAnotherMethod
Promise<void>
Permet à l’utilisateur de se soustraire au défi de l’authentificateur de plateforme WebAuthn et de sélectionner une autre méthode d’AMF (MFA) pour vérifier son identité lors de la réinitialisation du mot de passe. Cette action envoie action: "pick-authenticator" à Auth0, ce qui doit rediriger l’utilisateur vers un écran de sélection d’un facteur d’AMF.Une promesse résolue lorsque l’action « pick-authenticator » est soumise.

​
Déclenche

Si l’envoi du formulaire échoue (p. ex., erreur réseau, état invalide).
Example
// Dans votre composant d’interface utilisateur, lorsqu’un bouton « Try Another Method » est cliqué :
try {
  await sdk.tryAnotherMethod();
  // En cas de succès, Auth0 gère la redirection vers l’écran de sélection du facteur d’AMF.
} catch (error) {
  console.error("Impossible de changer de méthode d’AMF :", error);
}