S3DNS

s3dns는 DNS 요청을 분석하고, CNAME을 추적하며, 알려진 버킷 URL 패턴과 일치시켜 클라우드 스토리지 버킷(AWS S3, Google Cloud Storage, Azure Blob)을 찾아내는 경량 DNS 서버입니다.

침투 테스터, 버그 바운티 헌터, 클라우드 보안 분석가에게 유용한 도구로, DNS 트래픽 분석 중 노출된 클라우드 버킷을 발견하는 데 도움을 줍니다.

S3DNS가 리콘 세션에서 시간을 절약해 주었다면, ⭐️를 눌러 주세요. 다른 사람들이 프로젝트를 찾는 데 도움이 됩니다.

🆕 업데이트 2026/03/06

• TCP/53 지원 — S3DNS가 이제 UDP와 TCP 포트 53 모두에서 수신합니다. 잘린 UDP 응답 후 TCP로 재시도하는 클라이언트를 올바르게 처리하며, 쿼리를 TCP를 통해 업스트림으로 전달하여 전체 응답을 가져옵니다.
• 더 큰 DNS 버퍼 — UDP 수신 버퍼가 512바이트에서 4096바이트로 증가했습니다. 클라이언트의 EDNS0 옵션이 변경되지 않고 업스트림 리졸버로 전달됩니다.
• 응답 캐시 — TTL 기반 LRU 캐시가 UDP 및 TCP 경로에서 DNS 응답을 공유합니다. 활성 리콘 세션 중 업스트림 부하와 지연 시간을 줄여줍니다. CACHE_SIZE로 설정 가능(기본값: 1000개 항목, 0으로 설정하면 비활성화).
• 속도 제한 — 클라이언트 IP별 요청 속도 제한으로 남용을 방지합니다. RATE_LIMIT으로 설정 가능(기본값: 100 req/s, 0으로 설정하면 비활성화).
• 서브도메인 탈취 탐지 — 도메인이 클라우드 스토리지 패턴과 일치하지만 NXDOMAIN을 반환하는 경우, S3DNS가 이를 가능한 도메인 탈취로 플래그합니다. 이는 공격자가 등록할 수 있는 클레임되지 않은 버킷을 가리키는 죽은 DNS 레코드를 나타냅니다.
• IPv6 IP 범위 확인 — AAAA 레코드도 확인하여 알려진 클라우드 스토리지 IP 범위와 대조합니다. AWS IPv6 S3 접두사가 IPv4 범위와 함께 로드됩니다.
• CNAME 깊이 제한 — 재귀적 CNAME 체인 추적이 제한됩니다(기본값: 10홉). 조작되거나 순환 레코드에서 무한 루프를 방지하기 위해 max_cname_depth 매개변수로 설정 가능합니다.

업데이트 2025/08/19

• 오프라인 AWS IP 범위를 JSON 파일로 추가했습니다.
• 오프라인 Azure Storage IP 범위를 JSON 파일로 추가했습니다.
• 다음을 사용하여 각 서비스에 대한 IP 범위 확인을 비활성화하는 옵션을 추가했습니다:
  • AZURE_IP_RANGES=false 또는 AWS_IP_RANGES=false (기본값은 true).
• regex_patterns 및 하드코딩된 패턴을 patterns 폴더로 YAML 파일로 이동했습니다. 사용자 패턴을 추가할 수 있습니다.
  • 정규식 패턴은 regex_로 시작해야 합니다.
• 여러 클라우드 제공업체를 추가했습니다
  • IBM Cloud Object Storage
  • Oracle Object Storage
  • Alibaba OSS
  • Backblaze B2
  • Linode Object Storage
  • Scaleway Object Storage
  • Vultr Object Storage
  • Cloudflare R2

업데이트 2025/06/21

• AWS GovCloud 지원을 추가했습니다.

업데이트 2025/04/16

• 정규식 패턴을 업데이트했습니다.
• 가시성을 위해 출력을 업데이트했습니다(CNAME의 원래 도메인, 클라이언트 IP, IP 범위 표시기 표시).
• AWS에서 IP 범위 자동 다운로드 — 이제 그것들도 확인합니다!
• 사용자 IP 범위를 추가하는 옵션(클래스에서 패턴 또는 IP 범위를 수동으로 조정).

