---

⚠️ Rechtlicher Hinweis

Guardian ist ausschließlich für autorisierte Sicherheitstests und Bildungszwecke konzipiert.

• ✅ Rechtmäßige Nutzung: Autorisierte Penetrationstests, Sicherheitsforschung, Bildungsumgebungen
• ❌ Rechtswidrige Nutzung: Unautorisierter Zugriff, böswillige Aktivitäten, jede Form von Cyberangriff

Sie sind vollständig dafür verantwortlich, sicherzustellen, dass Sie vor dem Testen eines Systems eine ausdrückliche schriftliche Genehmigung haben. Der unbefugte Zugriff auf Computersysteme ist gesetzeswidrig, einschließlich des Computer Fraud and Abuse Act (CFAA), der DSGVO und gleichwertiger internationaler Gesetze.

Durch die Nutzung von Guardian erklären Sie sich damit einverstanden, es nur auf Systemen zu verwenden, die Ihnen gehören oder für die Sie eine ausdrückliche Testgenehmigung haben.

---

✨ Funktionen

🤖 Multi-Anbieter-KI-Intelligenz

• 7 KI-Anbieter unterstützt: OpenAI (GPT-4o), Anthropic (Claude), Google (Gemini), OpenRouter, Requesty, Ollama (lokal), OpenAI-kompatibel (vLLM, LM Studio, Together, Groq)
• Plugin-Anbietervertrag: Drittanbieter liefern über [project.entry-points."guardian.providers"] aus – kein Fork erforderlich
• Multi-Agent-Architektur: Spezialisierte KI-Agenten (Planer, Werkzeugauswähler, Analyst, Berichterstatter) plus Debattentriage-Rollen (Roter Anwalt, Blauer Anwalt, Richter) und visuelle Triage
• Multi-Agent-Debattentriage: Drei-Rollen-Debatte (rot/blau/Richter) bei mehrdeutigen Befunden – F1 ≥ Einzelagent-Baseline +5 Prozentpunkte
• Vision-LLM-visuelle Triage: Kopfzeilenlose Bildschirmaufnahme + bildgestützte Analystenanreicherung über gpt-4o / Claude 3.5+ / Gemini 1.5+
• RAG-Wissensdatenbank: SQLite + FTS5-gestützte Abfrage über CVE / CWE / MITRE ATT&CK-Feeds – unterdrückt halluzinierte CVE-Referenzen
• Richtermodell-Routing: think_deeply-Austausch-und-Wiederherstellung – großes Modell denkt, kleines Modell bewertet, ~10-fache Kostenreduzierung
• Gelernte Werkzeugauswahl: Offline-Rangfolge, trainiert auf Sitzungstelemetrie; enthält sich bei geringem Vertrauen und fällt auf LLM-Auswahl zurück
• Adaptives Testen: KI passt Taktiken basierend auf entdeckten Schwachstellen und vorherigen Werkzeugerträgen an
• Fehlalarmfilterung: Debattentriage reduziert Rauschen; günstiger Pfad wird übersprungen, wenn fp_probability entscheidend ist

🛠️ Umfangreiches Werkzeugarsenal

50 integrierte Sicherheitstools in 10 Kategorien:

Kategorie	Tools
Netzwerk	nmap, masscan
Web-Erkundung	httpx, whatweb, wafw00f, cmseek
Subdomain / DNS	subfinder, amass, dnsrecon
Schwachstellenscanning	nuclei, nikto, sqlmap, wpscan
SSL/TLS-Tests	testssl, sslyze
Inhaltserkennung	gobuster, ffuf, arjun
Sicherheitsanalyse	xsstrike, gitleaks
Cloud / Container / SBOM	trivy, grype, syft, scoutsuite, prowler, kube-bench
Moderne Web + OSINT	graphw00f, clairvoyance, jwt_tool, shodan, theharvester
SAST + Secrets (B11)	semgrep, trufflehog, dependency-check
API-Fuzzer (B10)	schemathesis, cariddi, restler
Burp/ZAP-Brücke (B13)	zap, burp
LLM-Red-Team (B12)	garak, pyrit, prompt_fuzz
Mobil Android (B9)	mobsf, apkleaks, objection
Active Directory (B8)	crackmapexec, bloodhound, kerbrute, impacket-secretsdump
Visuelle Beweise (A3)	playwright_screenshot

📊 Verbesserte Beweiserfassung

• Ausführungsrückverfolgbarkeit: Jeder Fund ist mit seiner Quellwerkzeugausführung über execution_id verknüpft
• Vollständiger Befehlsverlauf: Gesamte Werkzeugausgabe wird mit jedem Fund gespeichert
• Rohe Beweisspeicherung: Ausgabeausschnitte sind an Funde gebunden
• Visuelle Beweise: Screenshots pro URL aufgenommen und an Web-Funde angehängt
• Sitzungswiederherstellung: Atomar geprüfte session_<id>.json ermöglicht --resume

🔄 Intelligentes Workflow-System (DSL v2)

• DAG-Planer: Schritte mit depends_on werden parallel bis zu max_parallel_tools ausgeführt
• Jinja2-Vorlagen (sandboxed): parameters: {key: "{{ <id>.parsed.alive_hosts }}"} löst Abhängigkeiten von vorherigen Schrittergebnissen auf
• Bedingte Schritte: when:-Klauseln steuern die Ausführung basierend auf vorheriger Ausgabe
• Fortsetzen: --resume setzt nach dem letzten abgeschlossenen Schritt fort
• Parameterpriorität: Workflow-YAML > Konfigurationsblock > Tool-Standardwerte
• Benutzerdefinierte Agenten: agent: debate | visual | analyst auf Analyseschritten
• Mehrere Berichtsformate: Markdown, HTML, JSON

📤 Ausgabeintegrationen (B14)

• SARIF v2.1.0: GitHub-kompatibel, enthält security-severity, Dedup fingerprints von execution_id
• DefectDojo: Direkter REST-Upload
• Slack: Webhook-Post mit farbcodiertem Schweregrad
• Ausgelöst über: guardian report --export sarif --export defectdojo --export slack

🔒 Sicherheit & Compliance

• DNS-aufgelöste Bereichsvalidierung: Schließt SSRF-Klasse-Bypass; private RFC1918-Bereiche sind blockiert
• Prompt-Injection-Abwehr: Alle Werkzeugausgaben werden über <UNTRUSTED_TOOL_OUTPUT>-Begrenzer + ANSI-Entfernung verpackt
• API-Schlüssel-Scrubbing: Protokolle und Berichte schwärzen Geheimnisse beim Schreiben
• Bestätigungsgate: Aktive+ Tools (intrusiv/destruktiv) erfordern explizite Benutzerbestätigung
• Audit-Protokollierung: Rotierende Protokolle jeder KI-Entscheidung und -Aktion
• Sicherer Modus: Verhindert destruktive Aktionen standardmäßig

📋 Professionelle Berichterstattung

• CVSS v3.1-Neuberechnung: Validiert behauptete Punktzahlen anhand der Vektormathematik; flaggt Abweichungen
• Zusammenfassungen für Führungskräfte: Nicht-technische Übersichten
• Technische Tiefenbohrungen: Befunde mit Beweisen, CVSS, CWE, CVE, MITRE-Technik
• KI-Entscheidungsabläufe: Token-Nutzung, Kosten, Denkkette-Buchhaltung pro Agent
• Visuelle Triage-Abschnitte: Bildgestützte Anreicherung in Beschreibungen eingebettet

⚡ Leistung & Effizienz

• Durchgängig asynchron: Tool-Ausführung über asyncio-Subprozess; Agenten asynchron
• Lazy Tool Loading: 50 Tools registriert, keines importiert bis benötigt – --help bleibt unter 500ms
• Parallele DAG-Ausführung: Unabhängige Schritte laufen gleichzeitig pro Generation
• Workflow-Automatisierung: 13+ mitgelieferte Workflows (Recon, Web, Netzwerk, AD, Mobil, LLM-Red-Team, SAST, API)

---

📋 Voraussetzungen

Erforderlich