Tokens de API pessoais permitem acessar o Krokanti Notes a partir de ferramentas externas — scripts, automações, assistentes de IA (via MCP) e integrações. Se um token for comprometido ou não for mais necessário, você deve revogá-lo imediatamente.

O que São Tokens de API?

Tokens de API são credenciais de longa duração no formato kn_ seguido de 40 caracteres hexadecimais (por exemplo, kn_a3f8b2c1...). Eles são uma alternativa aos cookies de sessão para acesso programático à API do Krokanti Notes.

Os tokens são armazenados como hashes SHA-256 — o token bruto é exibido apenas uma vez no momento da criação e nunca é armazenado em texto simples. Se você perder um token, não poderá recuperá-lo — crie um novo.

Visualizando Seus Tokens

Vá em Configurações → Conexões
Em Tokens de API Pessoais, você verá uma lista de todos os tokens ativos com seus nomes, datas de criação e registros de último uso

Revogando um Token

Vá em Configurações → Conexões
Encontre o token que deseja revogar
Clique em Revogar ao lado dele
Confirme a ação

O token é desativado imediatamente — qualquer requisição que o use receberá uma resposta 401 Unauthorized.

Revogar um token é imediato e irreversível. Se você estiver usando o token em uma automação ou integração, ela parará de funcionar instantaneamente. Atualize a integração com um novo token antes de revogar o antigo se o tempo de inatividade for uma preocupação.

Quando Revogar

Revogue um token quando:

Você não usa mais a ferramenta ou integração para a qual ele foi criado
Você suspeita que o token foi acidentalmente exposto (por exemplo, enviado para um repositório público, exibido em um log)
Você está rotacionando credenciais como parte de uma auditoria de segurança
Você perdeu um dispositivo onde o token estava armazenado

Rotação de Tokens (Boa Prática)

Por segurança, rotacione seus tokens periodicamente:

Crie um novo token em Configurações → Conexões
Atualize sua integração/ferramenta para usar o novo token
Verifique se a integração funciona com o novo token
Revogue o token antigo

Dessa forma, não há tempo de inatividade durante a rotação.

Criando um Novo Token

Vá em Configurações → Conexões
Clique em Novo token
Insira um nome descritivo (por exemplo, "Claude Code MCP", "Script do Servidor Doméstico")
Clique em Criar — o valor do token é exibido uma vez. Copie-o imediatamente.

Nomeie seus tokens de forma descritiva para saber para que cada um é usado. "Token 1" é menos útil do que "Claude Desktop MCP" ou "Automação Zapier".

Propriedades de Segurança

Tokens são armazenados como hashes SHA-256 — uma violação de banco de dados não expõe tokens brutos
Tokens têm um limite de taxa de 100 requisições por minuto
Requisições baseadas em token não podem criar ou revogar outros tokens (operação apenas por sessão)
Todas as operações com tokens são registradas no log de auditoria (Configurações → Segurança → Log de auditoria)

Revogando Tokens de API