Gerenciar, regenerar e revogar tokens de API

A aba Tokens lista seus tokens de API com seus acessos, limites e último uso. A partir dela, você regenera o segredo de um token, revoga um token e vê por que um token parou de funcionar.

Onde encontrar seus tokens#

Abra o menu do workspace e escolha AI agents & API. A aba Tokens é a primeira aba; cada aba mostra sua contagem.

Quem vê quais tokens:

Cada linha mostra o Nome (com os últimos caracteres do segredo, como clv_agent_…k7Qe), o Proprietário, o Acesso (suas permissões), os Websites que ele cobre, Criado, Último uso e Expira. O rodapé conta os tokens ativos do workspace em relação ao seu limite. Selos em uma linha:

Tokens revogados e expirados ficam ocultos por padrão. Clique em Mostrar revogados e expirados (contagem) para listá-los; eles permanecem listados por 30 dias.

Alterar o acesso de um token#

As permissões, websites, expiração, limites de gastos e lista de permissão de IP de um token não podem ser editados após sua criação. Para alterar qualquer um deles, crie um novo token com as novas configurações, altere seu agente e, em seguida, revogue o antigo.

Regenerar o segredo de um token#

Regenere quando um segredo puder ter vazado, ou para rotacioná-lo conforme um cronograma. O novo segredo tem o mesmo nome, acesso, websites, lista de permissão de IP, limites de gastos e data de expiração.

1. Abrir o menu do token#

   Na aba Tokens, abra o menu ⋯ na linha do token e escolha Regenerar segredo.

2. Escolher quando o segredo antigo para#

   A caixa de diálogo pergunta "Regenerar “nome”?": "Você recebe um novo segredo com o mesmo acesso. O antigo para de funcionar." Marque Manter o segredo antigo funcionando por 24 horas se os agentes ainda estiverem usando-o e você precisar de tempo para trocá-los. Deixe desmarcado para parar o segredo antigo imediatamente.

3. Copiar o novo segredo#

   Clique em Regenerar. A caixa de diálogo Token criado mostra o novo segredo uma vez. Copie-o, atualize seu agente ou armazenamento de segredos e, em seguida, clique em Eu armazenei.

Regras para regenerar:

• Apenas a pessoa que criou um token pode regenerá-lo. Um proprietário ou administrador que não o criou vê "Apenas a pessoa que criou este token pode regenerá-lo. Você pode revogá-lo."
• Um segredo pode ser regenerado uma vez. Depois disso, a linha antiga mostra "Substituído por um segredo regenerado" e não tem a opção Regenerar segredo; regenere o novo token em vez disso. Tentar novamente no segredo antigo retorna "Este token já foi regenerado, revogado ou expirou; use seu substituto ou crie um novo."
• A data de expiração não muda. Um token criado por 90 dias ainda expira na sua data original. Se as 24 horas do segredo antigo ultrapassarem essa data, ele para na data de expiração.
• Você pode regenerar mesmo quando o workspace está no limite de tokens ativos. Durante a sobreposição de 24 horas, ambos os segredos funcionam e ambos contam como tokens ativos.
• Regenerar requer que o workspace esteja no plano Pro ou superior; caso contrário, Regenerar segredo abre a caixa de diálogo de upgrade.

Revogar um token#

1. Abra o menu ⋯ na linha do token e escolha Revogar.
2. Confirme com Revogar token: "Agentes usando este token perdem o acesso imediatamente. Isso não pode ser desfeito."

Um token revogado libera seu lugar no limite de tokens ativos do workspace imediatamente.

Expiração#

Todo token expira. Você escolhe o tempo de vida ao criá-lo: 7 dias, 30 dias, 90 dias (o padrão) ou 1 ano. Não existe a opção "nunca expira", portanto, um token esquecido não pode permanecer válido para sempre. A coluna Expira mostra a data.

Após a data de expiração, toda chamada retorna "Este token expirou. Crie um novo em Integrações → AI agents & API." Um token expirado não pode ser renovado ou regenerado; crie um novo.

Lista de permissão de IP#

Um token pode ser limitado aos endereços a partir dos quais seu agente é executado (por exemplo, um executor de CI ou um servidor). Você define isso na etapa Limites do assistente em Avançado → Lista de permissão de IP: "Opcional. Um endereço ou intervalo por linha; chamadas de qualquer outro lugar são recusadas."

• Insira endereços IPv4 ou IPv6 (203.0.113.7) ou intervalos no formato CIDR (198.51.100.0/24), até 20 entradas.
• Deixe vazio para permitir qualquer endereço. A etapa de revisão mostrará então Qualquer endereço.
• Uma chamada de outro endereço retorna "Este token não pode ser usado a partir deste endereço IP."
• Uma entrada que não seja um endereço ou intervalo é recusada: "valor não é um endereço IP ou intervalo."

Por que um token parou de funcionar#

Atividade incomum#

A Clevera monitora cada token em busca de picos e avisa o proprietário do workspace com uma notificação de "Atividade incomum no token":

• Muitas solicitações recusadas em poucos minutos: o token é revogado. "Ele fez muitas solicitações recusadas em poucos minutos."
• Um número incomumente alto de alterações em poucos minutos (mais de 200 gravações ou 20 remoções de página em 10 minutos): suas gravações são pausadas por 10 minutos. Chamadas retornam "Gravações deste token estão pausadas após um pico incomum de alterações. O proprietário do workspace foi notificado." Leituras continuam funcionando.
• Créditos gastos incomumente rápido: o token não pode iniciar trabalho pago por 24 horas. "Ele gastou um número incomumente alto de créditos em poucos minutos, então não pode iniciar trabalho pago por enquanto."

Se o workspace sair do Pro#

AI agents & API está nos planos Pro, Business e Custom. Se o workspace mudar para Starter ou Free, a página mostra "AI agents & API estão incluídos no Pro": "Faça upgrade para permitir que Claude, ChatGPT e seus scripts funcionem neste workspace. Tokens e aplicativos existentes param de funcionar até lá; você ainda pode revogá-los aqui."

• Tokens permanecem listados e podem ser revogados, mas toda chamada é recusada com plan_locked.
• Regenerar segredo abre a caixa de diálogo de upgrade.
• Fazer upgrade de volta para o Pro faz os tokens funcionarem novamente. Nada é excluído; tokens ainda expiram em suas datas.

Relacionado#