Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Configurações de segurança/ Consulta da política de autenticação de logon

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Consulta da política de autenticação de logon

Função

Essa API é usada para consultar a política de autenticação de logon.

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

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

**Tabela 1** Parâmetros de URI
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

**Tabela 2** Parâmetros no cabeçalho da 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âmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
login_policy	object	Política de autenticação de logon.

**Tabela 4** login_policy
Parâmetro	Tipo	Descrição
account_validity_period	Integer	Período de validade (dias) para desativar usuários se eles não tiverem feito logon dentro do período.
custom_info_for_login	String	Informações personalizadas que serão exibidas após o logon bem-sucedido.
lockout_duration	Integer	Duração (minutos) para bloquear usuários.
login_failed_times	Integer	Número de tentativas de logon sem sucesso para bloquear os usuários.
period_with_login_failures	Integer	Período (minutos) para contar o número de tentativas de logon sem sucesso.
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 as informações do último logon serão exibidas após o logon bem-sucedido.

Exemplo de solicitação

Solicitação para consultar a política de autenticação de logon

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

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: 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: 404

O recurso solicitado não pode ser encontrado.

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

Código de status: 500

Erro de servidor interno.

{ 
  "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.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.