> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MfaWebauthnRoamingChallenge
> Décrit tous les hooks et toutes les méthodes offerts pour personnaliser l’écran `mfa-webauthn-roaming-challenge` d’Universal Login.
L’écran `mfa-webauthn-roaming-challenge` demande à l’utilisateur de répondre à un défi d’AMF à l’aide d’une clé de sécurité itinérante, comme une YubiKey ou un autre authentificateur matériel FIDO2.
## Importation
Chaque écran a son propre ensemble de hooks et de méthodes. Le SDK prend en charge **l’importation partielle** et **l’importation depuis la racine** pour chaque écran.
* Avec l’importation partielle, vous pouvez inclure uniquement le code nécessaire à votre cas d’usage.
* Avec l’importation depuis la racine, vous pouvez charger tous les écrans à partir d’un seul bundle, ce qui est utile si vous souhaitez qu’une compilation unifiée prenne en charge tous les écrans possibles.
```jsx Import Example theme={null}
// importation racine
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react';
// importation partielle
import {
useMfaWebAuthnRoamingChallenge,
// Hooks de contexte
useUser,
useTenant,
useBranding,
useClient,
useOrganization,
usePrompt,
useScreen,
useTransaction,
useUntrustedData,
// Hooks communs
useCurrentScreen,
useAuth0Themes,
useErrors,
// Hooks utilitaires
useChangeLanguage,
// Méthodes
reportWebAuthnError,
tryAnotherMethod,
verify,
} from "@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge";
function MfaWebAuthnRoamingChallengeScreen() {
const { verify } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
## Hooks de contexte
Des hooks propres à l’écran qui fournissent un accès en lecture seule aux données de contexte Auth0 sur l’écran `mfa-webauthn-roaming-challenge`. Importez-les depuis `@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge`.
() => BrandingMembers}>
Ce hook fournit les paramètres de personnalisation de la marque, comme le logo, les couleurs et les paramètres de thème affichés sur l’écran `mfa-webauthn-roaming-challenge`.
```jsx Example theme={null}
import { useBranding } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function CustomTheme() {
const branding = useBranding();
}
```
() => ClientMembers}>
Ce hook fournit des paramètres liés au client, comme `id`, `name` et `logoUrl`, pour l’écran `mfa-webauthn-roaming-challenge`.
```jsx Example theme={null}
import { useClient } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function AppInfo() {
const client = useClient();
}
```
() => OrganizationMembers}>
Ce hook fournit des renseignements sur l’organisation de l’utilisateur si le flux MFA est limité à une organisation. Retourne `null` lorsqu’aucun contexte d’organisation n’est présent.
```jsx Example theme={null}
import { useOrganization } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function OrgSelector() {
const organization = useOrganization();
if (!organization) {
return
Aucun contexte d’organisation
;
}
}
```
() => PromptMembers}>
Ce hook contient des données sur l’invite actuelle dans le flux d’authentification.
```jsx Example theme={null}
import { usePrompt } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function FlowInfo() {
const prompt = usePrompt();
}
```
() => ScreenMembersOnMfaWebAuthnRoamingChallenge}>
Ce hook contient des détails propres à l’écran `mfa-webauthn-roaming-challenge`, y compris sa configuration et son contexte.
```jsx Example theme={null}
import { useScreen } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function ScreenDebug() {
const screen = useScreen();
}
```
() => TenantMembers}>
Ce hook contient des données liées au locataire, comme `id` et les métadonnées associées.
```jsx Example theme={null}
import { useTenant } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TenantInfo() {
const tenant = useTenant();
}
```
() => TransactionMembers}>
Ce hook fournit des données propres à la transaction pour l’écran `mfa-webauthn-roaming-challenge`, comme l’état actuel du flux MFA.
```jsx Example theme={null}
import { useTransaction } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TransactionInfo() {
const transaction = useTransaction();
}
```
() => UntrustedDataMembers}>
Ce hook traite les données non fiables transmises à l’écran, comme les valeurs préremplies provenant des paramètres d’URL.
```jsx Example theme={null}
import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function PrefilledForm() {
const untrustedData = useUntrustedData();
}
```
() => UserMembers}>
Ce hook fournit des renseignements sur l’utilisateur actif, notamment `username`, `email` et les méthodes d’authentification disponibles.
```jsx Example theme={null}
import { useUser } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function UserProfile() {
const user = useUser();
}
```
MfaWebAuthnRoamingChallengeMembers}>
Ce hook renvoie toutes les méthodes et tout le contexte disponibles pour l’écran `mfa-webauthn-roaming-challenge`.
## Méthodes
Cette méthode signale une erreur WebAuthn survenue lors du test avec une clé de sécurité itinérante.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function HandleWebAuthnError({ error }) {
const { reportWebAuthnError } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
**Paramètres de la méthode**
[MfaWebAuthnRoamingChallengeReportErrorOptions](/fr-CA/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/MfaWebAuthnRoamingChallengeReportErrorOptions).
WebAuthnErrorDetails} required>
L’objet d’erreur de l’API WebAuthn (`navigator.credentials.get()`) à signaler.
Le nom de l’erreur (p. ex., `'NotAllowedError'`).
Le message d’erreur décrivant le problème.
Cette méthode redirige vers l’écran de sélection de la méthode MFA pour permettre à l’utilisateur de choisir un autre facteur d’authentification.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TryAnotherMethodButton() {
const { tryAnotherMethod } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
Cette méthode lance la vérification de la clé de sécurité itinérante afin de terminer le défi d’AMF.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function VerifyButton() {
const { verify } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
**Paramètres de la méthode**
[VerifySecurityKeyOptions](/fr-CA/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/VerifySecurityKeyOptions).
Facultatif. Si la valeur est true, le navigateur sera mémorisé pour les futurs défis d’AMF.
Correspond au champ de formulaire `rememberBrowser`.
## Hooks communs et utilitaires
useAuth0Themes} type="Hooks">
Ce hook récupère les options de thème actuelles avec une configuration aplatie à partir du contexte de marque.
useChangeLanguage} type="Hooks">
Ce hook renvoie une fonction permettant de changer la langue d’affichage de l’écran ACUL actuel.
useCurrentScreen} type="Hooks">
Ce hook récupère le contexte et l’état de l’écran actuel.
useErrors} type="Hooks">
Ce hook permet de lire et de gérer les erreurs du serveur, du client et du développeur à l’écran.
