Пометка переменной Postman как "secret" лишь скрывает ее на экране: экспортируйте окружение, и API-ключ окажется в JSON открытым текстом. Полученный OAuth-токен может остаться в блоке авторизации коллекции, а сохраненный пример ответа по-прежнему содержать сеансовый cookie, поэтому следующий экспорт, форк или git-коммит передаст их вместе с остальными данными. Этот навык находит такие и еще десять ошибок в файлах API-клиентов перед передачей, коммитом или импортом и объясняет, как исправить каждую из них.

Ваш агент запускает сканер коллекций Postman (v2.0 и v2.1), экспортов окружений и глобальных переменных Postman, экспортов Insomnia (v4 JSON или YAML, v5 YAML), файлов запросов и окружений Bruno .bru. Он разбирает каждый файл с точностью до строки, считает {{variables}}, {{vault:name}}, {{ _.token }}, теги {% response %} и {{process.env.NAME}} ссылками, а не секретами, пропускает заглушки вида <API Key>, остающиеся после импорта OpenAPI, учитывает список vars:secret Bruno и читает скрипты перед запросом и тестовые скрипты с распознаванием комментариев и строк. Он никогда не отправляет запросы и не запускает скрипты. Результат: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода. Секреты никогда не выводятся.

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

БЛОКИРОВКА (исправить перед выпуском)

• P01: токены, пароли, секреты клиентов и ключи, записанные в блоках авторизации (bearer, basic, API key, OAuth 2.0 и 1.0, AWS, digest, NTLM, JWT и другие)

• P02: учетные данные в заголовках (Authorization, X-API-Key, сеансовые cookie), параметрах запроса или URL вида user:password@

• P03: пароли и секреты в телах запросов (необработанный JSON, поля форм, GraphQL)

• P04: переменные окружения, глобальные переменные и переменные коллекций с секретными названиями и реальными значениями, переменные Bruno со значениями, записанными в файле, и скрипты, задающие секрет строковым литералом

• P05: действующие ключи сервисов и закрытые ключи в любом месте файла (GitHub, GitLab, Slack, рабочие ключи Stripe, Google, OpenAI, Anthropic, SendGrid, npm, Hugging Face, API-ключи Postman)

ПРОВЕРКА (проверить перед релизом)

• P11: http:// к удаленным хостам в запросах или переменных базового URL

• P12: strictSSL false, rejectUnauthorized: false или NODE_TLS_REJECT_UNAUTHORIZED

• P13: eval() или new Function() в скриптах перед запросом и тестовых скриптах

• P14: скрипты, отправляющие все окружение, cookie или секрет на хост, который коллекция не использует (запросы OAuth-токенов распознаются)

• P15: запросы с жестко заданным рабочим хостом вместо {{baseUrl}}

• P16: сохраненные примеры ответов и хранилища cookie с сеансовыми cookie, JWT или токенами доступа

• P17: вывод секретных переменных или целых хранилищ переменных через console.log

• P18: сохранение заголовков Authorization при перенаправлении на другой хост (followAuthorizationHeader, forwardAuthorizationHeader)

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

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным подходом для каждого правила

• Пример проекта с рисками и его безопасная версия (коллекция и окружение Postman, экспорт Insomnia, запрос и окружение Bruno), а также реальный отчет сканера по проекту с рисками

Ограничения

Он читает экспортированные файлы в том виде, в каком они записаны. Значения, существующие только внутри Postman, Insomnia или Bruno (локальные значения, Postman Vault, секреты Bruno, настройки всего приложения, например глобальная проверка SSL), отсутствуют в файлах и не проверяются. Формат YAML Bruno, коллекции Postman v1, файлы HAR и отчеты Newman не читаются, а файлы больше 20 МБ отмечаются как непроверенные. NOT FLAGGED не дает гарантий.

Содержимое

Один ZIP-архив с 21 файлами: SKILL.md, сканер в scripts/ (6 файлов Python), references/rules.md (все правила с обоснованием и более безопасным подходом), а также examples/ (12 файлов примеров и report.md, реальный вывод сканера для примера с рисками).

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