Package Exports

pentesting
pentesting/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (pentesting) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🎯 Pentesting

인간처럼 생각하고 실행하는 자율 침투 테스트 AI 에이전트

💡 철학: 왜 Pentesting인가?

문제

기존 침투 테스트는 도구 중심입니다:

nmap으로 스캔하고, 결과를 보고
sqlmap으로 테스트하고, 다른 도구로 넘어가고
각 도구의 출력을 해석하고, 다음 단계를 결정하고

이것은 반복적이고, 시간 소모적이며, 전문가 지식이 필요합니다.

해결책

Pentesting은 사고 중심입니다:

"이 웹 애플리케이션을 침투하라"
에이전트가 스스로 도구를 선택하고, 결과를 분석하고, 다음 전략을 결정합니다

Before (도구 중심):
  Human → [결정] → nmap → [분석] → [결정] → sqlmap → [분석] → ...

After (사고 중심):
  Human → "침투하라" → Pentesting Agent → [자동화된 사고-행동 루프] → 보고서

핵심 신념

AI는 도구가 아니라 동료입니다
- 명령을 실행하는 것이 아니라 목표를 달성합니다
- 실패하면 스스로 다른 방법을 찾습니다
신뢰할 수 있는 결과만 보고합니다
- 80% 이상 신뢰도의 발견만 보고
- 거짓 양성을 적극적으로 필터링
인간 전문가의 사고 과정을 모방합니다
- "Think → Act → Observe → Reflect" 루프
- 막다른 길에서 시간여행으로 복구 (D-Mail)

🧠 ReAct: 생각하고 행동하기

Pentesting은 ReAct 패턴을 핵심으로 합니다:

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   🤔 THINK                                                      │
│   "타겟이 Apache 2.4.49를 실행 중이다.                         │
│    Path Traversal 취약점(CVE-2021-41773)이 있을 수 있다."       │
│                                                                 │
│   ⚡ ACT                                                        │
│   [nmap_scan] target=192.168.1.1 ports=80,443                  │
│                                                                 │
│   👁️ OBSERVE                                                   │
│   "포트 80에서 Apache/2.4.49 확인.                              │
│    mod_cgi 활성화됨."                                           │
│                                                                 │
│   💭 REFLECT                                                    │
│   "CVE-2021-41773 가능성 높음. 익스플로잇 시도해야 함.          │
│    신뢰도: 85%. 다음: exploit-researcher에게 위임."             │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

🚀 빠른 시작

설치

npm install -g pentesting
# 또는
npx pentesting

API 키 설정

export ANTHROPIC_API_KEY=sk-ant-xxx

실행

pentesting

첫 번째 공격

🎯 Pentesting > scan 192.168.1.1

에이전트가 자동으로:

포트 스캔 수행
서비스 버전 확인
취약점 검색
익스플로잇 시도
결과 보고

🏗️ 아키텍처

┌─────────────────────────────────────────────────────────────────────┐
│                         PENTESTING SOUL                             │
│                                                                     │
│  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐           │
│  │   ReAct Loop  │  │   D-Mail      │  │   Planner     │           │
│  │               │  │   System      │  │               │           │
│  │  Think/Act/   │  │  Time Travel  │  │  Attack Plan  │           │
│  │  Observe/     │  │  Checkpoint   │  │  Generation   │           │
│  │  Reflect      │  │  Rollback     │  │               │           │
│  └───────┬───────┘  └───────┬───────┘  └───────┬───────┘           │
│          │                  │                  │                    │
│          └──────────────────┼──────────────────┘                    │
│                             │                                       │
│  ┌──────────────────────────▼──────────────────────────────────┐   │
│  │                        RUNTIME                               │   │
│  │  Context │ Toolset │ Memory │ Approval                      │   │
│  └──────────────────────────────────────────────────────────────┘   │
└──────────────────────────────┬──────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────────┐
│                        LABOR MARKET                                 │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐              │
│  │   Recon      │  │   Exploit    │  │   Web        │              │
│  │   Agent      │  │   Agent      │  │   Agent      │              │
│  └──────────────┘  └──────────────┘  └──────────────┘              │
└─────────────────────────────────────────────────────────────────────┘

핵심 컴포넌트

컴포넌트	역할
PentestingSoul	메인 에이전트 루프, 모든 것을 조율
ReActLoop	Think/Act/Observe/Reflect 패턴 구현
DMailSystem	시간여행 디버깅, 체크포인트 롤백
Planner	공격 계획 생성 및 관리
LaborMarket	전문 서브에이전트 할당
ContextManager	대화 히스토리 압축
ConfidenceFilter	80%+ 신뢰도 필터링

⏱️ D-Mail: 시간여행 디버깅

막다른 길에 도달했을 때, 에이전트는 과거로 메시지를 보내 다른 경로를 시도합니다:

현재: SQLi 시도 5회 모두 실패
      ↓
