Just User.
← Все гайды

КОД

Shannon — КОД

КОД — как проверить своё приложение с Shannon

Shannon ищет уязвимости по исходникам и проверяет их на работающем приложении. Первый результат — отчёт с воспроизводимыми проблемами, который можно передать Codex или Claude Code для исправления.

Репозиторий и официальная инструкция

Открыть материал ↗github.com/KeygraphHQ/shannon

1. Подготовь тестовую копию

Нужны папка с исходным кодом и работающая тестовая версия сайта. Используй вымышленных пользователей и тестовые данные. 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.md

5. Дождись завершения и найди отчёт

Проверить состояние можно из терминала:

Текст для копирования
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.md

6. Исправь проблемы и проверь снова

Приложи отчёт в Codex или Claude Code, открытый на своём проекте:

Текст для копирования
Изучи отчёт Shannon по моему проекту. Сначала объясни подтверждённые уязвимости и предложи порядок исправлений. После согласования внеси минимальные изменения, сохрани текущую функциональность и добавь тесты, проверяющие устранение проблемы. Не меняй стек и не раскрывай секреты. В конце перечисли изменения, результаты тестов и то, что ещё нужно проверить вручную.

После исправлений повтори проверку на тестовой версии. Не публикуй отчёт с рабочими паролями, токенами и внутренними данными. Shannon дополняет проверку безопасности, но не гарантирует отсутствие всех уязвимостей.

Все материалы из роликов

Открыть материал ↗t.me/justuserai