Hermes용 Agentic 침투 테스트 프로필: 승인된 정찰, 웹/접근 제어 공격, 안전한 익스플로잇 검증, 가드 게이트 기반 증거 중심 보고를 위한 31개의 플레이북.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/50022/55f1c11f1fa53cb32838b487d5b5b6f1745b609c7123ce0a2b28ff21108c765b.png" alt="Violin" width="256"/>
</p>
<h1 align="center">Violin ☤ — 감독형 에이전틱 Hermes 침투 테스트 프로필</h1>
<p align="center">
<a href="https://github.com/Strategic-Automation/violin"><img src="https://img.shields.io/badge/Status-Release%20Ready-2ea44f?style=for-the-badge" alt="Release Ready"></a>
<a href="https://github.com/Strategic-Automation/violin/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License: MIT"></a>
<a href="https://hermes-agent.nousresearch.com/"><img src="https://img.shields.io/badge/Hermes-%3E=0.21.5-FFD700?style=for-the-badge" alt="Hermes >=0.21.5"></a>
<a href="https://www.kali.org/"><img src="https://img.shields.io/badge/Kali%20Linux-557C94?style=for-the-badge&logo=kali-linux&logoColor=white" alt="Kali Linux"></a>
<a href="https://www.parrotsec.org/"><img src="https://img.shields.io/badge/Parrot%20OS-2E8B57?style=for-the-badge" alt="Parrot OS"></a>
<a href="https://strategic-automation.github.io/violin/"><img src="https://img.shields.io/badge/Site-Landing%20page-FF3B4A?style=for-the-badge" alt="Landing page"></a>
<a href="https://github.com/Strategic-Automation/violin/stargazers"><img src="https://img.shields.io/github/stars/Strategic-Automation/violin?style=for-the-badge&color=FFD166" alt="GitHub stars"></a>
</p>
<p align="center">
<b>35개 플레이북 · 19개 레퍼런스 · 14개 템플릿 · 필수 실행 가드 · Hermes 네이티브</b>
</p>
Violin은 감독 하에 승인된 침투 테스트를 위한 **Hermes 네이티브 에이전틱 침투 테스트 프로필**로, 정찰부터 안전한 익스플로잇 검증, 보고에 이르기까지 다룹니다. Hermes에 내장된 툴셋, 7개의 라우팅된 스킬, 그리고 대상 실행 경계에서 필수로 요구되는 `violin_guard` 플러그인을 사용합니다. 독립 실행형 CLI는 릴리스 검사, 진단, 관리 복구를 지원하며, 대상 명령은 플러그인을 통해 실행됩니다. Violin은 프로필 전용 자격 증명을 추가하지 않으며, Hermes에 이미 구성된 프로바이더 및 도구 백엔드를 그대로 상속합니다.
<p align="center">
<a href="#quick-start">빠른 시작</a> ·
<a href="#engagement-lifecycle">워크플로</a> ·
<a href="#guard-tools">가드 도구</a> ·
<a href="#benchmarks">벤치마크</a> ·
<a href="https://strategic-automation.github.io/violin/">랜딩 페이지</a> ·
<a href="https://github.com/Strategic-Automation/violin/discussions">토론</a> ·
<a href="#development">개발</a>
</p>
<p align="center">
<strong>Violin을 지켜보고 계신가요?</strong>
<a href="https://github.com/Strategic-Automation/violin/stargazers">저장소에 스타를 눌러</a>
쉽게 찾을 수 있도록 돕고, 다른 보안 엔지니어들이 감독형 에이전틱 침투 테스트를 발견할 수 있게 해 주세요.
</p>
### 커뮤니티 소개
Violin은 다음을 비롯한 커뮤니티 큐레이션 컬렉션에 등재되어 있습니다:
[awesome-ai-security](https://github.com/gmh5225/awesome-ai-security),
[awesome-hermes-skills](https://github.com/ZeroPointRepo/awesome-hermes-skills),
[awesome-hermes-agent](https://github.com/Anil-matcha/awesome-hermes-agent), 그리고
[awesome-infosec](https://github.com/onlurking/awesome-infosec).
제3자 보도:
[Starlog 기술 분석](https://starlog.is/articles/cybersecurity/strategic-automation-violin) 및
[“Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent”](https://hamradio.my/violin-supervised-agentic-pentest-profile-hermes/).
독립적인 평가를 위해서는
[리뷰어 키트](https://strategic-automation.github.io/violin/review.html)를 사용하세요. 이 키트는
벤치마크 경로, 알려진 한계, 리뷰 컨텍스트, 그리고 자율 침투 테스트 에이전트 설계와의
사실 기반 비교를 모아 제공합니다.
---
<table>
<tr><td width="240"><strong>보호된 대상 실행</strong></td><td>범위, 단계, PTT, 스킬, 가설, 이력 및 동기화 검사가 대상 명령이 시작되기 전에 실행됩니다.</td></tr>
<tr><td><strong>지속적인 참여 상태</strong></td><td>PTT 작업, 가설, 명령 이력, 체크포인트, 증거 및 보고서가 컨텍스트 압축 후에도 유지됩니다.</td></tr>
<tr><td><strong>증거 기반 발견 사항</strong></td><td>타입이 지정된 제출은 각 검증된 발견 사항을 인증된 실행 영수증에 연결합니다.</td></tr>
<tr><td><strong>라우팅된 방법론</strong></td><td>침투 테스트 오케스트레이터가 집중적인 웹, 아이덴티티, API, 비즈니스 로직, LLM 보안 및 구성 오류 플레이북을 선택합니다.</td></tr>
<tr><td><strong>제한된 실행</strong></td><td>단일 명령, 명령 버스트, 백그라운드 프로세스, 배치 검토, 하트비트 검사 및 취소가 하나의 상태 모델을 공유합니다.</td></tr>
<tr><td><strong>검증 가능한 릴리스</strong></td><td>플러그인 등록, 스키마, 스킬 스냅샷, 문서 계약, 린트, 포매팅 및 전체 테스트 스위트가 릴리스 게이트를 통과해야 합니다.</td></tr>
</table>
## 빠른 시작
### 프로필 설치
```bash
hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin plugins disable violin_guard
hermes -p violin plugins enable violin_guard --no-allow-tool-override
hermes -p violin
```
가드 의존성은 `plugins/violin_guard/plugin.yaml`에 선언되어 있습니다. 플러그인 이름, 디렉터리, 활성화 구성 모두 `violin_guard`를 사용하므로 Hermes는 디렉터리 우회 없이 의존성을 해석할 수 있습니다. 개발용 `.venv`에 의존성을 설치해도 Hermes에는 설치되지 않습니다. 위의 비활성화/활성화 주기는 프로필 구성에서 이미 플러그인을 활성화하고 있더라도 의존성 승인을 강제합니다. 설치 후 등록을 확인하세요:
```bash
hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list
```
Plugin Doctor는 12개의 도구와 5개의 훅을 보고해야 하며, `violin_guard`는 활성화된 도구 세트로 나타나야 합니다. 설치 후에는 참여를 시작하기 전에 Hermes를 재시작하세요. 이전 `violin-guard` 설치를 마이그레이션하려면 프로필을 재설치하세요.
그런 다음 권한이 부여된 대상으로 시작하고, 대상과 상호작용하기 전에 Violin이 범위를 수집하도록 하세요:
```text
Run an authorized penetration test against example.com.
```
### 요구 사항
- [Hermes Agent](https://hermes-agent.nousresearch.com/) 0.21.5 이상 (컨테이너는 `v2026.9.24` 릴리스 커밋을 고정함)
- 로컬 개발을 위한 Python 3.11 및 `uv`
- 예상되는 보안 도구 환경을 위한 Kali Linux 또는 Parrot OS
- 서면 승인 및 승인된 범위
Violin은 모델이나 제공자를 선택하지 않습니다. 해당 항목은 Hermes에서 구성하십시오. 성능이 충분한 기본값으로는 로컬에서 **Qwen3.8 27B**를 사용하거나 호스팅 제공자를 통해 **DeepSeek V4 Flash**를 사용하십시오.
## 참여 수명 주기
```mermaid
flowchart LR
S[Scope] --> R[Recon]
R --> V[Vulnerability research]
V --> E[Exploit validation]
E --> P[Reporting]
P --> X[Retrospective]
G[Violin Guard] -. validates .-> R
G -. validates .-> V
G -. validates .-> E
```
1. 참여를 초기화하고 `scope/scope.yaml`을 승인합니다.
2. `violin_record_ptt`로 활성 PTT 작업 하나와 그에 라우팅된 스킬을 선택합니다.
3. `violin_exec` 또는 `violin_exec_burst`로 대상 명령을 실행합니다.
4. 증거가 상태를 변경함에 따라 가설을 업데이트합니다.
5. `violin_review_batch`로 각 경계 지정 명령 배치를 검토합니다.
6. 검증된 발견 사항을 제출하고 최종 보고서를 생성합니다.
7. 회고를 완료합니다.
전체 단계 모델은 다음과 같습니다:
```text
SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
→ POST_EXPLOITATION / PRIVESC / FLAGS
→ REPORTING → RETROSPECTIVE
```
새 단계에서 작업을 시작하려면 해당 단계 아래에 PTT 작업이 있어야 합니다. 기존
작업은 단계 섹션 간에 이동되지 않습니다.
## 가드 도구
플러그인은 하나의 타입 지정 레지스트리에서 열두 개의 Hermes 도구를 등록합니다:
| 도구 | 용도 |
|---|---|
| `violin_record_ptt` | PTT 작업 생성, 시작, 새로 고침, 종료 또는 취소 |
| `violin_record_hypothesis` | 범위가 지정된 가설 생성 또는 업데이트 |
| `violin_submit_finding` | 서명된 실행 영수증에 바인딩된 검증된 발견 사항 제출 |
| `violin_exec` | 가드된 명령 하나 실행 |
| `violin_exec_burst` | 범위가 제한된 명령 파일 실행 |
| `violin_exec_status` | 백그라운드 실행 상태 읽기 |
| `violin_exec_cancel` | 추적 중인 백그라운드 실행 취소 |
| `violin_review_batch` | 완료된 배치를 검토하고 상태 확정 |
| `violin_rebind_pending_batch` | 확인 후 대기 중인 배치 다시 바인딩 |
| `violin_heartbeat_done` | 완료된 하트비트 검토 지우기 |
| `violin_target` | 승인된 평가 대상 확인 |
| `violin_status` | 현재 작업, 스킬 및 차단 요소 설명 |
`violin_exec`는 일반적인 대상 명령 경계입니다. 도구별 실행 어댑터나 바이너리
허용 목록은 없습니다. 설치된 비대화형 도구는 참여 게이트를 통과한 후에만 실행될 수
있습니다.
원시 터미널 훅은 최선 노력 방식의 안전망이며 네트워크 격리가 아닙니다.
`terminal`은 호스트 로컬 준비 및 관리에만 사용하십시오.
## 안전 모델
```mermaid
flowchart LR
A[Written authorization] --> B[Approved scope]
B --> C[Active phase task]
C --> D[Skill and hypothesis gates]
D --> E[Guarded execution]
E --> F[Evidence receipt]
F --> G[Batch review]
```
- 범위 승인 및 부트스트랩 검증 전에는 대상과 상호작용하지 않습니다.
- 대상 명령을 위한 원시 셸 실행은 하지 않습니다.
- 명시적인 서면 승인 없이는 파괴적, 방해적, 자격 증명, 지속성, 은닉 또는
제3자 행위를 수행하지 않습니다.
- 원시 증거는 `$ENG_DIR/evidence/<phase>/` 아래에 보관합니다.
- 비밀 정보, 덤프 및 증명 출력은 `$ENG_DIR/state/` 밖에 보관합니다.
- 컨텍스트 압축은 현재 Hermes 대화의 engagement 파일에서 재개됩니다.
상세 정책은
[`skills/pentest/references/standards.md`](https://github.com/strategic-automation/violin/blob/master/skills/pentest/references/standards.md)에 있습니다.
## Engagement 상태
`init-engagement`는 표준 작업 구조를 생성합니다:
```text
$ENG_DIR/
├── scope/
│ └── scope.yaml
├── state/
│ ├── ptt.md
│ ├── history.md
│ └── checkpoint.json
├── hypotheses.md
├── evidence/
├── reporting/
└── retrospective/
```
### Violin 3.3에서 업그레이드
Violin 4.0은 실행기 상태를 `state/runtime.json`에 저장하며, 3.3의 `sync.json`, `counts.json`, `heartbeat.json` 파일을 마이그레이션하지 않습니다. 새 디렉터리에서 새 작업을 시작하세요. 3.3 디렉터리는 기록용으로 보관하세요. 해당 디렉터리를 재사용하면 레거시 상태 파일이 그대로 남아 있으므로 Violin 4.0이 이를 거부합니다.
### 스킬 전달
스킬은 필요할 때 로드됩니다. 라우팅된 스킬에 대한 첫 `violin_record_ptt` 호출은 PTT를 변경하지 않고 `skill_prepared`를 반환할 수 있습니다. Hermes가 스킬 콘텐츠를 전달한 후, 영수증을 바인딩하고 작업 변경을 적용하려면 전환을 반복하세요. `violin_status`가 정확한 복구 작업을 보고합니다.
`.skill-loaded-*`와 같은 마커 파일은 스킬 전달을 증명하지 않습니다.
## 라우팅된 스킬
| 스킬 | 범위 |
|---|---|
| `pentest` | 범위, 수명 주기, 정찰, 익스플로잇, 보고, 종료 |
| `web-app` | 인젝션, SSRF, 경로 순회, 역직렬화, 클라이언트 측 결함 |
| `identity-auth` | 인증, 권한 부여, IDOR, JWT, CSRF, 암호화 |
| `api-testing` | REST, SOAP, GraphQL, WebSocket |
| `business-logic` | 워크플로, 가격 책정, 쿠폰, 할당량, 추천, 경쟁 조건 |
| `llm-security` | 프롬프트 인젝션, MCP, JSON-RPC |
| `misconfig` | 배포, 오류 처리, 관측 가능성, 은닉 |
오케스트레이터는 현재 작업에 필요한 단계 자료와 전문가 플레이북만 로드합니다.
## 관리 CLI
CLI는 보호된 대상 실행을 대체하지 않습니다.
```bash
python scripts/violin_guard.py --help
python scripts/violin_guard.py init-engagement engagements/example --host example.com
python scripts/violin_guard.py check-bootstrap --eng-dir engagements/example
python scripts/violin_guard.py status --eng-dir engagements/example
python scripts/violin_guard.py generate-closeout --eng-dir engagements/example
python scripts/violin_guard.py check-release
```
`check-command`는 진단을 위한 어드미션 검사를 노출하며, 제공된 명령을 실행하지 않습니다.
## 아키텍처
```text
plugins/violin_guard/
├── core/
│ ├── commands/ shell parsing, targets, HTTP proof
│ ├── engagement/ state, PTT, phases, hypotheses, bootstrap
│ ├── evidence/ findings, history, receipts, redaction
│ └── skills/ skill policy and receipts
├── gates/ command, scope, hypothesis, terminal policies
├── engine/ execution, runtime backend, code audit, release checks
├── handlers/ public Hermes tool handlers
├── hooks.py Hermes lifecycle hooks
└── registry.py registered tool definitions
skills/ orchestrator, routed skills, playbooks, references
benchmark/ runner, scorer, proof checks, calibration fixtures
scripts/ administrative CLI and platform smoke tests
tests/ runtime, integration, documentation, release tests
```
## 벤치마크
저장소에는 Escape Duck Store 정의와 함께 정상(known-good) 및 비정상(known-bad) 스코어러 픽스처가 포함되어 있습니다. 캘리브레이션은 스코어러가 해당 픽스처를 처리함을 입증하지만, 라이브 에이전트 재현율, 워크플로 완료 또는 보고서 품질을 입증하지는 않습니다.
```bash
uv run python -m benchmark.score --calibrate known-good
uv run python -m benchmark.score --calibrate known-bad
uv run python -m benchmark.run \
--target http://localhost:<published-port> \
--provider <provider> \
--api-base <openai-compatible-base-url> \
--model <model-id> \
--target-isolation-id escape-duck-store-2026-04:<image-digest-or-reset-id>
```
점수를 게시하기 전에 [벤치마크 방법론](https://github.com/strategic-automation/violin/blob/master/docs/BENCHMARKS.md)을 읽으십시오.
이는 신뢰할 수 있는 결과를 위한 증명, 재현성, 비공개 평가 및 공개 요건을
정의합니다.
## 개발
```bash
uv sync --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run python scripts/violin_guard.py check-release
```
릴리스 게이트는 버전 표면, 격리된 플러그인 임포트, 등록된
도구, 생성된 스키마, 스킬 스냅샷, 문서 계약, Ruff, 그리고
전체 테스트 스위트를 검사합니다.
플랫폼 스모크 테스트:
- `scripts/smoke-test.sh` — Linux 및 Kali/Parrot 릴리스 스모크
- `scripts/smoke-test.ps1` — Windows 부트스트랩, 스코프, 타깃 해석
스모크; 스킬 전달과 타깃 실행에는 Hermes가 필요합니다
기여 규칙은 [CONTRIBUTING.md](https://github.com/strategic-automation/violin/blob/master/CONTRIBUTING.md)를, 비공개 취약점 신고는
[SECURITY.md](https://github.com/strategic-automation/violin/blob/master/SECURITY.md)를 참조하세요.
## 책임 있는 사용
Violin은 승인된 보안 평가를 위한 도구입니다. 운영자는
스코프, 승인, 타깃 소유권, 데이터 처리, 그리고 현지 법률에 대한 책임이 있습니다.
## Violin 후원
Violin은 Strategic Automation Ltd.가 유지 관리하는 오픈소스 프로젝트입니다.
Violin이 귀하 또는 귀하의 조직에 유용하다면,
[지속적인 개발을 후원](https://github.com/sponsors/Strategic-Automation)할 수 있습니다.
후원은 지속적인 개발, 테스트, 문서화,
호환성 작업, 그리고 릴리스를 지원합니다.
Violin은 MIT 라이선스에 따라 계속 제공됩니다. 후원에는
보장된 지원, 기능 우선순위, 또는 보안 정책에 대한 영향력이 포함되지 않습니다.
## 라이선스
MIT — [LICENSE](https://github.com/strategic-automation/violin/blob/master/LICENSE)를 참조하세요.