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

# ペイロードミューテーションを有効にして実行（WAF/ガードレールを回避）
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

# グローバルレート制限（1秒あたり2リクエスト）
crucible scan --target URL --rate-limit 2

# YAMLファイルによるスコープ強制
crucible scan --target URL --scope-file scope.yaml

# MCPサーバーのツールポイズニング、コマンドインジェクション、OAuthスコープ乱用を監査
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の幻覚/過信頼攻撃 (v0.5)
    toxicity.py                # 20の有害性/安全性攻撃 (v0.5)
  modules/
    base.py                    # BaseModule ABC
    security.py                # モジュールレジストリ
  core/
    runner.py                  # 非同期並列スキャンエンジン (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                   # anyio & h11を使用した非同期TCPリバースプロキシ
  targets/                     # グラウンドトゥルース評価用リファレンスターゲットスイート (v0.18.0)
    base_target.py             # Python標準ライブラリを使用した抽象ベースHTTPターゲット
    registry.py                # 名前をクラスにマッピングする中央ターゲットレジストリ
    runner.py                  # ターゲットをクリーンに開始/停止するためのコンテキストマネージャー

✗ プリフライト失敗: ターゲットが405 Method Not Allowedを返しました。
  --method GET を指定しましたが、このエンドポイントはPOSTを要求します。
  --method GET を指定せずに再実行するか、--skip-preflight を使用してこのチェックをバイパスしてください。