내보낸 Azure 도메인 덤프에서 일반 텍스트 비밀번호, 연결 문자열, 스토리지 키 및 기타 비밀을 스캔하고, 읽기 전용 감사 워크플로우를 위해 마스킹된 CSV/HTML 보고서를 생성합니다.
MicroBurst의 Get-AzDomainInfo 출력을 훑어 Azure 환경에 암호화되지 않은 채로 남아 있어서는 안 되는 평문 비밀번호, 키, 연결 문자열 및 기타 비밀 정보를 찾아내는 PowerShell 스캐너입니다.
읽기 전용 감사 워크플로를 위해 만들어졌습니다. MicroBurst로 도메인 덤프를 수집한 뒤(Get-AzDomainInfo에는 Reader 권한이면 충분합니다) 이 도구를 출력 폴더에 지정하면 됩니다. 이 도구는 Azure 자체에 접근하지 않으며, 이미 내보낸 파일만 읽습니다. 모든 보고서에서 비밀 값은 마스킹(redacted) 처리되므로 결과물을 발견 사항에 안전하게 첨부할 수 있습니다.
# 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
-OutputDirectory를 지정하지 않는 한 보고서는 현재 디렉터리의 타임스탬프가 붙은 폴더(MBSecretScan-<timestamp>)에 작성됩니다.
기본적으로 모든 값은 마스킹(redacted) 처리되어 보고서를 안전하게 공유할 수 있습니다. 노출되는 문자 수는 값 길이의 4분의 1로 제한되며(앞 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에서 분류(triage)할 수 있습니다. 스캔된 콘텐츠를 담은 필드는 스프레드시트 수식 주입에 대비해 이스케이프 처리됩니다. |
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/DB 연결 문자열 | Critical | App Service 설정, web.config 내보내기 |
| Azure Storage 계정 연결 문자열 / 88자 키 | Critical | 앱 설정, Storage 내보내기 |
Service Bus / Event Hub SharedAccessKey | Critical | 메시징 리소스 구성 |
| Cosmos DB 계정 키 | Critical | 앱 설정 |
| PEM 개인 키 블록 | Critical | Key Vault / 인증서 내보내기 |
Azure Function 키 (Function / Logic App URL의 ?code=, x-functions-key) | High | Logic App 정의, 앱 설정 |
ARM 매개 변수 값 ("adminPassword": { "value": "..." }, 여러 줄에 걸쳐 pretty-print된 경우 포함) | High | ARM 템플릿 / 매개 변수 파일 |
| Azure Redis Cache 비밀번호 | High | 캐시 연결 문자열 |
Azure AD 클라이언트 암호 (2021년 이후 …Q~… 형식) | High | ARM 템플릿, 앱 설정 |
SAS 토큰 / sig= 매개 변수 | High | Storage SAS URL |
| JWT / 전달자 토큰 | High | 캐시된 토큰, 구성 |
인증서 / 키 파일 존재 (.pfx, .p12, .pem, .key, .jks, .ppk, …) | High | 덤프 내 어디든 |
인증서 파일 존재 (.cer, .crt, .der — 보통 공개) | Low | 덤프 내 어디든 |
일반 password / pwd 할당, 복합 이름 포함 (administratorLoginPassword, userPWD) | High | Automation 변수, 앱 설정, ARM 매개 변수, 게시 프로필 |
일반 secret / client_secret 할당, 복합 이름 포함 (servicePrincipalSecret) | High | 앱 설정, 템플릿 |
| AWS 액세스 키 / GitHub / Slack 토큰 | High/Med | Azure 앱에 저장된 외부 자격 증명 |
일반 api_key / access_key / connectionstring | Medium | 앱 설정 |
| 고엔트로피 문자열 (휴리스틱) | Low | 알 수 없는 키 형식에 대한 최후 방어선 — -IncludeEntropy로 선택적 사용 |
일반 키워드 규칙은 복합 이름의 끝에 있는 키워드와 일치하므로
(sqlAdminPassword, servicePrincipalSecret, storageAccountKey),
단지 그 키워드로 시작하기만 하는 메타데이터 필드(passwordLastSet, secretName)는
조용히 넘어갑니다. 일반 값은 공백 뒤에 또 다른
key=/key:가 오기 전에서 멈추므로, password=abc apikey=xyz는 두 개의 깔끔한
결과를 내는 반면, 공백을 포함한 암호 문구는 여전히 통째로 캡처됩니다.
비밀당 하나의 결과. 여러 규칙이 같은 줄의 같은 값과 일치할 때
(Storage 연결 문자열 그리고 순수한 88자 키, SQL
연결 문자열 그리고 일반 비밀번호 규칙), 가장 높은 심각도의
일치만 유지됩니다. 동점일 경우 형식별 규칙(AZ_AAD_CLIENT_SECRET)이
키워드 기반 규칙(GENERIC_*, ARM_PARAM_*, CSV_*)보다 우선합니다.
전체 편집 가능한 규칙 집합은 **Private/Get-MBSignature.ps1**에 있습니다. 각 규칙은
다음 필드를 가진 [PSCustomObject]입니다:
| 필드 | 필수 | 용도 |
|---|---|---|
Id, Name, Category, Severity | 예 | 식별 정보 및 결과가 보고되고 정렬되는 방식. |
Pattern | 예 | 정규식. 스캔당 한 번 컴파일됩니다. |
ValueGroup | 예 | 비밀을 담고 있는 캡처 그룹 (0 = 전체 일치). 마스킹을 제어합니다. |
MultiLine | 아니요 | 줄 단위 대신 전체 파일 텍스트에 대해 평가합니다 (PEM 블록, pretty-print된 ARM 매개 변수). 첫 번째 일치뿐 아니라 모든 일치가 ValueGroup이 시작되는 줄에서 보고됩니다. |
CaseSensitive | 아니요 | 기본 IgnoreCase 컴파일을 해제합니다. 대소문자를 구분하여 정의된 형식(AKIA, ghp_, eyJ, Q~)에 설정하십시오 — 설정하지 않으면 임의 대소문자의 유사 문자열이 일치합니다. |
Redact | 아니요 | 캡처된 값이 비밀이 아닌 레이블(PEM 헤더 줄, 인증서 파일 이름)인 경우 $false로 설정하여 읽을 수 없게 마스킹되는 대신 그대로 표시되도록 합니다. 기본값은 마스킹입니다. |
Get-AzDomainInfo는 자동화 계정 변수와 앱 설정을 Name,Value[,Encrypted] 행으로 내보냅니다. 비밀 값은 Value 열에 있는 반면, 이를 식별하는 키워드(예: ServiceAccountPwd, dbConnectionString)는 Name 열에 있습니다. 따라서 단순 정규식은 이들을 같은 "줄"에서 볼 수 없고, 키워드는 단어 경계가 없는 복합 토큰 안에 묻혀 있습니다.
.csv / .tsv 파일의 경우 스캐너는 추가로 구조화된 열 페어링(Private/Get-MBCsvFinding.ps1)을 수행합니다:
Encrypted=True로 표시된 행은 건너뜁니다(값이 평문이 아님).Password 또는 StorageKey 열), 모든 비플레이스홀더 셀을 보고합니다.고신뢰도 규칙이 이미 다루는 값(연결 문자열, 스토리지 키, SAS)은 더 엄격한 마스킹을 위해 원시 줄 검사로 넘겨지며, 결과는 값과 줄 단위로 중복 제거되어 동일한 비밀이 두 번 보고되지 않습니다. 파일을 CSV로 파싱할 수 없는 경우, 스캐너는 자동으로 일반 원시 줄 검사로 폴백합니다.
-ScanValues)위의 페어링은 설정의 이름을 기준으로 합니다. 의미 없는 이름으로 저장된 비밀(예: Config1 = P@ssw0rd2026!)도 잡으려면 **-ScanValues**를 전달하세요. 이 옵션은 두 가지 보수적인 Low 심각도 휴리스틱으로 값 셀의 내용을 검사합니다:
!@#$%^&* …)와 문자 및 다른 문자 클래스를 포함합니다. Standard_D2s_v3처럼 식별자 스타일의 값(기호가 _ - .뿐인 경우)은 무시됩니다.-MinEntropy. 경로 / URL / 리소스 ID(/ 또는 \를 포함하는 모든 것)는 리소스 ID를 잘못 표시하지 않도록 건너뜁니다.Name/Value 테이블에서는 Value 열을 검사하고, 자유 형식 테이블에서는 모든 셀을 검사합니다. 이는 재현율을 높이는 대신 오탐이 늘어나므로 기본적으로 꺼져 있습니다 — 더 깊은 검사를 위해 켠 다음 Low 결과를 분류하세요.
Azure 덤프에는 비밀이 아닌 길고 무작위로 보이는 문자열이 가득합니다. 스캐너는 이를 필터링합니다:
********, 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('...')]). 자동화
런북과 Logic App 정의에서 흔히 볼 수 있습니다.