Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Identity and Access Management/ Referencia de la API/ API/ Configuraciones de seguridad/ Creación de un dispositivo MFA virtual

Actualización más reciente 2024-08-01 GMT+08:00

Ver PDF

Creación de un dispositivo MFA virtual

Función

Esta API se proporciona para que los usuarios de IAM creen un dispositivo MFA virtual.

Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.

URI

POST /v3.0/OS-MFA/virtual-mfa-devices

Parámetros de solicitud

**Tabla 1** Parámetros en el encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token (sin requisitos de permiso especiales) del usuario de IAM correspondiente al user_id especificado en el cuerpo de la solicitud.

**Tabla 2** Parámetro en el cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
virtual_mfa_device	Sí	object	Información del dispositivo MFA.

**Tabla 3** virtual_mfa_device
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Nombre del dispositivo. Longitud mínima: 1 carácter Longitud máxima: 64 caracteres
user_id	Sí	String	ID del usuario de IAM para el que creará el dispositivo MFA.

Parámetros de respuesta

Código de estado: 201

**Tabla 4** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
virtual_mfa_device	object	Información del dispositivo MFA virtual.

**Tabla 5** virtual_mfa_device
Parámetro	Tipo	Descripción
serial_number	String	Número de serie del dispositivo MFA virtual.
base32_string_seed	String	Base32 seed, que un sistema de terceros puede usar para generar un código CAPTCHA.

Ejemplo de solicitud

Solicitud de creación de un dispositivo MFA virtual

POST https://iam.myhuaweicloud.com/v3.0/OS-MFA/virtual-mfa-devices 
{ 
  "virtual_mfa_device" : { 
    "name" : "{device_name}", 
    "user_id" : "09f99d8f6a001d4f1f01c00c31968..." 
  } 
}

Ejemplo de respuesta

Código de estado: 201

La solicitud se ha realizado correctamente.

{
  "virtual_mfa_device": {
    "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
    "base32_string_seed": "{string}"
  }
}

Códigos de estado

Código de estado	Descripción
201	La solicitud se ha realizado correctamente.
400	La solicitud no es válida.
401	Error de autenticación.
403	No tiene permiso para realizar esta acción.
500	Se produjo un error del sistema.