> ## 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.

# MfaBeginEnrollOptions

> Describe los hooks y métodos disponibles para personalizar la pantalla `mfa-begin-enroll-options` de Universal Login.

La pantalla `mfa-begin-enroll-options` muestra al usuario las opciones disponibles para inscribirse en la autenticación multifactor y le permite seleccionar un factor para inscribirse.

<Frame>
  <img style={{maxHeight:"400px"}} src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/62OEPAxQZojISBMcfMSSDl/7e72c9355ec129e03113121e308672a8/Screenshot_2025-02-18_at_13.40.51.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=133c4d8f3dce68983dfda31ba8933c92" alt="undefined" width="391" height="724" data-path="docs/images/cdy7uua7fh8z/62OEPAxQZojISBMcfMSSDl/7e72c9355ec129e03113121e308672a8/Screenshot_2025-02-18_at_13.40.51.png" />
</Frame>

<div id="import">
  ## Importación
</div>

Cada pantalla tiene su propio conjunto de hooks y métodos. El SDK admite **importaciones parciales** e **importaciones desde la raíz** para cada pantalla.

* Usar una importación parcial le permite incluir solo el código que necesita para su caso de uso.
* Usar una importación desde la raíz le permite cargar todas las pantallas desde un único paquete, lo que resulta útil cuando quiere una compilación unificada para gestionar todas las pantallas posibles.

```jsx Import Example theme={null}
// importación raíz
import { useMfaBeginEnrollOptions } from '@auth0/auth0-acul-react';

// importación parcial
import {
  useMfaBeginEnrollOptions,
  // Hooks de contexto
  useUser,
  useTenant,
  useBranding,
  useClient,
  useOrganization,
  usePrompt,
  useScreen,
  useTransaction,
  useUntrustedData,
  // Hooks comunes
  useCurrentScreen,
  useAuth0Themes,
  useErrors,
  // Hooks de utilidad
  useChangeLanguage,
  // Métodos
  enroll,
} from "@auth0/auth0-acul-react/mfa-begin-enroll-options";

function MfaBeginEnrollOptionsScreen() {
  const { enroll } = useMfaBeginEnrollOptions();
  return (
    <button onClick={() => enroll({ action: 'otp' })}>
      Inscribirse con la aplicación de autenticación
    </button>
  );
}
```

<div id="context-hooks">
  ## Hooks de contexto
</div>

Hooks con alcance de pantalla que proporcionan acceso de solo lectura a los datos de contexto de Auth0 en la pantalla `mfa-begin-enroll-options`. Impórtelos desde `@auth0/auth0-acul-react/mfa-begin-enroll-options`.

<ParamField body="useBranding" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/BrandingMembers">BrandingMembers</a></span>}>
  Este hook proporciona configuraciones de marca, como el logotipo, los colores y el tema que se muestran en la pantalla `mfa-begin-enroll-options`.

  ```jsx Example theme={null}
  import { useBranding } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function CustomTheme() {
    const branding = useBranding();
  }
  ```
</ParamField>

<ParamField body="useClient" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/ClientMembers">ClientMembers</a></span>}>
  Este hook proporciona configuraciones relacionadas con el cliente, como `id`, `name` y `logoUrl`, para la pantalla `mfa-begin-enroll-options`.

  ```jsx Example theme={null}
  import { useClient } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function AppInfo() {
    const client = useClient();
  }
  ```
</ParamField>

<ParamField body="useOrganization" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/OrganizationMembers">OrganizationMembers</a></span>}>
  Este hook proporciona información sobre la Organización del usuario si la inscripción en MFA está dentro del ámbito de una Organización. Devuelve `null` cuando no existe un contexto de Organización.

  ```jsx Example theme={null}
  import { useOrganization } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function OrgSelector() {
    const organization = useOrganization();
    if (!organization) {
      return <p>No organization context</p>;
    }
  }
  ```
</ParamField>

