Como obter um token de usuário usando o Postman?
Postman é uma ferramenta de edição visual para criar e testar solicitações de API. Ele fornece uma interface de usuário fácil de usar para enviar solicitações HTTP, incluindo solicitações GET, PUT, POST e DELETE. Postman permite que você modifique parâmetros de solicitações HTTP e retorna resposta às suas solicitações.
Um token é uma credencial de acesso do usuário, que inclui identidades e permissões do usuário. Quando você chama uma API para acessar recursos de nuvem, um token é necessário para autenticação de identidade.
Execute o procedimento descrito nesta seção para obter um token de usuário usando o Postman. Para obter detalhes sobre os parâmetros, consulte Obtenção de um token de usuário.
- Período de validade de um token
O período de validade de um token é de 24 horas. Armazene seu token em cache para evitar chamadas frequentes de API. Certifique-se de que o token seja válido enquanto você o estiver usando. Usar um token que expirará em breve pode causar falhas de chamada de API.
A obtenção de um novo token não afeta a validade do token existente. No entanto, as seguintes operações invalidarão o token existente:
- Exclusão ou desativação do usuário do IAM
- Alteração da senha ou da chave de acesso do usuário do IAM
- As permissões do usuário do IAM são alteradas (devido a pagamentos pendentes, aprovação de aplicação de OBT ou modificação de permissão).
- Obtenção de um token
- Se a sua conta da Huawei Cloud tiver sido atualizada para uma HUAWEI ID, você não poderá obter um token usando a HUAWEI ID. No entanto, você pode criar um usuário do IAM, conceder as permissões necessárias ao usuário e obter um token como usuário.
- Se você for usuário de um sistema de terceiros, não poderá obter um token usando o nome de usuário e a senha que usa para autenticação de identidade federada. Vá para a página de logon da Huawei Cloud, clique em Forgot password, clique em Reset Huawei Cloud account password e defina uma senha.
Pré-requisitos
Você instalou e se registrou no Postman.
- É aconselhável instalar uma versão do Postman que suporte um cabeçalho maior que 32 KB. Caso contrário, poderá ser relatado um erro de estouro de cabeçalho.
Procedimento
- Edite o URL da solicitação, o cabeçalho e o corpo da API usada para obter um token para chamar APIs.
- URL de solicitação
O URL da solicitação está no formato "https://IAM region and endpoint/API URI".
- Obtenha a região e o ponto de extremidade do IAM em Regiões e pontos de extremidade.
Figura 1 Regiões e pontos de extremidade do IAM
- Obtenha o URI da API em Obtenção de um token de usuário.
Por exemplo, o URL de solicitação na região ap-southeast-1 é https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/tokens.
- Selecione um método de solicitação da API e insira o URL da solicitação no Postman.
- Obtenha a região e o ponto de extremidade do IAM em Regiões e pontos de extremidade.
- Cabeçalho da solicitação
Defina key como Content-Type e value como application/json;charset=utf8.
- Corpo da solicitação
Modifique os parâmetros no corpo da solicitação de exemplo.
{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "Account name" }, "name": "IAM user name", "password": "IAM user password" } } }, "scope": { "domain": { "name": "Account name" } } } }
Para obter detalhes sobre como obter o nome da conta e o nome de usuário do IAM, consulte Obtenção de informações de conta, usuário do IAM e projeto.
- URL de solicitação
- Clique em Send para enviar a solicitação da API.
- Visualize o token no cabeçalho da resposta. Você pode usar esse token para autenticação ao chamar outras APIs do IAM.
- Se o erro 401 for retornado, a autenticação falhou. Certifique-se de que os parâmetros no corpo da solicitação estão corretos e envie a solicitação novamente.
- Se o erro 400 for retornado, o formato do corpo está incorreto. Verifique se o formato do corpo está em conformidade com a sintaxe JSON. Para obter detalhes, consulte Códigos de status.
- Se a mensagem "Header Overflow" for exibida, resolva o problema consultando Por que estou vendo uma mensagem indicando estouro de cabeçalho quando tento usar o Postman para obter um token?
Por que estou vendo uma mensagem indicando estouro de cabeçalho quando tento usar o Postman para obter um token?
O Postman da V7.25.0, V7.26.0 ou de uma versão posterior não pode ser usado para obter um token de usuário devido a configurações. A mensagem "Header Overflow" será exibida se você usar qualquer uma dessas versões.
- Solução 1
Use uma versão anterior do Postman, como V 5.xx.
- Solução 2
Use curl para obter um token e substituir o texto em negrito por valores reais:
curl -ik -X POST -H 'Content-Type=application/json;charset=utf8' -d '{"auth": {"identity": {"methods": ["password"],"password": {"user": {"domain": {"name": "Account name"},"name": "IAM username","password": "IAM user password"}}},"scope": {"domain": {"name": "Account name"}}}}' https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/tokens
- Solução 3
Passe uma variável de ambiente adicional NODE_OPTIONS=--max-http-header-size=16384 (16 KB) ao Postman para especificar o tamanho máximo do cabeçalho HTTP (em bytes).
Execute um dos seguintes comandos, dependendo do seu sistema operacional:
- macOS
NODE_OPTIONS=--max-http-header-size=16384 /Applications/Postman.app/Contents/MacOS/Postman
- Linux
NODE_OPTIONS=--max-http-header-size=16384 /path/to/Postman/Postman
- Windows
set NODE_OPTIONS=--max-http-header-size=16384 C:\users\<username>\AppData\local\Postman\Postman.exe
- macOS