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

# Genera configurazione
crucible init --target URL --provider openai --key sk-xxx

# Esegue una scansione standard
crucible scan \
  --target https://my-agent.com/api/chat \
  --name "My ChatBot" \
  --header "Authorization: Bearer sk-xxx" \
  --timeout 30 \
  --concurrency 5

# Esegue con mutazione dei payload (bypass WAF/guardrail)
crucible scan --target URL --mutate

# Strategia di attacco multi-turn
crucible scan --target URL --strategy multi-turn

# Usa profilo agente per indirizzare gli attacchi
crucible profile --target URL --output agent_profile.json
crucible scan --target URL --profile agent_profile.json

# Audit di integrità comportamentale (rilevamento deriva multi-turn)
crucible behavioral-audit \
  --target https://my-agent.com/api/chat \
  --baseline-turns 5 \
  --probe-turns 15

# Genera report di conformità EU AI Act dai risultati della scansione
crucible scan --target URL --output json > results.json
crucible compliance-report --results results.json --output compliance.md

# Output JSON per CI/CD
crucible scan --target URL --output json > report.json

# Scansione modello locale (Ollama, LM Studio, HuggingFace TGI)
crucible scan --target http://localhost:11434 --format-preset ollama --model llama3

# Limitazione globale della frequenza (2 richieste al secondo)
crucible scan --target URL --rate-limit 2

# Applicazione dello scopo tramite file YAML
crucible scan --target URL --scope-file scope.yaml

# Esegue audit di un server MCP per avvelenamento degli strumenti, iniezione di comandi e abuso ambito OAuth
crucible mcp-scan --server https://my-mcp.example.com

# Con header di autenticazione e output JSON
crucible mcp-scan --server http://localhost:3000 \
  --header "Authorization: Bearer sk-xxx" \
  --output mcp-report.json

# Rende nuovamente un report salvato
crucible report report.json

# Esegue scansione con intervalli di confidenza statistica bootstrap (calcola IC al 95% con 10 esecuzioni per attacco)
crucible scan --target URL --confidence --confidence-runs 10

# Valida un file YAML di policy di tracciamento
crucible trace validate-policy policy.yaml

# Avvia il proxy di tracciamento per intercettazione e audit MCP (HTTP semplice)
crucible trace start --listen 8080 --upstream http://localhost:8001 --policy policy.yaml --log audit.jsonl

# Avvia il proxy con terminazione TLS nativa (certificato di sviluppo self-signed generato automaticamente)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls-self-signed

# Avvia il proxy con terminazione TLS nativa (usando file di certificato/chiave personalizzati)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls --tls-cert cert.pem --tls-key key.pem

# Produce un report riassuntivo da un file di log di audit di tracciamento
crucible trace report audit.jsonl

# Pianta un documento avvelenato usando l'iniezione Semantic Anchor (Tecnica 1)
crucible poison-test plant --topic "company secrets" --technique 1 --output secret.txt

# Esegue il ciclo di vita end-to-end automatico pianta-e-query per avvelenamento RAG
crucible poison-test rag --ingest-url http://api/ingest --query-url http://api/query --topic "finances"

# Elenca le sessioni di valutazione di avvelenamento attive
crucible poison-test list

# Controlla lo stato di una specifica sessione di avvelenamento
crucible poison-test status <session-id>

# Elenca tutti i 12 target di riferimento (6 vulnerabili, 6 induriti)
crucible target list

# Avvia un target di riferimento specifico (es. sql_vulnerable) sulla porta 9000
crucible target start --name sql_vulnerable --port 9000

# Accende tutti i 12 target, esegue health e validazione ground-truth, scrive report JSON
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 # Fa fallire il workflow se il voto è C, D o F

crucible/
  models.py                    # Modelli dati Pydantic
  cli.py                       # CLI Typer (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # Classe astratta BaseAttack
    prompt_injection.py        # 50 vettori di attacco
    goal_hijacking.py          # 20 vettori di attacco
    jailbreaks.py              # 20 vettori di attacco
    enterprise_graph.py        # Attacchi di fiducia cross-agente
    memory_poisoning.py        # Attacchi allo stato persistente
    behavioral_escalation.py   # Sequenze di escalation multi-turn (v0.3)
    multi_turn_strategies.py   # Crescendo & Confusione di contesto (v0.3)
    profile_templates/         # Template di rilevamento tipo agente (v0.3)
    multi_agent_contagion.py   # Attacchi di fiducia cross-agente (v0.4)
    dynamic_generator.py       # Generazione attacchi guidata da ricerca (v0.4)
    hallucination.py           # 15 attacchi di allucinazione/eccessiva dipendenza (v0.5)
    toxicity.py                # 20 attacchi di tossicità/sicurezza (v0.5)
  modules/
    base.py                    # Classe astratta BaseModule
    security.py                # Registro dei moduli
  core/
    runner.py                  # Motore di scansione parallela asincrona (anyio)
    scorer.py                  # Punteggio basato su decurtazione + valutazione
    mutation_engine.py         # Offuscamento payload (6 strategie)
    behavioral_engine.py       # Motore di deriva comportamentale multi-turn (v0.3)
    multi_turn_engine.py       # Esecuzione attacchi multi-turn (v0.3)
    profiler.py                # Profilatore di capacità agente (v0.3)
    compliance_engine.py       # Motore di mappatura EU AI Act (v0.3)
    reporter.py                # Generatore report bug bounty
    cache.py                   # Cache dei risultati di scansione con TTL
    research_engine.py         # Orchestratore di ricerca autonoma (v0.4)
    patcher.py                 # Motore di auto-riparazione (v0.4)
    canary.py                  # Canarini di inganno attivo (v0.4)
    statistics.py              # Motore di confidenza bootstrap senza dipendenze (v0.6.1)
  reporters/
    base.py                    # Classe astratta BaseReporter
    terminal.py                # Renderer terminale Rich
    json_reporter.py           # Esportatore file JSON
    html_reporter.py           # Report HTML interattivo
    slack.py                   # Reporter webhook Slack
    compliance_reporter.py     # Reporter conformità Markdown/JSON (v0.3)
    huntr_reporter.py          # Reporter invio bug bounty (v0.4)
    sarif_reporter.py          # Esportazione risultati in SARIF 2.1.0 (v0.5)
    atlas_reporter.py          # Mappatore conformità MITRE ATLAS (v0.6)
    nist_reporter.py           # Mappatore conformità NIST AI RMF (v0.6)
  poison/                      # Pacchetto avvelenamento memoria e RAG con stato (v0.8.0)
    session_store.py           # Archivio sessioni avvelenamento JSON atomico
    document_generator.py      # Implementa 4 tecniche di impianto avversario
  trace/                       # Proxy di policy e intercettazione chiamate strumento MCP (v0.7.0)
    models.py                  # Modelli di tracciamento Pydantic
    policy.py                  # Motore di valutazione basato su regole YAML
    audit_log.py               # Logger JSONL thread-safe append-only
    proxy.py                   # Proxy inverso TCP asincrono usando anyio e h11
  targets/                     # Suite di target di riferimento per valutazione ground-truth (v0.18.0)
    base_target.py             # Target HTTP base astratto usando libreria standard Python
    registry.py                # Registro centrale dei target che mappa nomi a classi
    runner.py                  # Gestore di contesto per avviare e fermare i target in modo pulito

✗ Preflight fallito: Il target ha restituito 405 Method Not Allowed.
  Hai specificato --method GET ma questo endpoint richiede POST.
  Esegui di nuovo senza --method GET o usa --skip-preflight per bypassare questo controllo.