Сканирует экспортированные дампы доменов Azure на предмет паролей в открытом виде, строк подключения, ключей хранилища и других секретов; генерирует отчёты CSV/HTML с маскированными секретами для рабочих процессов аудита с доступом только для чтения.
Сканер PowerShell, который перебирает вывод Get-AzDomainInfo из MicroBurst в поисках паролей в открытом виде, ключей, строк подключения и других секретов, которые никогда не должны храниться в незашифрованном виде в среде Azure.
Создан для рабочих процессов аудита только для чтения: вы собираете дамп домена с помощью MicroBurst (для Get-AzDomainInfo достаточно доступа Reader), затем указываете этому инструменту папку с выводом. Он не обращается к самому Azure — он только читает файлы, которые вы уже экспортировали. Значения секретов скрываются в каждом отчёте, поэтому вывод безопасно прикреплять к результатам проверки.
# Clone / copy this folder, then from a PowerShell prompt:
.\Scan-MicroBurst.ps1 -Path .\MicroBurst-2026 -Verbose
Или импортируйте модуль и используйте командлет напрямую:
Import-Module .\MicroBurstSecretsHunter.psd1 -Force
Invoke-MBSecretScan -Path .\MicroBurst-2026
Отчёты записываются в папку с меткой времени (MBSecretScan-<timestamp>) в
текущем каталоге, если не передан параметр -OutputDirectory.
По умолчанию каждое значение маскируется, чтобы отчётами можно было безопасно делиться. Количество раскрываемых символов ограничено четвертью длины значения (не более 4
ведущих + 2 замыкающих), а всё, что короче 8 символов или равно 8, заменяется маской
фиксированной ширины — так типичный пароль отображается как ********, а 88-символьный
ключ хранилища остаётся узнаваемым как AAAA**********AA. Строки контекста
маскируются до их усечения, и каждый секрет, найденный в строке,
вырезается из контекста каждого finding'а в этой строке, поэтому открытый текст не сохраняется
в отчёте. При триаже ложных срабатываний часто быстрее увидеть полное значение —
передайте -ShowSecrets, чтобы выводить немаскированные значения везде (консоль, CSV,
HTML, JSON, SARIF). Тогда консоль и HTML сопровождаются явным предупреждающим баннером, а отчёты
необходимо рассматривать как действующий секретный материал:
Invoke-MBSecretScan -Path .\dump -ShowSecrets # raw values, for local triage
Работает на PowerShell 7+ (Windows, Linux, macOS).
Каждый запуск создаёт:
| Выходные данные | Описание |
|---|---|
| Сводка в консоли | Цветовая маркировка количества по критичности/категории плюс главные находки уровня Critical/High. |
findings.csv | Одна строка на находку (критичность, правило, файл, строка, замаскированное значение, контекст) для триажа в Excel. Поля, содержащие просканированное содержимое, экранируются от инъекции формул в электронные таблицы. |
report.html | Автономный HTML-отчёт (без внешних ресурсов, защищённый Content-Security-Policy) с карточками критичности, живым текстовым фильтром и переключателями критичности — можно передать клиенту. |
findings.json | Метаданные сканирования плюс все находки, для скриптов и инструментов (-NoJson для пропуска). |
findings.sarif | Опциональный лог SARIF 2.1.0 для инструментов сканирования кода (-Sarif). |
Каждая выходная папка также получает небольшой файл-маркер .mbsecretscan-output, чтобы
последующее сканирование, чей корень его содержит, пропускало её (см. Ограничения покрытия).
Командлет также выдаёт объекты находок в конвейер, так что вы можете их постобрабатывать:
$f = Invoke-MBSecretScan -Path .\dump -Quiet
$f | Where-Object Severity -eq 'Critical' | Format-Table File,Line,RuleName
| Правило | Уровень критичности | Пример источника в дампе |
|---|---|---|
| Строка подключения SQL/БД со встроенным паролем | Критический | Настройки App Service, экспорт web.config |
| Строка подключения учётной записи Azure Storage / 88-символьный ключ | Критический | Настройки приложения, экспорт Storage |
SharedAccessKey Service Bus / Event Hub | Критический | Конфигурации ресурсов обмена сообщениями |
| Ключ учётной записи Cosmos DB | Критический | Настройки приложения |
| Блок закрытого ключа PEM | Критический | Экспорт Key Vault / сертификатов |
Ключ Azure Function (?code= в URL Function / Logic App, x-functions-key) | Высокий | Определения Logic App, настройки приложения |
Значение параметра ARM ("adminPassword": { "value": "..." }, включая отформатированные с переносами строк) | Высокий | Шаблоны ARM / файлы параметров |
| Пароль Azure Redis Cache | Высокий | Строки подключения кэша |
Секрет клиента Azure AD (формат …Q~… после 2021 года) | Высокий | Шаблоны ARM, настройки приложения |
Токен SAS / параметр sig= | Высокий | URL-адреса SAS хранилища |
| JWT / токен bearer | Высокий | Кэшированные токены, конфигурации |
Присутствует файл сертификата / ключа (.pfx, .p12, .pem, .key, .jks, .ppk, …) | Высокий | В любом месте дампа |
Присутствует файл сертификата (.cer, .crt, .der — обычно открытый) | Низкий | В любом месте дампа |
Обобщённое присваивание password / pwd, включая составные имена (administratorLoginPassword, userPWD) | Высокий | Переменные автоматизации, настройки приложения, параметры ARM, профили публикации |
Обобщённое присваивание secret / client_secret, включая составные имена (servicePrincipalSecret) | Высокий | Настройки приложения, шаблоны |
| Ключи доступа AWS / токены GitHub / Slack | Высокий/Средний | Сторонние учётные данные, хранящиеся в приложениях Azure |
Обобщённые api_key / access_key / connectionstring | Средний | Настройки приложения |
| Строка с высокой энтропией (эвристика) | Низкий | Подстраховка для неизвестных форматов ключей — включается по желанию через -IncludeEntropy |
Обобщённые правила по ключевым словам сопоставляют ключевое слово в конце составного имени
(sqlAdminPassword, servicePrincipalSecret, storageAccountKey), поэтому
поля метаданных, которые лишь начинаются с него (passwordLastSet, secretName),
остаются незамеченными. Обобщённое значение останавливается перед пробелом, за которым следует другой
key=/key:, поэтому password=abc apikey=xyz даёт две чистые находки, а
парольная фраза, содержащая пробелы, всё равно захватывается целиком.
Одна находка на секрет. Когда несколько правил сопоставляются с одним и тем же значением в
одной строке (строка подключения к хранилищу и голый 88-символьный ключ; строка подключения
SQL и обобщённое правило пароля), сохраняется только совпадение с наивысшей критичностью. При
равенстве правило, специфичное для формата (AZ_AAD_CLIENT_SECRET), побеждает
над правилом на основе ключевых слов (GENERIC_*, ARM_PARAM_*, CSV_*).
Полный редактируемый набор правил находится в Private/Get-MBSignature.ps1. Каждое правило
представляет собой [PSCustomObject] со следующими полями:
| Поле | Обязательно | Назначение |
|---|---|---|
Id, Name, Category, Severity | да | Идентификация и то, как находка сообщается и сортируется. |
Pattern | да | Регулярное выражение. Компилируется один раз за сканирование. |
ValueGroup | да | Какая группа захвата содержит секрет (0 = всё совпадение). Управляет редактированием. |
MultiLine | нет | Выполнять оценку по тексту всего файла, а не построчно (блоки PEM, отформатированные параметры ARM). Сообщается каждое совпадение, а не только первое, в строке, где начинается ValueGroup. |
CaseSensitive | нет | Отказ от компиляции по умолчанию с IgnoreCase. Установите для форматов, определяемых с учётом регистра (AKIA, ghp_, eyJ, Q~) — без этого совпадают похожие строки с произвольным регистром. |
Redact | нет | Установите $false, когда захваченное значение является меткой, а не секретом (строка заголовка PEM, имя файла сертификата), чтобы оно отображалось дословно, а не маскировалось до нечитаемости. По умолчанию выполняется редактирование. |