Escanea endpoints públicos de almacenamiento de objetos en la nube de Yandex, VK, Selectel, Sber, Alibaba, Tencent, Huawei y Baidu para encontrar buckets listables y objetos expuestos.
Escáner de exposición de almacenamiento de objetos en la nube y CLI de almacenamiento de solo lectura para pruebas de seguridad autorizadas, trabajo de bug bounty e infraestructura de su propiedad.
BucketBuster comprueba nombres de bucket candidatos contra endpoints públicos de Yandex Cloud, VK Cloud, Selectel, SberCloud, Alibaba OSS, Tencent COS, Huawei OBS, Baidu BOS y China Mobile Cloud EOS. Puede identificar buckets listables públicamente, coincidir nombres de objetos relacionados con certificados y, opcionalmente, descargar objetos accesibles públicamente mediante HTTP GET. Los comandos de almacenamiento también admiten listados autenticados, descargas, metadatos y URLs firmadas usando las credenciales nativas de cada proveedor.
Se requiere autorización: Utilice esta herramienta únicamente contra activos de su propiedad o para los que tenga permiso explícito de probar. Escanear o descargar datos de buckets de terceros puede ser ilegal. Usted es responsable de cumplir con las leyes aplicables, contratos, reglas de bug-bounty y políticas de los proveedores.
scan.git clone <repository-url>
cd bucketbuster
python -m venv .venv
Activa el entorno virtual:
# Linux/macOS
source .venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
Instalar dependencias:
python -m pip install -r requirements.txt
Cree una lista de palabras como buckets.txt:
example-company
example-company-backup
example-company-documents
Ejecute el conjunto de proveedores predeterminado, Yandex Cloud y VK Cloud:
python bucketbuster.py scan --wordlist buckets.txt
El escáner reporta respuestas HTTP 200, listados públicos, nombres de objetos coincidentes y endpoints con acceso denegado que parecen existir. Una respuesta 404 se ignora.
Cambio en la CLI: Ahora se requiere un comando. Las invocaciones existentes que comienzan con
python bucketbuster.py -w ... deben convertirse en python bucketbuster.py scan -w ....
| Flag de proveedor | Servicio | Familias de endpoints incluidas |
|---|---|---|
yandex | Yandex Cloud | Endpoints de almacenamiento y sitio web |
vk | VK Cloud | Endpoints vkcloud-storage.ru |
selectel | Selectel | Endpoints S3 y selstorage.ru |
sber | SberCloud | Endpoints OBS y s3.cloud.ru |
aliyun | Alibaba Cloud OSS | Regiones seleccionadas de China |
tencent | Tencent Cloud COS | Regiones seleccionadas de China y Asia |
huawei | Huawei Cloud OBS | Regiones seleccionadas de China |
baidu | Baidu Cloud BOS | Regiones seleccionadas de China y Asia |
cmecloud | China Mobile Cloud EOS | 30 regiones de la herramienta EOS proporcionada |
Grupos de proveedores:
--providers russia # yandex, vk, selectel, sber
--providers china # aliyun, tencent, huawei, baidu, cmecloud
--providers all # every supported provider
También puedes proporcionar una lista separada por comas, por ejemplo:
python bucketbuster.py scan -w buckets.txt --providers aliyun,tencent
Cada proveedor utiliza sus propias credenciales. Las claves de un proveedor nunca se reutilizan
para otro, y los perfiles de AWS no relacionados, los metadatos de instancia o las entradas de .netrc
no se utilizan para autenticar solicitudes.
| Proveedor | API autenticada |
|---|---|
yandex, vk, selectel, cmecloud | S3 Signature V4 mediante boto3 |
aliyun | OSS V4 nativo mediante oss2 |
tencent | COS nativo mediante cos-python-sdk-v5 |
huawei | OBS nativo mediante esdk-obs-python |
sber | OBS para obs.*.hc.sbercloud.ru; S3 para s3.cloud.ru |
baidu | Firma nativa BCE/BOS para BOS regional; S3 para s3.*.bcebos.com |
Establezca las variables de entorno utilizando el indicador del proveedor en mayúsculas:
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_ID
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_SECRET
BUCKETBUSTER_<PROVIDER>_SESSION_TOKEN
BUCKETBUSTER_<PROVIDER>_ENDPOINT
BUCKETBUSTER_<PROVIDER>_REGION
Por ejemplo, BUCKETBUSTER_CMECLOUD_ACCESS_KEY_ID y
BUCKETBUSTER_CMECLOUD_ACCESS_KEY_SECRET. CMECloud también acepta las variables
EOS_ACCESS_KEY_ID, EOS_ACCESS_KEY_SECRET, EOS_SESSION_TOKEN,
EOS_ENDPOINT y EOS_REGION de la herramienta independiente como alias de menor prioridad.
Para los comandos de almacenamiento, --access-key-id, --access-key-secret y
el opcional --session-token sobrescriben los valores de entorno por campo. Para el escaneo,
use flags específicos del proveedor como --cmecloud-access-key-id y
--cmecloud-access-key-secret; el mismo patrón funciona para todos los proveedores.
Se rechaza un par de claves incompleto, o un token sin un par.
Prefiera las variables de entorno: los secretos en la línea de comandos pueden aparecer en el historial del shell y en los listados de procesos. No incluya credenciales reales en informes ni en envíos de errores.
Los comandos seleccionan exactamente un --provider; no necesitan una wordlist ni sondear
todas las regiones. Las opciones comunes pueden aparecer antes o después del comando, como en la
herramienta EOS proporcionada:
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