업데이트 2025/04/14

• Google Cloud Storage 및 Azure Blob Storage 버킷에 대한 정규식 지원을 추가했습니다.

🚀 기능

• 포트 53(UDP 및 TCP)에서 DNS 서버로 실행
• DNS 요청에서 잠재적 클라우드 스토리지 버킷 탐지:
  • AWS S3 (가상 호스트 및 경로 스타일, GovCloud 포함)
  • GCP 버킷
  • Azure Blob 컨테이너
  • DigitalOcean Spaces, Wasabi, IBM COS, Oracle Object Storage, Alibaba OSS, Backblaze B2, Linode, Scaleway, Vultr, Cloudflare R2
• CNAME 체인을 재귀적으로 추적(설정 가능한 깊이 제한)하여 마스킹된 클라우드 버킷 링크 포착
• 잠재적 서브도메인 탈취 플래그 — NXDOMAIN을 반환하는 클라우드 스토리지 패턴
• 확인된 IP(A 및 AAAA 모두)를 알려진 AWS S3 및 Azure Storage IP 범위와 대조
• TTL 인식 응답 캐시로 지연 시간 및 업스트림 부하 감소
• IP별 속도 제한으로 남용 방지
• 모든 발견 사항을 콘솔과 파일에 기록
• 컨테이너 친화적

⚙️ 작동 방식

S3DNS는 DNS 쿼리를 위해 **포트 53(UDP 및 TCP)**에서 수신합니다. 각 요청에 대해 다음을 수행합니다:

1. 요청된 도메인 추출
2. 응답 캐시 확인 — 유효한 캐시된 응답이 있으면 즉시 반환
3. 요청을 실제 DNS 리졸버(예: 1.1.1.1)로 전달 — UDP 클라이언트는 UDP로, TCP 클라이언트는 TCP로
4. 유효한 DNS 응답을 클라이언트에 반환

병렬로 다음을 수행합니다:

• 클라우드 스토리지 버킷 패턴 확인(정규식 및 하드코딩된 호스트 이름 일치)
• 확인된 IP를 알려진 AWS S3 및 Azure Storage 범위와 대조(IPv4 및 IPv6)
• CNAME 체인을 재귀적으로 추적(설정된 깊이까지)
• 일치하는 패턴에서 NXDOMAIN 히트를 가능한 서브도메인 탈취 후보로 플래그
• 모든 발견 사항을 콘솔과 s3dns.log에 기록

⚡ 리콘 중에 DNS로 사용하면 도구나 브라우저가 확인하는 모든 도메인에 대해 클라우드 버킷과 탈취 후보를 수동적으로 표면화합니다.

🧱 전제 조건

다음 중 하나만 필요합니다:

• Python 3.11+
• Docker (선택 사항이지만 권장됨)

🔧 설치

Python으로 로컬에서 실행하려는 경우에만 필요합니다

리포지토리 클론

git clone https://github.com/olizimmermann/s3dns.git
cd s3dns

의존성 설치

(가상 환경 사용 권장)

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

🧪 사용법

Python으로 실행

포트 53은 상승된 권한이 필요합니다:

sudo python s3dns.py

sudo에서 모듈 누락 오류가 발생하면 sudo venv/bin/python s3dns.py를 시도하세요

• 이미지를 직접 빌드하는 경우 Docker Hub 버전과 일관성을 위해 동일하게 태그하세요: docker build -t ozimmermann/s3dns:latest .

Docker 사용

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로 빌드 및 실행

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

🌐 리콘에서 S3DNS 사용

시스템 또는 도구의 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

환경 변수

⚠️ Azure IP 범위 참고 사항

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 라이선스 — 자유롭게 사용, 개선 및 공유할 수 있습니다.

⚠️ 면책 조항

책임감 있게 사용하세요. 소유하고 있거나 명시적 권한이 있는 도메인만 스캔하세요.

무단 액세스 또는 프로빙은 불법일 수 있습니다.