Tokens são chaves geradas na plataforma da Kondado que permitem que outras aplicações interajam programaticamente com nossas APIs e Webhooks.
Com acesso via tokens, as suas aplicações podem:
- Criar e editar conectores, destinos, integrações e modelos
- Disparar integrações
- Receber dados no seu data warehouse via webhooks
Toda essa flexibilidade também vem com o mesmo nível de segurança que a nossa plataforma oferece.
Veja abaixo como interagir com os seus tokens.
Acessando a página de tokens
1) Uma vez logado, clique no seu e-mail (menu superior à direita) e depois em configurações
2) Na página de configurações, localize a seção "Seus Tokens" e clique em "GERENCIAR"
3) Você verá a página de tokens, onde poderá criar novos ou ativar e desativar tokens existentes. Os tokens estão vinculados ao usuário que os criou.
Criando novos tokens
4) Uma vez na página de tokens, para criar tokens novos, clique no botão à direita "NOVO TOKEN"
5) Na caixa de texto que irá abrir, digite uma descrição para o token e clique em "CRIAR". Recomendamos que essa descrição seja relacionada à utilização do token (por exemplo, para receber leads do RDStation) e que você use um token para cada aplicação diferente - atualmente, não há limites para quantos tokens você pode ter em uma conta
6) Após clicar em CRIAR, nossa plataforma irá gerar o seu token. Ele é composto por duas partes:
- Chave do token: Fazendo um paralelo com um usuário e senha utilizados para acessar algum site, a chave do token se comporta como um usuário
- Token: essa informação é similar a uma senha e será exibida apenas nesse momento. Guarde-a em um lugar seguro (ou já diretamente na aplicação que irá interagir com a Kondado)
Depois de anotar o token, clique em OK
7) Pronto! o seu novo token está criado
Gerenciando seus tokens
8) Quando você já tiver tokens criados, pode ativá-los ou desativá-los à qualquer momento clicando nos switches à direita, na coluna "Ativo". Desativar um token irá torná-lo inacessível.
Recomendamos que você "rotacione" os seus tokens de tempos em tempos. Basta desativar um token antigo, criar um novo e substituí-lo na sua aplicação.
Gerenciar tokens de acesso da Kondado
Crie, descreva, rotacione e desative tokens de acesso para integrar aplicações às APIs e Webhooks da Kondado com segurança.
Acesse a página de tokens
Logado na plataforma, clique no seu e-mail no menu superior à direita, depois em Configurações e localize a seção Seus Tokens; clique em GERENCIAR.
Gere um novo token
Clique para criar um novo token, dê uma descrição relacionada ao uso (ex.: 'Receber leads do RD Station') e use um token por aplicação. Não há limite para a quantidade de tokens.
Copie e armazene o token com segurança
O token tem duas partes: a Chave do token (usuário) e o Token (senha), exibido apenas no momento da criação. Guarde-o em um cofre seguro ou diretamente na aplicação que vai consumir a API.
Use o token para criar/disparar integrações ou enviar dados via webhook
Com o token, sua aplicação pode criar e editar conectores, destinos, integrações e modelos, disparar integrações ou enviar dados ao seu data warehouse via webhook.
Rotacione e desative tokens periodicamente
Para revogar acesso, use o switch da coluna Ativo. Para rotacionar, crie um novo token, atualize a aplicação e só depois desative o antigo, garantindo continuidade da operação.
