Scansiona gli endpoint pubblici di object storage su Yandex, VK, Selectel, Sber, Alibaba, Tencent, Huawei e Baidu per individuare bucket listabili e oggetti esposti.
Scanner per l'esposizione di object storage cloud e CLI di storage in sola lettura per test di sicurezza autorizzati, attività di bug bounty e infrastrutture di tua proprietà.
BucketBuster verifica nomi di bucket candidati su endpoint pubblici per Yandex Cloud, VK Cloud, Selectel, SberCloud, Alibaba OSS, Tencent COS, Huawei OBS, Baidu BOS e China Mobile Cloud EOS. Può identificare bucket elencabili pubblicamente, individuare nomi di oggetti correlati ai certificati e, facoltativamente, scaricare oggetti accessibili pubblicamente tramite HTTP GET. I comandi di storage supportano anche elenchi autenticati, download, metadati e URL firmati utilizzando le credenziali native di ciascun provider.
Autorizzazione richiesta: Utilizza questo strumento solo su asset di tua proprietà o per i quali disponi di esplicita autorizzazione al test. La scansione o il download di dati da bucket di terze parti può essere illegale. Sei responsabile del rispetto delle leggi applicabili, dei contratti, delle regole di bug-bounty e delle policy dei provider.
scan.git clone <repository-url>
cd bucketbuster
python -m venv .venv
Attiva l'ambiente virtuale:
# Linux/macOS
source .venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
Installa le dipendenze:
python -m pip install -r requirements.txt
Crea una wordlist come buckets.txt:
example-company
example-company-backup
example-company-documents
Esegui il set di provider predefinito, Yandex Cloud e VK Cloud:
python bucketbuster.py scan --wordlist buckets.txt
Lo scanner segnala risposte HTTP 200, listing pubblici, nomi di oggetti corrispondenti ed endpoint con accesso negato che sembrano esistere. Una risposta 404 viene ignorata.
Modifica alla CLI: Ora è richiesto un comando. Le invocazioni esistenti che iniziano con
python bucketbuster.py -w ... devono diventare python bucketbuster.py scan -w ....
| Flag del provider | Servizio | Famiglie di endpoint incluse |
|---|---|---|
yandex | Yandex Cloud | Endpoint di storage e website |
vk | VK Cloud | Endpoint vkcloud-storage.ru |
selectel | Selectel | Endpoint S3 e selstorage.ru |
sber | SberCloud | Endpoint OBS e s3.cloud.ru |
aliyun | Alibaba Cloud OSS | Regioni selezionate della Cina |
tencent | Tencent Cloud COS | Regioni selezionate della Cina e dell'Asia |
huawei | Huawei Cloud OBS | Regioni selezionate della Cina |
baidu | Baidu Cloud BOS | Regioni selezionate della Cina e dell'Asia |
cmecloud | China Mobile Cloud EOS | 30 regioni dallo strumento EOS fornito |
Gruppi di provider:
--providers russia # yandex, vk, selectel, sber
--providers china # aliyun, tencent, huawei, baidu, cmecloud
--providers all # every supported provider
Puoi anche fornire un elenco separato da virgole, ad esempio:
python bucketbuster.py scan -w buckets.txt --providers aliyun,tencent
Ogni provider utilizza le proprie credenziali. Le chiavi di un provider non vengono mai riutilizzate
per un altro, e profili AWS, metadati delle istanze o voci .netrc non correlati
non vengono usati per autenticare le richieste.
| Provider | API autenticata |
|---|---|
yandex, vk, selectel, cmecloud | S3 Signature V4 tramite boto3 |
aliyun | OSS V4 nativo tramite oss2 |
tencent | COS nativo tramite cos-python-sdk-v5 |
huawei | OBS nativo tramite esdk-obs-python |
sber | OBS per obs.*.hc.sbercloud.ru; S3 per s3.cloud.ru |
baidu | Firma BCE/BOS nativa per BOS regionale; S3 per s3.*.bcebos.com |
Imposta le variabili d'ambiente usando il flag del provider in maiuscolo:
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_ID
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_SECRET
BUCKETBUSTER_<PROVIDER>_SESSION_TOKEN
BUCKETBUSTER_<PROVIDER>_ENDPOINT
BUCKETBUSTER_<PROVIDER>_REGION
Ad esempio, BUCKETBUSTER_CMECLOUD_ACCESS_KEY_ID e
BUCKETBUSTER_CMECLOUD_ACCESS_KEY_SECRET. CMECloud accetta anche le variabili
EOS_ACCESS_KEY_ID, EOS_ACCESS_KEY_SECRET, EOS_SESSION_TOKEN,
EOS_ENDPOINT e EOS_REGION dello strumento standalone come alias a priorità inferiore.
Per i comandi di storage, --access-key-id, --access-key-secret e
l'opzionale --session-token espliciti sovrascrivono i valori delle variabili d'ambiente per ciascun campo. Per la scansione,
usare flag specifici del provider come --cmecloud-access-key-id e
--cmecloud-access-key-secret; lo stesso schema funziona per ogni provider.
Una coppia di chiavi incompleta, o un token senza coppia, viene rifiutata.
Preferire le variabili d'ambiente: i segreti sulla riga di comando possono comparire nella cronologia della shell e negli elenchi dei processi. Non includere credenziali reali nei report o nelle segnalazioni di bug.
I comandi selezionano esattamente un --provider; non necessitano di una wordlist né di sondare
tutte le regioni. Le opzioni comuni possono apparire prima o dopo il comando, come nello
strumento EOS fornito:
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