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.
