扫描导出的 Azure 域转储文件,以查找明文密码、连接字符串、存储密钥及其他机密;生成经脱敏处理的 CSV/HTML 报告,用于只读审计工作流。
一个 PowerShell 扫描器,用于梳理 MicroBurst Get-AzDomainInfo 的输出,查找明文密码、密钥、连接字符串以及其他不应以未加密形式存在于 Azure 环境中的机密信息。
专为只读审计工作流而构建:你使用 MicroBurst 收集域转储(Get-AzDomainInfo 只需 Reader 访问权限即可),然后将此工具指向输出文件夹。它不会接触 Azure 本身——它只读取你已导出的文件。机密值在每份报告中都会被脱敏,因此输出可以安全地附加到发现项中。
# Clone / copy this folder, then from a PowerShell prompt:
.\Scan-MicroBurst.ps1 -Path .\MicroBurst-2026 -Verbose
或者导入该模块并直接使用该 cmdlet:
Import-Module .\MicroBurstSecretsHunter.psd1 -Force
Invoke-MBSecretScan -Path .\MicroBurst-2026
报告会写入当前目录下以时间戳命名的文件夹(MBSecretScan-<timestamp>),除非你传入 -OutputDirectory。
默认情况下,所有值都会被脱敏,因此报告可以安全地共享。显示出来的字符数被限制为值长度的四分之一(最多 4 个前导字符 + 2 个尾随字符),任何长度不超过 8 个字符的值都会被替换为固定宽度的掩码——因此典型密码会显示为 ********,而 88 个字符的存储密钥仍可识别为 AAAA**********AA。上下文字符串会在被截断之前先进行脱敏,并且一行中发现的每个密钥都会从该行所有发现的上下文中被脱敏移除,因此报告中不会残留任何明文。在排查误报时,查看完整值通常更快——传入 -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 标记文件,以便后续扫描的根目录包含它时跳过该文件夹(参见 覆盖范围限制)。
该 cmdlet 还会将发现项对象输出到管道,因此你可以进行后处理:
$f = Invoke-MBSecretScan -Path .\dump -Quiet
$f | Where-Object Severity -eq 'Critical' | Format-Table File,Line,RuleName
| 规则 | 严重性 | 转储中的示例来源 |
|---|---|---|
| 内嵌密码的 SQL/数据库连接字符串 | 严重 | App Service 设置、web.config 导出 |
| Azure 存储账户连接字符串 / 88 字符密钥 | 严重 | 应用设置、存储导出 |
服务总线 / 事件中心 SharedAccessKey | 严重 | 消息传递资源配置 |
| Cosmos DB 账户密钥 | 严重 | 应用设置 |
| PEM 私钥块 | 严重 | Key Vault / 证书导出 |
Azure 函数密钥(函数 / 逻辑应用 URL 中的 ?code=、x-functions-key) | 高 | 逻辑应用定义、应用设置 |
ARM 参数值("adminPassword": { "value": "..." },包括跨行美化打印) | 高 | ARM 模板 / 参数文件 |
| Azure Redis 缓存密码 | 高 | 缓存连接字符串 |
Azure AD 客户端密钥(2021 年后的 …Q~… 格式) | 高 | ARM 模板、应用设置 |
SAS 令牌 / sig= 参数 | 高 | 存储 SAS URL |
| JWT / 持有者令牌 | 高 | 缓存的令牌、配置 |
存在证书 / 密钥文件(.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 | 否 | 当捕获值是标签而非密钥(PEM 头行、证书文件名)时设为 $false,使其原样出现而不是被掩码成不可读。默认为脱敏。 |
Get-AzDomainInfo 将自动化账户变量和应用设置导出为
Name,Value[,Encrypted] 行。机密位于 Value 列,而用于标识它的关键字(例如 ServiceAccountPwd、dbConnectionString)位于 Name 列——因此普通正则表达式永远无法在同一“行”中同时看到它们,而且关键字被埋在一个没有词边界的复合 token 中。
对于 .csv / .tsv 文件,扫描器还会执行 结构化列配对(Private/Get-MBCsvFinding.ps1):
Encrypted=True 的行会被跳过(该值不是明文)。Password 或 StorageKey 列),则每个非占位符单元格都会被上报。已被高置信度规则覆盖的值(连接字符串、存储密钥、SAS)会交由原始行扫描处理,以便进行更严格的脱敏;并且发现结果会按值和行去重,因此同一个机密绝不会被上报两次。如果文件无法解析为 CSV,扫描器会自动回退到常规的原始行扫描。
-ScanValues)上述配对依赖于设置的 名称。为了同时捕获存储在无意义名称下的机密(例如 Config1 = P@ssw0rd2026!),请传入 -ScanValues。它使用两种保守的 低严重性 启发式规则检查值单元格的 内容:
!@#$%^&* …)以及字母和另一类字符。像 Standard_D2s_v3 这样的标识符风格值(其唯一符号是 _ - .)会被忽略。-MinEntropy。路径 / URL / 资源 ID(任何包含 / 或 \ 的内容)会被跳过,以避免误报资源 ID。在 Name/Value 表中,它会扫描 Value 列;在自由格式表中,它会扫描每个单元格。这会以更高的误报率换取更高的召回率,因此它 默认关闭——请为更深入的扫描开启它,然后对低严重性发现进行分诊。
Azure 转储中充满了看起来像随机字符串但 并非 机密的长字符串。扫描器会过滤掉这些内容:
GUID(订阅 / 租户 / 资源 / 对象 ID)永远不会被标记。
占位符与非机密值形态 — ********、null、
<provide-at-deploy>、true/false、重复字符、模板标记
(${var}、%VAR%)、JSON 对象/数组({...}、[...],包括
多行)、日期/时间戳,以及序列化的 .NET 类型/集合名称
(例如 VM 规模集的 Secrets 列渲染为
System.Collections.Generic.List1[...VaultSecretGroup])— 均会被跳过。 注意这是基于形态的:如果 Secrets` 列中存放的是实际的明文
值,仍会被标记。
无害的密码元数据字段 — 名称包含关键字但仅描述密码策略/状态、
从不包含机密本身的目录列
(PasswordProfile、PasswordPolicies、ForceChangePasswordNextSignIn、
LastPasswordChangeDateTime、PasswordExpirationDateTime 等)。这些在
InheritedOwners.csv / InheritedContributors.csv 等 RBAC 导出中很常见,
不会被标记,而真正命名为 Password 的列仍会被标记。
Key Vault 访问策略权限列(PermissionsToSecretsStr、
PermissionsToKeysStr 等)— 其中存放的是 Get, List, Set, Delete 等
权限动词 — 同样会被忽略。
代码与模板表达式 — 当 password/secret 等是变量
或属性名并指向表达式而非字面量时,捕获的值会被跳过:
PowerShell cmdlet 调用(Get-RandomPassword 8、
Get-AzKeyVaultSecret ...)、变量引用(包括带作用域的
($result、$kv.Secrets、$global:clientSecret、$env:KEY)、
子表达式((-join $x)),以及 ARM / Logic App 引用
(@{body(...)}、@body(...)、[parameters('...')])。常见于自动化
runbook 和 Logic App 定义中。
这里的歧义形态 — $var、(expr)、Verb-Noun — 仅在
实际包含代码的文件(.ps1、.json、.tf、.yaml 等)中被排除。
密码常常是合法的变量引用($ummer2026、
$ecretPass1),因此将该过滤器应用于 CSV 值单元格会丢弃真实
机密。无歧义的模板标记(@{、@body(、[parameters()在所有位置
都会被过滤。
列标题相邻 — 通用的 keyword = value 规则仅将
: 和 = 视为分隔符(不包括 ,),因此像 ...,AdminPassword,Secrets,...
这样的 CSV 标题不再将下一列名捕获为密码。逗号分隔的
Name,Value 对仍由结构化 CSV 配对覆盖。
资源 ID 路径会被拆分为短片段,而不是被当作 一个高熵令牌。
区分大小写的凭据格式(AWS AKIA…、GitHub ghp_…、JWT
eyJ…、Azure AD …Q~…)按大小写敏感匹配,因此任意大小写的
相似字符串(如 akiaijklmnopqrstuvwx)不会被报告。关键字规则
(password=、AccountKey=)保持大小写不敏感。
熵启发式默认关闭 — 它会产生大量噪声性的低严重度
发现,因此需通过 -IncludeEntropy 选择启用,以进行更深入的扫描。即便如此,
它也只对看起来像密钥材料的令牌(字母+数字混合或
base64 标记)触发,因此像 networkSecurityGroups 这样的 camelCase 标识符会被
忽略。可通过 -MinEntropy 4.5 进一步提高门槛。
| 参数 | 默认值 | 用途 |
|---|---|---|
-Path | (必填) | MicroBurst 输出的根文件夹。 |
-OutputDirectory | 带时间戳的文件夹 | 报告写入的位置(不会被扫描)。不能是扫描根目录本身;若为其内部嵌套的文件夹则会发出警告。 |
-IncludeEntropy | 关闭 | 选择启用高熵启发式扫描(会增加低严重性发现)。 |
-MinEntropy | 4.0 | 启发式扫描的香农熵阈值(比特/字符)。 |
-ScanValues | 关闭 | 同时检查 CSV 值单元格的内容,以发现使用无害名称隐藏的机密(低严重性,召回率更高)。 |
-ShowSecrets | 关闭 | 在所有输出中输出未脱敏的值,以加快误报分类。报告将变为实时凭据材料。 |
-MaxFileSizeMB | 50 | 跳过大于此大小的文件。被跳过的文件会发出警告,并计入摘要和 HTML 报告。 |
-IncludeExtension | 常见文本类型 | 覆盖要扫描的文件类型(前导点可选)。 |
-SuppressionFile | 无 | 包含已知误报的 JSON 文件,用于将其丢弃(见下文)。 |
-Sarif | 关闭 | 同时写入 findings.sarif。 |
-NoCsv / -NoHtml / -NoJson | 关闭 | 跳过某种报告格式。 |
-Quiet | 关闭 | 抑制控制台摘要(仍会返回对象)。 |
Scan-MicroBurst.ps1 接受上述所有参数,另有两个用于脚本化和
CI 使用的选项: