Тема v4: любой артефакт — включая модели с инференсом — исполняется в единой изолированной (Kata) песочнице с ловушками и обязательным наблюдением; движки инференса подключаются как данные под тип артефакта; проверки — расширяемые «пакеты тестов»; вердикт выдаётся по управляемой (скоринговой) политике.
Документ описывает архитектурное решение (не отчёт о реализации). Основной код остаётся в
deploy/, poc/, tests/; здесь — архитектура и контракты, по которым её реализуют.
Опирается на факты текущего стенда: CrossProcess_overview.md
(сквозные процессы и области наблюдения / открытые зоны), Arch_v3/19-implementation-as-built.md
(as-built v3), deploy/tenant/STATUS.md.
v3 уже умеет: запускать артефакт в Kata (сканы), поднимать недоверенный движок инференса
(vLLM / SGLang / llama.cpp) и получать вердикт bundle с аттестацией. Но в v3 остаются три
принципиальных расхождения с целевой моделью:
| Проблема v3 | Следствие | Что делает v4 |
|---|---|---|
LLM-инференс идёт в runtimeClassName: nvidia (хостовое ядро, микро-ВМ нет) |
движок и модель исполняются вне микро-ВМ; изоляция только seccomp/non-root | все движки (включая GPU-инференс) — в Kata (kata-gpu); хост-путь запрещён admission-политикой |
Наблюдение за инференсом фактически отключено (eBPF-сенсор SANDBOX_EBPF/LLM_TEST_EBPF=0), honeypots только для сканов |
поведение LLM/движка не наблюдается | обязательный in-guest observer (eBPF + harness) и общий набор ловушек для всех job'ов |
Тесты и вердикт зашиты в код (порог 90/75/50, наборы вопросов, правила в evaluators.py) |
нельзя расширять/управлять без правки и пересборки | TestPack — декларативные расширяемые тесты; Policy — управляемое скоринг/правило вердикта (редактор + симулятор) |
- Единый периметр доверия. Любой недоверенный код (артефакт и движок) исполняется только
внутри Kata-микро-ВМ. Хост-исполнение артефактов/движков запрещено; допустимые RuntimeClass —
только Kata-варианты (
kata,kata-btf,kata-gpu). - Одна песочница на все типы. Различия артефактов выражаются движком (EngineDescriptor) и пакетом тестов (TestPack), а не разной изоляцией.
- Ловушки и наблюдение — всегда. Для каждого job'а монтируются honeypot/traps и запускается
observer; «нет наблюдения» ⇒ вердикт
Inconclusiveи запретSafe. - Расширяемость без правки ядра. Новый движок/тест/детектор/правило подключается как данные (подписанные записи реестра), а не как патч платформы.
- Вердикт — функция политики. Скоринг и правила вердикта версионируются, подписываются, воспроизводимы и симулируемы до публикации.
- Воспроизводимость.
bundleфиксирует: digest артефакта + digest движка + версию TestPack + версию Policy + конфигурацию наблюдения; всё записывается и аттестуется.
| Док. | Содержание |
|---|---|
00-overview.md |
Цели, принципы, высокоуровневая схема, словарь, отличия v3→v4 |
01-unified-sandbox.md |
Единая Kata-песочница (в т.ч. GPU-в-Kata), состав пода, ловушки, сеть, ресурсы, деградация |
02-engine-framework.md |
Движок как данные: EngineDescriptor, адаптеры, реестр, матрица «тип артефакта × движок» |
03-test-framework.md |
Расширяемые тесты: TestPack, шаги/плагины, датасеты, произвольное взаимодействие с инференсом, запись/реплей |
04-observation.md |
Обязательное наблюдение: eBPF/Tetragon + harness + ловушки, покрытие, события, свидетельства |
05-verdict-scoring.md |
Скоринг и инструмент управления критериями вердикта (редактор + симулятор + публикация) |
06-contracts.md |
Контракты: SandboxJobSpec, EngineDescriptor, TestPack, Event, Verdict/Policy |
07-migration-roadmap.md |
Переход v3→v4 по фазам, критерии приёмки, риски |
08-threat-model.md |
Модель угроз и границы доверия унифицированной песочницы |
09-large-artifact-pipeline.md |
Сквозной процесс большого артефакта (модель на ТБ): очередь/S3, доставка через gateway, тиры проверки, стриминг/кэш |
10-implementation-plan.md |
План реализации v4: фазы, задачи, приёмка, текущий инкремент (библиотечный слой) |
flowchart TB
subgraph CP["Control plane (доверенная зона)"]
OL["Orchestrator / bundle"]
ER["Engine registry (EngineDescriptor)"]
TR["Test registry (TestPack)"]
PR["Policy / scoring service"]
OB["Observer sink (events)"]
end
subgraph SB["Unified sandbox (Kata microVM per job)"]
FET["artifact-fetcher (init)"]
ENG["engine (untrusted, by digest)"]
RNR["test-runner (TestPack)"]
OBS["observer (eBPF + harness)"]
TRP["traps (honeypot, sinkhole, DNS)"]
end
OL --> SB
ER --> SB
TR --> RNR
RNR --> ENG
FET --> ENG
FET --> RNR
OBS --> OB
TRP --> OBS
RNR --> CP
OB --> PR
PR --> OL
- Артефакт — проверяемый объект (модель, архив, датасет, скрипт, образ движка и т.п.).
- Движок (engine) — недоверенный образ, который «поднимает» артефакт (загрузчик/инференс-сервер).
- EngineDescriptor — подписанное описание движка (как запускать, чем готов измерять готовность, как с ним взаимодействовать).
- TestPack — версионированный набор шагов проверки (статика/загрузка/инференс/фаззинг/ассерты).
- Observer — обязательный in-guest сенсор (eBPF + userland harness) и ловушки.
- Finding — нормализованная находка (детектор, категория, severity, confidence, доказательство).
- Политика (Policy) — версионируемые скоринг и правила вердикта; вердикт — её результат.
- Bundle — неизменяемая связка «артефакт + движок + TestPack + Policy + наблюдение».