jamesalmeida/agent-honeypot

어떤 프로젝트인가요?

핵심 기능

• 01기준이 되는 flag.txt를 설치하고 일반적인 정찰 경로에 심볼릭 링크를 만듭니다.
• 02자체 에이전트를 플래그에 등록해 작업이 방해받지 않도록 합니다.
• 03방문자가 스스로 방문 기록을 남길 수 있는 추가 전용·전체 사용자 쓰기 가능 방명록을 제공합니다.
• 04재부팅 후 나타나는 선택적 macOS synthetic /flag.txt 항목을 제공합니다.
• 05Linux, macOS, Windows용 설치 및 제거 스크립트를 포함합니다.

활용 사례

• 개인 개발 머신에 체크포인트를 만들어 알 수 없는 에이전트가 탐색하는지 확인합니다.
• 공유 서버나 CI runner에 트립와이어를 추가해 어떤 에이전트가 접근했는지 기록합니다.
• 통제된 환경에서 AI 에이전트의 프롬프트 인젝션 방어를 실험합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/jamesalmeida/agent-honeypot.git
2. 2

   프로젝트 디렉터리로 이동합니다

   cd agent-honeypot
3. 3

   Linux 또는 macOS에서 설치 프로그램을 실행합니다

   ./install.sh

사용 전 알아둘 점

• !에이전트가 플래그의 위치를 알 수 있는 단서가 없으므로, 에이전트가 우연히 해당 위치를 확인해야만 작동합니다.
• !플래그는 프롬프트 수준의 요청이므로, 제대로 동작하지 않는 에이전트는 이를 무시할 수 있습니다.
• !방명록은 자기 신고 방식이고 누구나 쓸 수 있으므로, 항목은 증거가 아니라 주장에 불과합니다.
• !Windows에서 전체 설치를 하려면 권한이 상승된 PowerShell 세션이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

agent-honeypot은(는) 무엇인가요?

내 컴퓨터에 접근한 AI 에이전트를 포착하도록 체크포인트와 방명록을 설치하는 허니팟 플래그 파일입니다. agent-honeypot은 방문한 AI 에이전트가 확인할 가능성이 높은 홈 디렉터리, /etc, /tmp, root의 홈 디렉터리 등에 flag.txt를 배치합니다. 플래그에는 낯선 에이전트에게 탐색을 중단하고, 비밀 정보를 피하며, 확실하게 파악할 수 있는 문제만 수정한 뒤 상황을 보고해 달라는 일반 텍스트 메시지가 담깁니다.

agent-honeypot은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agent-honeypot은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agent-honeypot은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. agent-honeypot의 마지막 커밋은 2026년 10월 23일입니다.

agent-honeypot은(는) 어디에 사용할 수 있나요?

개인 개발 머신에 체크포인트를 만들어 알 수 없는 에이전트가 탐색하는지 확인합니다. 공유 서버나 CI runner에 트립와이어를 추가해 어떤 에이전트가 접근했는지 기록합니다. 통제된 환경에서 AI 에이전트의 프롬프트 인젝션 방어를 실험합니다.

agent-honeypot는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/jamesalmeida/agent-honeypot.git 프로젝트 디렉터리로 이동합니다: cd agent-honeypot Linux 또는 macOS에서 설치 프로그램을 실행합니다: ./install.sh

agent-honeypot은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jamesalmeida/agent-honeypot