> ## 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.
# MfaWebauthnRoamingEnrollment
> Describe todos los hooks y métodos disponibles para personalizar la pantalla `mfa-webauthn-roaming-enrollment` de Universal Login.
La pantalla `mfa-webauthn-roaming-enrollment` solicita al usuario que inscriba una clave de seguridad de itinerancia, como una YubiKey u otro autenticador de hardware FIDO2, como factor MFA.
## 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.
* Usar la importación parcial le permite incluir solo el código que necesita para su caso de uso específico.
* Usar la importación desde la raíz le permite cargar todas las pantallas desde un único bundle, lo que resulta útil cuando desea una compilación unificada para gestionar todas las pantallas posibles.
```jsx Import Example theme={null}
// importación desde la raíz
import { useMfaWebAuthnRoamingEnrollment } from '@auth0/auth0-acul-react';
// importación parcial
import {
useMfaWebAuthnRoamingEnrollment,
// Hooks de contexto
useUser,
useTenant,
useBranding,
useClient,
useOrganization,
usePrompt,
useScreen,
useTransaction,
useUntrustedData,
// Hooks comunes
useCurrentScreen,
useAuth0Themes,
useErrors,
// Hooks de utilidad
useChangeLanguage,
// Métodos
enroll,
showError,
tryAnotherMethod,
} from "@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment";
function MfaWebAuthnRoamingEnrollmentScreen() {
const { enroll } = useMfaWebAuthnRoamingEnrollment();
return (
);
}
```
## Hooks de contexto
Hooks del ámbito de la pantalla que proporcionan acceso de solo lectura a los datos de contexto de Auth0 en la pantalla `mfa-webauthn-roaming-enrollment`. Impórtelos desde `@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment`.
() => BrandingMembers}>
Este hook proporciona configuración de marca, como el logotipo, los colores y la configuración del tema que se muestran en la pantalla `mfa-webauthn-roaming-enrollment`.
```jsx Example theme={null}
import { useBranding } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
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-enrollment`.
```jsx Example theme={null}
import { useClient } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function AppInfo() {
const client = useClient();
}
```
() => OrganizationMembers}>
Este hook proporciona información sobre la Organización del usuario si el flujo de MFA está asociado 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-enrollment';
function OrgSelector() {
const organization = useOrganization();
if (!organization) {
return
No organization context
;
}
}
```
() => PromptMembers}>
Este hook contiene datos sobre la pantalla actual del flujo de autenticación.
```jsx Example theme={null}
import { usePrompt } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function FlowInfo() {
const prompt = usePrompt();
}
```
() => ScreenMembersOnMfaWebAuthnRoamingEnrollment}>
Este hook contiene detalles específicos de la pantalla `mfa-webauthn-roaming-enrollment`, incluida su configuración y contexto.
```jsx Example theme={null}
import { useScreen } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
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-enrollment';
function TenantInfo() {
const tenant = useTenant();
}
```
() => TransactionMembers}>
Este hook proporciona datos específicos de la transacción para la pantalla `mfa-webauthn-roaming-enrollment`, como el estado actual del flujo de MFA.
```jsx Example theme={null}
import { useTransaction } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function TransactionInfo() {
const transaction = useTransaction();
}
```
() => UntrustedDataMembers}>
Este hook gestiona los datos no confiables que se pasan a la pantalla, como los valores precompletados a partir de parámetros de URL.
```jsx Example theme={null}
import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function PrefilledForm() {
const untrustedData = useUntrustedData();
}
```
() => UserMembers}>
Este hook proporciona información 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-enrollment';
function UserProfile() {
const user = useUser();
}
```
MfaWebAuthnRoamingEnrollmentMembers}>
Este hook devuelve todos los métodos y el contexto disponibles para la pantalla `mfa-webauthn-roaming-enrollment`.
## Métodos
Este método inicia el proceso de inscripción de la clave de seguridad de itinerancia.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingEnrollment } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function EnrollButton() {
const { enroll } = useMfaWebAuthnRoamingEnrollment();
return (
);
}
```
Este método notifica un error de WebAuthn detectado durante la inscripción de la clave de seguridad.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingEnrollment } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function HandleWebAuthnError({ error }) {
const { showError } = useMfaWebAuthnRoamingEnrollment();
return (
);
}
```
**Parámetros del método**
[ShowErrorOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/ShowErrorOptions).
WebAuthnErrorDetails} required>
El objeto de error de la API de WebAuthn (`navigator.credentials.create()`) que se notificará.
El nombre del error (por ejemplo, `'NotAllowedError'`).
El mensaje de error que describe lo que salió mal.
Este método lleva a la pantalla de selección del método MFA para que el usuario pueda elegir un factor de autenticación diferente.
```jsx Example theme={null}
import { useMfaWebAuthnRoamingEnrollment } from '@auth0/auth0-acul-react/mfa-webauthn-roaming-enrollment';
function TryAnotherMethodButton() {
const { tryAnotherMethod } = useMfaWebAuthnRoamingEnrollment();
return (
);
}
```
## Hooks comunes y de utilidad
useAuth0Themes} type="Hooks">
Este hook obtiene las opciones del tema actual 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 lee y administra los errores del servidor, del cliente y del desarrollador en la pantalla.
