Маршрут Flask, который отвечает на запрос url_verification от Slack, но никогда не проверяет X-Slack-Signature, принимает поддельные события и нажатия кнопок от любого, кто найдёт URL, и одна строка signatureVerification: false в приложении на Bolt делает то же самое. Этот навык находит такие ошибки и ещё одиннадцать других ошибок в приложениях Slack до развёртывания и объясняет, как исправить каждую.

Ваш агент запускает сканер для файлов JavaScript, TypeScript и Python, которые используют Slack (Bolt, slack_sdk, @slack/web-api, токены Slack, URL, заголовки или поля запроса, которые отправляет только Slack), для манифестов приложений Slack в JSON или YAML, а также для env-, конфигурационных и CI-файлов в поисках токенов и URL вебхуков. Он знает настройки Bolt по умолчанию (проверка подписи включена, пока вы её не отключите, а Socket Mode она не нужна), вспомогательные функции проверки в slack_sdk и @slack/bolt, edge-фреймворки, которые проверяют подпись по умолчанию, и понимает, когда проверка может находиться в middleware, хуке, декораторе или вспомогательной функции, которую он не может прочитать (тогда он выдаёт REVIEW, а не BLOCK). Он читает .gitignore, поэтому токен в .env-файле, который git игнорирует, учитывается одной строкой, а не выносится в отчёт. Плейсхолдеры из документации Slack игнорируются, комментарии и тестовые файлы пропускаются, ничего не запускается и не отправляется в Slack. Результат: BLOCK, REVIEW или NOT FLAGGED, с указанием файла, строки, причины и более безопасного подхода. Токены, секреты и URL вебхуков никогда не выводятся.

Что проверяется

BLOCK (исправить до выпуска)

• K01: токены Slack (xoxb, xoxp, xapp, ротируемые токены и токены обновления) в коде, манифестах, env-, конфигурационных или CI-файлах, которые попадут в коммит git
• K02: секреты подписи, секреты клиента или токены верификации, записанные литералами или литеральными резервными значениями в коде
• K03: URL входящих вебхуков или вебхуков рабочих процессов в коде, env-, конфигурационных или CI-файлах, которые попадут в коммит git
• K04: файл с целым сервером, который обрабатывает события Slack, слэш-команды или интерактивность, но не содержит ничего, что могло бы проверять X-Slack-Signature
• K05: проверка подписи в Bolt отключена (signatureVerification: false, request_verification_enabled=False) вне Socket Mode

REVIEW (проверить перед релизом)

• K11: самописная проверка подписи без пятиминутного ограничения по временной метке
• K12: самописная проверка подписи, которая сравнивает через == вместо функции сравнения за постоянное время
• K13: обработчик запросов Slack, проверка подписи которого, если она есть, находится в middleware, хуках, декораторах, вспомогательных функциях или файлах, которые сканер не может прочитать
• K14: обработчики, которые доверяют устаревшему токену верификации
• K15: админские scopes и scopes истории или поиска для пользовательских токенов (в том числе необязательные scopes) в манифестах и настройках OAuth
• K16: URL перенаправления OAuth, Events, интерактивности и слэш-команд по http (не https)
• K17: сообщения с @channel, @here или @everyone либо link_names, вызов которых содержит текст пользователя или запроса
• K18: проверка параметра state в OAuth отключена или секрет state записан в коде

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)
• Руководство по правилам с причиной, более безопасным подходом и ссылкой на документацию Slack для каждого правила
• Рискованный и безопасный примеры приложений Slack (приложение на Bolt, манифест, сервис на Flask и маршруты Express), а также реальный отчёт сканера по рискованному

Ограничения

Сканер читает каждый файл в том виде, в каком он написан: настройки, заданные на страницах конфигурации приложения Slack, значения из переменных окружения или других модулей, а также то, что на самом деле делают middleware или вспомогательные функции в других файлах, не видны. Обработчик, который нигде не упоминает Slack, не проверяется. Читается только код на JavaScript, TypeScript и Python; Bolt для Java и приложения на Go, Ruby или PHP не проверяются. Env-, конфигурационные и CI-файлы проверяются только на токены и URL вебхуков. На каждое правило и строку показывается одна находка. Тестовые файлы пропускаются. NOT FLAGGED не является гарантией.

Содержимое

Один ZIP-файл с 24 файлами: SKILL.md, сканер в scripts/ (7 файлов Python), references/rules.md (каждое правило с причиной и более безопасным подходом) и examples/ (14 файлов примеров плюс report.md, реальный результат работы сканера на рискованном примере).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить ваш проект. Скрипты также работают самостоятельно с Python 3.9 или новее, ничего устанавливать не нужно. Они только читают ваши файлы: без доступа к сети, и ничего никуда не отправляется.