КОД — как проверить своё приложение с Shannon
Shannon ищет уязвимости по исходникам и проверяет их на работающем приложении. Первый результат — отчёт с воспроизводимыми проблемами, который можно передать Codex или Claude Code для исправления.
Репозиторий и официальная инструкция
Открыть материал ↗github.com/KeygraphHQ/shannon1. Подготовь тестовую копию
Нужны папка с исходным кодом и работающая тестовая версия сайта. Используй вымышленных пользователей и тестовые данные. Shannon выполняет реальные атаки: проверяй только свои приложения или проекты с письменным разрешением. Рабочий сайт с клиентами для этого не подходит.
Сохрани копию проекта перед проверкой. Уточни, какие адреса и функции разрешено тестировать. Не используй боевые платежи, рассылки и другие действия с реальными последствиями.
2. Проверь программы и расходы
Нужны Node.js 18+ и запущенный Docker. На Windows можно использовать Docker Desktop. Выбирай актуальную поддерживаемую версию Node.js, подходящую требованиям проекта.
Node.js
Открыть материал ↗nodejs.org/Docker Desktop
Открыть материал ↗www.docker.com/products/docker-desktop/Сам Shannon открыт и бесплатен, но запросы к выбранной модели могут стоить денег. До запуска проверь тариф, лимит расходов и правила провайдера для легального тестирования безопасности. Некоторые провайдеры требуют дополнительной проверки доступа к таким задачам.
Не рассчитывай, что любая подписка автоматически подходит. Для первого запуска используй поддерживаемый способ подключения из текущей документации Shannon. Ключ вводи локально в настройке, не в переписке.
3. Начни через Codex или Claude Code
Открой папку проекта в среде, где Codex или Claude Code имеют доступ к файлам и терминалу. Отправь:
Подготовь Shannon для проверки моей тестовой копии приложения. Прочитай актуальную официальную инструкцию KeygraphHQ/shannon. Проверь Node.js и Docker, уточни путь к исходникам и адрес тестового сайта. Объясни способ подключения модели и возможные расходы. Секреты я введу локально. Пока не запускай атаки: сначала покажи точную цель, команду и план проверки.Дай адрес тестового сайта и путь к исходникам. Проверь предложенную цель, затем отдельно разреши запуск. Если у чата нет доступа к компьютеру, выполняй команды ниже самостоятельно.
4. Команды для самостоятельного запуска
Открой терминал в своей рабочей папке. Настрой подключение к модели:
npx @keygraph/shannon@latest setupСледуй мастеру. Пример запуска на Windows:
npx @keygraph/shannon@latest start -u https://staging.example.com -r "D:\projects\my-app"Замени staging.example.com на свою тестовую версию, а путь — на папку своего проекта. Пример не предназначен для проверки чужого сайта.
Если сайт запущен только на компьютере, помни: localhost внутри Docker указывает на контейнер. На Docker Desktop для доступа к компьютеру обычно используют host.docker.internal и порт приложения. Убедись, что сервис доступен контейнеру.
Сеть и Windows
Открыть материал ↗github.com/KeygraphHQ/shannon/blob/main/docs/platforms.md5. Дождись завершения и найди отчёт
Проверить состояние можно из терминала:
npx @keygraph/shannon@latest status
npx @keygraph/shannon@latest logs
npx @keygraph/shannon@latest scansЕсли запущено несколько проверок, укажи нужное рабочее пространство по инструкции. В режиме npx результаты находятся в папке .shannon/workspaces внутри домашней папки пользователя. В каталоге запуска ищи Security-Assessment-Report.pdf или Security-Assessment-Report.md.
У каждой подтверждённой находки проверь место ошибки, способ воспроизведения и последствия. Прерванная проверка не равна завершённой проверке без находок.
Команды и расположение результатов
Открыть материал ↗github.com/KeygraphHQ/shannon/blob/main/docs/development.md6. Исправь проблемы и проверь снова
Приложи отчёт в Codex или Claude Code, открытый на своём проекте:
Изучи отчёт Shannon по моему проекту. Сначала объясни подтверждённые уязвимости и предложи порядок исправлений. После согласования внеси минимальные изменения, сохрани текущую функциональность и добавь тесты, проверяющие устранение проблемы. Не меняй стек и не раскрывай секреты. В конце перечисли изменения, результаты тестов и то, что ещё нужно проверить вручную.После исправлений повтори проверку на тестовой версии. Не публикуй отчёт с рабочими паролями, токенами и внутренними данными. Shannon дополняет проверку безопасности, но не гарантирует отсутствие всех уязвимостей.