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

# Вывод JSON для CI/CD
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

# Аудит 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

# Запустить сканирование с bootstrap-доверительными интервалами (расчёт 95% CI с 10 запусками на атаку)
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-завершением (автоматически сгенерированный самоподписанный dev-сертификат)
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

# Запустить полный автоматизированный жизненный цикл plant-and-query для отравления 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 целей, выполнить проверку здоровья и ground-truth валидацию, записать 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 # Прерывает workflow, если оценка C, D или F

crucible/
  models.py                    # Модели данных Pydantic
  cli.py                       # CLI на Typer (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # Базовый класс атаки 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                    # Базовый класс модуля 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                # Генератор отчётов для программы bug bounty
    cache.py                   # Кэш результатов сканирования с TTL
    research_engine.py         # Автономный оркестратор исследований (v0.4)
    patcher.py                 # Движок автоматического исправления (v0.4)
    canary.py                  # Активные обманные «канарейки» (v0.4)
    statistics.py              # Движок bootstrap-доверия без зависимостей (v0.6.1)
  reporters/
    base.py                    # Базовый класс репортёра 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          # Репортёр для отправки в программы bug bounty (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                   # Асинхронный TCP-reverse proxy на anyio и h11
  targets/                     # Набор эталонных целей для оценки ground-truth (v0.18.0)
    base_target.py             # Абстрактная базовая HTTP-цель с использованием стандартной библиотеки Python
    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.