mafifrizi/aresMITRE ATT&CK 모듈 오케스트레이션, DAG 공격 경로 해결, OPSEC 제어, 암호화된 자격 증명 보관소, 다중 형식 보고를 갖춘 자율 레드팀 참여 플랫폼입니다.
엔터프라이즈 레드팀, MSSP, 보안 운영 센터가 부수적 위험 없이 표적화된 공격적 참여를 실행하고, 결정론적 공격 경로를 발견하며, 방어 태세를 지속적으로 검증할 수 있도록 지원하는 오픈코어 플랫폼입니다.
플랫폼 쇼케이스 • 왜 ARES인가? • 경쟁 매트릭스 • 아키텍처 • MITRE 매트릭스 • 빠른 시작 • 제로 트러스트 보안 • 문서
전통적인 침투 테스트는 근본적으로 결함이 있습니다. 비용이 많이 들고, 일회성이며, 특정 시점에만 수행되고, 조직은 새로 도입된 잘못된 구성과 새롭게 등장하는 공격자 기법에 대해 눈이 먼 상태로 남게 됩니다. 한편, 자동화된 취약점 스캐너는 악용 가능성이나 다단계 측면 공격 경로를 입증하지 않은 채 수천 개의 가상 CVE로 SOC 팀을 압도합니다.
ARES는 이 격차를 해소합니다. 현대 엔터프라이즈 인프라를 위해 처음부터 구축된 ARES는 실제 위협 행위자를 모델링하는 자율적이고 목표 지향적인 레드팀 참여 플랫폼을 제공합니다. 커널 수준의 강력한 범위 방화벽, 적응형 OPSEC 노이즈 프로파일링, 대화형 방향성 비순환 그래프(DAG) 공격 솔버, 그리고 MITRE ATT&CK에 매핑된 60개 이상의 무기화된 기법을 결합함으로써, ARES는 보안 팀이 취약점 악용 가능성을 입증하고, Active Directory 핵심 자산에 대한 최단 침해 경로를 찾아내며, 운영 중단 없이 경영진용 결과물을 생성할 수 있게 합니다.
THE ARES ADVANTAGE
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ STRICT SCOPE ENCLAVE │ │ AUTONOMOUS DAG ENGINE │ │ ZERO-TRUST ARCHITECTURE │ │ Hard kernel CIDR egress │ │ Computes shortest paths │ │ Memory-only JWT tokens, │ │ whitelisting prevents │───│ to Domain Admins & Crown│───│ AES-256 encrypted vault,│ │ any collateral impact. │ │ Jewels deterministically│ │ strict HMAC-CSRF checks.│ └─────────────────────────┘ └─────────────────────────┘ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ INSTANT EXECUTIVE SUITE │ │ Branded PDF, HTML, JSON │ │ deliverables with zero │ │ native GTK dependencies │ └─────────────────────────┘
### 핵심 가치 기둥
1. **🛡️ 무부수 피해 범위 거버넌스**: 모든 캠페인은 격리된 암호학적 경계 내에서 실행됩니다. 네트워크 소켓 계층에서의 강력한 대상 IP 및 CIDR 검증은 어떤 패킷도 범위를 벗어난 인프라에 접촉하지 않도록 보장합니다.
2. **🧠 자율 목표 지향 계획**: 운영자는 상위 수준 목표(예: `domain_admin`, `full_compromise`, `cloud_audit`)를 설정하고, ARES 의사 결정 엔진은 그래프 휴리스틱과 선택적 LLM 에이전트(Claude / OpenAI / 로컬 Ollama)를 사용하여 다단계 실행 경로를 자율적으로 합성합니다.
3. **🕸️ 다중 벡터 공격 그래프(DAG)**: BloodHound 수집 데이터를 수집하거나 활성 도메인 세션을 실시간으로 매핑합니다. 내장 그래프 엔진은 최단 공격 경로를 계산하고, 병목 지점을 강조하며, 측면 피벗 가능성을 시뮬레이션합니다.
4. **🔐 심층 방어 보안 모델**: 제로 트러스트 환경을 위해 설계되었습니다. 데이터베이스 권위 세션, 메모리 전용 단기 JWT 액세스 토큰, HttpOnly 순환 리프레시 자격 증명, AES-256-GCM 암호화 로컬 볼트가 수집된 해시와 민감한 클라이언트 증거를 보호합니다.
5. **📑 자동화된 결과물 파이프라인**: 브랜드가 적용된 감사 준비 완료 컴플라이언스 결과물을 PDF, HTML, Markdown, JSON 형식으로 원클릭 생성합니다. 외부 GTK 의존성 없이 Windows/Linux에서 자동화된 헤드리스 브라우저 PDF 렌더링을 지원합니다.
---
## 📊 시장 비교 매트릭스
| 운영 역량 | 전통적 수동 침투 테스트 | 레거시 취약점 스캐너 | ARES 자율 플랫폼 |
| :--- | :---: | :---: | :---: |
| **테스트 빈도** | 연간 / 반기 | 매일 / 매주 예약 | **지속적 / 온디맨드** |
| **익스플로잇 가능성 검증** | 수동 및 노동 집약적 | ❌ 이론적 CVE 매칭 | **결정론적 다단계 증명** |
| **다중 홉 공격 경로** | 수동 그리기 | ❌ 없음 | **실시간 대화형 DAG** |
| **범위 엔클레이브 및 이그레스 방화벽** | 운영자 규율에만 의존 | 네트워크 방화벽만 | **하드 소켓 수준 CIDR 적용** |
| **Active Directory 측면 경로** | 느린 스크립트 실행 | ❌ 활성 경로 없음 | **네이티브 BloodHound 및 Kerberos 제품군** |
| **자격 증명 보안 및 저장** | 느슨한 플랫 파일 / 평문 | 취약점 로그 | **AES-256-GCM 암호화 볼트** |
| **OPSEC 및 텔레메트리 스로틀링** | 수동 지터 스크립트 | 높은 네트워크 노이즈 | **적응형 노이즈 프로필 및 거버너** |
| **보고서 전달 시간** | 계약 후 1–2주 | 원시 데이터 덤프 | **즉시 다중 형식 결과물** |
| **배포 설치 공간** | 외부 컨설턴트 | 부피 큰 클라우드 에이전트 | **에어갭 로컬 / 자체 호스팅** |
---
## 🖥️ 플랫폼 쇼케이스 및 제어 인터페이스
ARES 플랫폼은 다크테크 미학, 낮은 인지 부하, 감사된 운영 제어를 염두에 두고 설계된 고성능 반응형 운영자 대시보드를 갖추고 있습니다.```powershell
# Launch local development environment
.\.venv\Scripts\ares.exe dashboard dev --no-reload
승인된 공격적 운영자와 보안 요원을 위해 특별히 설계된 자율 진입 장벽.
ARES 운영자 엔클레이브 — 로그인 버튼은 호버, 클릭, Enter 키 입력 시 진홍색 플라즈마 불꽃이 분출됩니다. 동적 아키텍처 그리드 캔버스, 시스템 환경 사양, 그리고 오른쪽 패널의 ARES 사이버 드래곤 마스코트.
requestAnimationFrame을 사용한 부력, 난류, 방사형 글로우를 갖춘 물리 기반 입자.InResponseTo/nonce), JIT 역할 매핑, 페더레이션 ID에 대한 엄격한 로컬 비밀번호 잠금 기능을 제공합니다. (SSO 설정 가이드 참조).X-ARES-CSRF).활성 캠페인 전반에 걸쳐 즉각적인 상황 가시성을 제공하는 실시간 운영 커맨드 콘솔.
실시간 텔레메트리, 심각도별 확인된 발견 사항, 운영 상태를 표시하는 경영진 커맨드 센터.
전술적 제로 상태 개요 — 활성 캠페인이 없을 때 즉시 준비 상태 스트립과 초기화 작업이 포함된 깔끔한 온보딩 히어로.
panel-subtle), 동적 반응형 상단바 상태 표시기, 초기화되지 않은 지표 기준선을 위한 뚜렷한 점선 진행 트랙을 특징으로 합니다.Staged, Executing, Standby).하드 CIDR 화이트리스트 경계와 암호화된 증거 격리를 시행하는 제로 콜래터럴 대상 거버넌스.
대상 범위, CIDR 경계, 노이즈 제어, 암호화된 자격 증명 볼트를 보여주는 캠페인 관리 인터페이스.
<label> 정의로 빠른 인게이지먼트 중 운영자의 모호함을 방지합니다.Stealth, Normal, Aggressive)을 구성합니다.MITRE ATT&CK 엔터프라이즈 매트릭스에 정렬된 무기화된 적대자 기법의 광범위한 카탈로그.
MITRE ATT&CK 분류, 동적 매개변수 생성, 드라이런 안전 모드를 갖춘 모듈 카탈로그.
ad.kerberoast, ad.adcs, ad.enum_users), Windows(windows.uac_bypass), Linux, 클라우드(AWS, Azure, GCP), 네트워크 인프라를 포괄하는 60개 이상의 모듈식 기법.엔터프라이즈 공격 경로와 권한 상승 체인을 시각화하는 대화형 방향성 비순환 그래프(DAG) 솔버.
자동화된 발광 흰색 패치 케이블, 좌에서 우로의 계층 구조(Domain Controller → Findings → Hosts), 실시간 안전 메타데이터 검사를 갖춘 다중 벡터 공격 그래프.
#ffffff)의 실시간 렌더링.DC01)에서 시작하여 활성 보안 발견 사항을 거쳐 대상 멤버 호스트로 이어지는 깔끔하고 충돌 없는 열 레이아웃.여러 엔터프라이즈 형식(경영진 PDF, 기술 Markdown, 결함 CSV)에 걸쳐 브랜드화된 감사 준비 완료 컴플라이언스 보고서를 즉시 생성합니다.
동기화된 실시간 라이프사이클 관리를 통해 다중 형식 내보내기를 지원하는 보고서 엔진 및 아티팩트 라이브러리.
<label> 요소(Target Campaign, Export Format)와 깔끔한 인라인 검증 오류 피드백을 갖춘 정렬된 다중 열 레이아웃.OPSEC 한계를 준수하면서 복잡한 공격 체인을 계획, 우선순위 지정, 실행하는 목표 지향 자율 엔진.
목표 기반 캠페인 계획 및 적응형 봉쇄 거버넌스를 위한 자율 전략 콘솔.
GET /api/tags)에 대한 실시간 비동기 상태 확인과 동적 서버 측 클라우드 키 검증(Claude, OpenAI)의 결합.Target Campaign, Strategic Objective, AI Planning Engine, Explicit Authorizations), 사람이 읽을 수 있는 목표 설명, UI 레이블에서 서버 환경 변수 누출의 완전한 제거.캔버스 내부에서 직접 수행하는 심층 Active Directory 엔티티 텔레메트리, 관계 검사, 실시간 안전 상세 감사.
Domain Controller(DC01 10.10.10.2) 텔레메트리, 활성 침해 수준, 열린 공격 표면 포트(53, 88, 135, 139, 389, 445, 636, 3268, 3389), 자산 소유 상태를 표시하는 대화형 안전 상세 서랍.
is_dc)를 즉시 검사합니다.53, Kerberos 88, RPC 135, NetBIOS 139, LDAP 389, SMB 445, LDAPS 636, Global Catalog 3268, RDP 3389)에 대한 실시간 가시성.정찰, 자격 증명 수집, 측면 이동을 순차적으로 조정하는 결정론적 다단계 킬 체인.
AD Kerberos Exposure Chain 및 AD Domain Enumeration Chain을 포함한 자동화된 실행 체인.
asreproast -> kerberoast -> hashcat), 도메인 열거, 클라우드 권한 상승을 위한 즉시 사용 가능한 체인.엔터프라이즈 엔드포인트 탐지 및 대응(EDR) 플랫폼 전반에 걸친 회피 효과의 경험적 추적.
CrowdStrike Falcon, SentinelOne, Microsoft Defender 전반에 걸친 기법 성공률을 추적하는 우회 지식 베이스.
감사된 다중 역할 접근 제어, 암호화 API 키 라이프사이클, 지속적인 플랫폼 무결성 검증.
운영자 프로필 관리, 범위 지정 API 키 프로비저닝, 자동화된 시스템 보안 감사.
Team Lead, Operator, Recon, Reporter).운영 텔레메트리, 모듈 출력, 파이프라인 상태를 스트리밍하는 고주파 WebSocket 이벤트 버스.
버퍼링된 텔레메트리와 고처리량 WebSocket 스트리밍을 갖춘 라이브 운영 이벤트 콘솔.
반복되는 레드 팀 훈련, 컴플라이언스 감사, 퍼플 팀 훈련을 위한 표준화된 인게이지먼트 아키텍처.
Internal Pentest, AD Full Compromise, Cloud Assessment, Assumed Breach를 포함한 내장 인게이지먼트 템플릿.
사용자 정의 도구, SOC 오케스트레이션, CI/CD 파이프라인 통합을 위한 완전히 문서화된 대화형 REST API 표면.
엔터프라이즈 자동화를 위한 70개 이상의 운영 엔드포인트를 노출하는 대화형 Swagger UI 문서.
| :--- | :--- | :--- | :--- |
| Overview | 경영진 관점의 상태, 텔레메트리 카운터, 발견 사항 심각도 지표. | Single Pane | 모든 이해관계자 |
| Campaigns | 범위 화이트리스트, 노이즈 프로필, 암호화된 자격 증명 보관소. | List, Scope, Findings | 팀 리드, 운영자 |
| Modules | 60개 이상의 모듈 카탈로그, 매개변수 입력 양식, 실행 콘솔. | Catalog, Run Panel, Results | 운영자 |
| Reports | 결과물 빌더, 증거 패키지, Report Library 수명 주기. | Generate, Library | 운영자, 리포터 |
| Graph | DAG 엔터티 탐색, 최단 공격 경로, BloodHound 수집. | Entities, Attack Paths, Ingest | 운영자, 정찰 |
| Templates | 반복 가능한 참여 플레이북 및 다단계 워크플로 계획. | Templates, Plan Builder | 팀 리드, 운영자 |
| | 목표 지향 자율 엔진, AI 플래너 통합. | , , | 팀 리드, 운영자 |
| | 운영자 자격 증명, API 키 수명 주기, 종속성 감사 검사. | , , | 팀 리드 |
| | 방어 텔레메트리, 우회 추적, 탐지 회피 규칙. | , | 운영자 |
| | 실시간 WebSocket 이벤트 스트림 및 버퍼링된 텔레메트리 로그. | , | 운영자 |
ARES는 프레젠테이션, 실행 오케스트레이션, 보안 거버넌스, 영구 암호화 스토리지를 분리하는 엄격한 심층 방어 아키텍처를 따릅니다:```mermaid
flowchart TB
subgraph Client["Presentation Layer (Operator Enclave)"]
UI["React 19 Dashboard
(Vite + TypeScript)"]
Mesh["Dynamic Architectural Grid
(Canvas 2D Engine)"]
WSClient["WebSocket Client
(Real-Time Telemetry Stream)"]
end
subgraph Gateway["Zero-Trust Security Gateway"]
FastAPI["FastAPI Async Engine<br>(Uvicorn Backend)"]
AuthGuard["Auth & Session Guard<br>(Memory-Only JWT + HttpOnly Refresh)"]
CSRF["HMAC Double-Submit CSRF<br>(X-ARES-CSRF Validation)"]
RateLimit["Rate Limiting & Brute-Force Shield"]
end
subgraph Core["ARES Core Engine & Governance"]
ScopeFirewall["Scope Egress Firewall<br>(Strict CIDR & IP Whitelist)"]
Governor["OPSEC Noise Governor<br>(Adaptive Jitter & Throttling)"]
Orchestrator["Module Execution Orchestrator<br>(Worker Thread Pool)"]
AutoPlanner["Autonomous Strategy Engine<br>(DAG Heuristics / AI Planner)"]
end
subgraph Storage["Cryptographic Persistence Layer"]
DB[(SQLite / PostgreSQL<br>Alembic Versioned)]
Vault[(AES-256-GCM Vault<br>Encrypted Credentials & Hashes)]
GraphEngine["Attack Graph DAG Engine<br>(BloodHound Ingest & Shortest Path)"]
end
subgraph Deliverables["Reporting Pipeline"]
PDFGen["Headless Chromium / Edge Engine<br>(Automated PDF Generation)"]
Artifacts["Evidence Library<br>(HTML, Markdown, JSON)"]
end
UI -->|HTTPS / REST| AuthGuard
WSClient -->|WSS / Ticket Barrier| AuthGuard
AuthGuard --> CSRF --> RateLimit --> FastAPI
FastAPI --> ScopeFirewall
ScopeFirewall --> Orchestrator
Orchestrator --> Governor
Orchestrator --> AutoPlanner
Orchestrator --> Storage
Storage --> GraphEngine
FastAPI --> Deliverables
## ⚔️ 공격자 기법 및 MITRE ATT&CK 매트릭스
ARES는 MITRE ATT&CK Enterprise Framework에 기본적으로 매핑된 60개 이상의 모듈식 공격자 기법을 구현합니다:```
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ MITRE ATT&CK MATRIX COVERAGE │
├─────────────────────┬─────────────────────┬─────────────────────┬─────────────────────┬──────────────────────────┤
│ DISCOVERY │ CREDENTIAL ACCESS │ LATERAL MOVEMENT │ PRIVILEGE ESCALATION│ DEFENSE EVASION / CLOUD │
├─────────────────────┼─────────────────────┼─────────────────────┼─────────────────────┼──────────────────────────┤
│ • T1087 User Enum │ • T1558.003 Kerberoast│ • T1021.002 SMB/RPC │ • T1548.002 UAC Byps│ • T1070 Indicator Removal│
│ • T1069 Group Enum │ • T1558.004 AS-REP │ • T1021.006 WinRM │ • T1068 Token Privs │ • T1562 Impair Defenses │
│ • T1046 Port/Net │ • T1003 LSASS Dump │ • T1550 Use Ticket │ • T1053 Scheduled │ • T1078 Cloud IAM Enum │
│ • T1018 Host Disc │ • T1649 ADCS ESC1-8 │ • T1071 App Layer │ • T1055 Injection │ • T1580 Cloud Discovery │
│ • T1082 System Info │ • T1110 Pass Spray │ • T1021.001 RDP │ • T1134 Access Token│ • T1526 Cloud Hierarchy │
└─────────────────────┴─────────────────────┴─────────────────────┴─────────────────────┴──────────────────────────┘
ad.kerberoast), AS-REP Roasting, ADCS 인증서 템플릿 악용(ESC1~ESC8), DCSync 계정 복제, BloodHound 데이터 생성.git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES
py -3.12 -m venv .venv ..venv\Scripts\python.exe -m pip install -U pip ..venv\Scripts\python.exe -m pip install -e ".[dev,pdf]"
Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..
$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke
..venv\Scripts\ares.exe dashboard dev --no-reload
브라우저에서 **`http://127.0.0.1:5173/dashboard/`** 를 엽니다.
- **초기 운영자**: `admin`
- **초기 비밀번호**: `.env`의 `ARES_DEFAULT_ADMIN_PASSWORD`를 통해 구성됩니다 (기본값: `Admin123456!`)
---
## 🔐 엔터프라이즈 보안 모델 및 규정 준수
ARES는 가장 엄격한 규정 준수 및 기밀성 요구 사항을 가진 환경을 위해 설계되었습니다:
### 심층 방어 인증
- **메모리 전용 액세스 토큰**: 수명이 짧은 JWT(15분 수명)는 순수하게 메모리 내 React 상태에만 존재하며 `localStorage`나 `sessionStorage`에 기록되지 않습니다.
- **회전하는 리프레시 패밀리**: 수명이 긴 리프레시 자격 증명은 엄격한 호스트 전용 HttpOnly 쿠키(`ares_refresh`)에 바인딩되며, 일회성 회전 및 자동 재사용 폐기를 지원합니다.
- **HMAC CSRF 장벽**: 상태 변경 엔드포인트는 암호학적으로 안전한 쿠키 토큰과 일치하는 유효한 `X-ARES-CSRF` 헤더를 필수로 요구합니다.
### 역할 기반 액세스 제어 (RBAC)
ARES는 모든 API 엔드포인트, 백그라운드 작업, UI 표면 전반에 걸쳐 엄격한 RBAC 권한을 적용합니다:
| 역할 | API 값 | 운영 범위 | 관리 권한 |
| :--- | :---: | :--- | :--- |
| **팀 리드** | `team_lead` | 완전한 플랫폼 권한: 캠페인 생성/삭제, 사용자 프로비저닝, 보안 감사, 고노이즈 모듈 재정의. | 전체 시스템 관리자 |
| **운영자** | `operator` | 일상 운영: 승인된 모듈 실행, 발견 사항 검토, 공격 그래프 탐색, 보고서 생성. 사용자 등록 불가. | 운영 계층 |
| **정찰** | `recon` | 읽기 중심 정찰: 안전한 탐색 및 네트워크 핑거프린팅 모듈 실행. 파괴적 모듈 실행은 차단됩니다. | 읽기 중심 |
| **리포터** | `reporter` | 이해관계자 검토: 캠페인 분석, 발견 사항, 공격 그래프, 생성된 산출물에 대한 읽기 전용 액세스. 실행 권한 없음. | 읽기 전용 감사 |
#### 역할 프로비저닝 및 권한 상승 방지 보장
- **권위 있는 데이터베이스 신원**: 클라이언트 측 JWT 역할 클레임을 맹목적으로 신뢰하는 시스템과 달리, ARES는 모든 요청에서 라이브 데이터베이스로부터 직접 사용자 신원과 역할을 확인합니다 (`row = await db.resolve_access_token_principal(...)`). 변조된 JWT 클레임은 수학적으로 폐기됩니다.
- **계정 생성 시 엄격한 역할 게이팅**: 새 사용자 역할은 `team_lead`가 `POST /auth/register`를 통해 독점적으로 할당하거나(`require_team_lead()`로 보호됨), SP-initiated SAML/OIDC SSO 중 엔터프라이즈 ID 공급자로부터 자동으로 매핑됩니다.
- **역할 불변성**: 역할 할당은 생성 후 변경할 수 없습니다. 사용자 역할을 변경할 수 있는 공개 엔드포인트가 존재하지 않으며(`PUT /users/{id}`는 존재하지 않음), 이는 수평적 및 수직적 권한 상승 벡터(예: `recon`이 `team_lead`로 상승하거나 `reporter`가 공격 모듈을 실행하는 것)를 제거합니다.
- **감사된 사용자 인벤토리**: 대시보드 `Security` 콘솔은 참여 책임성을 위해 등록된 모든 신원과 활성 세션의 투명한 인벤토리를 제공합니다.
---
## 🔌 ARES MCP 게이트웨이 및 제품급 CLI
ARES는 현대적인 AI 코딩 어시스턴트(Cursor IDE, Claude Desktop, Windsurf, VS Code Cline, Zed, Open-WebUI, LibreChat)가 ARES 퍼플팀 공격 플랫폼과 안전하게 그리고 엄격한 거버넌스 하에 상호작용할 수 있도록 하는 프로덕션급 **Model Context Protocol (MCP)** 게이트웨이를 제공합니다.
<div align="center">
*실시간 도구 텔레메트리, 라이브 범위 검사, 1키 토큰 인증을 갖춘 ARES MCP 투 페인 분할 터미널 모니터 (OpenClaw 스타일).*
</div>
가드레일 없이 원시 엔드포인트를 LLM에 노출하는 기본 MCP 서버와 달리, ARES는 라이브 공격 작업이 실행되기 전에 엄격한 **사전 비행 범위 불변성 (`ScopeGuard`)**, **안티 프롬프트 인젝션 테인트 격리**, **단일 사용 60초 HMAC 확인 토큰**을 적용합니다.
### 🚀 무엇부터 시작해야 하나요? (단계별 온보딩)
Cursor, Claude Desktop 또는 Windsurf를 ARES에 연결하는 운영자 또는 개발자를 위한 안내:
1. **하위 시스템 준비 상태 확인 (`doctor`)**:
모든 핵심 하위 시스템(프로토콜 엔진, 9개 도구, 3개 리소스, 3개 프롬프트, 62개 모듈, 보안 게이트)이 `PASS`를 보고하는지 확인합니다: ```powershell
.\mcp.bat doctor
1-클릭 AI 클라이언트 설정 (수동 JSON 편집 불필요): 단일 명령으로 선호하는 IDE를 자동으로 구성합니다: ```powershell
.\mcp.bat setup --client cursor
.\mcp.bat setup --client claude
.\mcp.bat setup --client windsurf
.\mcp.bat setup --client cline
이것은 활성 Python 가상 환경 경로를 클라이언트 구성 파일(예: .cursor/mcp.json)에 직접 기록합니다.
Cursor IDE에서 창 다시 로드:
Ctrl + Shift + P를 누릅니다.Developer: Reload Window**를 선택합니다.Ctrl + ,) → Features → MCP Servers를 엽니다. ares 서버가 녹색 점(Connected)으로 표시됩니다.실시간 2분할 모니터 실행(선택적 동반 창): 전용 터미널 창에서 OpenClaw 스타일의 2분할 모니터를 실행하여 실시간 AI 도구 호출, 범위 검사 및 토큰 승인을 확인합니다: ```powershell .\mcp.bat monitor
ares_scope_check, ares_dry_run_module, ares_run_tool).
A**를 눌러 대기 중인 실행 토큰을 승인하고, **R**로 거부하며, **C**로 스트림을 지우고, **Q**로 종료합니다.Ctrl + I 또는 Ctrl + L)을 열고 다음 프롬프트를 시도하세요:
"활성 캠페인 상태를 확인하고, 대상 10.0.1.50의 범위를 검증하며, ad_kerberoast 모듈의 드라이런을 스테이징하세요."
심층 아키텍처, 7가지 보안 불변식, CLI 스크립트 가능성(--json), POSIX 종료 코드, 운영 도구 스키마에 대해서는 ARES MCP Gateway & Product-Grade CLI Specification을 참조하세요.
ARES는 맞춤형 적대자 모듈을 구축하고, 격리된 테스트 하네스에서 기법을 시뮬레이션하며, 참여를 프로그래밍 방식으로 자동화할 수 있는 일급 타입 안전 Python SDK(ares.sdk)를 제공합니다:
BaseModule[P, R] & @ares_module)Pydantic v2로 검증된 매개변수 스키마를 선언하고 전체 IDE 자동 완성과 함께 모듈을 작성하세요:```python from ares.sdk import ( BaseModule, ExecutionContext, ModuleResult, ModuleParams, param, SecretParam, OpsecLevel, Severity, ares_module, )
class KerberoastParams(ModuleParams): dc: str = param("Target Domain Controller IP or FQDN", min_length=3) domain: str = param("AD DNS domain name, e.g. CORP.LOCAL", min_length=3) password: SecretParam = param("Domain user password", secret=True, required=False)
class CustomKerberoastModule(BaseModule[KerberoastParams, ModuleResult]): MODULE_ID = "custom.ad.kerberoast" MODULE_NAME = "Custom Kerberoasting" MODULE_CATEGORY = "ad" OPSEC_LEVEL = OpsecLevel.LOW MITRE_TECHNIQUES = ["T1558.003"] PARAMS_MODEL = KerberoastParams
async def execute(self, ctx: ExecutionContext[KerberoastParams]) -> ModuleResult:
# ctx.params provides full static typing and runtime validation
await self.before_request(ctx.params.dc)
# Emit findings using fluent context helpers
finding = ctx.emit_finding(
title=f"Kerberoastable SPN Captured on {ctx.params.dc}",
severity=Severity.HIGH,
mitre_technique="T1558.003",
)
return ModuleResult(status="success", findings=[finding], module_id=self.MODULE_ID)
### 2. 격리된 테스트 및 시뮬레이션 (`ModuleTestHarness`)
모의 스코프 가드, 합성 자격 증명 볼트, 유창한 어서션 매처를 사용하여 사용자 정의 기법을 로컬에서 단위 테스트하세요:```python
from ares.sdk import ModuleTestHarness, Severity
async def test_module():
harness = ModuleTestHarness(CustomKerberoastModule)
result = await harness.simulate(params={"dc": "10.0.0.10", "domain": "LAB.LOCAL"})
result.assert_success()
result.assert_finding(severity=Severity.HIGH, mitre="T1558.003")
AresClient)Python 스크립트 또는 CI/CD 파이프라인을 통해 인게이지먼트를 자동화하고, 모듈을 디스패치하며, 실시간 WebSocket 텔레메트리를 스트리밍합니다:```python from ares.sdk import AresClient
async with AresClient(base_url="http://127.0.0.1:8000", api_key="ares_key_...") as ares: campaign = await ares.campaigns.create(name="Op-Titan", scope=["10.0.0.0/24"]) job = await ares.modules.run("ad.kerberoast", target="dc01.corp.local", campaign_id=campaign["id"]) findings = await ares.campaigns.findings(campaign["id"])
전체 개발자 문서, 아키텍처 명세 및 예제는 [docs/module_sdk.md](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md)와 [docs/module-development.md](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md)를 참조하십시오.
---
## 📚 문서 사이트맵
포괄적인 문서는 [`docs/`](https://github.com/mafifrizi/ares/blob/main/docs) 디렉터리에서 확인할 수 있습니다:
- [**문서 포털 및 서브시스템 색인**](https://github.com/mafifrizi/ares/blob/main/docs/README.md)
- [**퀵스타트 참여 가이드**](https://github.com/mafifrizi/ares/blob/main/QUICKSTART.md)
- [**차세대 모듈 SDK 명세 (v2)**](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md)
- [**ARES MCP 서버 및 프로덕트급 CLI 명세**](https://github.com/mafifrizi/ares/blob/main/docs/mcp-server.md)
- [**단계별 모듈 개발 가이드**](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md)
- [**대시보드 화면별 매뉴얼**](https://github.com/mafifrizi/ares/blob/main/docs/dashboard-guide.md)
- [**적대자 모듈 카탈로그 및 스키마**](https://github.com/mafifrizi/ares/blob/main/docs/modules.md)
- [**API 엔드포인트 레퍼런스 및 페이로드**](https://github.com/mafifrizi/ares/blob/main/docs/api-reference.md)
- [**엔터프라이즈 SSO 통합 가이드 (SAML 2.0 / OIDC)**](https://github.com/mafifrizi/ares/blob/main/docs/sso-setup.md)
- [**엔터프라이즈 보안 및 위협 모델**](https://github.com/mafifrizi/ares/blob/main/docs/security-model.md)
- [**검증 랩 및 테스트 하네스**](https://github.com/mafifrizi/ares/blob/main/docs/validation-lab.md)
---
## ⚖️ 책임 있는 사용 및 법적 고지
> [!IMPORTANT]
> **ARES는 승인된 사이버보안 연구, 내부 엔터프라이즈 복원력 검증, 그리고 명시적 서면 허가를 받은 전문 레드팀 참여를 위해 독점적으로 설계된 이중 용도 소프트웨어 프레임워크입니다.**
- 시스템 소유자의 사전 서면 승인 없이 **어떠한** 네트워크, 호스트 또는 클라우드 인프라에 대해서도 ARES를 실행하지 **마십시오**.
- 무단 시스템 접근 또는 테스트는 국내 및 국제 사이버범죄 법률(예: Computer Fraud and Abuse Act 18 U.S.C. § 1030)을 위반합니다.
- ARES의 제작자와 유지관리자는 이 소프트웨어로 인해 발생하는 오용, 손해 또는 규제 위반에 대해 어떠한 책임도 지지 않습니다.
ARES의 보안 취약점을 신고하려면 [보안 정책](https://github.com/mafifrizi/ares/blob/main/SECURITY.md)을 따라 주십시오.
---
## 📄 라이선스
ARES는 오픈소스 **[MIT 라이선스](https://github.com/mafifrizi/ares/blob/main/LICENSE)** 하에 배포됩니다.
<br>
<div align="center">
**ARES — 엔터프라이즈급 자율 레드팀 참여 시스템.**
*지속적인 보안 검증. 제로 부수적 위험.*
</div>
ObjectiveActiveResultAccountAPI KeysAuditKnowledge BaseReport OutcomeStreamBuffer