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/ Criação de um dispositivo de MFA virtual
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Criação de um dispositivo de MFA virtual

Função

Esta API é fornecida para que os usuários do IAM criem um dispositivo de MFA virtual.

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

POST /v3.0/OS-MFA/virtual-mfa-devices

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

virtual_mfa_device

Sim

object

Informações do dispositivo de MFA.
Tabela 3 virtual_mfa_device

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome do dispositivo.

Comprimento mínimo: 1 caractere

Comprimento máximo: 64 caracteres

user_id

Sim

String

ID do usuário do IAM para o qual você criará o dispositivo de MFA.

Parâmetros de resposta

Código de status: 201

Tabela 4 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

virtual_mfa_device

object

Informações sobre o dispositivo de MFA virtual.
Tabela 5 virtual_mfa_device

Parâmetro

Tipo

Descrição

serial_number

String

Número de série do dispositivo de MFA virtual.

base32_string_seed

String

Semente Base32, que um sistema de terceiros pode usar para gerar um código CAPTCHA.

Exemplo de solicitação

Solicitação para criar um dispositivo de MFA virtual

POST https://iam.myhuaweicloud.com/v3.0/OS-MFA/virtual-mfa-devices 
 
{ 
  "virtual_mfa_device" : { 
    "name" : "{device_name}", 
    "user_id" : "09f99d8f6a001d4f1f01c00c31968..." 
  } 
}

Exemplo de resposta

Código de status: 201

A solicitação foi bem-sucedida.

{
  "virtual_mfa_device": {
    "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
    "base32_string_seed": "{string}"
  }
}

Códigos de status

Código de status

Descrição

201

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.

500

Ocorreu um erro no sistema.

Códigos de erro

Para obter detalhes, consulte Códigos de erro.

Tópico principal: Configurações de segurança