Analizza i dump di domini Azure esportati alla ricerca di password in chiaro, stringhe di connessione, chiavi di storage e altri segreti; genera report CSV/HTML oscurati per flussi di lavoro di audit in sola lettura.
Uno scanner PowerShell che setaccia l'output di Get-AzDomainInfo di MicroBurst
alla ricerca di password in chiaro, chiavi, stringhe di connessione e
altri segreti che non dovrebbero mai rimanere non cifrati in un ambiente Azure.
Realizzato per flussi di lavoro di audit in sola lettura: si raccoglie un dump del dominio con MicroBurst
(l'accesso Reader è sufficiente per Get-AzDomainInfo), quindi si punta questo strumento alla
cartella di output. Non interagisce con Azure stesso — legge solo i file già
esportati. I valori dei segreti sono oscurati in ogni report, quindi l'output
è sicuro da allegare ai risultati.
# Clone / copy this folder, then from a PowerShell prompt:
.\Scan-MicroBurst.ps1 -Path .\MicroBurst-2026 -Verbose
Oppure importa il modulo e utilizza direttamente il cmdlet:
Import-Module .\MicroBurstSecretsHunter.psd1 -Force
Invoke-MBSecretScan -Path .\MicroBurst-2026
I report vengono scritti in una cartella con timestamp (MBSecretScan-<timestamp>) nella
directory corrente, a meno che non si passi -OutputDirectory.
Per impostazione predefinita ogni valore è redatto in modo che i report siano sicuri da condividere. I
caratteri rivelati sono limitati a un quarto della lunghezza del valore (con un massimo di 4
iniziali + 2 finali), e qualsiasi valore di 8 caratteri o meno viene sostituito con una
maschera a larghezza fissa — quindi una password tipica appare come ********, mentre una chiave di archiviazione di 88 caratteri resta identificabile come AAAA**********AA. Le stringhe di contesto vengono
redatte prima di essere troncate, e ogni segreto trovato su una riga viene
redatto dal contesto di ogni finding su quella riga, così nessun testo in chiaro sopravvive
in un report. In fase di triage dei falsi positivi spesso è più rapido vedere il valore completo —
passare -ShowSecrets per emettere valori non redatti ovunque (console, CSV,
HTML, JSON, SARIF). La console e l'HTML riportano quindi un chiaro banner di avviso, e i report
devono essere trattati come materiale credenziale attivo:
Invoke-MBSecretScan -Path .\dump -ShowSecrets # raw values, for local triage
Funziona su PowerShell 7+ (Windows, Linux, macOS).
Ogni esecuzione produce:
| Output | Descrizione |
|---|---|
| Riepilogo console | Conteggi codificati a colori per gravità/categoria più i principali risultati Critici/Alti. |
findings.csv | Una riga per risultato (gravità, regola, file, riga, valore redatto, contesto) per il triage in Excel. I campi che contengono contenuto scansionato sono sottoposti a escape contro l'iniezione di formule nei fogli di calcolo. |
report.html | Report HTML autonomo (nessuna risorsa esterna, protetto da una Content-Security-Policy) con schede per gravità, filtro testuale live e toggle per gravità — condivisibile con il cliente. |
findings.json | Metadati della scansione più ogni risultato, per scripting e tooling (-NoJson per saltare). |
findings.sarif | Log SARIF 2.1.0 opzionale per strumenti di code-scanning (-Sarif). |
Ogni cartella di output riceve anche un piccolo file marcatore .mbsecretscan-output così che
una scansione successiva la cui root lo contiene lo salti (vedi Limiti di copertura).
Il cmdlet emette anche oggetti risultato nella pipeline, così puoi post-elaborarli:
$f = Invoke-MBSecretScan -Path .\dump -Quiet
$f | Where-Object Severity -eq 'Critical' | Format-Table File,Line,RuleName
| Regola | Gravità | Esempio di sorgente in un dump |
|---|---|---|
| Stringa di connessione SQL/DB con password incorporata | Critica | Impostazioni App Service, esportazioni web.config |
| Stringa di connessione dell'account Azure Storage / chiave da 88 caratteri | Critica | Impostazioni dell'app, esportazioni Storage |
SharedAccessKey di Service Bus / Event Hub | Critica | Configurazioni delle risorse di messaggistica |
| Chiave dell'account Cosmos DB | Critica | Impostazioni dell'app |
| Blocco di chiave privata PEM | Critica | Esportazioni Key Vault / certificati |
Chiave di Azure Function (?code= in un URL di Function / Logic App, x-functions-key) | Alta | Definizioni di Logic App, impostazioni dell'app |
Valore di parametro ARM ("adminPassword": { "value": "..." }, anche formattato su più righe) | Alta | Template ARM / file di parametri |
| Password di Azure Redis Cache | Alta | Stringhe di connessione della cache |
Client secret di Azure AD (formato …Q~… post-2021) | Alta | Template ARM, impostazioni dell'app |
Token SAS / parametro sig= | Alta | URL SAS di Storage |
| Token JWT / bearer | Alta | Token in cache, configurazioni |
File di certificato / chiave presente (.pfx, .p12, .pem, .key, .jks, .ppk, …) | Alta | Ovunque nel dump |
File di certificato presente (.cer, .crt, .der — di solito pubblico) | Bassa | Ovunque nel dump |
Assegnazione generica di password / pwd, inclusi nomi composti (administratorLoginPassword, userPWD) | Alta | Variabili di automazione, impostazioni dell'app, parametri ARM, profili di pubblicazione |
Assegnazione generica di secret / client_secret, inclusi nomi composti (servicePrincipalSecret) | Alta | Impostazioni dell'app, template |
| Chiavi di accesso AWS / token GitHub / Slack | Alta/Media | Credenziali esterne memorizzate in app Azure |
api_key / access_key / connectionstring generici | Media | Impostazioni dell'app |
| Stringa ad alta entropia (euristica) | Bassa | Rete di sicurezza per formati di chiave sconosciuti — opt-in tramite -IncludeEntropy |
Le regole generiche basate su parole chiave individuano la parola chiave alla fine di un nome composto
(sqlAdminPassword, servicePrincipalSecret, storageAccountKey), così i
campi di metadati che iniziano semplicemente con una di esse (passwordLastSet, secretName)
restano silenziosi. Un valore generico si interrompe prima di uno spazio seguito da un'altra
key=/key:, quindi password=abc apikey=xyz produce due risultati distinti, mentre una
passphrase contenente spazi viene comunque catturata per intero.
Un risultato per segreto. Quando più regole corrispondono allo stesso valore sulla
stessa riga (una stringa di connessione Storage e la chiave nuda da 88 caratteri; una stringa di
connessione SQL e la regola generica della password), viene mantenuta solo la corrispondenza con gravità
più alta. In caso di parità, vince una regola specifica per il formato (AZ_AAD_CLIENT_SECRET)
rispetto a una basata su parole chiave (GENERIC_*, ARM_PARAM_*, CSV_*).
L'insieme completo e modificabile delle regole si trova in Private/Get-MBSignature.ps1. Ogni regola
è un [PSCustomObject] con questi campi:
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.