Modificação da política de senha
Função
Essa API é fornecida para que o administrador modifique a política de senha.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
PUT /v3.0/OS-SECURITYPOLICY/domains/{domain_id}/password-policy
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
domain_id |
Sim |
String |
ID da conta. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência. |
Parâmetros de solicitação
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
X-Auth-Token |
Sim |
String |
Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
Sim |
object |
Política de senha. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
maximum_consecutive_identical_chars |
Não |
Integer |
Número máximo de vezes que um caractere pode ser apresentado consecutivamente em uma senha. Intervalo de valores: 0–32. |
|
minimum_password_age |
Não |
Integer |
Período mínimo (minutos) após o qual os usuários têm permissão para fazer uma alteração de senha. Intervalo de valores: 0–1440. |
|
minimum_password_length |
Não |
Integer |
Número mínimo de caracteres que uma senha deve conter. Intervalo de valores: 6–32. |
|
number_of_recent_passwords_disallowed |
Não |
Integer |
Número de senhas usadas anteriormente que não são permitidas. Intervalo de valores: 0–10. |
|
password_not_username_or_invert |
Não |
Boolean |
Indica se a senha pode ser o nome de usuário ou o nome de usuário escrito ao contrário. |
|
password_validity_period |
Não |
Integer |
Período de validade da senha (dias). Intervalo de valores: 0–180. O valor 0 indica que este requisito não se aplica. |
|
password_char_combination |
Não |
Integer |
Número mínimo de tipos de caracteres que uma senha deve conter. Intervalo de valores: 2–4. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
object |
Política de senha. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
maximum_consecutive_identical_chars |
Integer |
Número máximo de vezes que um caractere pode ser apresentado consecutivamente em uma senha. |
|
maximum_password_length |
Integer |
Número máximo de caracteres que uma senha pode conter. |
|
minimum_password_age |
Integer |
Período mínimo (minutos) após o qual os usuários têm permissão para fazer uma alteração de senha. |
|
minimum_password_length |
Integer |
Número mínimo de caracteres que uma senha deve conter. |
|
number_of_recent_passwords_disallowed |
Integer |
Número de senhas usadas anteriormente que não são permitidas. |
|
password_not_username_or_invert |
Boolean |
Indica se a senha pode ser o nome de usuário ou o nome de usuário escrito ao contrário. |
|
password_requirements |
String |
Caracteres que uma senha deve conter. |
|
password_validity_period |
Integer |
Período de validade da senha (dias). |
|
password_char_combination |
Integer |
Número mínimo de tipos de caracteres que uma senha deve conter. Intervalo de valores: 2–4. |
Exemplo de solicitação
Solicitação de alteração da política de senha para o seguinte: deve conter pelo menos 6 caracteres, pelo menos 3 tipos de caracteres, não pode ser o mesmo que as duas últimas senhas, o período mínimo de validade deve ser de 20 minutos, o período de validade da senha deve ser de 60 dias, os mesmos caracteres podem ser usados consecutivamente por um máximo de três vezes e não pode ser o mesmo que o nome de usuário ou o nome de usuário escrito ao contrário
PUT https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/password-policy
{
"password_policy" : {
"minimum_password_length" : 6,
"number_of_recent_passwords_disallowed" : 2,
"minimum_password_age" : 20,
"password_validity_period" : 60,
"maximum_consecutive_identical_chars" : 3,
"password_not_username_or_invert" : false,
"password_char_combination" : 3
}
}
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{
"password_policy" : {
"password_requirements" : "A password must contain at least two of the following: uppercase letters, lowercase letters, digits, and special characters.",
"minimum_password_age" : 20,
"minimum_password_length" : 8,
"maximum_password_length" : 32,
"number_of_recent_passwords_disallowed" : 2,
"password_validity_period" : 60,
"maximum_consecutive_identical_chars" : 3,
"password_not_username_or_invert" : true,
"password_char_combination" : 3
}
}
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.
- Exemplo 1
{
"error_msg" : "You are not authorized to perform the requested action.",
"error_code" : "IAM.0002"
}
- Exemplo 2
{
"error_msg" : "Policy doesn't allow %(actions)s to be performed.",
"error_code" : "IAM.0003"
}
Código de status: 500
O sistema está anormal.
{
"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 |
Falha na autenticação. |
|
403 |
Acesso negado. |
|
500 |
O sistema está anormal. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.
