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

> Describe cómo importar las inscripciones en autenticadores MFA de sus usuarios existentes.

# Importar inscripciones en autenticadores MFA de usuarios

Puede importar las inscripciones de un usuario en <Tooltip tip="Autenticación multifactor (MFA): proceso de autenticación de usuarios que utiliza un factor adicional al nombre de usuario y la contraseña, como un código por SMS." cta="Ver glosario" href="/es/docs/glossary?term=MFA">MFA</Tooltip> con la [migración automática](/es/docs/manage-users/user-migration/configure-automatic-migration-from-your-database) y las [importaciones masivas de usuarios](/es/docs/manage-users/user-migration/bulk-user-imports). Los tipos de inscripción compatibles son:

* Correo electrónico: para la verificación por correo electrónico.
* Teléfono: para la verificación por SMS.
* OTP: para contraseñas de un solo uso (OTP) utilizadas con aplicaciones de autenticación, como Google Authenticator.

Importar las inscripciones en MFA ofrece una experiencia de usuario fluida, ya que los usuarios no tendrán que volver a inscribirse después de la migración.

La experiencia de inicio de sesión clásica no admite la selección de factores para usuarios con varios factores. Si planea importar usuarios con varios factores registrados, considere usar la experiencia de [Universal Login](/es/docs/authenticate/login/auth0-universal-login).

<div id="schema">
  ## Esquema
</div>

El esquema se aplica a los factores de MFA en ambos de los siguientes flujos de trabajo.

```json lines expandable theme={null}
{
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "totp": {
                "type": "object",
                "properties": {
                "secret": {
                    "type": "string",
                        "pattern": "^[A-Z2-7]+$",
                        "description": "The OTP secret is used for MFA authentication with Google Authenticator type apps. It must be supplied in un-padded Base32 encoding, such as: JBTWY3DPEHPK3PNP"
                    },
                },
                "additionalProperties": false,
                "required": ["secret"],
            },
            "phone": {
                "type": "object",
                "properties": {
                "value": {
                    "type": "string",
                    "pattern": "^\\+[0-9]{1,15}$",
                    "description": "The phone number for SMS or Voice MFA. The phone number should include a country code and begin with +, such as: +12125550001"
                },
                },
                "additionalProperties": false,
                "required": ["value"],
            },
            "email": {
                "type": "object",
                "properties": {
                    "value": {
                        "type": "string",
                        "format": "email",
                        "description": "The email address for MFA"
                    },
                },
                "additionalProperties": false,
                "required": ["value"],
            },
        },
        "maxProperties": 1,
        "additionalProperties": false,
    },
    "minItems": 1,
    "maxItems": 10
}
```

<div id="automatic-migration">
  ## Migración automática
</div>

Las inscripciones de MFA también se pueden importar durante una [migración automática](/es/docs/authenticate/database-connections/custom-db/overview-custom-db-connections#automatic-migration-scenario). Para ello, proporciona cualquier inscripción existente en el campo `mfa_factors` del usuario que se pasa al callback al final de tu script de [inicio de sesión](/es/docs/authenticate/database-connections/custom-db/templates/login).

Cualquier error aparecerá en los registros de tu inquilino como un inicio de sesión fallido y se distinguirá de otros errores por su descripción: `Unable to import MFA factors`. Por ejemplo:

```json lines theme={null}
{
  "_id": "5e9df3b29ebabe00571c04a7",
  "date": "2020-04-20T19:10:42.916Z",
  "type": "fu",
  "description": "Unable to import MFA factors.",
  "connection": "Username-Password-Authentication",
  "connection_id": "con_mMkvaycgzgCS0p0z",
  "client_id": "aCbTAJNi5HbsjPJtRpSP6BIoLPOrSj2Cgg",
  "client_name": "All Applications",
  "ip": "10.12.13.1",
  "client_ip": null,
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36",
  "details": {
    "error": {
      "message": "Unable to import MFA factors."
    }
  },
  "user_name": "test@test.io",
  "strategy": "auth0",
  "strategy_type": "database"
}
```

<div id="bulk-user-import">
  ## Importación masiva de usuarios
</div>

1. Prepare un archivo `users.json`. Consulte [importaciones masivas de usuarios](/es/docs/manage-users/user-migration/bulk-user-imports) para obtener más información.
2. Incluya las inscripciones a MFA existentes de cada usuario.
3. Inicie una importación masiva de usuarios.
4. Actualice los factores de los usuarios existentes habilitando la opción `upsert` en la solicitud inicial.
5. Una vez que se complete la tarea de importación, revise la respuesta para detectar cualquier error. Si no se pudieron importar algunos de los factores de MFA de los usuarios, verá errores como los siguientes:

Al usar la opción `upsert`, cualquier actualización de los usuarios existentes no relacionada con MFA se habrá aplicado al perfil del usuario. Por ejemplo, el siguiente resumen de errores muestra que el atributo `picture` del usuario se estableció correctamente en `http://example.org/jdoe.png`; sin embargo, no pudimos importar los factores de MFA proporcionados. En casos como este, es seguro volver a intentar la importación para los usuarios que fallaron.

```json lines expandable theme={null}
[
  {
    "user": {
      "email": "antoinette@contoso.com",
      "picture": "http://example.org/jdoe.png",
      "mfa_factors": [
        {
          "totp": {
            "secret": "2PRXZWZAYYDAWCD"
          }
        },
        {
          "phone": {
            "value": "+15551112233"
          }
        },
        {
          "email": {
            "value": "antoinette@antoinette.biz"
          }
        }
      ]
    },
    "errors": [
      {
        "code": "MFA_FACTORS_FAILED",
        "message": "Unable to import factors"
      }
    ]
  }
]
```

<div id="recovery-codes">
  ## Códigos de recuperación
</div>

Auth0 no ofrece una forma de importar códigos de recuperación. Cuando se importan los factores de MFA del usuario, estos no contarán con un código de recuperación.

Para proporcionar un código de recuperación a los usuarios, puede comprobar si ya tienen uno registrado y, de no ser así, usar el [endpoint de regeneración de código de recuperación](https://auth0.com/docs/api/management/v2#!/Users/post_recovery_code_regeneration) para generar uno nuevo.

<div id="learn-more">
  ## Más información
</div>

* [Configurar la migración automática desde su base de datos](/es/docs/manage-users/user-migration/configure-automatic-migration-from-your-database)
* [Importaciones masivas de usuarios](/es/docs/manage-users/user-migration/bulk-user-imports)
