Modificação da política de autenticação de login
Função
Esta API é fornecida para que o administrador modifique a política de autenticação de login.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
PUT /v3.0/OS-SECURITYPOLICY/domains/{domain_id}/login-policy
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
domain_id |
Sim |
String |
ID da conta. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Consulte Ações. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
object |
Política de autenticação de login. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
account_validity_period |
Não |
Integer |
Período de validade (dias) para desativar usuários se eles não tiverem feito login dentro do período. Faixa de valor: 0–240. |
custom_info_for_login |
Não |
String |
Informações personalizadas que serão exibidas após o login bem-sucedido. |
lockout_duration |
Não |
Integer |
Duração (minutos) para bloquear usuários. Faixa de valor: 15–30. |
login_failed_times |
Não |
Integer |
Número de tentativas de login malsucedidas para bloquear usuários. Faixa de valor: 3–10. |
period_with_login_failures |
Não |
Integer |
Período (minutos) para contar o número de tentativas de login malsucedidas. Faixa de valor: 15–60. |
session_timeout |
Não |
Integer |
Tempo limite da sessão (minutos) que será aplicado se você ou os usuários criados usando sua conta não realizarem nenhuma operação dentro de um período específico. Faixa de valor: 15–1440. |
show_recent_login_info |
Não |
Boolean |
Indica se as informações do último login devem ser exibidas após o login bem-sucedido. O valor pode ser true ou false. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
object |
Política de autenticação de login. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
account_validity_period |
Integer |
Período de validade (dias) para desativar usuários se eles não tiverem feito login dentro do período. |
custom_info_for_login |
String |
Informações personalizadas que serão exibidas após o login bem-sucedido. |
lockout_duration |
Integer |
Duração (minutos) para bloquear usuários. |
login_failed_times |
Integer |
Número de tentativas de login malsucedidas para bloquear usuários. |
period_with_login_failures |
Integer |
Período (minutos) para contar o número de tentativas de login malsucedidas. |
session_timeout |
Integer |
Tempo limite de sessão (minutos) que será aplicado se você ou os usuários criados usando sua conta não realizarem nenhuma operação dentro de um período específico. |
show_recent_login_info |
Boolean |
Indica se deseja exibir as informações do último login após o login bem-sucedido. |
Exemplo de solicitação
PUT https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/login-policy { "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 } }
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "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 status: 400
O corpo de solicitação é anormal.
- Exemplo 1
{ "error_msg" : "'%(key)s' is a required property.", "error_code" : "IAM.0072" }
- Exemplo 2
{ "error_msg" : "Invalid input for field '%(key)s'. The value is '%(value)s'.", "error_code" : "IAM.0073" }
Código de status: 403
Acesso negado.
{ "error_msg" : "You are not authorized to perform the requested action.", "error_code" : "IAM.0002" }
Código de status: 500
O sistema não está normal.
{ "error_msg" : "An unexpected error prevented the server from fulfilling your request.", "error_code" : "IAM.0006" }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
A solicitação foi bem-sucedida. |
400 |
O corpo de solicitação é anormal. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
500 |
O sistema não está normal. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.