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

# कॉन्फ़िग उत्पन्न करें
crucible init --target URL --provider openai --key sk-xxx

# मानक स्कैन चलाएँ
crucible scan \
  --target https://my-agent.com/api/chat \
  --name "My ChatBot" \
  --header "Authorization: Bearer sk-xxx" \
  --timeout 30 \
  --concurrency 5

# पेलोड म्यूटेशन के साथ चलाएँ (WAFs/गार्डरेल्स को बायपास करें)
crucible scan --target URL --mutate

# मल्टी-टर्न हमला रणनीति
crucible scan --target URL --strategy multi-turn

# एजेंट प्रोफाइल का उपयोग करके हमलों को लक्षित करें
crucible profile --target URL --output agent_profile.json
crucible scan --target URL --profile agent_profile.json

# व्यवहारिक अखंडता ऑडिट (मल्टी-टर्न ड्रिफ्ट डिटेक्शन)
crucible behavioral-audit \
  --target https://my-agent.com/api/chat \
  --baseline-turns 5 \
  --probe-turns 15

# स्कैन परिणामों से EU AI Act अनुपालन रिपोर्ट उत्पन्न करें
crucible scan --target URL --output json > results.json
crucible compliance-report --results results.json --output compliance.md

# CI/CD के लिए JSON आउटपुट
crucible scan --target URL --output json > report.json

# स्थानीय मॉडल स्कैनिंग (Ollama, LM Studio, HuggingFace TGI)
crucible scan --target http://localhost:11434 --format-preset ollama --model llama3

# वैश्विक दर सीमा (प्रति सेकंड 2 अनुरोध)
crucible scan --target URL --rate-limit 2

# YAML फ़ाइल के माध्यम से दायरा प्रवर्तन
crucible scan --target URL --scope-file scope.yaml

# टूल पॉइज़निंग, कमांड इंजेक्शन और OAuth स्कोप दुरुपयोग के लिए MCP सर्वर का ऑडिट करें
crucible mcp-scan --server https://my-mcp.example.com

# प्रमाणीकरण हेडर और JSON आउटपुट के साथ
crucible mcp-scan --server http://localhost:3000 \
  --header "Authorization: Bearer sk-xxx" \
  --output mcp-report.json

# सहेजी गई रिपोर्ट को फिर से रेंडर करें
crucible report report.json

# बूटस्ट्रैप सांख्यिकीय विश्वास अंतराल के साथ स्कैन चलाएँ (प्रति हमला 10 रन के साथ 95% CI की गणना)
crucible scan --target URL --confidence --confidence-runs 10

# एक ट्रेस पॉलिसी YAML फ़ाइल को मान्य करें
crucible trace validate-policy policy.yaml

# MCP इंटरसेप्शन और ऑडिटिंग ट्रेस प्रॉक्सी शुरू करें (सादा HTTP)
crucible trace start --listen 8080 --upstream http://localhost:8001 --policy policy.yaml --log audit.jsonl

# देशी TLS समाप्ति के साथ प्रॉक्सी शुरू करें (स्वतः-उत्पन्न सेल्फ-साइनड डेव प्रमाणपत्र)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls-self-signed

# कस्टम प्रमाणपत्र/कुंजी फ़ाइलों का उपयोग करके देशी TLS समाप्ति के साथ प्रॉक्सी शुरू करें
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls --tls-cert cert.pem --tls-key key.pem

# ट्रेस ऑडिट लॉग फ़ाइल से सारांश रिपोर्ट रेंडर करें
crucible trace report audit.jsonl

# Semantic Anchor इंजेक्शन (तकनीक 1) का उपयोग करके जहरीला दस्तावेज़ रोपित करें
crucible poison-test plant --topic "company secrets" --technique 1 --output secret.txt

# एंड-टू-एंड स्वचालित प्लांट-एंड-क्वेरी RAG पॉइज़निंग जीवनचक्र चलाएँ
crucible poison-test rag --ingest-url http://api/ingest --query-url http://api/query --topic "finances"

# सक्रिय पॉइज़निंग मूल्यांकन सत्रों की सूची बनाएं
crucible poison-test list

# किसी विशिष्ट पॉइज़निंग सत्र की स्थिति जांचें
crucible poison-test status <session-id>

# सभी 12 संदर्भ लक्ष्यों की सूची बनाएं (6 कमजोर, 6 कठोर)
crucible target list

# एक विशिष्ट संदर्भ लक्ष्य प्रारंभ करें (जैसे sql_vulnerable) पोर्ट 9000 पर
crucible target start --name sql_vulnerable --port 9000

# सभी 12 लक्ष्यों को स्पिन करें, स्वास्थ्य और ग्राउंड-ट्रुथ सत्यापन चलाएँ, 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 # अगर ग्रेड C, D या F है तो वर्कफ़्लो फेल करता है

