
さまざまなプラットフォームにおいて、既知のあるいは非常に脆弱な暗号学的シークレットが使用されていることを特定するための、純粋な Python ライブラリです。本プロジェクトは、各種の「既知のシークレット」(例えば、チュートリアルの例で見つかる ASP.NET マシンキーなど)のリポジトリであると同時に、それらの使用を特定するための言語非依存の抽象化レイヤーを提供することを目的としています。
「悪いシークレット」が使用されたかどうかを知ることは、通常、そのシークレットが使われた何らかの暗号学的な生成物を調べることで判断できます。例えば、鍵付きハッシュアルゴリズムで署名された Cookie などです。各プラットフォームが提供する個々の実装上の特異性を掘り下げていくと物事は複雑になりがちですが、本ライブラリはその負担を軽減することを目指しています。
Black Lantern Security ブログの詳細なブログ記事もぜひご覧ください!
Blacklist3rに触発され、対応プラットフォームの拡充と、言語およびオペレーティングシステムへの依存の排除を目指して開発されました。
パッシブモジュールは、すでに手元にある暗号学的な生成物(Cookie、トークン、署名付き URL など)を分析します。既知のシークレットのデータベースに対してその生成物の復号や検証を試みることで、オフラインで動作します。
| 名前 | 説明 |
|---|---|
| ASPNET_Viewstate | viewstate/generator を既知のマシンキーのリストと照合してチェックします。 |
| ASPNET_Resource | WebResource.axd および ScriptResource.axd の暗号化された URL を既知のマシンキーのリストと照合してチェックします。ページに __VIEWSTATE が存在しない場合に有用です。 |
| Telerik_HashKey | パッチ適用済み(2017 年以降)の Telerik UI について、既知の Telerik.Upload.ConfigurationHashKey をチェックします。 |
| Telerik_EncryptionKey | パッチ適用済み(2017 年以降)の Telerik UI について、既知の Telerik.Web.UI.DialogParametersEncryptionKey をチェックします。 |
| Flask_SignedCookies | 脆弱な Flask クッキー署名パスワードをチェックします。flask-unsign のラッパーです。 |
| Peoplesoft_PSToken | peoplesoft の PS_TOKEN について、不正または脆弱な署名パスワードをチェックできます。 |
| Django_SignedCookies | django のセッションクッキー(signed_cookie モードの場合)について、既知の django secret_key をチェックします。 |
| Rails_SecretKeyBase | Ruby on Rails の署名済みまたは暗号化されたセッションクッキー(複数のメジャーリリース由来)について、既知の secret_key_base をチェックします。 |
| Generic_JWT | JWT について、既知の HMAC シークレットまたは RSA 秘密鍵をチェックします。 |
| Jsf_viewstate | Java Server Faces(JSF)の Mojarra および Myfaces の両実装について、既知または脆弱な秘密鍵の使用をチェックします。 |
| Symfony_SignedURL | symfony の「_fragment」URL について、既知の HMAC キーをチェックします。ハッシュを含む完全な URL に対して動作します。 |
| Express_SignedCookies_ES | express.js の express-session ミドルウェアについて、署名済みクッキーおよびセッションクッキーの既知の「session secret」をチェックします。 |
| Express_SignedCookies_CS | express.js の cookie-session ミドルウェアについて、署名済みクッキーおよびセッションクッキーの既知の secret をチェックします。 |
| Laravel_SignedCookies | 「laravel_session」クッキーについて、既知の laravel「APP_KEY」をチェックします。 |
| ASPNET_Compressedviewstate | かつて普及していた、RCE に対して脆弱なカスタム圧縮 Viewstate のコードスニペットをチェックします。 |
| Rack2_SignedCookies | Rack 2.x の署名済みクッキーについて、既知の秘密鍵をチェックします。 |
| Yii2_SignedCookies | Yii2 フレームワークの署名済みクッキーについて、既知のクッキー検証キーをチェックします。 |
| Shiro_RememberMe | Apache Shiro の rememberMe クッキーについて、既知の AES 暗号化キーをチェックします。 |
| LTPA_Token | IBM WebSphere の LtpaToken および LtpaToken2 クッキーについて、既知の LTPA 暗号化キーをチェックします。 |
| NextAuth | NextAuth.js / Auth.js の JWE セッションクッキーについて、既知または脆弱な NEXTAUTH_SECRET / AUTH_SECRET をチェックします。 |
アクティブモジュールはパッシブ検出の一歩先を行きます。YARA ベースのプリフィルタリングを用いて稼働中のターゲットをフィンガープリントし(HTTP レスポンスヘッダー、クッキー、ボディコンテンツに基づく)、その後、既知のキーで暗号化された生成物を偽造してターゲットに送信し、そのキーが受け入れられるかどうかを確認します。これにより、分析対象のトークンをまだ持っていないものの、ターゲットがデフォルトまたは広く知られたシークレットを使用している可能性があると疑われる場合に有用です。
アクティブモジュールは URL モード(--url)でデフォルトで有効になっています。無効にするには --passive-only を使用してください。
| 名前 | 説明 |
|---|---|
| Shiro_RememberMe_Key | 既知の AES キーで Apache Shiro の rememberMe クッキーを偽造し、ターゲットがそれらを受け入れるかどうかをテストします(デシリアライゼーション RCE)。 |
| GlobalProtect_DefaultMasterKey | PAN-OS GlobalProtect ポータルについて、デフォルトのマスター暗号化キーの使用をテストします。 |
| LTPA_Token_Key | 既知の LTPA キーで IBM WebSphere の LtpaToken2 クッキーを偽造し、ターゲットが認証を許可するかどうかをテストします(認証バイパス)。 |
pypi パッケージがあるため、ライブラリを利用するには pip install badsecrets を実行するだけです。
Badsecrets を使う最良の方法は、pip install を実行した後に単純に badsecrets を実行することです:
pip install badsecrets
badsecrets eyJhbGciOiJIUzI1NiJ9.eyJJc3N1ZXIiOiJJc3N1ZXIiLCJVc2VybmFtZSI6IkJhZFNlY3JldHMiLCJleHAiOjE1OTMxMzM0ODMsImlhdCI6MTQ2NjkwMzA4M30.ovqRikAo_0kKJ0GVrAwQlezymxrLGjcEiW_s3UJMMCo
内部的には cli.py の例を使用しています。CLI は pip インストールなしでも手動でアクセスできます:
git clone https://github.com/blacklanternsecurity/badsecrets.git
cd badsecrets
python ./badsecrets/examples/cli.py eyJhbGciOiJIUzI1NiJ9.eyJJc3N1ZXIiOiJJc3N1ZXIiLCJVc2VybmFtZSI6IkJhZFNlY3JldHMiLCJleHAiOjE1OTMxMzM0ODMsImlhdCI6MTQ2NjkwMzA4M30.ovqRikAo_0kKJ0GVrAwQlezymxrLGjcEiW_s3UJMMCo
例を使用するには、pip install を実行した後、リポジトリを git clone し、badsecrets ディレクトリに cd します:
git clone https://github.com/blacklanternsecurity/badsecrets.git
cd badsecrets
以下の例のセクションにあるコマンドは、このディレクトリにいることを前提としています。
Badsecrets の BBOT モジュールを使用している場合、他に何もする必要はありません。BBOT がパッケージをインストールします。
Bad secrets には、シークレットを手動で確認する際の利便性のためにサンプル CLI が含まれています。前述のとおり、pip インストールが成功した後は badsecrets を実行するだけでアクセスできます。
usage: badsecrets [-h] [-nc] [-j] [-u URL] [-nh] [-c FILE_OR_MODULE:KEYS]
[-p PROXY] [-a USER_AGENT] [-H HEADER] [-d] [-t TIMEOUT]
[-P] [-l]
[product ...]
Check cryptographic products against badsecrets library
positional arguments:
product Cryptographic product to check for known secrets
options:
-h, --help show this help message and exit
-nc, --no-color Disable color message in the console
-j, --json Output results as JSON only (no banner, no color).
Outputs nothing on no detection
-u URL, --url URL Use URL Mode. Specified the URL of the page to access
and attempt to check for secrets
-nh, --no-hashcat Skip the check for compatable hashcat commands when
secret isn't found
-c FILE_OR_MODULE:KEYS, --custom-secrets FILE_OR_MODULE:KEYS
Custom secrets to check. Can be specified multiple
times. Without a module prefix, the file is loaded for
all modules. With a module prefix (MODULE:value), keys
are targeted to that module only. Value can be a file
path or comma-separated inline keys. Example: -c
my_keys.txt or -c Shiro_RememberMe_Key:key1,key2 or -c
GlobalProtect_DefaultMasterKey:keys.txt
-p PROXY, --proxy PROXY
In URL mode, Optionally specify an HTTP proxy
-a USER_AGENT, --user-agent USER_AGENT
In URL mode, Optionally set a custom user-agent
-H HEADER, --header HEADER
Custom header (e.g., -H 'Cookie: foo=bar'). Can be
specified multiple times
-d, --debug Enable debug output (request URL, response status,
headers, etc.)
-t TIMEOUT, --timeout TIMEOUT
Request timeout in seconds (default: 10)
-P, --passive-only Disable active probing in URL mode (only run passive
analysis)
-l, --list-modules List all available modules with descriptions and exit