Apache, Nginx 및 IIS용 서버 보안 감사 도구 — 13개 스캔 단계, 70개 이상의 발견 코드, AI 기반 강화 가이드.

빠른 시작 · 문서 · Docker · AI 분석 · GitHub에서 스타

실제 동작

_{실시간 스캔 · Apache 2.4.54 · 11개 발견 항목 · 44.17초 · 스캔 #518 · 안전 모드}

_{HTML 보고서 — 심각도 분석, OWASP 매핑, 필터 막대}

_{발견 항목 표 — CVE/CWE 배지, 확장 가능한 증거, 설정 조각}

🎯 헤파이스토스란?

헤파이스토스는 윤리를 최우선으로 하는 프로덕션급 서버 보안 감사 도구입니다. 시스템 관리자, DevOps 엔지니어, 침투 테스터를 위해 제작되었으며, 공격자가 악용하기 전에 웹 서버 설정(Apache, Nginx, IIS)을 스캔하여 중요한 오설정을 식별합니다.

왜 헤파이스토스인가?

🔒 윤리적 설계: 동의 토큰 시스템으로 무단 스캔 방지
🤖 AI 기반: GPT-4, Claude 또는 로컬 Ollama를 통한 지능형 강화 가이드 제공
📊 전문 보고서: 아름다운 HTML + 기계가 읽을 수 있는 JSON
🚀 빠르고 효율적: 지능형 속도 제한을 적용한 동시 스캔
💾 영구 추적: Argos 제품군과 공유되는 SQLite 데이터베이스 (~/.argos/argos.db)
🐳 Docker 지원: 컨테이너화된 스캔 + 취약한 테스트 랩(Apache 및 Nginx)
🎯 0% 오탐: 55개 이상의 검증 테스트로 광범위하게 테스트됨

스캔 항목

✨ 기능

🛡️ 핵심 보안 감사```bash

One command, comprehensive server analysis

python -m heph --target https://example.com --html

- **다중 서버 지원**: Apache, Nginx, IIS 탐지 및 강화
- **동시 스캔**: 스레드 풀 + 속도 제한으로 빠르고 예의 바른 스캔
- **증거 수집**: HTTP 응답, 헤더, 파일 내용 보존
- **우아한 오류 처리**: 타임아웃, DNS 실패, 연결 거부를 강건하게 처리

### 🤖 AI 기반 강화 가이드

필요에 따라 AI 제공업체를 선택하세요:

| 제공업체            | 적합한 용도          | 속도            | 비용            | 개인정보 보호       |
| ------------------- | -------------------- | --------------- | --------------- | ------------------- |
| **OpenAI GPT-4**    | 프로덕션 품질        | ⚡ 빠름 (35초)  | 💰 $0.25/스캔  | 🔒 표준             |
| **Anthropic Claude**| 개인정보 중점        | ⚡ 빠름 (45초)  | 💰 $0.30/스캔  | 🔒 강화             |
| **Ollama (Local)**  | 완전한 개인정보 보호  | 🐢 느림 (28분)  | 💰 무료         | 🔐 100% 오프라인    |

**두 가지 분석 모드:**

- **기술적**: Apache/Nginx 구성 스니펫, CLI 명령어, 단계별 강화
- **경영진**: 이해관계자와 경영진을 위한 평이한 언어의 위험 평가

### 📊 프로페셔널 리포트

**JSON 보고서** (기계 판독 가능)```json
{
  "tool": "hephaestus",
  "version": "0.2.0",
  "target": "https://example.com",
  "mode": "safe",
  "summary": {
    "critical": 3,
    "high": 2,
    "medium": 5,
    "low": 3,
    "info": 0
  },
  "findings": [...],
  "diff": {...}
}

HTML 보고서 (사람 친화적)

🎨 주황색/빨간색 그라데이션의 Forge 테마 (⚒️ 대장장이 미학)
🏷️ 색상으로 구분된 심각도 배지
📝 펼칠 수 있는 증거 섹션
🤖 AI 강화 가이드가 아름답게 포맷됨
📱 모바일 반응형 디자인

🔐 동의 토큰 시스템

적극적인 스캔 및 AI 분석은 소유권 증명이 필요합니다:```bash

1. Generate token

python -m heph --gen-consent example.com

2. Place token on your server

echo "verify-abc123..." > .well-known/verify-abc123.txt

3. Verify ownership

python -m heph --verify-consent http --domain example.com --token verify-abc123

4. Now you can use aggressive mode

python -m heph --target https://example.com --aggressive --use-ai

### 💾 데이터베이스 지속성

Argos 제품군과 **공유되는** SQLite 데이터베이스 (`~/.argos/argos.db`):

- **스캔 기록**: 날짜, 소요 시간, 발견 항목 수, 심각도 분류
- **발견 항목 저장소**: 검색 가능한 취약점 데이터베이스 (1159개 이상의 발견 항목 저장)
- **검증된 도메인**: 만료가 있는 동의 토큰 추적
- **도구 간 통합**: Argus, Pythia 및 향후 도구와 완벽하게 연동```bash
# Query recent scans
sqlite3 ~/.argos/argos.db "SELECT * FROM scans WHERE tool='hephaestus' ORDER BY scan_id DESC LIMIT 10"

# Find critical issues
sqlite3 ~/.argos/argos.db "SELECT * FROM findings WHERE severity='critical' AND tool='hephaestus'"

✅ 검증 및 테스트

Hephaestus v0.2.0은 Docker 기반의 통제된 취약 실습 환경(Apache 및 Nginx)을 사용하여 경험적으로 검증되었습니다.

검증 요약 (2026년 5월)

테스트 범위 (13단계):

✅ 1단계: 기본 CLI (종료 코드, 오류 처리)
✅ 2단계: 동의 토큰 (HTTP 확인, 공격 모드)
✅ 3단계: AI 통합 (OpenAI, Anthropic, Ollama)
✅ 4단계: 보고서 생성 (JSON, HTML, AI 분석)
✅ 5단계: 고급 옵션 (속도 제한, 스레드, 시간 초과)
✅ 6단계: 검사 모듈 (70개 이상의 발견 코드 검증)
✅ 7단계: 로깅 (텍스트, JSON, 상세 수준)
✅ 8단계: 데이터베이스 (스키마, 무결성, 외래 키)
✅ 9단계: 오류 처리 (경계 사례, 권한)
✅ 10단계: 통합 (Argos 스위트 호환성)
✅ 11단계: CORS, Robots.txt, WAF 탐지
✅ 12단계: API 발견, 쿠키 보안, phpinfo 분석
✅ 13단계: 설정 파일 파서, 차이점 보고서, AI 비용 추적

주요 발견 사항:

✅ 모든 중요 취약점 탐지 (.env, .git, server-status, phpinfo)
✅ 모든 서버 버전 식별 (Apache 2.4.54, Nginx 1.18.0)
✅ 모든 보안 헤더 정확하게 분석 (6개 헤더 확인)
✅ 모든 디렉터리 목록 노출 문제 식별
✅ CORS, WAF, API, 쿠키, phpinfo 모듈 완전 작동
✅ 차이점 보고서 (--diff last) 스캔 기록 전반에 걸쳐 작동
✅ 복원력 있는 오류 처리 (시간 초과, DNS 실패, 연결 거부)

평가: Hephaestus는 서버 보안 평가를 위한 프로덕션 준비가 완료되었습니다.

🚀 빠른 시작

사전 요구 사항

Python 3.11+ (3.12 권장)
pip (Python 패키지 관리자)
Docker (선택 사항, 취약 실습 환경용)

설치

1. 저장소 클론```bash git clone https://github.com/rodhnin/hephaestus-server-forger.git cd hephaestus-server-forger

**2. (선택 사항) 아직 사용할 수 없는 경우 `venv`를 설치하십시오**```bash
# Debian/Ubuntu
sudo apt update && sudo apt install -y python3-venv

# Fedora/RHEL
sudo dnf install python3-virtualenv

# macOS (via Homebrew)
brew install [email protected]

3. 가상 환경 생성 및 활성화```bash python3 -m venv .venv source .venv/bin/activate

You should see (.venv) in your terminal prompt

**4. pip 업그레이드**```bash
python -m pip install --upgrade pip

5. 의존성 설치```bash python -m pip install -r requirements.txt

**6. API 키 구성 (클라우드 AI 사용 시)**```bash
# OpenAI
export OPENAI_API_KEY="sk-..."

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

7. 설치 확인```bash python -m heph --version

Output: heph 0.2.0

### 첫 번째 스캔```bash
# Basic scan (safe mode, no consent required)
python -m heph --target https://example.com

# With HTML report
python -m heph --target https://example.com --html

# With AI hardening guide (requires consent)
python -m heph --target https://example.com --use-ai --html

🐳 Docker로 빠른 시작

cd docker && ./deploy.sh

Select option 3 for testing (Both)

docker compose exec hephaestus python -m heph --target http://vulnerable-apache

🎉 성공! ~/.hephaestus/reports/에서 보고서를 확인하세요.

📘 사용 가이드

기본 스캔```bash

Safe mode (default) - Non-intrusive checks

python -m heph --target https://example.com

Generate HTML report

python -m heph --target https://example.com --html

Increase verbosity for debugging

python -m heph --target https://example.com -vv

Quiet mode (errors only)

python -m heph --target https://example.com -q

### 고급 스캐닝```bash
# Control scan speed (1-20 req/s)
python -m heph --target https://example.com --rate 10

# Control concurrency (1-20 threads)
python -m heph --target https://example.com --threads 8

# Custom timeout (useful for slow servers)
python -m heph --target https://example.com --timeout 60

# Custom output directory
python -m heph --target https://example.com --report-dir ./my-reports

# Custom User-Agent
python -m heph --target https://example.com --user-agent "MyBot/1.0"

# Disable SSL verification (testing only)
python -m heph --target https://self-signed.badssl.com --no-verify-ssl

AI 기반 강화 가이드

단계 1: 공급자 구성

Edit config/defaults.yaml:```yaml ai: langchain: provider: "openai" # Options: openai, anthropic, ollama model: "gpt-4o-mini-2024-07-18" temperature: 0.3

**2단계: 설정을 테스트하세요**```bash
# Verify AI provider works
python -m heph.core.ai openai

3단계: AI 기반 스캔 실행```bash

Technical hardening guide (for sysadmins)

python -m heph --target https://example.com
--use-ai
--ai-tone technical
--html

Executive risk summary (for management)

python -m heph --target https://example.com
--use-ai
--ai-tone non_technical
--html

Both analyses in one report

python -m heph --target https://example.com
--use-ai
--ai-tone both
--html

Stream AI output token-by-token

python -m heph --target https://example.com
--use-ai
--ai-stream
--html

Compare two AI providers in parallel

python -m heph --target https://example.com
--use-ai
--ai-compare openai,anthropic
--html

Agent mode with live NVD CVE lookup

python -m heph --target https://example.com
--use-ai
--ai-agent
--html

Set a cost budget cap (USD)

python -m heph --target https://example.com
--use-ai
--ai-budget 0.50
--html

### 공격 모드 (동의 필요)```bash
# Step 1: Generate consent token
python -m heph --gen-consent example.com
# Output: Token: verify-a3f9b2c1d8e4...

# Step 2: Place token on your server
# Create: https://example.com/.well-known/verify-a3f9b2c1d8e4.txt
# Content: verify-a3f9b2c1d8e4

# Step 3: Verify consent
python -m heph --verify-consent http \
  --domain example.com \
  --token verify-a3f9b2c1d8e4

# Step 4: Run aggressive scan (deeper checks, higher rate limit)
python -m heph --target https://example.com --aggressive

🤖 AI 기반 분석

헤파이스토스는 LangChain 1.0.0을 사용하며 여러 AI 제공자를 지원합니다.

지원되는 제공자

OpenAI GPT-4 Turbo

최적: 프로덕션 사용

⭐ 품질: 우수 (5/5)
⚡ 속도: ~35초
💰 비용: 스캔당 ~$0.25
🔒 개인정보 보호: 표준 (전송 중 데이터 암호화)```bash export OPENAI_API_KEY="sk-..." python -m pip install langchain-openai==1.0.0

#### Anthropic Claude

**최적 대상: 향상된 개인정보 보호**

- ⭐ 품질: 우수 (5/5)
- ⚡ 속도: ~45초
- 💰 비용: 스캔당 ~$0.30
- 🔒 개인정보 보호: 강화됨 (Anthropic의 개인정보 우선 접근 방식)```bash
export ANTHROPIC_API_KEY="sk-ant-..."
python -m pip install langchain-anthropic==1.0.0

Ollama (로컬 모델)

최적 용도: 완전한 프라이버시

⭐ 품질: 좋음 (3/5)
🐢 속도: ~28분 (CPU) 또는 ~75초 (GPU)
💰 비용: 무료
🔐 프라이버시: 100% 오프라인 (데이터가 기기를 벗어나지 않음)```bash

Install Ollama: https://ollama.ai

ollama pull llama3.2 python -m pip install "langchain-ollama>=0.3.0,<0.4.0"

### 개인정보 보호 및 보안

**자동 정화**

AI 제공자에게 전송하기 전에 Hephaestus가 자동으로 제거합니다:

- ✅ 동의 토큰
- ✅ API 키 및 자격 증명
- ✅ 개인 키 및 인증서
- ✅ 내부 IP 주소
- ✅ 데이터베이스 자격 증명

**옵트인 전용**

- AI 분석에는 명시적인 `--use-ai` 플래그가 필요합니다
- 공격적 스캔에는 확인된 동의 토큰이 필요합니다
- 귀하가 어떤 제공자가 귀하의 데이터를 보는지 제어합니다

**최대 개인정보 보호를 위해**: Ollama를 로컬에서 사용하세요.

---

## 🧪 안전한 테스트 랩

**⚠️ 서면 허가 없이 프로덕션 사이트를 스캔하지 마십시오!**

안전하게 연습하려면 Docker 랩을 사용하세요:

### 테스트 환경 설정

### 옵션 1: 대화형 스크립트 (권장)```bash
# Run the interactive deployment script
cd docker && ./deploy.sh

스크립트는 5가지 옵션을 제공합니다:

프로덕션 → Hephaestus 스캐너 서비스 배포
테스트 랩 → 취약한 웹 서버 배포 (Apache + Nginx)
모두 → 두 환경 모두 배포
모두 중지 → 실행 중인 모든 서비스 중지
모두 제거 → 컨테이너, 볼륨, 데이터 제거 (확인 필요)

옵션 2: 수동 Docker Compose

테스트 랩 전용:```bash

Start vulnerable servers (Apache + Nginx)

docker compose -f docker/compose.testing.yml up -d

Wait for initialization (~15 seconds)

sleep 15

Verify services

docker compose -f docker/compose.testing.yml ps curl -I http://localhost:8080 # Apache curl -I http://localhost:8081 # Nginx

**프로덕션 스캐너:**```bash
# Start Hephaestus scanner service
docker compose -f docker/compose.yml up -d

# Run a scan
docker compose -f docker/compose.yml exec hephaestus heph --target https://example.com

# View reports
ls -lh docker/reports/

두 환경 모두:```bash

Start both production and testing

docker compose -f docker/compose.yml up -d docker compose -f docker/compose.testing.yml up -d

Scan the testing labs from host

python -m heph --target http://localhost:8080 --html python -m heph --target http://localhost:8081 --html

### 랩 스캔```bash
# Scan Apache lab (from host)
python -m heph --target http://localhost:8080 --html

# Scan Nginx lab (from host)
python -m heph --target http://localhost:8081 --html

# AI-powered analysis (requires OPENAI_API_KEY)
python -m heph --target http://localhost:8080 --use-ai --html

# OR from inside production container (using container name)
docker compose -f docker/compose.yml exec hephaestus python -m heph --target http://hephaestus-vulnerable-apache --html

예상 결과

Apache Lab (localhost:8080):

42개 발견 (13개 스캔 단계 전체)
CORS, WAF, API, Cookie, phpinfo, OWASP 매핑 발견 포함

Nginx Lab (localhost:8081):

25개 발견 (13개 스캔 단계 전체)
CORS, WAF, API, Cookie, OWASP 매핑 발견 포함

정리

서비스 중지:```bash

Using script

cd docker && ./deploy.sh # Choose option 4 (Stop All)

OR manually

docker compose -f docker/compose.yml down docker compose -f docker/compose.testing.yml down

**모든 것을 제거 (경고: 데이터와 보고서를 삭제합니다):**```bash
# Using script (with confirmation)
cd docker && ./deploy.sh  # Choose option 5 (Remove All)

# OR manually
docker compose -f docker/compose.yml down -v
docker compose -f docker/compose.testing.yml down -v
rm -rf docker/data docker/reports

🐳 Docker 배포

Hephaestus는 두 가지 Docker 배포 옵션을 제공합니다:

옵션 1: Docker Compose (권장)

프로덕션 스캐너 서비스:```bash

Start long-running scanner service

docker compose -f docker/compose.yml up -d

Run scans

docker compose -f docker/compose.yml exec hephaestus heph --target https://example.com --html

View reports

ls -lh docker/reports/

Stop service

docker compose -f docker/compose.yml down

**테스트 랩 (취약한 서버):**```bash
# Start Apache + Nginx vulnerable servers
docker compose -f docker/compose.testing.yml up -d

# Scan from host
python -m heph --target http://localhost:8080 --html

# Stop lab
docker compose -f docker/compose.testing.yml down

대화형 배포 스크립트:```bash

cd docker && ./deploy.sh

### 옵션 2: 직접 Docker 실행

**이미지 빌드:**```bash
docker build -f docker/Dockerfile -t hephaestus:0.2.0 .

일회성 스캔 실행:```bash docker run --rm
-v $(pwd)/docker/reports:/reports
-v $(pwd)/docker/data:/data
hephaestus:0.2.0
--target https://example.com
--html

**AI 분석 포함:**```bash
docker run --rm \
  -v $(pwd)/docker/reports:/reports \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  hephaestus:0.2.0 \
  --target https://example.com \
  --use-ai \
  --ai-tone both \
  --html

로컬 테스트 랩 스캔:```bash

Start testing lab first

docker compose -f docker/compose.testing.yml up -d

Scan from container (join the testing lab network)

docker run --rm
--network hephaestus-lab
hephaestus:0.2.0
--target http://hephaestus-vulnerable-apache

---

## 📊 보고서 이해하기

### 보고서 구조```
~/.hephaestus/
├── reports/
│   ├── hephaestus_report_example_20251021_143022.json
│   └── hephaestus_report_example_20251021_143022.html
└── (shared with Argos)
    ~/.argos/
    ├── argos.db          # Shared database
    └── logs/
        └── hephaestus.log

발견 ID (패턴, 총 70개 이상)```

HEPH-SRV-001: Server version disclosed (Apache/Nginx/IIS) HEPH-SRV-004: Server disclosed in error page HEPH-SRV-016: PHP version disclosed in Server header HEPH-SRV-017: OpenSSL version disclosed in Server header HEPH-FILE-001: Environment file exposed (.env) HEPH-FILE-002: Git repository exposed HEPH-FILE-003: PHP information page exposed HEPH-FILE-004: Apache server-status exposed HEPH-HTTP-003: Unsafe HTTP method in OPTIONS (TRACE) HEPH-HTTP-008: TRACE method enabled (XST vulnerability) HEPH-HDR-001: Missing security header: HSTS HEPH-HDR-002: Missing security header: CSP HEPH-HDR-003: Missing security header: X-Frame-Options HEPH-HDR-004: Missing security header: X-Content-Type-Options HEPH-HDR-005: Missing security header: Referrer-Policy HEPH-HDR-006: Missing security header: Permissions-Policy HEPH-CFG-001: Directory listing enabled HEPH-TLS-000: TLS not enabled HEPH-TLS-001: Weak TLS protocol (SSLv3, TLS 1.0) HEPH-TLS-002: Weak cipher suite enabled COR-001 to COR-006: CORS misconfiguration findings ROB-001/002/003: Robots.txt intelligence findings WAF-001/002: WAF detection findings API-001 to API-005: API discovery findings COO-001 to COO-005: Cookie security findings PHP-001 to PHP-009: phpinfo() dangerous settings

### 심각도 매핑

- **CRITICAL**: .env exposed, .git accessible, phpinfo, server-status, SQL dumps
- **HIGH**: 서버 버전 공개, 약한 TLS, TLS 누락, 안전하지 않은 HTTP 메서드
- **MEDIUM**: 중요한 헤더 누락 (HSTS, CSP, X-Frame-Options), 디렉터리 목록, 오류 페이지 노출
- **LOW**: 사소한 헤더 (X-Content-Type-Options, Referrer-Policy, Permissions-Policy)
- **INFO**: 정보성 발견 (서버 감지됨, TLS 1.2 OK)

---

## 📁 프로젝트 구조```
hephaestus-server-forger/
│
├── heph/                       # Main application package
│   ├── checks/                 # Security check modules (13 phases)
│   │   ├── __init__.py
│   │   ├── api_discovery.py    # Phase 11: Swagger/OpenAPI/GraphQL exposure
│   │   ├── config.py           # Phase 5: Directory listing detection
│   │   ├── config_file.py      # Phase 14: Offline httpd.conf/nginx.conf parser
│   │   ├── cookies.py          # Phase 12: HttpOnly/Secure/SameSite analysis
│   │   ├── cors.py             # Phase 8: CORS wildcard & reflection probes
│   │   ├── files.py            # Phase 2: 70+ sensitive file paths
│   │   ├── headers.py          # Phase 4: Security headers analysis
│   │   ├── http_methods.py     # Phase 3: Unsafe HTTP methods (PUT/DELETE/TRACE)
│   │   ├── phpinfo.py          # Phase 13: phpinfo() dangerous settings
│   │   ├── ports.py            # Phase 7: 37-port scanner with banner grabbing
│   │   ├── robots.py           # Phase 9: robots.txt disallowed path analysis
│   │   ├── server_info.py      # Phase 1: Apache/Nginx/IIS fingerprinting
│   │   ├── tls.py              # Phase 6: Deep TLS/SSL + CVE correlation
│   │   └── waf.py              # Phase 10: 13 WAF signatures detection
│   │
│   ├── core/                   # Core infrastructure
│   │   ├── __init__.py
│   │   ├── ai.py               # LangChain AI (GPT-4/Claude/Ollama) + cost tracking
│   │   ├── config.py           # Configuration loader
│   │   ├── consent.py          # Consent token system (HTTP + DNS)
│   │   ├── cve_lookup.py       # NVD CVE API integration
│   │   ├── db.py               # SQLite — shared with Argos suite (~/.argos/argos.db)
│   │   ├── diff.py             # Scan diff engine (--diff last / --diff <id>)
│   │   ├── http_client.py      # Token-bucket rate-limited HTTP client
│   │   ├── logging.py          # Structured logging
│   │   ├── owasp.py            # HEPH-* code → OWASP Top 10 2021 mapper
│   │   └── report.py           # JSON + HTML report generation
│   │
│   ├── __init__.py             # Package metadata
│   ├── __main__.py             # Entry point
│   ├── cli.py                  # CLI (30+ flags incl. --use-ai, --diff, --config-file)
│   └── scanner.py              # Orchestrator — 13 parallel phases
│
├── assets/
│   └── ascii.txt               # Hephaestus braille ASCII art
│
├── config/                     # Configuration files
│   ├── defaults.yaml           # Default settings
│   └── prompts/                # AI prompt templates
│       ├── technical.txt       # Technical hardening prompt
│       └── non_technical.txt   # Executive summary prompt
│
├── db/
│   └── migrate.sql             # Shared database schema (Argos suite)
│
├── docker/                     # Docker deployment
│   ├── vulnerable-apache/      # Vulnerable Apache lab (port 8080/8443)
│   │   └── docker-entrypoint.sh
│   ├── vulnerable-nginx/       # Vulnerable Nginx lab (port 8081/8444)
│   │   └── docker-entrypoint.sh
│   ├── compose.yml             # Production stack
│   ├── compose.testing.yml     # Vulnerable lab stack
│   ├── deploy.sh               # Interactive deployment script
│   └── Dockerfile              # Production image
│
├── docs/                       # Documentation
│   ├── media/                  # README visual assets
│   │   ├── hephaestus-banner.webp  # Banner 1280×400
│   │   ├── hephaestus-hero.webp    # Hero 1600×640
│   │   ├── console.webp            # Terminal scan output
│   │   ├── report_html.webp        # HTML report header
│   │   └── report_findings.webp    # Findings table with CVE badges
│   ├── AI_INTEGRATION.md       # AI providers setup guide
│   ├── CONSENT.md              # Consent system details
│   ├── DATABASE_GUIDE.md       # Shared database reference
│   ├── ETHICS.md               # Ethical use guidelines
│   ├── REPORT_FORMAT.md        # JSON/HTML report specification
│   ├── ROADMAP.md              # v0.3.0 tickets and priorities
│   └── TESTING_GUIDE.md        # Safe testing practices
│
├── schema/
│   └── report.schema.json      # JSON report schema (OWASP + CVE fields)
│
├── scripts/
│   └── cli-examples.md         # CLI usage examples
│
├── templates/
│   └── report.html.j2          # HTML report template — forge theme
│
├── CHANGELOG.md                # Version history
├── CODE_OF_CONDUCT.md          # Community guidelines
├── CONTRIBUTING.md             # Contribution guide
├── LICENSE                     # MIT License
├── README.md                   # This file
├── requirements.txt            # Python dependencies
└── setup.py                    # Package installer

🗺️ 로드맵

v0.1.0 — 초기 릴리스 ✅ (2026년 1월)

상태: 🎉 출시됨 (v0.2.0으로 대체됨)

✅ 6개의 보안 검사 모듈 (서버, 파일, 메서드, 헤더, TLS, 구성)
✅ AI 기반 강화 가이드 (OpenAI, Anthropic, Ollama)
✅ 동의 토큰 시스템 (HTTP + DNS 검증)
✅ 전문 보고서 (AI 분석 포함 JSON + HTML)
✅ SQLite 영속성 (Argos 제품군과 공유: ~/.argos/argos.db)
✅ 취약한 실습 환경을 포함한 Docker 지원 (Apache 및 Nginx)
✅ 포괄적인 오류 처리 및 탄력성
✅ 55개 이상의 검증 테스트 (10단계, 100% 통과)

v0.2.0 — 향상된 탐지 ✅ (2026년 5월)

상태: 🎉 출시됨

✅ 13개 스캔 단계 (v0.1.0 대비 7개 신규 단계 추가)
✅ 심층 TLS 분석: SSLyze 통합, 암호화 스위트, CVE 상관 분석, A+/F 등급
✅ 프레임워크 및 모듈 탐지: Laravel, Django, Rails, mod_security, WAF 탐지
✅ Apache/Nginx 구성 파서 (--config-file): httpd.conf/nginx.conf 오프라인 분석
✅ CORS 탐지: 와일드카드, null-오리진, 반사 프로브 (COR-001 ~ COR-006)
✅ Robots.txt 인텔리전스: 금지된 경로 분석, 실시간 접근성 프로브 (ROB-001/002/003)
✅ WAF 탐지: Cloudflare, Sucuri, ModSecurity, AWS WAF 등 13개 시그니처 (WAF-001/002)
✅ API 발견: Swagger/OpenAPI, GraphQL 인트로스펙션, 인증되지 않은 엔드포인트 (API-001 ~ API-005)
✅ 쿠키 보안: 쿠키별 HttpOnly/Secure/SameSite 분석 (COO-001 ~ COO-005)
✅ phpinfo() 심층 분석: 9가지 위험한 PHP 설정 (PHP-001 ~ PHP-009)
✅ OWASP Top 10 2021 매핑 (모든 결과에 적용)
✅ 실시간 CVE 조회 (NVD API v2 사용, Apache, Nginx, PHP, OpenSSL)
✅ 포트 스캐너: 배너 그래빙 포함 37개 포트
✅ AI 비용 추적 (--ai-budget): 예산 제한, costs.json, ai_costs 테이블
✅ AI 스트리밍 (--ai-stream): 실시간 토큰 단위 출력
✅ AI 비교 (--ai-compare): 두 제공자를 병렬로 실행
✅ AI 에이전트 (--ai-agent): NVD CVE 조회 기능이 있는 LangChain 에이전트
✅ 차이 보고서 (--diff last / --diff SCAN_ID): 신규/수정/지속 발견 항목

v0.3.0 — 엔터프라이즈 기능 (2026년 3분기)

초점: 사용성, 확장성, 대화형 AI

🔜 대화형 구성 관리: Metasploit 스타일 인터페이스 (heph --show-options, heph --set)
🔜 데이터베이스 CLI: SQL 불필요 (heph db scans list, heph db findings search)
🔜 다중 사이트 스캐닝: 파일에서 일괄 처리
🔜 AI 채팅 인터페이스: 대화형 강화 가이드
🔜 CI/CD 통합: GitHub Actions, Jenkins, GitLab 템플릿
🔜 REST API 서버: 자동화를 위한 FastAPI 기반 API
🔜 Nmap 통합: 종합 평가를 위한 포트 스캐닝

v0.4.0 — 지능 및 자동화 (2026년 4분기)

초점: 머신러닝, 자동화, 고급 AI

🔜 자동 수정: 자동 수정을 위한 Ansible/Puppet 플레이북
🔜 ML 기반 탐지: 이상 탐지, 오탐 감소
🔜 분산 스캐닝: 대규모 작업을 위한 워커 노드
🔜 고급 AI 에이전트: 자율 스캔 계획, 익스플로잇 생성

프로 트랙 (2027년 1분기)

기업용 상용 제품

진행 중

자세한 기능 설명은 ROADMAP.md를 참조하세요.

🔒 윤리 및 법률

황금률

소유하거나 명시적인 서면 허가를 받은 시스템만 스캔하세요.

동의 강제

Hephaestus는 오용을 방지하기 위해 기술적 통제를 구현합니다:

법적 프레임워크

컴퓨터 시스템에 대한 무단 접근은 대부분의 국가에서 불법입니다:

🇺🇸 미국: 컴퓨터 사기 및 남용 법 (CFAA)
🇬🇧 영국: 1990년 컴퓨터 오용법
🇪🇺 EU: 지침 2013/40/EU
🌍 국제: 다양한 사이버 범죄 법률

모범 사례

✅ 스캔 전 서면 승인 받기
✅ 범위 명확히 정의 (대상 도메인/IP)
✅ 모든 것 문서화 (동의, 발견 사항, 수정)
✅ 먼저 안전 모드 사용하여 기준 설정
✅ 결과를 책임감 있게 보고 (조정된 공개)
❌ 명시적 허가 없이 취약점을 악용하지 마세요
❌ 타사 사이트 스캔 금지 (예: apache.org, nginx.com)

전체 윤리 지침은 docs/ETHICS.md를 참조하세요.

🤝 기여

기여를 환영합니다! 다음과 같은 경우:

🐛 버그 신고
💡 기능 요청
📝 문서 개선
🔧 코드 기여

기여 방법

저장소를 포크하세요
기능 브랜치를 생성하세요 (git checkout -b feature/amazing-feature)
변경 사항을 적용하세요
테스트를 작성/업데이트하세요 (해당하는 경우)
변경 사항을 커밋하세요 (git commit -m 'Add amazing feature')
브랜치에 푸시하세요 (git push origin feature/amazing-feature)
풀 리퀘스트를 여세요

개발 환경 설정```bash

Clone your fork

git clone https://github.com/YOUR-USERNAME/hephaestus-server-forger.git cd hephaestus-server-forger

Install development dependencies

python -m pip install -r requirements.txt python -m pip install pytest black flake8 mypy

Run code formatting

black heph/

Run linting

flake8 heph/ mypy heph/

Run tests (when available)

pytest tests/

### 문제 보고

버그를 발견했나요? 기능 요청이 있나요?

**이슈 열기**: https://github.com/rodhnin/hephaestus-server-forger/issues

다음을 포함해 주세요:

- Hephaestus 버전 (`python -m heph --version`)
- Python 버전 (`python --version`)
- 운영 체제
- 재현 단계 (버그의 경우)
- 예상 동작과 실제 동작

---

## 📚 문서

`docs/` 디렉토리에서 포괄적인 문서를 확인할 수 있습니다:

| 문서                                         | 설명                                     |
| -------------------------------------------- | ---------------------------------------- |
| [AI_INTEGRATION.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/AI_INTEGRATION.md) | 완전한 AI 설정 가이드 (3개 제공업체 모두) |
| [CONSENT.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/CONSENT.md)               | 동의 토큰 시스템 기술 세부 사항          |
| [DATABASE_GUIDE.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/DATABASE_GUIDE.md) | SQLite 스키마, 쿼리, 관리                |
| [ETHICS.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/ETHICS.md)                 | 법적 프레임워크 및 윤리 지침             |
| [REPORT_FORMAT.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/REPORT_FORMAT.md)   | JSON 스키마 및 HTML 사양                 |
| [TESTING_GUIDE.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/TESTING_GUIDE.md)   | Docker 랩을 사용한 안전한 테스트         |
| [ROADMAP.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/docs/ROADMAP.md)               | 향후 기능 및 개발 계획                   |

### 빠른 링크

- **변경 로그**: [CHANGELOG.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/CHANGELOG.md)
- **라이선스**: [LICENSE](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/LICENSE)
- **CLI 예제**: [scripts/cli-examples.md](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/scripts/cli-examples.md)

---

## ⚖️ 라이선스

이 프로젝트는 **MIT 라이선스**에 따라 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE](https://github.com/rodhnin/hephaestus-server-forger/blob/HEAD/LICENSE) 파일을 참조하세요.```
MIT License

Copyright (c) 2026 Rodney Dhavid Jimenez Chacin

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

⚠️ 면책 조항

중요: 이 도구는 승인된 보안 테스트 전용입니다.

법적 고지

Hephaestus를 사용함으로써 귀하는 다음 사항을 인정하고 동의합니다:

✅ 귀하는 소유한 시스템 또는 명시적 서면 허가를 받은 시스템만 스캔할 것입니다.
✅ 귀하는 모든 해당 법률 및 규정을 준수할 것입니다.
✅ 귀하는 무단 접근이 불법임을 이해합니다 (CFAA, 컴퓨터 남용 방지법 등).
✅ 작성자와 기여자는 오용에 대해 어떠한 책임도 지지 않습니다.
✅ 이 소프트웨어는 어떠한 종류의 보증도 없이 "있는 그대로" 제공됩니다.

책임 있는 공개

Hephaestus를 사용하여 취약점을 발견한 경우:

📧 먼저 사이트 소유자에게 개인적으로 연락하십시오.
⏰ 합리적인 수정 시간을 주십시오 (보통 90일).
🤝 공개 일정을 조정하십시오.
📝 귀하의 발견 사항을 전문적으로 문서화하십시오.

의심스러울 때

스캔하지 마십시오. 허가 여부가 확실하지 않다면, 아마 허가가 없는 것입니다.

🙏 감사의 말

Hephaestus는 거인의 어깨 위에 서 있습니다:

Apache & Nginx — 문서화 및 강화 가이드
OWASP — 보안 표준 (Top 10, 테스트 가이드, 보안 헤더 프로젝트)
CIS Benchmarks — 서버 강화 모범 사례
LangChain — 지능형 분석을 위한 AI 프레임워크
Anthropic & OpenAI — 취약점 분석을 위한 AI 모델
Ollama — 개인정보 중심 스캔을 위한 로컬 AI 추론
Python Community — 훌륭한 라이브러리와 도구들

윤리적 해킹을 실천하고 장려하는 모든 보안 연구자들에게 특별한 감사를 드립니다.

👤 저자

Rodney Dhavid Jimenez Chacin (rodhnin)

🌐 웹사이트 및 연락처: rodhnin.com
💼 GitHub: @rodhnin
🔗 프로젝트: hephaestus-server-forger

질문, 피드백 또는 협업 문의는 rodhnin.com을 방문하여 연락해 주십시오.

💬 커뮤니티

토론: GitHub Discussions
이슈: GitHub Issues
릴리스: GitHub Releases

전 세계의 윤리적 해커와 시스템 관리자를 위해 ❤️로 제작되었습니다

⭐ 유용하다면 이 저장소에 별표를 눌러주세요! ⭐

Report Bug • Request Feature • Documentation

Hephaestus v0.2.0 — 2026년 5월

서버 정보	헤더 및 오류 페이지를 통한 Apache/Nginx/IIS 버전 노출
민감한 파일	.env, .git, phpinfo.php, server-status, 백업, 설정 파일(70개 이상 경로)
HTTP 메서드	안전하지 않은 메서드(PUT, DELETE, TRACE, OPTIONS)
보안 헤더	HSTS, CSP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy
TLS/SSL 설정	심층 분석: 암호 제품군, 프로토콜 버전, 인증서 유효성, CVE 연관
디렉터리 목록 노출	Apache/Nginx autoindex가 민감한 디렉터리에서 활성화된 경우
CORS 탐지	와일드카드, null-origin, 반사 프로브(COR-001 ~ COR-006)
Robots.txt	허용되지 않은 경로 분석, 공격 모드에서의 실시간 접근성 프로브
WAF 탐지	Cloudflare, Sucuri, ModSecurity, AWS WAF, Imperva 등 13개 시그니처
API 탐색	Swagger/OpenAPI 사양 노출, GraphQL 인트로스펙션, 인증되지 않은 엔드포인트
쿠키 보안	인증된 경로에서 쿠키별 HttpOnly/Secure/SameSite 분석
phpinfo() 분석	display_errors, allow_url_include, open_basedir 등 9가지 위험한 PHP 설정
설정 파일 파서	오프라인에서 httpd.conf / nginx.conf 분석을 통한 오설정 식별
포트 스캐너	배너 수집 및 CVE 강화를 포함한 37개 일반 포트 스캔

테스트 스위트	55/55개 테스트 통과 (13단계)
Apache 탐지	13개 스캔 단계 전체에서 42개 결과
Nginx 탐지	13개 스캔 단계 전체에서 25개 결과
정밀도	100% (오탐지 없음)
재현율	100% (미탐지 없음)
F1 점수	100% (완벽한 균형)
평균 스캔 시간	30-35초
데이터베이스 작업	80건 스캔 추적, 1159건 이상 결과 저장

안전	비침습적	❌ 아니오	5 req/s
공격적	심층 탐사	✅ 예	12 req/s
AI 분석	강화 가이드	✅ 예	N/A

hephaestus-server-forger

인기