crucible/
  models.py                    # Pydantic डेटा मॉडल
  cli.py                       # Typer CLI (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # BaseAttack ABC
    prompt_injection.py        # 50 हमला वैक्टर
    goal_hijacking.py          # 20 हमला वैक्टर
    jailbreaks.py              # 20 हमला वैक्टर
    enterprise_graph.py        # क्रॉस-एजेंट ट्रस्ट हमले
    memory_poisoning.py        # स्थायी स्थिति हमले
    behavioral_escalation.py   # मल्टी-टर्न एस्केलेशन अनुक्रम (v0.3)
    multi_turn_strategies.py   # Crescendo और Context Confusion (v0.3)
    profile_templates/         # एजेंट प्रकार पहचान टेम्पलेट (v0.3)
    multi_agent_contagion.py   # क्रॉस-एजेंट ट्रस्ट हमले (v0.4)
    dynamic_generator.py       # रिसर्च-संचालित हमला जनरेटर (v0.4)
    hallucination.py           # 15 hallucination/overreliance हमले (v0.5)
    toxicity.py                # 20 toxicity/safety हमले (v0.5)
  modules/
    base.py                    # BaseModule ABC
    security.py                # मॉड्यूल रजिस्ट्री
  core/
    runner.py                  # Async समानांतर स्कैन इंजन (anyio)
    scorer.py                  # कटौती-आधारित स्कोरिंग + ग्रेडिंग
    mutation_engine.py         # पेलोड अस्पष्टता (6 रणनीतियाँ)
    behavioral_engine.py       # मल्टी-टर्न व्यवहारिक बहाव इंजन (v0.3)
    multi_turn_engine.py       # मल्टी-टर्न हमला रनर (v0.3)
    profiler.py                # एजेंट क्षमता प्रोफाइलर (v0.3)
    compliance_engine.py       # EU AI Act मैपिंग इंजन (v0.3)
    reporter.py                # बग बाउंटी रिपोर्ट जनरेटर
    cache.py                   # TTL-आधारित स्कैन परिणाम कैश
    research_engine.py         # स्वायत्त अनुसंधान ऑर्केस्ट्रेटर (v0.4)
    patcher.py                 # स्वतः-सुधार इंजन (v0.4)
    canary.py                  # सक्रिय धोखा कैनरी (v0.4)
    statistics.py              # शून्य-निर्भरता बूटस्ट्रैप विश्वास इंजन (v0.6.1)
  reporters/
    base.py                    # BaseReporter ABC
    terminal.py                # Rich टर्मिनल रेंडरर
    json_reporter.py           # JSON फ़ाइल एक्सपोर्टर
    html_reporter.py           # इंटरैक्टिव HTML रिपोर्ट
    slack.py                   # Slack वेबहुक रिपोर्टर
    compliance_reporter.py     # अनुपालन Markdown/JSON रिपोर्टर (v0.3)
    huntr_reporter.py          # बग बाउंटी सबमिशन रिपोर्टर (v0.4)
    sarif_reporter.py          # परिणामों को SARIF 2.1.0 में निर्यात करें (v0.5)
    atlas_reporter.py          # MITRE ATLAS अनुपालन मैपर (v0.6)
    nist_reporter.py           # NIST AI RMF अनुपालन मैपर (v0.6)
  poison/                      # स्टेटफुल मेमोरी और RAG पॉइज़निंग पैकेज (v0.8.0)
    session_store.py           # परमाणु JSON पॉइज़निंग सत्र स्टोर
    document_generator.py      # 4 विरोधी रोपण तकनीकों को लागू करें
  trace/                       # MCP टूल-कॉल इंटरसेप्शन और पॉलिसी प्रॉक्सी (v0.7.0)
    models.py                  # Pydantic ट्रेस मॉडल
    policy.py                  # YAML नियम-आधारित मूल्यांकन इंजन
    audit_log.py               # अपेंड-ओनली थ्रेड-सुरक्षित JSONL लॉगर
    proxy.py                   # Async TCP रिवर्स प्रॉक्सी using anyio & h11
  targets/                     # ग्राउंड-ट्रुथ मूल्यांकन के लिए संदर्भ लक्ष्य सूट (v0.18.0)
    base_target.py             # Python मानक पुस्तकालय का उपयोग करके अमूर्त आधार HTTP लक्ष्य
    registry.py                # नामों को कक्षाओं से मैप करने वाली केंद्रीय लक्ष्य रजिस्ट्री
    runner.py                  # लक्ष्यों को साफ-सुथरे ढंग से शुरू और बंद करने के लिए कॉन्टेक्स्ट-मैनेजर

✗ Preflight failed: Target returned 405 Method Not Allowed.
  You specified --method GET but this endpoint requires POST.
  Re-run without --method GET or use --skip-preflight to bypass this check.