소유권이 입증된 도메인만 스캔하고 스캔 시점에 그 증명을 다시 확인하는 셀프서비스 모의 침투 테스트 플랫폼입니다. OWASP, TLS, DNS 및 포트 검사와 제한된 읽기 전용 AI 분석을 제공합니다.
무료 오픈소스 검증 도메인 침투 테스트 플랫폼입니다. 웹사이트를 입력하고 소유권을 증명하면 실제 보안 평가가 실행됩니다 — OWASP 웹 취약점, 의존성/시크릿 스캐닝, 네트워크/인프라 노출, TLS/SSL 감사, 그리고 (번들로 제공되는 Claude Code 스킬을 통해) 결과를 상호 연관시켜 고정된 규칙 엔진이 놓칠 공격 체인으로 분석하는 AI 분석 패스까지 수행합니다.
소유하거나 통제하지 않는 웹사이트에 대한 자동 스캐닝은 의도와 무관하게, 선한 동기라 하더라도 불법입니다. 그래서 전체 시스템은 하나의 양보할 수 없는 관문을 중심으로 구축되었습니다: 암호학적으로 소유권이 증명되지 않은 도메인에 대해서는 스캔이 절대 실행되지 않으며, 가입 시점이 아니라 스캔 시점에 재확인됩니다. 아래의 다른 모든 안전 장치는 이 도구가 본래 목적이 아닌 다른 용도로 전용되는 것을 막기 위해 존재합니다.
src/verification/) — DNS TXT 레코드 또는 /.well-known/verified-pentest.txt 파일 / 메타 태그. 가입 시 한 번만이 아니라 매 스캔 직전에 재검증되므로, 소유자가 바뀌었거나 토큰이 제거된 도메인은 오래된 신뢰를 근거로 스캔될 수 없습니다.src/config/safety.ts) — 이 도구는 절대 DoS 소스가 될 수 없습니다.src/utils/ssrfGuard.ts) — 모든 아웃바운드 요청은 사설/루프백/링크-로컬/클라우드 메타데이터 IP 대역을 대상으로 하는 것을 거부합니다.이 중 어느 것도 형식적인 체크박스가 아닙니다 — 소스 내 인라인으로 된 검사별 근거를 참조하세요, 특히 src/config/safety.ts와 .claude/skills/deep-pentest/SKILL.md를 보세요.
설치 불필요(순수 Node, 외부 바이너리 없음):
| 검사 | 발견하는 항목 |
|---|---|
headers | 누락된 CSP/HSTS/X-Frame-Options 등, 서버 버전 노출 |
tls | 인증서 만료/신뢰, 폐기된 TLS1.0/1.1 지원 |
dns-config | 누락/약한 SPF, 누락/모니터링 전용 DMARC |
cookie-flags | 쿠키의 누락된 Secure/HttpOnly/SameSite |
csrf | 명백한 CSRF 토큰이 없는 POST 폼 (휴리스틱) |
client-js-libs | 취약한 클라이언트 측 JS 라이브러리 버전 |
secret-scan | 클라이언트에 제공되는 코드에 노출된 API 키/시크릿 |
port-scan | 열린 포트 (nmap이 설치되어 있으면 사용, 그렇지 않으면 내장 TCP-connect 폴백) |
도구 기반(자동 감지; 도구가 없으면 각 검사는 설치 힌트와 함께 skipped를 보고합니다 — 조용히 실패하는 것은 없습니다):
| 검사 | 도구 | 추가하는 항목 |
|---|---|---|
zap-scan | OWASP ZAP | 능동 웹 취약점 스캐닝 (DoS 범주 규칙은 강제 비활성화) |
nuclei-scan | nuclei | 수천 개의 커뮤니티 CVE/오구성 템플릿 |
httpx-fingerprint | httpx | 기술/스택 핑거프린팅 |
subfinder-recon | subfinder | 수동 서브도메인 탐색 (보고만 되며, 자동 스캔되지 않음) |
testssl-scan | testssl.sh | 심층 TLS/SSL 감사 (Heartbleed, POODLE, ROBOT, 암호/프로토콜 커버리지) |
repo-dependency-scan | gitleaks, osv-scanner, semgrep, trivy | 유출된 시크릿, 취약한 의존성, 코드 수준 취약점 클래스, IaC 오구성 (repoUrl이 제공된 경우에만) |
npm install
cp .env.example .env # fill in BOOTSTRAP_ADMIN_TOKEN at minimum
npx prisma migrate dev
npm run dev # http://localhost:3000
선택 사항 — 위의 도구 기반 검사를 설치합니다(sudo 불필요; nuclei/ httpx/subfinder/trivy/gitleaks/osv-scanner는 사전 빌드된 바이너리로, ZAP + 이식 가능한 JDK 17, testssl.sh는 git clone으로, semgrep은 pipx로):
scripts/setup-tools.sh
# 1. Get an API key (gated by BOOTSTRAP_ADMIN_TOKEN in .env — this is a
# self-service security tool, not an open-signup product yet)
curl -X POST localhost:3000/auth/signup \
-H 'content-type: application/json' \
-d '{"email":"[email protected]","bootstrapToken":"<from .env>"}'
# 2. Register a domain -- returns DNS TXT / file / meta-tag instructions
curl -X POST localhost:3000/domains \
-H "authorization: Bearer $API_KEY" -H 'content-type: application/json' \
-d '{"hostname":"yoursite.com"}'
# 3. Add the DNS TXT record (or well-known file / meta tag) to your site,
# then verify:
curl -X POST localhost:3000/domains/$DOMAIN_ID/verify \
-H "authorization: Bearer $API_KEY"
# 4. Scan
curl -X POST localhost:3000/domains/$DOMAIN_ID/scans \
-H "authorization: Bearer $API_KEY" -H 'content-type: application/json' \
-d '{"checkTypes":["headers","tls","dns-config"],"consentStatement":"I own this site"}'
# 5. Poll, then get the report
curl localhost:3000/scans/$SCAN_ID -H "authorization: Bearer $API_KEY"
curl "localhost:3000/scans/$SCAN_ID/report?format=markdown" -H "authorization: Bearer $API_KEY"
보고서는 json(기본값), markdown 또는 html로 렌더링됩니다. 모든 보고서에는 Check Execution Summary 표가 포함되어 있어 "이 카테고리에서 아무것도 발견되지 않음"과 "이 검사에서 오류가 발생했거나 건너뛰어짐"이 절대 모호하게 섞이지 않습니다.
이 저장소에는 .claude/skills/deep-pentest/SKILL.md가 포함되어 있습니다. Claude Code에서 이 프로젝트를 열고, 위 API를 통해 이미 등록하고 검증한 도메인에 대해 딥/AI 지원 펜테스트를 요청하세요. 이 스킬은:
POST /scans/:id/ai-findings를 통해 분석 결과를 다시 게시하며, 여기서 동일한 보고서에 병합되고 AI-CONFIRMED(증거 포함) 또는 AI-HYPOTHESIZED(미확인)로 명확히 배지가 표시됩니다.스킬 파일 자체에 하드 규칙(소유권 검증된 대상만, 상한이 설정된 읽기 전용 검증, 브루트포싱/DDoS/데이터 수정에 대한 명시적 금지)이 담겨 있어 대화에서 무엇을 요청하든 이 규칙이 유지됩니다. AI 계층이 무엇을 하고 무엇을 하지 않을지 가정하기 전에 이 파일을 읽어 보세요.
prisma/schema.prisma의 datasource 주석 참조), Vitest.src/scanner/orchestrator.ts): p-queue 기반이며, 동시성이 상한 설정되고, HTTPS를 가정하지 않고 대상별로 작동 스킴(http vs https)을 자동 감지합니다.src/scanner/checks/): 모두 동일한 CheckModule 인터페이스(src/scanner/types.ts)를 구현합니다 — 도구 존재 여부를 확인하고, 바이너리가 설치되어 있지 않으면 깔끔하게 건너뛰며, "아무것도 발견되지 않음"에 대해서는 절대 예외를 던지지 않고 실제 실행 오류에 대해서만 예외를 던집니다.src/utils/networkSetup.ts): 실제 IPv6 라우팅이 없는 샌드박스/컨테이너 환경에서 Node의 fetch는 실패할 것이 뻔한 듀얼 스택 시도를 하느라 요청당 5초 이상을 소모한 뒤에야 폴백할 수 있습니다. 이는 기본적으로 강제 해제되어 있으며, IPv6 전용 대상을 스캔해야 하는 경우 다시 검토하세요.npm test # vitest
npx tsc --noEmit # typecheck
npx prisma migrate dev # after schema changes
MIT — LICENSE를 참조하세요. 이 도구는 침투 테스트 도구입니다. 코드를 보유한다고 해서 소유하지 않았거나 명시적 테스트 허가를 받지 않은 대상을 스캔할 권한이 부여되는 것은 아니며, 이는 이 도구 자체의 검증이 이미 강제하는 사항에 더해 적용됩니다.