olizimmermann/s3dns수동 DNS 서버로, DNS 요청을 확인하고 CNAME 체인을 추적하며 정찰 중 잠재적인 서브도메인 탈취를 플래그하여 노출된 클라우드 스토리지 버킷(AWS S3, GCP, Azure)을 탐지합니다.
s3dns는 DNS 요청을 분석하고, CNAME을 추적하며, 알려진 버킷 URL 패턴과 일치시켜 클라우드 스토리지 버킷(AWS S3, Google Cloud Storage, Azure Blob)을 찾아내는 경량 DNS 서버입니다.
침투 테스터, 버그 바운티 헌터, 클라우드 보안 분석가에게 유용한 도구로, DNS 트래픽 분석 중 노출된 클라우드 버킷을 발견하는 데 도움을 줍니다.
S3DNS가 리콘 세션에서 시간을 절약해 주었다면, ⭐️를 눌러 주세요. 다른 사람들이 프로젝트를 찾는 데 도움이 됩니다.
CACHE_SIZE로 설정 가능(기본값: 1000개 항목, 0으로 설정하면 비활성화).RATE_LIMIT으로 설정 가능(기본값: 100 req/s, 0으로 설정하면 비활성화).NXDOMAIN을 반환하는 경우, S3DNS가 이를 가능한 도메인 탈취로 플래그합니다. 이는 공격자가 등록할 수 있는 클레임되지 않은 버킷을 가리키는 죽은 DNS 레코드를 나타냅니다.max_cname_depth 매개변수로 설정 가능합니다.AZURE_IP_RANGES=false 또는 AWS_IP_RANGES=false (기본값은 true).regex_patterns 및 하드코딩된 패턴을 patterns 폴더로 YAML 파일로 이동했습니다. 사용자 패턴을 추가할 수 있습니다.
regex_로 시작해야 합니다.53(UDP 및 TCP)에서 DNS 서버로 실행S3DNS는 DNS 쿼리를 위해 **포트 53(UDP 및 TCP)**에서 수신합니다. 각 요청에 대해 다음을 수행합니다:
1.1.1.1)로 전달 — UDP 클라이언트는 UDP로, TCP 클라이언트는 TCP로병렬로 다음을 수행합니다:
s3dns.log에 기록⚡ 리콘 중에 DNS로 사용하면 도구나 브라우저가 확인하는 모든 도메인에 대해 클라우드 버킷과 탈취 후보를 수동적으로 표면화합니다.
다음 중 하나만 필요합니다:
Python으로 로컬에서 실행하려는 경우에만 필요합니다
git clone https://github.com/olizimmermann/s3dns.git
cd s3dns
(가상 환경 사용 권장)
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
포트 53은 상승된 권한이 필요합니다:
sudo python s3dns.py
sudo에서 모듈 누락 오류가 발생하면 sudo venv/bin/python s3dns.py를 시도하세요
docker build -t ozimmermann/s3dns:latest .S3DNS를 시작하는 가장 쉬운 방법입니다.
docker pull ozimmermann/s3dns:latest
docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
--name "s3dns" \
ozimmermann/s3dns:latest
docker build -t ozimmermann/s3dns:latest .
docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
--name "s3dns" \
ozimmermann/s3dns:latest
발견 사항 저장 위치:
./bucket_findings/ 디렉터리분석을 수행하는 동일한 머신에서 S3DNS를 사용할 때 --network host 플래그를 설정하면 도움이 될 수 있습니다:
docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
--network host \
--name "s3dns" \
ozimmermann/s3dns:latest
포트 53은 상승된 권한이 필요하므로 일부 사용자(예: Mac 사용자)는 sudo가 필요할 수 있습니다:
sudo docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
--name "s3dns" \
ozimmermann/s3dns:latest
시스템 또는 도구의 DNS 리졸버를 S3DNS 인스턴스로 설정하세요.
대상 브라우징 또는 퍼징 중에 S3DNS는 모든 도메인을 분석하고 다음으로 확인되는지 알려줍니다:
- AWS S3 버킷
- GCP 버킷
- Azure Blob 컨테이너
- 지원되는 13개 이상의 클라우드 스토리지 제공업체
CNAME을 추적하므로 도메인이
cdn.example.com을 가리키고, 이 도메인이 다시 클라우드 버킷을 가리키는 경우에도 포착합니다.또한 잠재적 서브도메인 탈취를 플래그합니다 — 도메인이 클라우드 스토리지 패턴과 일치하지만 대상이 존재하지 않는 경우(NXDOMAIN), 죽은 레코드가 탈취 가능 후보로 강조 표시됩니다.
사이트를 분석하는 동안 수동적으로 사용하여 노출된 버킷과 탈취 기회를 능동적인 프로빙 없이 발견하세요.
명령줄 플래그, 환경 변수 또는 s3dns.py 수정을 통해 동작을 조정할 수 있습니다.
모든 옵션의 우선순위는 명령줄 플래그 > 환경 변수 > 대화형 프롬프트 / 기본값입니다. 플래그 없이 실행하면 이전과 동일하게 작동합니다.
전체 목록은 python s3dns.py -h를 실행하세요:
예시:
sudo python s3dns.py -l 0.0.0.0 -u 1.1.1.1 --rate-limit 200 --no-azure-ip-ranges
Microsoft는 Azure Blob Storage IP 범위를 명시적으로 명명하지 않으므로, S3DNS는 공개적으로 제공되는 모든 Azure Storage IP 주소를 사용합니다. 이로 인해 오탐이 발생할 수 있습니다. 문제가 발생하면 이 확인을 비활성화하는 것을 고려하세요:
AZURE_IP_RANGES=false
patterns/ 디렉터리에 YAML 파일을 추가하세요. regex_ 접두사가 있는 파일은 정규식 패턴으로 처리되며, 그 외의 파일은 부분 문자열 일치로 처리됩니다.
Python:
sudo su
export DEBUG=true
python s3dns.py
Docker:
docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
-e "DEBUG=true" \
--name "s3dns" \
ozimmermann/s3dns:latest
Docker에서 여러 환경 변수 설정:
docker run --rm -p 53:53/udp -p 53:53/tcp \
-v "./bucket_findings/:/app/buckets/" \
-e "LOCAL_DNS_SERVER_IP=0.0.0.0" \
-e "REAL_DNS_SERVER_IP=1.1.1.1" \
-e "RATE_LIMIT=200" \
-e "CACHE_SIZE=2000" \
--name "s3dns" \
ozimmermann/s3dns:latest
기여는 환영합니다 — 새로운 클라우드 제공업체 패턴, 버그 수정, 개선 사항. 자세한 내용은 CONTRIBUTING.md를 참조하세요.
패턴 파일은 patterns/에 있습니다. 새 제공업체에 대한 지원을 추가하는 것은 YAML 항목을 추가하는 것만큼 간단합니다 — Python이 필요하지 않습니다.
MIT 라이선스 — 자유롭게 사용, 개선 및 공유할 수 있습니다.
책임감 있게 사용하세요. 소유하고 있거나 명시적 권한이 있는 도메인만 스캔하세요.
무단 액세스 또는 프로빙은 불법일 수 있습니다.
| 플래그 | 해당 환경 변수 | 설명 |
|---|
-h, --help | – | 도움말 표시 및 종료 |
--version | – | 버전 표시 및 종료 |
-d, --debug | DEBUG | 상세 디버그 출력 활성화 |
-l, --listen IP | LOCAL_DNS_SERVER_IP | 수신할 로컬 인터페이스 |
-u, --upstream IP | REAL_DNS_SERVER_IP | 전달할 업스트림 DNS 리졸버 |
-b, --bucket-file PATH | BUCKET_FILE | 발견된 버킷 도메인을 쓸 파일 경로 |
--aws-ip-ranges / --no-aws-ip-ranges | AWS_IP_RANGES | AWS S3 IP 범위 확인 전환 |
--azure-ip-ranges / --no-azure-ip-ranges | AZURE_IP_RANGES | Azure Storage IP 범위 확인 전환 |
--rate-limit N | RATE_LIMIT | 클라이언트 IP당 최대 DNS 요청/초 (0 = 비활성화) |
--cache-size N | CACHE_SIZE | 최대 캐시된 DNS 응답 수 (0 = 비활성화) |
--max-cname-depth N | – | 추적할 최대 CNAME 체인 깊이 (기본값: 10) |
| 변수 | 기본값 | 설명 |
|---|
DEBUG | false | 상세 디버그 출력 활성화 |
AWS_IP_RANGES | true | AWS S3 IP 범위 확인 활성화 |
AZURE_IP_RANGES | true | Azure Storage IP 범위 확인 활성화 |
REAL_DNS_SERVER_IP | 1.1.1.1 | 쿼리를 전달할 업스트림 DNS 리졸버 |
LOCAL_DNS_SERVER_IP | 0.0.0.0 | 수신할 로컬 인터페이스 |
BUCKET_FILE | buckets.txt | 발견된 버킷 도메인을 쓸 파일 경로 |
RATE_LIMIT | 100 | 클라이언트 IP당 최대 DNS 요청/초 (0 = 비활성화) |
CACHE_SIZE | 1000 | 최대 캐시된 DNS 응답 수 (0 = 비활성화) |