Маршрут 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 або новішим, нічого встановлювати не потрібно. Вони лише читають ваші файли: без доступу до мережі, і нічого нікуди не надсилається.