> ## 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
> Describe todos los hooks y métodos disponibles para personalizar la pantalla `mfa-webauthn-roaming-challenge` de Universal Login.
La pantalla `mfa-webauthn-roaming-challenge` pide al usuario que complete un desafío de MFA con una clave de seguridad de itinerancia, como una YubiKey u otro autenticador de hardware FIDO2.
## Importación
Cada pantalla tiene su propio conjunto de hooks y métodos. El SDK admite **importación parcial** e **importación desde la raíz** para cada pantalla.
* La importación parcial te permite incluir solo el código que necesitas para tu caso de uso.
* La importación desde la raíz te permite cargar todas las pantallas desde un único paquete, lo que resulta útil cuando quieres una compilación unificada que gestione todas las pantallas posibles.
```jsx Import Example theme={null}
// importación desde la raíz
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react';
// importación parcial
import {
useMfaWebAuthnRoamingChallenge,
// Hooks de contexto
useUser,
useTenant,
useBranding,
useClient,
useOrganization,
usePrompt,
useScreen,
useTransaction,
useUntrustedData,
// Hooks comunes
useCurrentScreen,
useAuth0Themes,
useErrors,
// Hooks de utilidad
useChangeLanguage,
// Métodos
reportWebAuthnError,
tryAnotherMethod,
verify,
} from "@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge";
function MfaWebAuthnRoamingChallengeScreen() {
const { verify } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
## Hooks de contexto
Hooks asociados a la pantalla que proporcionan acceso de solo lectura a los datos de contexto de Auth0 en la pantalla `mfa-webauthn-roaming-challenge`. Impórtalos desde `@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge`.
() => BrandingMembers}>
Este hook proporciona la configuración de marca, como el logotipo, los colores y los ajustes de tema que se muestran en la pantalla `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}>
Este hook proporciona configuraciones relacionadas con el cliente, como `id`, `name` y `logoUrl`, para la pantalla `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}>
Este hook proporciona información sobre la Organización del usuario si el flujo de MFA está limitado a una Organización. Devuelve `null` cuando no hay contexto de Organización.
```jsx Example theme={null}
import { useOrganization } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function OrgSelector() {
const organization = useOrganization();
if (!organization) {
return
No organization context
;
}
}
```
() => PromptMembers}>
Este hook contiene datos sobre la pantalla actual en el flujo de autenticación.
```jsx Example theme={null}
import { usePrompt } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function FlowInfo() {
const prompt = usePrompt();
}
```
() => ScreenMembersOnMfaWebAuthnRoamingChallenge}>
Este hook contiene detalles específicos de la pantalla `mfa-webauthn-roaming-challenge`, incluida su configuración y contexto.
```jsx Example theme={null}
import { useScreen } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function ScreenDebug() {
const screen = useScreen();
}
```
() => TenantMembers}>
Este hook contiene datos relacionados con el inquilino, como `id` y los metadatos asociados.
```jsx Example theme={null}
import { useTenant } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TenantInfo() {
const tenant = useTenant();
}
```
() => TransactionMembers}>
Este hook proporciona datos específicos de la transacción para la pantalla `mfa-webauthn-roaming-challenge`, como el estado actual del flujo de MFA.
```jsx Example theme={null}
import { useTransaction } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TransactionInfo() {
const transaction = useTransaction();
}
```
() => UntrustedDataMembers}>
Este hook gestiona los datos no confiables que se pasan a la pantalla, como los valores rellenados previamente a partir de parámetros de URL.
```jsx Example theme={null}
import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function PrefilledForm() {
const untrustedData = useUntrustedData();
}
```
() => UserMembers}>
Este hook proporciona detalles del usuario activo, incluidos `username`, `email` y los métodos de autenticación disponibles.
```jsx Example theme={null}
import { useUser } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function UserProfile() {
const user = useUser();
}
```
MfaWebAuthnRoamingChallengeMembers}>
Este hook devuelve todos los métodos y el contexto disponibles en la pantalla `mfa-webauthn-roaming-challenge`.
## Métodos
Este método notifica un error de WebAuthn detectado durante el desafío con clave de seguridad de itinerancia.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function HandleWebAuthnError({ error }) {
const { reportWebAuthnError } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
**Parámetros del método**
[MfaWebAuthnRoamingChallengeReportErrorOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/MfaWebAuthnRoamingChallengeReportErrorOptions).
WebAuthnErrorDetails} required>
El objeto de error de la API de WebAuthn (`navigator.credentials.get()`) que se va a notificar.
El nombre del error (por ejemplo, `'NotAllowedError'`).
El mensaje de error que describe qué salió mal.
Este método dirige a la pantalla de selección del método MFA para que el usuario pueda elegir otro factor de autenticación.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function TryAnotherMethodButton() {
const { tryAnotherMethod } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
Este método inicia la verificación con la clave de seguridad de itinerancia para completar el desafío de MFA.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingChallenge } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-challenge';
function VerifyButton() {
const { verify } = useMfaWebAuthnRoamingChallenge();
return (
);
}
```
**Parámetros del método**
[VerifySecurityKeyOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/VerifySecurityKeyOptions).
Opcional. Si es `true`, intenta recordar el navegador para futuros desafíos de MFA.
Corresponde al campo de formulario `rememberBrowser`.
## Hooks comunes y de utilidad
useAuth0Themes} type="Hooks">
Este hook obtiene las opciones actuales del tema con la configuración consolidada del contexto de marca.
useChangeLanguage} type="Hooks">
Este hook devuelve una función para cambiar el idioma que se muestra en la pantalla actual de ACUL.
useCurrentScreen} type="Hooks">
Este hook obtiene el contexto y el estado de la pantalla actual.
useErrors} type="Hooks">
Este hook permite leer y gestionar los errores del servidor, del cliente y del desarrollador en la pantalla.