<ParamField body="usePrompt" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PromptMembers">PromptMembers</a></span>}>
  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-begin-enroll-options';
  function FlowInfo() {
    const prompt = usePrompt();
  }
  ```
</ParamField>

<ParamField body="useScreen" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/ScreenMembers">ScreenMembers</a></span>}>
  Este hook contiene detalles específicos de la pantalla `mfa-begin-enroll-options`, incluida su configuración y contexto.

  ```jsx Example theme={null}
  import { useScreen } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function ScreenDebug() {
    const screen = useScreen();
  }
  ```
</ParamField>

<ParamField body="useTenant" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/TenantMembers">TenantMembers</a></span>}>
  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-begin-enroll-options';
  function TenantInfo() {
    const tenant = useTenant();
  }
  ```
</ParamField>

<ParamField body="useTransaction" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/TransactionMembers">TransactionMembers</a></span>}>
  Este hook proporciona datos específicos de la transacción para la pantalla `mfa-begin-enroll-options`, como los factores de MFA disponibles y el estado actual del flujo.

  ```jsx Example theme={null}
  import { useTransaction } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function TransactionInfo() {
    const transaction = useTransaction();
  }
  ```
</ParamField>

<ParamField body="useUntrustedData" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/UntrustedDataMembers">UntrustedDataMembers</a></span>}>
  Este hook contiene datos no confiables que se pasan a la pantalla, como valores rellenados previamente a partir de parámetros de URL.

  ```jsx Example theme={null}
  import { useUntrustedData } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';
  function PrefilledForm() {
    const untrustedData = useUntrustedData();
  }
  ```
</ParamField>

<ParamField body="useUser" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/UserMembers">UserMembers</a></span>}>
  Este hook proporciona información sobre el 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-begin-enroll-options';
  function UserProfile() {
    const user = useUser();
  }
  ```
</ParamField>

<ParamField body="useMfaBeginEnrollOptions" type={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/MfaBeginEnrollOptionsMembers">MfaBeginEnrollOptionsMembers</a>}>
  Este hook devuelve todos los métodos y el contexto disponibles en la pantalla `mfa-begin-enroll-options`.
</ParamField>

<div id="methods">
  ## Métodos
</div>

<ParamField body="enroll" type="Promise<void>">
  Este método inicia la inscripción en el factor de MFA seleccionado y avanza el flujo hasta la pantalla de inscripción de ese factor.

  ```jsx Example theme={null}
  import { useMfaBeginEnrollOptions } from '@auth0/auth0-acul-react/mfa-begin-enroll-options';

  function EnrollOptions() {
    const { enroll } = useMfaBeginEnrollOptions();
    return (
      <button onClick={() => enroll({ action: 'otp' })}>
        Inscribirse con la aplicación de autenticación
      </button>
    );
  }
  ```

  **Parámetros del método**

  <Expandable title="Parámetros">
    <ParamField body="options">
      [MfaEnrollOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/MfaEnrollOptions).
    </ParamField>

    <ParamField body="action" type="string" required>
      La acción que indica en qué factor inscribirse. Puede ser "push-notification", "otp", "sms", "phone", "voice" o "webauthn-roaming".
    </ParamField>
  </Expandable>
</ParamField>

<div id="commonutility-hooks">
  ## Hooks comunes/utilitarios
</div>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useAuth0Themes">useAuth0Themes</a>} type="Hooks">
  Este hook obtiene las opciones del tema actual con la configuración consolidada del contexto de marca.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useChangeLanguage">useChangeLanguage</a>} type="Hooks">
  Este hook devuelve una función para cambiar el idioma de visualización en la pantalla actual de ACUL.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useCurrentScreen">useCurrentScreen</a>} type="Hooks">
  Este hook obtiene el contexto y el estado de la pantalla actual.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useErrors">useErrors</a>} type="Hooks">
  Este hook permite leer y gestionar los errores del servidor, del cliente y del desarrollador en la pantalla.
</ParamField>
