Varre endpoints públicos de armazenamento de objetos em nuvem no Yandex, VK, Selectel, Sber, Alibaba, Tencent, Huawei e Baidu para encontrar buckets listáveis e objetos expostos.
Scanner de exposição de armazenamento de objetos em nuvem e CLI de armazenamento somente leitura para testes de segurança autorizados, trabalho de bug bounty e infraestrutura própria.
O BucketBuster verifica nomes de buckets candidatos em endpoints públicos do Yandex Cloud, VK Cloud, Selectel, SberCloud, Alibaba OSS, Tencent COS, Huawei OBS, Baidu BOS e China Mobile Cloud EOS. Ele pode identificar buckets listáveis publicamente, corresponder a nomes de objetos relacionados a certificados e, opcionalmente, baixar objetos acessíveis publicamente via HTTP GET. Os comandos de armazenamento também suportam listagens autenticadas, downloads, metadados e URLs assinadas usando as credenciais nativas de cada provedor.
Autorização necessária: Use esta ferramenta apenas contra ativos que você possui ou tem permissão explícita para testar. Escanear ou baixar dados de buckets de terceiros pode ser ilegal. Você é responsável por cumprir as leis aplicáveis, contratos, regras de bug bounty e políticas dos provedores.
scan.git clone <repository-url>
cd bucketbuster
python -m venv .venv
Ative o ambiente virtual:
# Linux/macOS
source .venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
Instale as dependências:
python -m pip install -r requirements.txt
Crie uma wordlist como buckets.txt:
example-company
example-company-backup
example-company-documents
Execute o conjunto padrão de provedores, Yandex Cloud e VK Cloud:
python bucketbuster.py scan --wordlist buckets.txt
O scanner relata respostas HTTP 200, listagens públicas, nomes de objetos correspondentes e endpoints com acesso negado que parecem existir. Uma resposta 404 é ignorada.
Alteraç��o na CLI: Agora um comando é obrigatório. Invocações existentes que começam com
python bucketbuster.py -w ... devem se tornar python bucketbuster.py scan -w ....
| Flag do provedor | Serviço | Famílias de endpoints incluídas |
|---|---|---|
yandex | Yandex Cloud | Endpoints de armazenamento e de site |
vk | VK Cloud | Endpoints vkcloud-storage.ru |
selectel | Selectel | Endpoints S3 e selstorage.ru |
sber | SberCloud | Endpoints OBS e s3.cloud.ru |
aliyun | Alibaba Cloud OSS | Regiões selecionadas da China |
tencent | Tencent Cloud COS | Regiões selecionadas da China e da Ásia |
huawei | Huawei Cloud OBS | Regiões selecionadas da China |
baidu | Baidu Cloud BOS | Regiões selecionadas da China e da Ásia |
cmecloud | China Mobile Cloud EOS | 30 regiões a partir da ferramenta EOS fornecida |
Grupos de provedores:
--providers russia # yandex, vk, selectel, sber
--providers china # aliyun, tencent, huawei, baidu, cmecloud
--providers all # every supported provider
Também é possível fornecer uma lista separada por vírgulas, por exemplo:
python bucketbuster.py scan -w buckets.txt --providers aliyun,tencent
Cada provedor usa suas próprias credenciais. Chaves de um provedor nunca são reutilizadas
para outro, e perfis AWS, metadados de instância ou entradas .netrc não relacionados
não são usados para autenticar requisições.
| Provedor | API autenticada |
|---|---|
yandex, vk, selectel, cmecloud | S3 Signature V4 via boto3 |
aliyun | OSS V4 nativo via oss2 |
tencent | COS nativo via cos-python-sdk-v5 |
huawei | OBS nativo via esdk-obs-python |
sber | OBS para obs.*.hc.sbercloud.ru; S3 para s3.cloud.ru |
baidu | Assinatura BCE/BOS nativa para BOS regional; S3 para s3.*.bcebos.com |
Defina as variáveis de ambiente usando a flag do provedor em maiúsculas:
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_ID
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_SECRET
BUCKETBUSTER_<PROVIDER>_SESSION_TOKEN
BUCKETBUSTER_<PROVIDER>_ENDPOINT
BUCKETBUSTER_<PROVIDER>_REGION
Por exemplo, BUCKETBUSTER_CMECLOUD_ACCESS_KEY_ID e
BUCKETBUSTER_CMECLOUD_ACCESS_KEY_SECRET. O CMECloud também aceita as variáveis
EOS_ACCESS_KEY_ID, EOS_ACCESS_KEY_SECRET, EOS_SESSION_TOKEN,
EOS_ENDPOINT e EOS_REGION da ferramenta autónoma como aliases de menor
prioridade.
Para comandos de armazenamento, --access-key-id, --access-key-secret e
--session-token opcional explícitos substituem os valores de ambiente por
campo. Para a análise, utilize flags específicas do fornecedor, como
--cmecloud-access-key-id e --cmecloud-access-key-secret; o mesmo padrão
funciona para todos os fornecedores. Um par de chaves incompleto, ou um token
sem par, é rejeitado.
Prefira variáveis de ambiente: segredos na linha de comandos podem aparecer no histórico da shell e nas listagens de processos. Não inclua credenciais reais em relatórios ou submissões de bugs.
Os comandos selecionam exatamente um --provider; não necessitam de uma
wordlist nem de sondar todas as regiões. As opções comuns podem aparecer antes
ou depois do comando, como na ferramenta EOS fornecida:
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