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을 지원합니다.
승인 필요: 이 도구는 소유한 자산 또는 테스트에 대한 명시적 허가를 받은 자산에 대해서만 사용하십시오. 제3자 버킷을 스캔하거나 데이터를 다운로드하는 것은 불법일 수 있습니다. 적용 가능한 법률, 계약, 버그 바운티 규칙, 공급자 정책을 준수할 책임은 사용자에게 있습니다.
scan 전용으로, 한 줄에 하나씩 후보 버킷 이름을 포함하는 워드리스트.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 같은 공급자별 플래그를
사용하십시오. 동일한 패턴이 모든 공급자에 적용됩니다.
불완전한 키 쌍이나, 쌍 없이 제공된 토큰은 거부됩니다.
환경 변수를 사용하는 것을 권장합니다. 명령줄에 입력한 비밀 정보는 셸 기록과 프로세스 목록에 나타날 수 있습니다. 보고서나 버그 제출물에 실제 자격 증명을 포함하지 마십시오.
명령은 정확히 하나의 --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 | 목록 페이지 하나를 조회합니다. --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로
전달되고 0이 아닌 종료 코드를 반환합니다. 서명된 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 | 필수 | 후보 버킷 이름이 한 줄에 하나씩 포함된 파일입니다. 빈 줄과 #으로 시작하는 주석은 무시됩니다. |
--providers VALUE | yandex,vk | 쉼표로 구분된 공급자 플래그 또는 all, russia, china입니다. |
--dns | 비활성화 | 수동 DNS 확인을 수행하고 확인되지 않는 호스트 이름을 건너뜁니다. |
--resolvers | 시스템 리졸버 | --dns와 함께 사용할 경우 대신 이 리졸버에 쿼리합니다. 쉼표로 구분된 IP(8.8.8.8,9.9.9.9) 또는 한 줄에 하나의 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입니다.