Подборка техник и реальных случаев злоупотребления локальными AI-агентами через их конфигурацию, состояние, инструменты и унаследованные права доступа.
jamesalmeida/agent-honeypot
Файл-флаг для honeypot устанавливает контрольную точку и гостевую книгу, чтобы обнаруживать AI-агентов, которые заглядывают на вашу машину.
- Звёзды
- 64
- Форки
- 8
- Открытые issues
- 1
- Последний коммит
- 15 дней назад
Что это?
agent-honeypot размещает flag.txt в местах, которые может проверить заглянувший AI-агент: например, в домашнем каталоге, /etc, /tmp и домашнем каталоге root. В файле содержится обычное текстовое сообщение с просьбой к незнакомому агенту прекратить исследовать систему, не трогать секреты, исправлять только то, в чём он уверен, и отчитаться о проделанном.
Установщик также создаёт доступную для записи всем гостевую книгу ~/guest-book.txt, в которую посетитель может добавить строку с временной меткой и описанием того, кто он или что собой представляет и как попал на машину. Ваши собственные агенты, например opencode, Claude Code, Codex и Cursor, перечислены в файле-флаге: их не прерывают, и они не оставляют записей в гостевой книге.
Это контрольная точка, а не граница безопасности: флаг — недоверенный текст, который не выдаёт и не отбирает разрешения. Установщики доступны для Linux, macOS (с необязательной синтетической записью /flag.txt, для появления которой нужна перезагрузка) и Windows, где для создания symlink и доступа к некоторым защищённым путям требуется запустить PowerShell с повышенными правами.
Ключевые возможности
- 01Устанавливает основной файл flag.txt и создаёт на него symlink в распространённых местах, где ищут информацию о системе.
- 02Перечисляет в файле-флаге ваши собственные агенты, чтобы не прерывать их работу.
- 03Создаёт доступную для записи всем гостевую книгу, в которую посетители могут добавлять записи, но не удалять их.
- 04Предлагает необязательную синтетическую запись /flag.txt в macOS, которая появляется после перезагрузки.
- 05Включает скрипты установки и удаления для Linux, macOS и Windows.
Сценарии использования
- Оставить контрольную точку на личной машине для разработки и проверить, будут ли её исследовать неизвестные агенты.
- Добавить триггер на общий сервер или CI-раннер, чтобы фиксировать, какие агенты туда приходят.
- Экспериментировать с защитой AI-агентов от prompt injection в контролируемой среде.
Быстрый старт
- 1
Клонируйте репозиторий
git clone https://github.com/jamesalmeida/agent-honeypot.git - 2
Перейдите в каталог проекта
cd agent-honeypot - 3
Запустите установщик в Linux или macOS
./install.sh
Что важно знать
- Ничто не указывает агенту на расположение флага, поэтому он работает, только если агент случайно заглянет в эти места.
- Флаг — это запрос на уровне промпта, и агент с некорректным поведением может его проигнорировать.
- Гостевая книга основана на самоотчётах и доступна для записи всем, поэтому записи — это заявления, а не доказательства.
- Для полной установки в Windows требуется сеанс PowerShell с повышенными правами.
В подборках
Темы
Частые вопросы
- Что такое agent-honeypot?
- Файл-флаг для honeypot устанавливает контрольную точку и гостевую книгу, чтобы обнаруживать AI-агентов, которые заглядывают на вашу машину. agent-honeypot размещает flag.txt в местах, которые может проверить заглянувший AI-агент: например, в домашнем каталоге, /etc, /tmp и домашнем каталоге root. В файле содержится обычное текстовое сообщение с просьбой к незнакомому агенту прекратить исследовать систему, не трогать секреты, исправлять только то, в чём он уверен, и отчитаться о проделанном.
- agent-honeypot можно использовать бесплатно? Какая у него лицензия?
- agent-honeypot распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- agent-honeypot всё ещё поддерживается?
- Активно поддерживается. Последний коммит в agent-honeypot — 23 окт. 2026 г..
- Для чего можно использовать agent-honeypot?
- Оставить контрольную точку на личной машине для разработки и проверить, будут ли её исследовать неизвестные агенты. Добавить триггер на общий сервер или CI-раннер, чтобы фиксировать, какие агенты туда приходят. Экспериментировать с защитой AI-агентов от prompt injection в контролируемой среде.
- Как установить 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
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Универсальная платформа с более чем 20 honeypot-сервисами, дашбордами Elastic Stack, интерактивной картой атак и инструментами безопасности.
Open-source фреймворк для обмана на Go: разворачивает SSH-, HTTP-, TCP-, TELNET- и MCP-приманки и фиксирует взаимодействия атакующих.
Реализация SSH-ловушки endlessh на Go с экспортом метрик Prometheus и дашбордом Grafana для статистики атакующих.
Node.js CLI, который добавляет в HTML и JavaScript обратимые комментарии-приманки с ключами, чтобы отвлекать AI-агентов для оценки безопасности.
Обёртка для запуска Claude Code и других AI-агентов с автоматическим подтверждением действий в песочнице ОС или Docker, чтобы защитить компьютер.