Ir para conteúdo
be-human.ai
← Voltar ao blog

Supervisão humana

Revogar acesso de agente de IA: checklist de tokens, chaves e canais

Revogue o acesso de um agente de IA: corte tokens, chaves, permissões e canais, e confirme o bloqueio. Checklist para desligamentos e incidentes.

Capa tipográfica do Be Human com o título: Revogar acesso de agente de IA: checklist de tokens, chaves e canais
Ilustração conceitual criada com IA · Be Human

Para revogar o acesso de um agente de IA, corte todas as rotas que ele usa para agir: tokens de login, chaves de API, permissões de ferramentas, conectores de memória e canais de mensagem. Depois, confirme que nenhuma delas ainda funciona. Pare primeiro as novas ações, revogue as credenciais nos sistemas que as emitiram e preserve os registros que você vai precisar depois. Um checklist escrito, com um responsável nomeado e testado antes de ser necessário, transforma uma reação apressada em um procedimento curto e controlado.

Principais pontos

  • Pare primeiro as novas ações, pausando a capacidade do agente de iniciar trabalho antes de trocar qualquer credencial.
  • Faça um inventário de cada credencial que o agente possui, inclusive as que ninguém se lembra de ter criado.
  • Revogue o acesso na origem (o provedor de identidade, o console do fornecedor, a ferramenta) e não apenas apagando um arquivo de configuração local.
  • Verifique o bloqueio com uma chamada que agora deve falhar, e não com uma página de status ou com a sensação de que está pronto.
  • Preserve logs, trabalho em fila e o estado da memória antes de apagar qualquer coisa.

Comece com um inventário do que o agente consegue acessar

Antes de revogar qualquer coisa, você precisa de uma lista. Agentes costumam ter acesso em mais lugares do que indica a nota original de configuração. Pode haver um token para o sistema de clientes, uma conta de serviço pasta compartilhada, uma chave de API para um remetente de e-mail, um segredo de webhook para uma ferramenta de chat e, às vezes, um token de acesso pessoal que alguém criou durante um teste e nunca removeu. Se a lista estiver incompleta, a revogação também estará, e a brecha geralmente é descoberta pelo próprio agente no pior momento possível.

Monte o inventário a partir dos sistemas, não da memória. Para cada conexão, levante as informações abaixo:

  • O nome do sistema, o responsável por ele e a conta que o agente usa ali.
  • O tipo de credencial: token de usuário, conta de serviço, chave de API, autorização OAuth, segredo de webhook ou link assinado.
  • As permissões concedidas, descritas como ações (ler, criar, enviar, apagar, exportar) e não pelo nome comercial do produto.
  • Onde a credencial está guardada, incluindo variáveis de ambiente, cofre de segredos, arquivos de configuração ou painéis do fornecedor.
  • Se algum outro processo, pessoa ou agente depende da mesma credencial, porque compartilhar uma chave é a causa mais comum de uma revogação limpa quebrar algo não relacionado.

Mantenha esse inventário fora da memória do agente e fora das ferramentas que ele usa. O registro em que você se apoia durante um incidente não deve ser algo que o agente consiga editar.

Interrompa novas ações primeiro: os primeiros minutos

O passo seguro mais rápido é impedir que o agente comece qualquer coisa nova. Trocar uma chave leva tempo, e, enquanto isso, tarefas agendadas, mensagens na fila e novas tentativas ainda podem rodar. Uma pausa na camada de orquestração fecha essa janela imediatamente e mantém o estado do agente intacto para você inspecionar depois. Para um padrão mais amplo, veja como parar um agente de IA com segurança, sem perder registros nem trabalho em fila.

Uma sequência prática para os primeiros minutos fica assim:

  • Suspenda o agendador, os gatilhos e os webhooks de entrada do agente para que nenhuma nova execução possa começar.
  • Marque o agente como revogado no seu próprio registro, com a data e hora, o motivo e a pessoa que aprovou.
  • Congele o trabalho de saída em fila (e-mails, mensagens, chamados, pagamentos ou exportações de dados) e mova-o para um estado de retenção.
  • Avise os responsáveis por cada sistema conectado que a revogação está em andamento, para que observem atividades inesperadas.
  • Capture um instantâneo dos logs atuais, da configuração e da lista de ações pendentes antes de qualquer limpeza.

Somente depois dessas etapas alguém deve mexer nas credenciais. Essa ordem importa porque o bloqueio de novas ações é o único passo que protege o negócio enquanto o restante do trabalho continua.

