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/ Vinculação de um dispositivo de MFA virtual

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

Ver PDF

Vinculação de um dispositivo de MFA virtual

Função

Esta API é fornecida para que os usuários do IAM vinculem um dispositivo de MFA virtual. A ativação de MFA não afeta a validade do token existente e a autenticação de MFA não pode ser ignorada à força.

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-MFA/mfa-devices/bind

Parâmetros de solicitação

**Tabela 1** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-token	Sim	String	Token (sem requisitos especiais de permissão) do usuário do IAM correspondente ao user_id especificado no corpo da solicitação.

**Tabela 2** Parâmetro no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
user_id	Sim	String	ID do usuário ao qual você vinculará o dispositivo de MFA virtual.
serial_number	Sim	String	Número de série do dispositivo de MFA virtual.
authentication_code_first	Sim	String	Código de verificação 1.
authentication_code_second	Sim	String	Código de verificação 2.

Parâmetros de resposta

Nenhum

Exemplo de solicitação

Solicitação para vincular um dispositivo de MFA cujo número de série é iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}. O primeiro código de verificação é 977931 e o segundo código de verificação é 527347.

PUT https://iam.myhuaweicloud.com/v3.0/OS-MFA/mfa-devices/bind 
 
{ 
  "user_id" : "09f99d8f6a001d4f1f01c00c31968...", 
  "authentication_code_first" : "977931", 
  "authentication_code_second" : "527347", 
  "serial_number" : "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}" 
}

Exemplo de resposta

Código de status: 204

A solicitação foi bem-sucedida.

Códigos de status

Código de status	Descrição
204	A solicitação foi bem-sucedida.
400	A solicitação é inválida.
401	Falha na autenticação.
403	Você não tem permissão para executar esta ação.
404	O recurso solicitado não pode ser encontrado.
409	Um conflito ocorre quando o recurso solicitado é salvo.
500	Ocorreu um erro no sistema.