Pular para o conteúdo
Central de Ajuda

Master Token na iugu

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ção

2. 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.

1

Na sua conta iugu, vá em Configurações.

2

Procure a seção DESENVOLVEDOR – Integração via API e clique em Novo.

3

Em Tipo, selecione a chave Mestre e informe um nome para ela no campo Descrição.

4

Para que a chave seja autorizada nos nossos endpoints, configure a Assinatura RSA informando uma chave pública. Veja como configurar a Assinatura RSA.

5

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.

Esse artigo foi útil?
Usuários que acharam isso útil: 1 de 2
Ainda precisa de ajuda? Nosso time responde pela sua conta iugu.
Abrir solicitação

0 Comentários

Artigo fechado para comentários.