Examina dumps de domínios Azure exportados em busca de senhas em texto claro, strings de conexão, chaves de armazenamento e outros segredos; gera relatórios CSV/HTML redigidos para fluxos de trabalho de auditoria somente leitura.
Um scanner PowerShell que vasculha a saída do Get-AzDomainInfo do MicroBurst em busca de senhas em texto simples, chaves, strings de conexão e outros segredos que nunca deveriam permanecer sem criptografia em um ambiente Azure.
Criado para fluxos de trabalho de auditoria somente leitura: você coleta um dump de domínio com o MicroBurst (acesso Reader é suficiente para o Get-AzDomainInfo) e depois aponta esta ferramenta para a pasta de saída. Ela não acessa o Azure em si — apenas lê os arquivos que você já exportou. Os valores dos segredos são redigidos em todos os relatórios, portanto a saída é segura para anexar a achados.
# Clone / copy this folder, then from a PowerShell prompt:
.\Scan-MicroBurst.ps1 -Path .\MicroBurst-2026 -Verbose
Ou importe o módulo e use o cmdlet diretamente:
Import-Module .\MicroBurstSecretsHunter.psd1 -Force
Invoke-MBSecretScan -Path .\MicroBurst-2026
Os relatórios são gravados em uma pasta com carimbo de data/hora (MBSecretScan-<timestamp>) no diretório atual, a menos que você passe -OutputDirectory.
Por padrão, todo valor é redigido para que os relatórios possam ser compartilhados com segurança. Os caracteres revelados são limitados a um quarto do comprimento do valor (no máximo 4 iniciais + 2 finais), e qualquer coisa com 8 caracteres ou menos é substituída por uma máscara de largura fixa — assim, uma senha típica aparece como ********, enquanto uma chave de armazenamento de 88 caracteres permanece identificável como AAAA**********AA. As strings de contexto são redigidas antes de serem truncadas, e todo segredo encontrado em uma linha é redigido do contexto de cada achado naquela linha, de modo que nenhum texto em claro sobrevive em um relatório. Ao triar falsos positivos, muitas vezes é mais rápido ver o valor completo — passe -ShowSecrets para emitir valores não redigidos em todos os lugares (console, CSV, HTML, JSON, SARIF). O console e o HTML passam então a exibir um banner de aviso claro, e os relatórios devem ser tratados como material de credencial ativo:
Invoke-MBSecretScan -Path .\dump -ShowSecrets # raw values, for local triage
Funciona em PowerShell 7+ (Windows, Linux, macOS).
Cada execução produz:
| Saída | Descrição |
|---|---|
| Resumo no console | Contagens com código de cores por severidade/categoria, além dos principais achados Critical/High. |
findings.csv | Uma linha por achado (severidade, regra, arquivo, linha, valor redigido, contexto) para triagem no Excel. Campos que contêm conteúdo escaneado são escapados contra injeção de fórmulas em planilhas. |
report.html | Relatório HTML autocontido (sem recursos externos, protegido por uma Content-Security-Policy) com cartões de severidade, filtro de texto em tempo real e alternâncias de severidade — compartilhável com o cliente. |
findings.json | Metadados da varredura mais todos os achados, para scripts e ferramentas (-NoJson para omitir). |
findings.sarif | Log SARIF 2.1.0 opcional para ferramentas de code-scanning (-Sarif). |
Cada pasta de saída também recebe um pequeno arquivo marcador .mbsecretscan-output para que uma
varredura posterior cuja raiz o contenha o ignore (veja Limites de cobertura).
O cmdlet também emite objetos de achado para o pipeline, para que você possa pós-processar:
$f = Invoke-MBSecretScan -Path .\dump -Quiet
$f | Where-Object Severity -eq 'Critical' | Format-Table File,Line,RuleName
| Regra | Severidade | Exemplo de origem num dump |
|---|---|---|
| Cadeia de conexão SQL/DB com palavra-passe incorporada | Crítica | Definições do App Service, exportações de web.config |
| Cadeia de conexão da conta de Armazenamento do Azure / chave de 88 caracteres | Crítica | Definições da aplicação, exportações de Armazenamento |
SharedAccessKey do Service Bus / Event Hub | Crítica | Configurações de recursos de mensagens |
| Chave da conta do Cosmos DB | Crítica | Definições da aplicação |
| Bloco de chave privada PEM | Crítica | Exportações do Key Vault / certificados |
Chave de Função do Azure (?code= num URL de Função / Logic App, x-functions-key) | Alta | Definições de Logic App, definições da aplicação |
Valor de parâmetro ARM ("adminPassword": { "value": "..." }, incluindo formatado em várias linhas) | Alta | Modelos ARM / ficheiros de parâmetros |
| Palavra-passe do Azure Redis Cache | Alta | Cadeias de conexão de cache |
Segredo de cliente do Azure AD (formato …Q~… pós-2021) | Alta | Modelos ARM, definições da aplicação |
Token SAS / parâmetro sig= | Alta | URLs SAS de Armazenamento |
| Token JWT / bearer | Alta | Tokens em cache, configurações |
Ficheiro de certificado / chave presente (.pfx, .p12, .pem, .key, .jks, .ppk, …) | Alta | Em qualquer parte do dump |
Ficheiro de certificado presente (.cer, .crt, .der — normalmente público) | Baixa | Em qualquer parte do dump |
Atribuição genérica de password / pwd, incluindo nomes compostos (administratorLoginPassword, userPWD) | Alta | Variáveis de automação, definições da aplicação, parâmetros ARM, perfis de publicação |
Atribuição genérica de secret / client_secret, incluindo nomes compostos (servicePrincipalSecret) | Alta | Definições da aplicação, modelos |
| Chaves de acesso AWS / tokens GitHub / Slack | Alta/Média | Credenciais externas armazenadas em aplicações Azure |
api_key / access_key / connectionstring genéricos | Média | Definições da aplicação |
| Cadeia de alta entropia (heurística) | Baixa | Rede de segurança para formatos de chave desconhecidos — opcional via -IncludeEntropy |
As regras genéricas de palavras-chave correspondem à palavra-chave no final de um nome composto
(sqlAdminPassword, servicePrincipalSecret, storageAccountKey), pelo que
campos de metadados que apenas começam com uma delas (passwordLastSet, secretName)
permanecem silenciosos. Um valor genérico termina antes de um espaço em branco seguido de outro
key=/key:, pelo que password=abc apikey=xyz produz dois resultados limpos, enquanto uma
frase-passe contendo espaços continua a ser capturada na íntegra.
Um resultado por segredo. Quando várias regras correspondem ao mesmo valor na
mesma linha (uma cadeia de conexão de armazenamento e a chave nua de 88 caracteres; uma cadeia de
conexão SQL e a regra genérica de palavra-passe), apenas a correspondência de maior severidade
é mantida. Em caso de empate, uma regra específica de formato (AZ_AAD_CLIENT_SECRET) prevalece
sobre uma regra orientada por palavras-chave (GENERIC_*, ARM_PARAM_*, CSV_*).
O conjunto completo e editável de regras reside em Private/Get-MBSignature.ps1. Cada regra
é um [PSCustomObject] com estes campos: