Master Token: a chave para gerenciar seus API Tokens
O API Token é a principal forma de autenticação para operar sua conta iugu pela nossa API. Mas existem outros tipos de tokens, como o master token e o user token, usados em operações específicas.
Tipos de chave ao criar um API Token
Teste ambiente homologado
Produção ações em ambiente real
Mestre gestão das demais chaves
↑ O Master Token é a chave do tipo Mestre
Esta FAQ explica o que é o Master Token, seus benefícios e como ele impacta a sua operação, além de orientar sobre sua utilização e as melhores práticas.
1. O que é o Master Token? 2. Como funciona? 3. Como gerar? 4. Quando e como utilizar?
1. O que é o Master Token?
Um novo tipo de chave para a API iugu, focado em segurança.
O Master Token foi criado para aumentar a segurança nas rotas de criação, listagem e exclusão de API Tokens.
O uso dessa chave é obrigatório para essas rotas, garantindo um processo mais seguro para a sua operação.
Quer mais detalhes sobre autenticação na API?
Ver autenticação na documentação2. Como funciona o Master Token?
Três tipos de chave, cada uma com um papel.
A autenticação na iugu é feita por uma “Chave de API” (API Token). Ela permite que o sistema identifique a sua conta e conceda as permissões necessárias para a comunicação com a iugu em nome da conta associada. Ao gerar uma chave na sua conta, você tem três tipos disponíveis:
🧪
Teste (test)
Para utilização em ambiente homologado.
🚀
Produção (live)
Para executar ações em ambiente real.
🔑
Mestre (master)
Para gestão das demais chaves pela nossa Documentação API.
3. Como gerar um Master Token?
Tudo é feito pelo painel da sua conta iugu.
Na sua conta iugu, vá em Configurações.
Procure a seção DESENVOLVEDOR – Integração via API e clique em Novo.
Em Tipo, selecione a chave Mestre e informe um nome para ela no campo Descrição.
Para que a chave seja autorizada nos nossos endpoints, configure a Assinatura RSA informando uma chave pública. Veja como configurar a Assinatura RSA.
Clique em Salvar e confirme o processo com o iugu token na dupla autenticação.
|
Copie o token logo após criar O token gerado só fica visível durante 1 hora após a criação. Não se esqueça de copiá-lo e guardá-lo em um ambiente seguro. |
Quem deve criar e usar o Master Token?
Sugerimos que a criação seja feita apenas por usuários com a permissão “Administrador”, e que só esses usuários ou pessoas de confiança tenham acesso para utilizar o Master Token.
4. Quando e como utilizar o Master Token?
Ele é a chave principal para a gestão dos tokens.
O Master Token funciona como uma chave principal, usada sempre que for necessário executar nossa API para gestão dos tokens da sua conta mestre ou subconta. Ele é obrigatório nos seguintes endpoints:
| Referência da API | Endpoint |
|---|---|
| Criar API Token | v1/{account_id}/api_tokens |
| Listar API Tokens | v1/{account_id}/api_tokens |
| Remover API Token | v1/{account_id}/api_tokens/{id} |
Seus tokens atuais continuam funcionando
O Master Token é necessário apenas para as chamadas listadas acima. Os tokens de teste e produção já criados para outras rotas continuam funcionando normalmente.
0 Comentários