
エクスポートされたAzureドメインダンプをスキャンして、平文パスワード、接続文字列、ストレージキー、その他のシークレットを検出します。読み取り専用の監査ワークフロー向けに、マスク処理されたCSV/HTMLレポートを生成します。
MicroBurst の Get-AzDomainInfo 出力を精査し、平文のパスワード、キー、接続文字列、その他 Azure 環境に暗号化されずに置かれるべきでないシークレットを検出する PowerShell スキャナーです。
読み取り専用の監査ワークフロー向けに構築されています。MicroBurst でドメインダンプを収集し(Get-AzDomainInfo には Reader アクセスで十分です)、その出力フォルダをこのツールに指定します。このツールは Azure 自体には一切アクセスしません — すでにエクスポート済みのファイルを読み取るだけです。シークレットの値はすべてのレポートで**マスク(redact)**されるため、出力は検出事項に添付しても安全です。
# 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
レポートは、-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 | 検出結果ごとに1行(重大度、ルール、ファイル、行、マスクされた値、コンテキスト)で、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/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": "..." }、複数行に整形されたものを含む) | 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 は
2 件のきれいな検出結果を生み、一方でスペースを含むパスフレーズは
そのまま全体が捕捉される。
1 つのシークレットにつき 1 件の検出。 同じ行の同じ値に複数のルールが
マッチした場合(ストレージ接続文字列と裸の 88 文字キー、SQL
接続文字列と汎用パスワードルールなど)、最も重大度の高い
マッチのみが保持される。同点の場合は、形式固有のルール(AZ_AAD_CLIENT_SECRET)が
キーワード駆動のルール(GENERIC_*、ARM_PARAM_*、CSV_*)より優先される。
完全で編集可能なルールセットは Private/Get-MBSignature.ps1 に存在する。各ルールは
次のフィールドを持つ [PSCustomObject] である:
| フィールド | 必須 | 目的 |
|---|---|---|
Id、Name、Category、Severity | はい | 識別情報と、検出結果の報告・並べ替え方法。 |
Pattern | はい | 正規表現。スキャンごとに 1 回コンパイルされる。 |
ValueGroup | はい | シークレットを保持するキャプチャグループ(0 = マッチ全体)。マスキングを制御する。 |
MultiLine | いいえ | 行単位ではなくファイル全体のテキストに対して評価する(PEM ブロック、整形された 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 を渡します。これは 2 つの保守的な Low 重大度 のヒューリスティックを用いて値セルの 内容 を検査します:
!@#$%^&* など)を含み、さらに英字と別の文字クラスを含む。Standard_D2s_v3 のような識別子スタイルの値(記号が _ - . のみ)は無視されます。-MinEntropy 以上。リソース ID を誤検出しないよう、パス / URL / リソース 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 コマンドレット呼び出し
(Get-RandomPassword 8、Get-AzKeyVaultSecret ...)、スコープ付きを含む変数参照
($result、$kv.Secrets、$global:clientSecret、$env:KEY)、
サブ式 ((-join $x))、および ARM / Logic App 参照
(@{body(...)}、@body(...)、[parameters('...')])。自動化ランブックや
Logic App 定義でよく見られます。