Neste passo a passo iremos utilizar uma conta de serviço para geração da chave que faz a ligação/autenticação de uma API.
Antes de tudo é necessário confirmar se possui uma conta de serviço ativa, caso não tenha, você pode conferir através deste link a orientação para solicitação de uma conta.
Ao receber o convite para criação da conta de serviço e clicar em "gerar chaves", você será direcionado para uma página com os dados da sua conta, onde também será possível gerar e baixar a sua Private Key.
Os principais dados que precisaremos para geração da chave são:
- Nome da conta
- ID do tenant
- Private Key
Com essas informações em mãos, o próximo passo é executar o POSTMAN com nossa Colletion, disponibilizada neste link.
Com o POSTMAN e nossa Collection aberta, acesse o campo Variables para visualizar a tela abaixo:
Conforme a ilustração, preencha os seguintes dados:
- Base_path: utilize o link de acesso ao ambiente prod/homol
- Service Account: é o nome da conta
- Tennant ID: ID do tennant
- Private key: Para encontrar a private key abra o arquivo que foi baixado key.pem com o bloco de notas e copie todo conteúdo dentro dele, incluindo o “-----BEGIN PRIVATE KEY-----” e “-----END PRIVATE KEY-----”.
A imagem abaixo ilustra como ficará após o preenchimento:
Muito importante: após preencher as os dados da conta, no canto superior direito da tela, clique em "salvar".
Por fim, clique no "JWT Bearer Grant" e logo após em "SEND".
Com o preenchimento correto e a conta de serviço ativa, você receberá o token no console que fica disponível dentro do POSTMAN e poderá prosseguir com a ligação/utilização da API.
Finalizada a autenticação, temos disponível neste link o material para utilização da API no segmento/ferramenta solicitada.