Revogue credenciais na origem, não só no agente

Apagar um token do ambiente do agente remove a cópia que o agente tem, mas a credencial pode continuar válida em outro lugar. Alguém que a copiou, uma sessão em cache ou um arquivo de backup podem mantê-la viva. A abordagem confiável é revogar no sistema que emitiu a credencial. Em autorizações OAuth, isso significa remover a autorização do aplicativo na conta que a concedeu. Em chaves de API, revogue a chave no console do fornecedor. Em contas de serviço, desative a conta e depois remova os vínculos de papéis.

Depois da revogação na origem, troque qualquer segredo que o agente possa ter lido. Se uma credencial estava guardada em uma configuração compartilhada, presuma que tudo ao redor ficou visível para o agente e revise. Vincule a troca ao inventário, para que cada linha seja marcada como revogada, trocada ou mantida de propósito por outro responsável. Uma linha que não é nenhuma dessas coisas vira uma dúvida aberta para a próxima pessoa que ler o registro.

Os princípios de autorização também valem aqui. A orientação da OWASP sobre autorização destaca que o acesso deve ser verificado no ponto em que é usado. Na prática, uma permissão revogada precisa falhar na próxima requisição, e não apenas em um documento.

Uma revogação só está completa quando a credencial antiga deixa de funcionar, e não quando a configuração diz que ela foi removida.

Feche os canais pelos quais o agente pode falar

Um agente não precisa de uma credencial para causar dano se ainda puder enviar mensagens. Aliases de e-mail, bots de chat, números de SMS, linhas de voz, caixas compartilhadas e contas em redes sociais carregam a voz do agente, e alguns são fáceis de esquecer porque foram adicionados como recursos de conveniência. Cada canal precisa de uma linha própria no inventário e de um passo próprio de encerramento.

Para cada canal, escolha entre três ações. Você pode desconectar o agente do canal, transferir o canal para uma pessoa nomeada ou arquivá-lo com uma resposta automática que direcione o cliente para um contato real. Não deixe um canal aberto com o agente removido, mas com o número ainda respondendo, porque um cliente que enviar mensagem não receberá retorno e vai supor que a empresa o ignora. Quando os clientes tiverem consentido em receber mensagens do número do agente, guarde os registros de descadastro e o histórico de consentimento, pois eles pertencem à empresa, e não ao agente.

Verifique também os caminhos de entrada. Um webhook que o agente recebe de uma ferramenta de formulário, ou um feed de calendário que ele lê, pode continuar entregando dados depois da revogação se ninguém desativar o remetente. Peça a cada responsável por ferramenta conectada que confirme que o lado que envia está desligado, e não apenas que o lado que recebe foi removido.

Verifique o bloqueio e guarde as evidências

A verificação é o passo que mais equipes pulam, e é ela que comprova que a revogação funcionou. Para cada credencial do inventário, tente a ação que ela permitia, usando uma requisição de teste que agora deve ser recusada. Registre a recusa, a hora e a pessoa que fez o teste. Para cada canal, envie uma mensagem de teste pela rota antiga e confirme que ela não chega ao agente nem sai da empresa. Em seguida, confira os logs de auditoria de cada sistema conectado em busca de qualquer atividade do agente após o horário da revogação.

Cenário ilustrativo: uma pequena equipe de operações desativa um agente de triagem que respondia a dúvidas rotineiras de fornecedores. A equipe pausa o agendador, revoga uma autorização OAuth na caixa compartilhada, desativa uma conta de serviço usada pelo repositório de documentos e fecha uma integração de chat. A etapa de verificação mostra que o repositório de documentos ainda aceita uma leitura feita por uma sessão em cache. A equipe rastreia o cache, limpa-o e refaz o teste antes de fechar o chamado. Sem o teste, o acesso em cache teria permanecido até que alguém percebesse leituras estranhas, possivelmente por muito tempo.

Guarde o registro da verificação junto com o inventário. Ele se torna evidência para o responsável, para auditores, se sua empresa tiver, e para a próxima pessoa que precisar entender o que o agente conseguia alcançar. A introdução à observabilidade da OpenTelemetry explica por que logs, rastreamentos e métricas devem estar correlacionados, e é isso que torna possível esse tipo de checagem depois dos fatos.

Trate um incidente sem destruir as evidências