D-Mail 전송: "SQLi 실패함. XSS 시도할 것"
      ↓
체크포인트로 롤백
      ↓
새로운 전략으로 재시도

// 에이전트 내부 동작
if (isStuck) {
    dmailSystem.sendDMail(
        'SQLi approach failed. Try XSS instead.',
        lastCheckpoint,
        'Stuck after 5 SQLi attempts'
    );
    throw new BackToTheFuture('Time travel initiated', lastCheckpoint);
}

👥 멀티 에이전트 시스템

전문 에이전트

에이전트	전문 분야	도구
target-explorer	정찰, 정보 수집	nmap, whois, dig
exploit-researcher	취약점 연구	searchsploit, cve-search
web-hacker	웹 애플리케이션	sqlmap, nuclei
crypto-analyst	암호 분석	hashcat, john

에이전트 위임

Main Agent: "웹 서버에서 SQLi 가능성 발견"
     ↓
     └──→ [web-hacker] "로그인 폼에서 SQLi 테스트"
                ↓
                └──→ 결과 반환: "SQLi 확인, 데이터베이스 덤프 가능"

병렬 Swarm 실행

const swarm = new AgentSwarm(runtime);

const results = await swarm.executeParallel([
    { agentName: 'web-hacker', task: 'Test SQLi on login' },
    { agentName: 'web-hacker', task: 'Test XSS on search' },
    { agentName: 'target-explorer', task: 'Find hidden endpoints' },
]);

🔒 신뢰도 기반 필터링

80% 이상 신뢰도만 보고합니다.

신뢰도 계산:
  기본값: 50%
  + 증거 수 × 10% (최대 30%)
  + 익스플로잇 가능: +15%
  + 심각도 높음: +5-10%
  + CVE 참조: +10%
  = 최종 신뢰도

const finding = createFinding({
    title: 'SQL Injection in login',
    description: 'Time-based blind SQLi',
    severity: 'critical',
    evidence: ['sqlmap output', 'response time analysis', 'CVE-2021-xxxx'],
    exploitable: true,
});

// 신뢰도: 50 + 30 + 15 + 10 + 10 = 115% → 100%
// → 보고됨 ✅

📋 명령어

명령어	설명
`scan <target>`	타겟 스캔 및 정찰
`exploit <target>`	취약점 익스플로잇
`report`	발견 사항 보고서 생성
`status`	현재 진행 상황
`plan`	공격 계획 조회
`agents`	사용 가능한 에이전트 목록

⚙️ 설정

// pentesting.config.ts
export default {
    // LLM 설정
    model: 'claude-opus-4-0',
    maxTokens: 8096,
    
    // 에이전트 설정
    maxStepsPerTurn: 50,
    confidenceThreshold: 80,
    
    // 컨텍스트 설정
    maxContextTokens: 150000,
    compactionThreshold: 0.8,
    
    // 승인 설정
    yoloMode: false, // true면 모든 도구 자동 승인
};

🧪 테스트

npm test

 ✓ tests/soul.test.ts (24 tests) 10ms
   ✓ Context
   ✓ AgentRegistry
   ✓ ConfidenceFilter
   ✓ ReActLoop
   ✓ DMailSystem
   ✓ MessageBus
   ✓ MemoryManager
   ✓ Integration Tests

📁 프로젝트 구조

src/
├── soul/                    # 핵심 에이전트 시스템
│   ├── pentesting-soul.ts   # 메인 에이전트 루프
│   ├── react.ts             # ReAct 패턴
│   ├── dmail.ts             # 시간여행 시스템
│   ├── planner.ts           # 계획 시스템
│   ├── swarm.ts             # 병렬 에이전트
│   ├── confidence.ts        # 신뢰도 필터링
│   └── ...
├── tools/                   # 도구 정의
├── agents/                  # 에이전트 스펙
├── experience/              # 학습 시스템
└── prompts/                 # 프롬프트 템플릿

📖 문서

시스템 아키텍처 - 상세 기술 문서
OpenClaw 분석 - 개선 계획
API 레퍼런스 - API 문서
구현 진행 상황 - 개발 상태

🛣️ 로드맵

v1.0 (현재) ✅

ReAct 패턴 구현
D-Mail 시간여행
멀티 에이전트 시스템
신뢰도 필터링
컨텍스트 압축

v1.1 (다음)

영구 벡터 메모리
세션 영속성
강화된 훅 시스템

v1.2 (계획)

Docker 샌드박스
스킬 마켓플레이스
인증 프로필 관리

🤝 기여

기여를 환영합니다! CONTRIBUTING.md를 참고하세요.

📜 라이선스

MIT License - LICENSE

⚠️ 면책 조항

이 도구는 합법적인 보안 테스트 목적으로만 사용해야 합니다. 허가 없이 시스템을 테스트하는 것은 불법입니다. 사용자는 모든 행동에 대한 책임을 집니다.

_{Built with 🧠 by agnusdei1207}