Catálogo organizado de técnicas e casos reais que mostram como atacantes abusam de agentes de IA locais por meio de configurações, estado, ferramentas e acessos herdados.
100+1 esta semana6PythonCC0-1.0Bem mantidoAtualizado há 4 dias
jamesalmeida/agent-honeypot
Um arquivo flag de honeypot instala um ponto de controle e um livro de visitas para detectar agentes de IA que apareçam na sua máquina.
- Estrelas
- 64
- Forks
- 8
- Issues abertas
- 1
- Último commit
- há 15 dias
O que é?
agent-honeypot coloca um flag.txt em locais que um agente de IA visitante provavelmente verificaria, como o diretório home, /etc, /tmp e o home do root. O flag contém uma mensagem em texto simples pedindo a qualquer agente desconhecido que pare de explorar, evite acessar secrets, corrija apenas o que conseguir identificar com confiança e informe o que fez.
O instalador também cria um livro de visitas em ~/guest-book.txt, com escrita apenas no final do arquivo e permissões de escrita para todos, onde um visitante pode deixar uma linha com data e hora descrevendo quem ou o que é e como conseguiu entrar. Seus próprios agentes, como opencode, Claude Code, Codex e Cursor, são listados no flag para não serem interrompidos nem assinarem o livro de visitas.
É um ponto de controle, não uma barreira de segurança: o flag é texto não confiável e não concede nem revoga permissões. Há instaladores para Linux, macOS (com uma entrada sintética opcional em /flag.txt, que exige reinicialização) e Windows, onde symlinks e alguns caminhos protegidos exigem um PowerShell com privilégios elevados.
Recursos principais
- 01Instala um flag.txt canônico e cria symlinks para ele em locais comuns de reconhecimento.
- 02Lista seus próprios agentes no flag para que não sejam interrompidos.
- 03Oferece um livro de visitas com escrita apenas no final do arquivo e permissões de escrita para todos, para que os visitantes se identifiquem.
- 04Oferece uma entrada sintética opcional em /flag.txt no macOS, que aparece após uma reinicialização.
- 05Inclui scripts de instalação e desinstalação para Linux, macOS e Windows.
Casos de uso
- Deixar um ponto de controle em uma máquina pessoal de desenvolvimento para ver se agentes desconhecidos a sondam.
- Adicionar um tripwire a um servidor compartilhado ou runner de CI para registrar quais agentes aparecem.
- Experimentar defesas contra prompt injection para agentes de IA em um ambiente controlado.
Início rápido
- 1
Clone o repositório
git clone https://github.com/jamesalmeida/agent-honeypot.git - 2
Entre no diretório do projeto
cd agent-honeypot - 3
Execute o instalador no Linux ou macOS
./install.sh
Antes de usar
- Nada indica ao agente onde está a flag, então ela só funciona se o agente por acaso procurar nesses locais.
- A flag é uma solicitação no nível do prompt, e um agente que não se comporte corretamente pode ignorá-la.
- O livro de visitas é baseado em autodeclarações e permite escrita por qualquer pessoa, então as entradas são alegações, não provas.
- A instalação completa no Windows exige uma sessão do PowerShell com privilégios elevados.
Em coleções
Tópicos
Perguntas frequentes
- O que é agent-honeypot?
- Um arquivo flag de honeypot instala um ponto de controle e um livro de visitas para detectar agentes de IA que apareçam na sua máquina. agent-honeypot coloca um flag.txt em locais que um agente de IA visitante provavelmente verificaria, como o diretório home, /etc, /tmp e o home do root. O flag contém uma mensagem em texto simples pedindo a qualquer agente desconhecido que pare de explorar, evite acessar secrets, corrija apenas o que conseguir identificar com confiança e informe o que fez.
- agent-honeypot é gratuito? Qual é a licença?
- agent-honeypot é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- agent-honeypot ainda é mantido?
- Manutenção ativa. O último commit de agent-honeypot foi em 23 de out. de 2026.
- Para que posso usar agent-honeypot?
- Deixar um ponto de controle em uma máquina pessoal de desenvolvimento para ver se agentes desconhecidos a sondam. Adicionar um tripwire a um servidor compartilhado ou runner de CI para registrar quais agentes aparecem. Experimentar defesas contra prompt injection para agentes de IA em um ambiente controlado.
- Como instalar agent-honeypot?
- Clone o repositório: git clone https://github.com/jamesalmeida/agent-honeypot.git Entre no diretório do projeto: cd agent-honeypot Execute o instalador no Linux ou macOS: ./install.sh
- Onde consigo agent-honeypot?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jamesalmeida/agent-honeypot
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Plataforma completa de honeypots que executa mais de 20 honeypots com dashboards do Elastic Stack, mapas de ataques em tempo real e ferramentas de segurança.
9,7 mil+30 esta semana1,4 milShellGPL-3.0Bem mantidoAtualizado há 12 horas
Framework de deception open source em Go para implantar serviços SSH, HTTP, TCP, TELNET e MCP-isca e registrar interações de atacantes como evidências.
2,2 mil+8 esta semana221GoGPL-3.0Bem mantidoAtualizado há 5 dias
Implementação em Go do tarpit SSH endlessh, com métricas Prometheus e um dashboard Grafana para estatísticas de atacantes.
1,5 mil+3 esta semana57GoGPL-3.0Atualizado há 13 dias
Uma CLI em Node.js que insere comentários-isca reversíveis, protegidos por chave, em HTML e JavaScript para distrair agentes de avaliação de segurança com IA.
123+24 esta semana11JavaScriptMITAtualizado há 5 dias
Um wrapper de sandbox que executa Claude Code (e outros agentes de programação com IA) com aprovação automática em um sandbox nativo do sistema operacional ou no Docker, protegendo sua máquina.
42931ShellMITBem mantidoAtualizado mês passado