Em um incidente, a revogação tem outra prioridade. Você precisa interromper o dano, mas também precisa manter o registro que explica o que aconteceu. Apagar os logs de um agente, limpar a memória ou reinstalar o ambiente pode parecer organizado, mas elimina os fatos de que a investigação depende. O padrão seguro é revogar o acesso, preservar o estado e só então investigar com cópias.

Um guia curto de decisão ajuda na primeira hora:

  • Se o agente estiver causando dano ativo, pause-o e revogue primeiro as credenciais que permitem esse dano, depois o restante.
  • Se o dano já terminou e a preocupação é uma ação passada, revogue o acesso e preserve logs, memória e prompts sem executar o agente de novo.
  • Se uma credencial pode ter vazado, troque-a no sistema emissor e procure nos logs o uso dela durante a janela de exposição.
  • Se clientes ou funcionários foram afetados, designe uma pessoa para coordenar as mensagens e registre cada decisão com data e hora.
  • Se um órgão regulador, a seguradora ou um parceiro contratual precisar ser informado, deixe que o jurídico ou o responsável definam o texto e o momento.

Em incidentes com tentativas bloqueadas ou inesperadas, uma revisão estruturada do que o agente tentou fazer pode revelar quais permissões eram amplas demais. Saiba como fazer a revisão de ações bloqueadas de agentes de IA antes de decidir o que mudar.

A Be Human desenha e opera infraestrutura de agentes com essas etapas incorporadas. Cada agente tem um inventário de sua memória, ferramentas, permissões e canais, um caminho de pausa documentado e um runbook de revogação que a equipe de operações consegue executar sem depender do construtor original. A operação gerenciada pode incluir revisão de permissões, resposta a incidentes e testes periódicos do bloqueio, para que o procedimento seja praticado antes de uma emergência e não apenas escrito.

Mantenha o runbook atualizado para o próximo desligamento

Um checklist de revogação envelhece rápido. Novas integrações entram durante um piloto, um fornecedor muda a forma de emitir chaves e a pessoa que sabia onde um segredo estava guardado deixa a empresa. Revise o runbook quando um agente for adicionado, quando uma permissão mudar e pelo menos uma vez por trimestre nos agentes que lidam com dados de clientes ou funcionários. Cada revisão deve comparar o inventário atual com os sistemas, e não com o documento.

Se sua equipe também lida com a saída de funcionários, a mesma lógica vale para as pessoas que tinham acesso junto com o agente. O checklist do mesmo dia para desligar funcionários e agentes de IA mostra como revisar acessos humanos e de agentes em conjunto. Para equipes que partem do zero, o guia sobre como parar um agente de IA com segurança explica como separar a interrupção do trabalho da exclusão de registros. Use a orientação sobre aprovação humana para agentes de IA para decidir quais ações devem exigir uma pessoa antes que o agente possa executá-las.

Para encontrar a primeira tarefa que vale entregar a um agente, e o acesso que essa tarefa exigiria, faça o diagnóstico gratuito de IA da Be Human.

Perguntas frequentes

Com que rapidez devo revogar o acesso de um agente de IA? Comece pela pausa, que interrompe novas ações em minutos se o agendador e os gatilhos estiverem sob seu controle. A revogação das credenciais na origem costuma vir na mesma sessão, e o teste de verificação deve ser feito antes de alguém fechar o chamado. O tempo exato depende de quantos sistemas o agente alcança, então o inventário determina quanto tempo o procedimento completo leva.

Devo apagar a memória do agente ao revogar o acesso? Normalmente não, pelo menos não na primeira resposta. Memória, logs e trabalho em fila são as evidências que explicam o que o agente sabia e fez, e apagá-los pode conflitar com obrigações de guarda de registros ou com uma investigação. Preserve tudo primeiro e depois decida com o jurídico ou o responsável pelos dados se a exclusão é obrigatória e como verificá-la.

Quem deve poder disparar uma revogação? Nomeie pelo menos duas pessoas capazes de fazê-lo, uma da operação e uma do dono do negócio ou do líder técnico, para que a ausência de uma delas não trave a resposta. As duas devem ter o inventário, o caminho de pausa e a permissão para revogar nos sistemas emissores. Registre cada acionamento com o motivo e a hora.

Revogar o acesso pode quebrar outros sistemas? Pode, principalmente quando uma chave ou conta de serviço era compartilhada entre o agente e outro processo. Por isso o inventário precisa indicar quem mais depende de cada credencial antes de qualquer revogação. Havendo dependência, substitua primeiro a credencial compartilhada por uma separada para o outro processo e só então revogue a cópia do agente.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →