crucible

   ██████╗██████╗ ██╗   ██╗ ██████╗██╗██████╗ ██╗     ███████╗
  ██╔════╝██╔══██╗██║   ██║██╔════╝██║██╔══██╗██║     ██╔════╝
  ██║     ██████╔╝██║   ██║██║     ██║██████╔╝██║     █████╗
  ██║     ██╔══██╗██║   ██║██║     ██║██╔══██╗██║     ██╔══╝
  ╚██████╗██║  ██║╚██████╔╝╚██████╗██║██████╔╝███████╗███████╗
   ╚═════╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝╚═╝╚═════╝ ╚══════╝╚══════╝
  

pip install crucible-security

crucible init --target https://my-agent.com/api/chat
crucible scan --target https://my-agent.com/api/chat
crucible report crucible-report.json

python examples/test_langchain_agent.py

python examples/test_openai_assistant.py

# Konfiguration generieren
crucible init --target URL --provider openai --key sk-xxx

# Standard-Scan ausführen
crucible scan \
  --target https://my-agent.com/api/chat \
  --name "My ChatBot" \
  --header "Authorization: Bearer sk-xxx" \
  --timeout 30 \
  --concurrency 5

# Scan mit Payload-Mutation (WAFs/Guardrails umgehen)
crucible scan --target URL --mutate

# Multi-Turn-Angriffsstrategie
crucible scan --target URL --strategy multi-turn

# Agentenprofil verwenden, um Angriffe zu steuern
crucible profile --target URL --output agent_profile.json
crucible scan --target URL --profile agent_profile.json

# Verhaltensintegritätsaudit (Multi-Turn-Drifterkennung)
crucible behavioral-audit \
  --target https://my-agent.com/api/chat \
  --baseline-turns 5 \
  --probe-turns 15

# EU AI Act-Compliance-Bericht aus Scan-Ergebnissen generieren
crucible scan --target URL --output json > results.json
crucible compliance-report --results results.json --output compliance.md

# JSON-Ausgabe für CI/CD
crucible scan --target URL --output json > report.json

# Scannen lokaler Modelle (Ollama, LM Studio, HuggingFace TGI)
crucible scan --target http://localhost:11434 --format-preset ollama --model llama3

# Globales Ratenlimit (2 Anfragen pro Sekunde)
crucible scan --target URL --rate-limit 2

# Bereichsdurchsetzung über YAML-Datei
crucible scan --target URL --scope-file scope.yaml

# Audit eines MCP-Servers auf Tool-Poisoning, Command Injection und OAuth-Scope-Missbrauch
crucible mcp-scan --server https://my-mcp.example.com

# Mit Auth-Header und JSON-Ausgabe
crucible mcp-scan --server http://localhost:3000 \
  --header "Authorization: Bearer sk-xxx" \
  --output mcp-report.json

# Gespeicherten Bericht neu rendern
crucible report report.json

# Scan mit Bootstrap-Statistik-Konfidenzintervallen ausführen (95%-KI mit 10 Durchläufen pro Angriff berechnen)
crucible scan --target URL --confidence --confidence-runs 10

# Trace-Policy-YAML-Datei validieren
crucible trace validate-policy policy.yaml

# MCP-Interception- und Audit-Trace-Proxy starten (einfaches HTTP)
crucible trace start --listen 8080 --upstream http://localhost:8001 --policy policy.yaml --log audit.jsonl

# Proxy mit nativer TLS-Terminierung starten (automatisch generiertes selbstsigniertes Dev-Zertifikat)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls-self-signed

# Proxy mit nativer TLS-Terminierung starten (benutzerdefinierte Zertifikat-/Schlüsseldateien)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls --tls-cert cert.pem --tls-key key.pem

# Zusammenfassenden Bericht aus einer Trace-Audit-Log-Datei rendern
crucible trace report audit.jsonl

# Ein vergiftetes Dokument mit Semantic Anchor Injection pflanzen (Technik 1)
crucible poison-test plant --topic "company secrets" --technique 1 --output secret.txt

# End-to-End automatisierten Plant-and-Query-RAG-Vergiftungslebenszyklus ausführen
crucible poison-test rag --ingest-url http://api/ingest --query-url http://api/query --topic "finances"

# Aktive Vergiftungsbewertungssitzungen auflisten
crucible poison-test list

# Status einer bestimmten Vergiftungssitzung prüfen
crucible poison-test status <session-id>

# Alle 12 Referenzziele auflisten (6 verwundbar, 6 gehärtet)
crucible target list

# Ein bestimmtes Referenzziel starten (z. B. sql_vulnerable) auf Port 9000
crucible target start --name sql_vulnerable --port 9000

# Alle 12 Ziele hochfahren, Health- & Ground-Truth-Validierung durchführen, JSON-Bericht schreiben
crucible target validate --output ground_truth_report.json

# .github/workflows/security.yml
- uses: actions/checkout@v4
- run: pip install crucible-security
- run: crucible scan --target ${{ secrets.AGENT_URL }} --fail-on CRITICAL

- name: Crucible Security Scan
  uses: crucible-security/[email protected]
  with:
    target: ${{ secrets.AGENT_URL }}
    format_preset: openai
    model: gpt-4o
    headers: '{"Authorization": "Bearer ${{ secrets.OPENAI_API_KEY }}"}'
    fail_on_grade: C # Fails workflow if grade is C, D, or F

crucible/
  models.py                    # Pydantic-Datenmodelle
  cli.py                       # Typer-CLI (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # BaseAttack ABC
    prompt_injection.py        # 50 Angriffsvektoren
    goal_hijacking.py          # 20 Angriffsvektoren
    jailbreaks.py              # 20 Angriffsvektoren
    enterprise_graph.py        # Cross-Agent Trust Attacks
    memory_poisoning.py        # Persistente Zustandsangriffe
    behavioral_escalation.py   # Multi-Turn-Eskalationssequenzen (v0.3)
    multi_turn_strategies.py   # Crescendo & Context Confusion (v0.3)
    profile_templates/         # Agententyperkennungsvorlagen (v0.3)
    multi_agent_contagion.py   # Cross-Agent Trust Attacks (v0.4)
    dynamic_generator.py       # Forschungsgesteuerte Angriffsgenerierung (v0.4)
    hallucination.py           # 15 Halluzinations-/Overreliance-Angriffe (v0.5)
    toxicity.py                # 20 Toxizitäts-/Sicherheitsangriffe (v0.5)
  modules/
    base.py                    # BaseModule ABC
    security.py                # Modulregistrierung
  core/
    runner.py                  # Async parallele Scan-Engine (anyio)
    scorer.py                  # Abzugsbasierte Bewertung + Notengebung
    mutation_engine.py         # Payload-Verschleierung (6 Strategien)
    behavioral_engine.py       # Multi-Turn Behavioral Drift Engine (v0.3)
    multi_turn_engine.py       # Multi-Turn-Angriffs-Runner (v0.3)
    profiler.py                # Agentenfähigkeitsprofiler (v0.3)
    compliance_engine.py       # EU AI Act Mapping Engine (v0.3)
    reporter.py                # Bug-Bounty-Berichtsgenerator
    cache.py                   # TTL-basierter Scan-Ergebnis-Cache
    research_engine.py         # Autonomer Forschungsorchestrator (v0.4)
    patcher.py                 # Auto-Remediation-Engine (v0.4)
    canary.py                  # Aktive Täuschungskanarienvögel (v0.4)
    statistics.py              # Null-Abhängigkeits-Bootstrap-Konfidenz-Engine (v0.6.1)
  reporters/
    base.py                    # BaseReporter ABC
    terminal.py                # Rich-Terminal-Renderer
    json_reporter.py           # JSON-Datei-Exporter
    html_reporter.py           # Interaktiver HTML-Bericht
    slack.py                   # Slack-Webhook-Reporter
    compliance_reporter.py     # Compliance-Markdown/JSON-Reporter (v0.3)
    huntr_reporter.py          # Bug-Bounty-Einreichungsreporter (v0.4)
    sarif_reporter.py          # Ergebnisse in SARIF 2.1.0 exportieren (v0.5)
    atlas_reporter.py          # MITRE ATLAS Compliance Mapper (v0.6)
    nist_reporter.py           # NIST AI RMF Compliance Mapper (v0.6)
  poison/                      # Zustandsbehaftete Speicher- & RAG-Vergiftungspaket (v0.8.0)
    session_store.py           # Atomarer JSON-Vergiftungssitzungsspeicher
    document_generator.py      # Implementiert 4 adversarielle Pflanztechniken
  trace/                       # MCP-Tool-Abruf-Interception & Policy-Proxy (v0.7.0)
    models.py                  # Pydantic-Trace-Modelle
    policy.py                  # YAML-Regelbasierte Bewertungs-Engine
    audit_log.py               # Append-Only Thread-sicherer JSONL-Logger
    proxy.py                   # Async TCP-Reverse-Proxy mit anyio & h11
  targets/                     # Referenzziel-Suite für Ground-Truth-Evaluierung (v0.18.0)
    base_target.py             # Abstraktes Base-HTTP-Ziel mit Python-Standardbibliothek
    registry.py                # Zentrales Zielverzeichnis, das Namen auf Klassen abbildet
    runner.py                  # Context-Manager zum sauberen Starten und Stoppen von Zielen

✗ Preflight fehlgeschlagen: Ziel gab 405 Method Not Allowed zurück.
  Sie haben --method GET angegeben, aber dieser Endpunkt erfordert POST.
  Führen Sie erneut ohne --method GET aus oder verwenden Sie --skip-preflight, um diese Prüfung zu umgehen.