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/ Vinculación de un dispositivo MFA virtual

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

Ver PDF

Vinculación de un dispositivo MFA virtual

Función

Esta API se proporciona para que los usuarios de IAM enlazan un dispositivo MFA virtual. La activación de MFA no afecta a la validez del token saliente y la autenticación MFA no puede ignorarse por la fuerza.

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

PUT /v3.0/OS-MFA/mfa-devices/bind

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
user_id	Sí	String	ID del usuario al que vinculará el dispositivo MFA virtual.
serial_number	Sí	String	Número de serie del dispositivo MFA virtual.
authentication_code_first	Sí	String	Código de verificación 1.
authentication_code_second	Sí	String	Código de verificación 2.

Parámetros de respuesta

Ninguno

Ejemplo de solicitud

Solicitud de vinculación de un dispositivo MFA cuyo número de serie sea iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}. El primer código de verificación es 977931 y el segundo código de verificación es 527347.

PUT https://iam.myhuaweicloud.com/v3.0/OS-MFA/mfa-devices/bind 
{ 
  "user_id" : "09f99d8f6a001d4f1f01c00c31968...", 
  "authentication_code_first" : "977931", 
  "authentication_code_second" : "527347", 
  "serial_number" : "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}" 
}

Ejemplo de respuesta

Código de estado: 204

La solicitud se ha realizado correctamente.

Códigos de estado

Código de estado	Descripción
204	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.
404	No se puede encontrar el recurso solicitado.
409	Se produce un conflicto cuando se guarda el recurso solicitado.
500	Se produjo un error del sistema.