
Yandex、VK、Selectel、Sber、Alibaba、Tencent、Huawei、Baidu のパブリッククラウドオブジェクトストレージエンドポイントをスキャンし、リスト可能なバケットと露出したオブジェクトを検出します。
クラウドオブジェクトストレージの公開状態スキャナーおよび読み取り専用ストレージCLI。許可されたセキュリティテスト、バグバウンティ活動、および自身が所有するインフラストラクチャ向け。
BucketBusterは、候補となるバケット名をYandex Cloud、VK Cloud、Selectel、SberCloud、Alibaba OSS、Tencent COS、Huawei OBS、Baidu BOS、China Mobile Cloud EOSの公開エンドポイントに対してチェックします。公開リスト可能なバケットの特定、証明書関連のオブジェクト名の照合、およびオプションでHTTP GET経由での公開アクセス可能なオブジェクトのダウンロードが可能です。ストレージコマンドは、各プロバイダのネイティブ認証情報を使用した認証済みリスト、ダウンロード、メタデータ、署名付きURLもサポートします。
認可が必要です: このツールは、自身が所有する、または明示的にテスト許可を得た資産に対してのみ使用してください。第三者バケットのスキャンやデータのダウンロードは違法となる可能性があります。適用される法律、契約、バグバウンティのルール、およびプロバイダのポリシーを遵守する責任は利用者にあります。
scan専用として、候補バケット名を1行に1つ含むワードリスト。git clone <repository-url>
cd bucketbuster
python -m venv .venv
仮想環境をアクティブ化します:
# Linux/macOS
source .venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
依存関係をインストールします:
python -m pip install -r requirements.txt
buckets.txt などのワードリストを作成します:
example-company
example-company-backup
example-company-documents
デフォルトのプロバイダーセット、Yandex Cloud、VK Cloudを実行します:
python bucketbuster.py scan --wordlist buckets.txt
スキャナーは、HTTP 200 レスポンス、公開リスティング、一致するオブジェクト名、および存在するように見えるアクセス拒否エンドポイントを報告します。404 レスポンスは無視されます。
CLI の変更: コマンドが必須になりました。python bucketbuster.py -w ... で始まる既存の呼び出しは、python bucketbuster.py scan -w ... に変更する必要があります。
| プロバイダーフラグ | サービス | 含まれるエンドポイントファミリー |
|---|---|---|
yandex | Yandex Cloud | ストレージおよびウェブサイトエンドポイント |
vk | VK Cloud | vkcloud-storage.ru エンドポイント |
selectel | Selectel | S3 および selstorage.ru エンドポイント |
sber | SberCloud | OBS および s3.cloud.ru エンドポイント |
aliyun | Alibaba Cloud OSS | 中国の一部リージョン |
tencent | Tencent Cloud COS | 中国およびアジアの一部リージョン |
huawei | Huawei Cloud OBS | 中国の一部リージョン |
baidu | Baidu Cloud BOS | 中国およびアジアの一部リージョン |
cmecloud | China Mobile Cloud EOS | 提供された EOS ツールの 30 リージョン |
プロバイダーグループ:
--providers russia # yandex, vk, selectel, sber
--providers china # aliyun, tencent, huawei, baidu, cmecloud
--providers all # every supported provider
カンマ区切りのリストを指定することもできます。例えば:
python bucketbuster.py scan -w buckets.txt --providers aliyun,tencent
各プロバイダーは独自の認証情報を使用します。あるプロバイダーのキーが別のプロバイダーで再利用されることはなく、無関係な AWS プロファイル、インスタンスメタデータ、または .netrc エントリはリクエストの認証に使用されません。
| プロバイダー | 認証済み API |
|---|---|
yandex, vk, selectel, cmecloud | boto3 経由の S3 Signature V4 |
aliyun | oss2 経由のネイティブ OSS V4 |
tencent | cos-python-sdk-v5 経由のネイティブ COS |
huawei | esdk-obs-python 経由のネイティブ OBS |
sber | obs.*.hc.sbercloud.ru には OBS、s3.cloud.ru には S3 |
baidu | リージョナル BOS にはネイティブ BCE/BOS 署名、s3.*.bcebos.com には S3 |
プロバイダーフラグを大文字にして環境変数を設定します:
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_ID
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_SECRET
BUCKETBUSTER_<PROVIDER>_SESSION_TOKEN
BUCKETBUSTER_<PROVIDER>_ENDPOINT
BUCKETBUSTER_<PROVIDER>_REGION
例えば、BUCKETBUSTER_CMECLOUD_ACCESS_KEY_ID と
BUCKETBUSTER_CMECLOUD_ACCESS_KEY_SECRET です。CMECloud はまた、スタンドアロン
ツールの EOS_ACCESS_KEY_ID、EOS_ACCESS_KEY_SECRET、EOS_SESSION_TOKEN、
EOS_ENDPOINT、EOS_REGION 変数を優先度の低いエイリアスとして受け付けます。
ストレージコマンドでは、明示的な --access-key-id、--access-key-secret、および
オプションの --session-token がフィールドごとに環境変数の値を上書きします。スキャンでは、
--cmecloud-access-key-id や
--cmecloud-access-key-secret などプロバイダー固有のフラグを使用します。同じパターンがすべてのプロバイダーで機能します。
不完全なキーペア、またはペアのないトークンは拒否されます。
環境変数を推奨します。コマンドラインのシークレットはシェル履歴や プロセス一覧に表示される可能性があります。実際の認証情報をレポートやバグ報告に含めないでください。
コマンドはちょうど1つの --provider を選択します。ワードリストや全リージョンのプローブは
必要ありません。共通オプションは、提供されている EOS ツールと同様に、コマンドの前後どちらに置いてもかまいません:
python bucketbuster.py --provider cmecloud \
--endpoint eos-beijing-1.cmecloud.cn --region beijing-1 list-buckets
python bucketbuster.py list-objects --provider cmecloud \
--endpoint eos.ecso.hecd-1.cmecloud.cn --bucket example-company --key certificates/
python bucketbuster.py list-objects --provider cmecloud \
--bucket example-company --key certificates/ --max-keys 100
python bucketbuster.py list-objects-all --provider cmecloud \
--bucket example-company --prefix documents/
python bucketbuster.py download-bucket --provider cmecloud \
--bucket example-company --prefix documents/ --output-dir ./authorized-downloads
python bucketbuster.py get-object --provider cmecloud \
--bucket example-company --key documents/readme.txt --output ./readme.txt
python bucketbuster.py head-object --provider cmecloud \
--bucket example-company --key documents/readme.txt
python bucketbuster.py presign --provider cmecloud \
--bucket example-company --key documents/readme.txt --expires 600
| コマンド | 動作とオプション |
|---|---|
list-buckets | アカウントのバケットを一覧表示します。認証情報のペアとアカウント一覧の権限が必要です。--region または --endpoint を指定しない場合、プロバイダーの既知のすべてのリージョンが試行され、結果は重複排除されます。 |
list-objects | 1ページ分の一覧表示を行います。--key はプレフィックスとして扱われ、--marker、--max-keys、--delimiter を指定できます。 |
list-objects-all | 自動的にページネーションを行います。--prefix、--delimiter、--max-keys を指定できます。 |
download-bucket | すべてのページにわたってプレフィックスに一致するすべてのオブジェクトをダウンロードします。--prefix、--max-keys、--output-dir/-o(デフォルト: バケット名)を指定できます。 |
get-object | --key をダウンロードします。--output/-o、またはカレントディレクトリ配下の安全なキー相対パスに保存されます。--stream を指定するとオブジェクトのバイト列のみを stdout に書き出します。 |
head-object | --key のメタデータを返します。 |
presign | 署名済みの GET URL を出力します。認証情報が必要です。--expires のデフォルトは 3600 秒で、範囲は 1〜604800 です。 |
list-buckets を除き、すべてのストレージコマンドには --bucket が必要です。読み取りは、バケットが許可している場合は匿名で行えます。認証情報を指定した場合、その権限が許す範囲でのみアクセスが可能になります。通常の結果は JSON です。presign は URL を出力し、get-object --stream はバイト列を出力します。エラーは stderr に出力され、非ゼロの終了コードを返します。署名済み URL はベアラ認証情報であるため、保護してください。
必要に応じて --endpoint(HTTPS API のホスト名。バケットやパスは含めない)と --region を指定してください。ウェブサイトやカスタムドメインは認証済み API エンドポイントではありません。デフォルトは ru-central1(Yandex)、ru-msk(VK)、ru-1(Selectel)、ru-moscow-1(Sber OBS)、cn-hangzhou(OSS)、ap-guangzhou(COS)、cn-north-4(OBS)、bj(BOS)、beijing-1(EOS)です。エンドポイントを上書きする場合は、プロバイダーの実際の署名リージョンを使用してください。Sber OBS と S3 のキーは異なるバックエンドに属する場合があり、相互に交換可能ではありません。Tencent のバケット名には数値の APPID サフィックスを含める必要があります(例: example-company-123456789)。
--path-style はサポートされている場合にパスアドレッシングを選択します。COS はこれを拒否します。--timeout のデフォルトは 30 秒、--delay のデフォルトは API リクエストあたり 0.12 秒です。リダイレクトは任意のホストへは追跡されません。リージョンリダイレクトに頼るのではなく、正しいリージョン/エンドポイントを指定してください。
SDK の署名とコマンドの動作はオフラインでテストされています。インポートされた EOS リージョンインベントリやレガシーな Sber エンドポイントを含む、実際のサービスでの受け入れ確認は、権限を持つプロバイダーアカウントに対して検証する必要があります。
| オプション | デフォルト | 説明 |
|---|---|---|
-w, --wordlist PATH | 必須 | 候補バケット名を1行に1つずつ含むファイル。空行と # で始まるコメントは無視されます。 |
--providers VALUE | yandex,vk | カンマ区切りのプロバイダーフラグ、または all、russia、china。 |
--dns | 無効 | パッシブ DNS チェックを実行し、解決できないホスト名をスキップします。 |
--resolvers | システムリゾルバー | --dns と併用し、代わりにこれらのリゾルバーに問い合わせます。カンマ区切りの IP(8.8.8.8,9.9.9.9)または1行に1つの IP を記載したファイル。 |
-t, --threads N | 12 | 同時に実行するバケットワーカーの数。 |
--delay SECONDS | 0.12 | HTTP リクエスト間の遅延。 |
--timeout SECONDS | 30 | リクエストのタイムアウト。 |
--<provider>-region VALUE | プロバイダーのエンドポイント | このプロバイダーを特定のリージョンに限定します。 |
--<provider>-endpoint HOST | プロバイダーのエンドポイント | このプロバイダーを明示的な HTTPS API エンドポイントに限定します。 |
EOS のリージョン/エンドポイントの上書きがない場合、scan --providers cmecloud はインポートされた30リージョンのインベントリ全体に対して両方のアドレッシングスタイルをプローブします。これにより、候補ごとに最大60回のエンドポイント試行が追加されます。デフォルトのプロバイダーセットは引き続き Yandex/VK です。