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/Consulta de la política de autenticación de inicio de sesión
Actualización más reciente 2024-08-01 GMT+08:00
Ver PDF
Compartir

Consulta de la política de autenticación de inicio de sesión

Función

Esta API se utiliza para consultar la política de autenticación de inicio de sesión.

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

GET /v3.0/OS-SECURITYPOLICY/domains/{domain_id}/login-policy

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

domain_id

Sí

String

ID de cuenta. Para obtener más información sobre cómo obtener el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación.

Parámetros de solicitud

Tabla 2 Parámetros en el encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de acceso emitido a un usuario para acreditar su identidad y sus permisos.

Para obtener más información sobre los permisos requeridos por el token, consulte Acciones.

Parámetros de respuesta

Tabla 3 Parámetros en el cuerpo de respuesta

Parámetro

Tipo

Descripción

login_policy

object

Política de autenticación de inicio de sesión.

Tabla 4 login_policy

Parámetro

Tipo

Descripción

account_validity_period

Integer

Período de validez (días) para deshabilitar a los usuarios si no han iniciado sesión dentro del período.

custom_info_for_login

String

Información personalizada que se mostrará al iniciar sesión correctamente.

lockout_duration

Integer

Duración (minutos) para bloquear a los usuarios.

login_failed_times

Integer

Número de intentos de inicio de sesión fallidos para bloquear a los usuarios.

period_with_login_failures

Integer

Período (minutos) para contar el número de intentos de inicio de sesión fallidos.

session_timeout

Integer

Tiempo de espera de la sesión (minutos) que se aplicará si usted o los usuarios creados con su cuenta no realizan ninguna operación dentro de un período específico.

show_recent_login_info

Boolean

Indica si se mostrará la última información de inicio de sesión al iniciar sesión correctamente.

Ejemplo de solicitud

Solicitud para consultar la política de autenticación de inicio de sesión

GET https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/login-policy

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{ 
  "login_policy" : { 
    "custom_info_for_login" : "", 
    "period_with_login_failures" : 15, 
    "lockout_duration" : 15, 
    "account_validity_period" : 99, 
    "login_failed_times" : 3, 
    "session_timeout" : 16, 
    "show_recent_login_info" : true 
  } 
}

Código de estado: 403

Acceso denegado.

  • Ejemplo 1
{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }
  • Ejemplo 2
{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de estado: 404

No se puede encontrar el recurso solicitado.

{ 
  "error_msg" : "Could not find %(target)s: %(target_id)s.", 
  "error_code" : "IAM.0004" 
}

Código de estado: 500

Error de servidor interno.

{ 
  "error_msg" : "An unexpected error prevented the server from fulfilling your request.", 
  "error_code" : "IAM.0006" 
}

Códigos de estado

Código de estado

Descripción

200

La solicitud se ha realizado correctamente.

401

Error de autenticación.

403

Acceso denegado.

404

No se puede encontrar el recurso solicitado.

500

Error de servidor interno.

Códigos de error

Para obtener más información, consulte Códigos de error.