Agentisches Pentest-Profil für Hermes: 31 Playbooks für autorisierte Recon, Web-/Access-Control-Angriffe, sichere Exploit-Validierung und evidenzbasierte Berichterstattung mit Guard-Gates.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/50022/55f1c11f1fa53cb32838b487d5b5b6f1745b609c7123ce0a2b28ff21108c765b.png" alt="Violin" width="256"/>
</p>
<h1 align="center">Violin ☤ — Überwachtes agentisches Hermes-Pentest-Profil</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 Playbooks · 19 Referenzen · 14 Vorlagen · verpflichtender Ausführungs-Guard · Hermes-nativ</b>
</p>
Violin ist ein **Hermes-natives agentisches Pentest-Profil** für überwachte, autorisierte Penetrationstests — von der Aufklärung über die sichere Exploit-Validierung bis hin zum Reporting. Es nutzt die integrierten Toolsets von Hermes, sieben geroutete Skills und das verpflichtende `violin_guard`-Plugin an der Zielausführungsgrenze. Die eigenständige CLI unterstützt Release-Prüfungen, Diagnosen und administrative Wiederherstellung; Zielbefehle werden über das Plugin ausgeführt. Violin fügt keine profilspezifischen Anmeldedaten hinzu und erbt die bereits in Hermes konfigurierten Provider- und Tool-Backends.
<p align="center">
<a href="#quick-start">Schnellstart</a> ·
<a href="#engagement-lifecycle">Workflow</a> ·
<a href="#guard-tools">Guard-Tools</a> ·
<a href="#benchmarks">Benchmarks</a> ·
<a href="https://strategic-automation.github.io/violin/">Landingpage</a> ·
<a href="https://github.com/Strategic-Automation/violin/discussions">Diskussionen</a> ·
<a href="#development">Entwicklung</a>
</p>
<p align="center">
<strong>Folgen Sie Violin?</strong>
<a href="https://github.com/Strategic-Automation/violin/stargazers">Geben Sie dem Repository einen Stern</a>,
damit es leicht zu finden bleibt und andere Security-Engineers überwachtes agentisches Pentesting entdecken können.
</p>
### Entdeckung in der Community
Violin ist in von der Community kuratierten Sammlungen gelistet, darunter
[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) und
[awesome-infosec](https://github.com/onlurking/awesome-infosec).
Berichterstattung durch Dritte:
[Starlog-Technikanalyse](https://starlog.is/articles/cybersecurity/strategic-automation-violin) und
[„Violin: Supervised Agentic Penetration Testing Profile for Hermes Agent“](https://hamradio.my/violin-supervised-agentic-pentest-profile-hermes/).
Für eine unabhängige Bewertung nutzen Sie das
[Reviewer-Kit](https://strategic-automation.github.io/violin/review.html), das
den Benchmark-Pfad, bekannte Grenzen, den Review-Kontext und einen sachlichen
Vergleich mit autonomen Pentest-Agent-Designs zusammenstellt.
---
<table>
<tr><td width="240"><strong>Geschützte Zielausführung</strong></td><td>Bereichs-, Phasen-, PTT-, Skill-, Hypothesen-, Verlaufs- und Synchronisationsprüfungen werden ausgeführt, bevor ein Zielbefehl startet.</td></tr>
<tr><td><strong>Persistenter Engagement-Zustand</strong></td><td>PTT-Aufgaben, Hypothesen, Befehlsverlauf, Checkpoints, Nachweise und Berichte überstehen die Kontextkomprimierung.</td></tr>
<tr><td><strong>Durch Nachweise belegte Ergebnisse</strong></td><td>Eine typisierte Einreichung bindet jeden validierten Befund an authentifizierte Ausführungsbelege.</td></tr>
<tr><td><strong>Gelenkte Methodik</strong></td><td>Ein Pentest-Orchestrator wählt fokussierte Playbooks für Web, Identität, API, Geschäftslogik, LLM-Sicherheit und Fehlkonfigurationen aus.</td></tr>
<tr><td><strong>Begrenzte Ausführung</strong></td><td>Einzelbefehle, Befehlsstapel, Hintergrundprozesse, Stapelüberprüfung, Heartbeat-Prüfungen und Abbruch teilen sich ein Zustandsmodell.</td></tr>
<tr><td><strong>Verifizierbare Releases</strong></td><td>Plugin-Registrierung, Schemas, Skill-Snapshots, Dokumentationsverträge, Lint, Formatierung und die vollständige Testsuite sind release-gesteuert.</td></tr>
</table>
## Schnellstart
### Profil installieren
```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
```
Guard-Abhängigkeiten werden in `plugins/violin_guard/plugin.yaml` deklariert. Der Plugin-Name, das Verzeichnis und die aktivierte Konfiguration verwenden alle `violin_guard`, sodass Hermes seine Abhängigkeiten ohne einen Verzeichnis-Workaround auflösen kann. Das Installieren von Abhängigkeiten in die Entwicklungs-`.venv` installiert sie nicht in Hermes. Der obige Deaktivieren/Aktivieren-Zyklus erzwingt die Abhängigkeitszulassung, selbst wenn die Profilkonfiguration das Plugin bereits aktiviert. Überprüfen Sie die Registrierung nach der Installation:
```bash
hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list
```
Plugin Doctor sollte 12 Tools und 5 Hooks melden, und `violin_guard` sollte
als aktiviertes Toolset erscheinen. Starte Hermes nach der Installation neu, bevor du ein
Engagement beginnst. Installiere das Profil neu, um eine ältere `violin-guard`-Installation zu migrieren.
Beginne dann mit einem autorisierten Ziel und lass Violin den Scope erfassen, bevor
es zu einer Interaktion mit dem Ziel kommt:
```text
Run an authorized penetration test against example.com.
```
### Voraussetzungen
- [Hermes Agent](https://hermes-agent.nousresearch.com/) 0.21.5 oder neuer (der Container pinnt den Release-Commit `v2026.9.24`)
- Python 3.11 und `uv` für die lokale Entwicklung
- Kali Linux oder Parrot OS für die erwartete Sicherheitswerkzeug-Umgebung
- Schriftliche Autorisierung und ein genehmigter Scope
Violin wählt kein Modell und keinen Anbieter aus. Konfigurieren Sie diese in Hermes. Für
einen leistungsfähigen Standard verwenden Sie **Qwen3.8 27B** lokal oder **DeepSeek V4 Flash** über einen
gehosteten Anbieter.
## Ablauf eines Engagements
```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. Die Engagement-Phase initialisieren und `scope/scope.yaml` genehmigen.
2. Eine aktive PTT-Aufgabe und die zugehörige zugewiesene Skill mit
`violin_record_ptt` auswählen.
3. Zielbefehle mit `violin_exec` oder `violin_exec_burst` ausführen.
4. Hypothesen aktualisieren, wenn neue Erkenntnisse ihren Status ändern.
5. Jeden begrenzten Befehlsstapel mit `violin_review_batch` überprüfen.
6. Validierte Befunde einreichen und den Abschlussbericht erstellen.
7. Die Retrospektive abschließen.
Das vollständige Phasenmodell lautet:
```text
SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
→ POST_EXPLOITATION / PRIVESC / FLAGS
→ REPORTING → RETROSPECTIVE
```
Der Beginn der Arbeit in einer neuen Phase erfordert eine PTT-Aufgabe unter dieser Phase. Bestehende
Aufgaben werden nicht zwischen Phasenabschnitten verschoben.
## Guard-Tools
Das Plugin registriert zwölf Hermes-Tools aus einer typisierten Registry:
| Tool | Zweck |
|---|---|
| `violin_record_ptt` | Eine PTT-Aufgabe erstellen, starten, aktualisieren, schließen oder abbrechen |
| `violin_record_hypothesis` | Eine abgegrenzte Hypothese erstellen oder aktualisieren |
| `violin_submit_finding` | Ein validiertes Finding einreichen, gebunden an seine signierten Ausführungsbelege |
| `violin_exec` | Einen abgesicherten Befehl ausführen |
| `violin_exec_burst` | Eine begrenzte Befehlsdatei ausführen |
| `violin_exec_status` | Den Status der Hintergrundausführung lesen |
| `violin_exec_cancel` | Eine verfolgte Hintergrundausführung abbrechen |
| `violin_review_batch` | Einen abgeschlossenen Batch überprüfen und den Zustand festlegen |
| `violin_rebind_pending_batch` | Einen ausstehenden Batch nach Bestätigung neu binden |
| `violin_heartbeat_done` | Eine abgeschlossene Heartbeat-Überprüfung löschen |
| `violin_target` | Das genehmigte Bewertungsziel auflösen |
| `violin_status` | Aktuelle Aufgaben, Skills und Blocker erläutern |
`violin_exec` ist die generische Grenze für Zielbefehle. Es gibt keine
tool-spezifischen Ausführungsadapter oder Binär-Allowlists. Installierte
nicht-interaktive Tools dürfen erst ausgeführt werden, nachdem die Engagement-Gates bestanden sind.
Der Raw-Terminal-Hook ist ein Best-Effort-Sicherheitsnetz, keine Netzwerk-Isolation.
Verwende `terminal` nur für host-lokale Vorbereitung und Administration.
## Sicherheitsmodell
```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]
```
- Keine Zielinteraktion vor Freigabe des Umfangs und Validierung des Bootstraps.
- Keine direkte Shell-Ausführung für Zielbefehle.
- Keine destruktiven, störenden, auf Anmeldedaten, Persistenz oder Tarnung abzielenden oder Drittanbieter-Aktionen ohne ausdrückliche schriftliche Genehmigung.
- Rohbelege verbleiben unter `$ENG_DIR/evidence/<phase>/`.
- Geheimnisse, Dumps und Proof-Ausgaben bleiben außerhalb von `$ENG_DIR/state/`.
- Die Kontextkomprimierung wird aus den Engagement-Dateien in der aktuellen Hermes-Konversation fortgesetzt.
Die ausführliche Richtlinie ist in
[`skills/pentest/references/standards.md`](https://github.com/strategic-automation/violin/blob/master/skills/pentest/references/standards.md) zu finden.
## Engagement-Status
`init-engagement` erstellt die kanonische Arbeitsstruktur:
```text
$ENG_DIR/
├── scope/
│ └── scope.yaml
├── state/
│ ├── ptt.md
│ ├── history.md
│ └── checkpoint.json
├── hypotheses.md
├── evidence/
├── reporting/
└── retrospective/
```
### Upgrade von Violin 3.3
Violin 4.0 speichert den Executor-Zustand in `state/runtime.json` und migriert
die Dateien `sync.json`, `counts.json` oder `heartbeat.json` aus 3.3 nicht. Starten Sie ein neues
Engagement in einem neuen Verzeichnis; behalten Sie das 3.3-Verzeichnis als historische Aufzeichnung.
Wenn Sie dessen Verzeichnis wiederverwenden, bleiben die Legacy-Zustandsdateien an Ort und Stelle, sodass Violin 4.0
es ablehnen wird.
### Skill-Bereitstellung
Skills werden bei Bedarf geladen. Der erste `violin_record_ptt`-Aufruf für einen gerouteten
Skill kann `skill_prepared` zurückgeben, ohne den PTT zu ändern. Nachdem Hermes
den Skill-Inhalt bereitgestellt hat, wiederholen Sie den Übergang, um die Quittung zu binden und die
Aufgabenänderung anzuwenden. `violin_status` meldet die genaue Wiederherstellungsaktion.
Marker-Dateien wie `.skill-loaded-*` beweisen nicht die Skill-Bereitstellung.
## Geroutete Skills
| Skill | Abdeckung |
|---|---|
| `pentest` | Scope, Lifecycle, Recon, Exploitation, Reporting, Closeout |
| `web-app` | Injection, SSRF, Traversal, Deserialisierung, clientseitige Schwachstellen |
| `identity-auth` | Authentifizierung, Autorisierung, IDOR, JWT, CSRF, Kryptografie |
| `api-testing` | REST, SOAP, GraphQL, WebSocket |
| `business-logic` | Workflow, Preisgestaltung, Coupon, Quota, Referral, Race Conditions |
| `llm-security` | Prompt Injection, MCP, JSON-RPC |
| `misconfig` | Deployment, Fehlerbehandlung, Observability, Obscurity |
Der Orchestrator lädt nur das Phasenmaterial und das Spezialisten-Playbook, die
für die aktuelle Aufgabe benötigt werden.
## Administrative CLI
Die CLI ersetzt nicht die abgesicherte Zielausführung.
```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` stellt Prüfungen bei der Zulassung für Diagnosezwecke bereit und führt den übergebenen Befehl nicht aus.
## Architektur
```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
```
## Benchmarks
Das Repository enthält die Definition des Escape Duck Store sowie bekannte
gute und bekannte schlechte Scorer-Fixtures. Die Kalibrierung belegt, dass der
Scorer diese Fixtures korrekt verarbeitet; sie belegt weder die Recall-Rate bei
Live-Agenten noch die Workflow-Vollständigkeit oder die Berichtsqualität.
```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>
```
Lesen Sie die [Benchmark-Methodik](https://github.com/strategic-automation/violin/blob/master/docs/BENCHMARKS.md), bevor Sie eine Punktzahl veröffentlichen.
Sie definiert die Nachweis-, Reproduzierbarkeits-, private Evaluierungs- und Offenlegungs-
anforderungen für ein glaubwürdiges Ergebnis.
## Entwicklung
```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
```
Das Release-Gate prüft Versionsoberflächen, isolierten Plugin-Import, registrierte
Tools, generierte Schemas, Skill-Snapshots, Dokumentationsverträge, Ruff und
die vollständige Testsuite.
Plattform-Smoke-Tests:
- `scripts/smoke-test.sh` — Linux- und Kali/Parrot-Release-Smoke
- `scripts/smoke-test.ps1` — Windows-Bootstrap-, Scope- und Target-Resolution-
Smoke; Skill-Bereitstellung und Target-Ausführung erfordern Hermes
Siehe [CONTRIBUTING.md](https://github.com/strategic-automation/violin/blob/master/CONTRIBUTING.md) für Beitragsregeln und
[SECURITY.md](https://github.com/strategic-automation/violin/blob/master/SECURITY.md) für die private Meldung von Schwachstellen.
## Verantwortungsvolle Nutzung
Violin ist für autorisierte Sicherheitsbewertungen gedacht. Operatoren sind
verantwortlich für Scope, Genehmigungen, Target-Eigentum, Datenhandhabung und
lokales Recht.
## Violin unterstützen
Violin ist ein Open-Source-Projekt, das von Strategic Automation Ltd. gepflegt wird.
Wenn Violin für Sie oder Ihre Organisation nützlich ist, können Sie
[die weitere Entwicklung sponsern](https://github.com/sponsors/Strategic-Automation).
Sponsoring unterstützt die weitere Entwicklung, Tests, Dokumentation,
Kompatibilitätsarbeit und Releases.
Violin bleibt unter der MIT-Lizenz verfügbar. Sponsoring umfasst keinen
garantierten Support, keine Feature-Priorisierung und keinen Einfluss auf die Sicherheitsrichtlinie.
## Lizenz
MIT — siehe [LICENSE](https://github.com/strategic-automation/violin/blob/master/LICENSE).