Архитектура¶

AegisAI построена как модульная платформа с чётким разделением ответственности между API-слоем, движком политик, модулем безопасности и фронтенд-панелью.

Обзор компонентов¶

graph LR
    subgraph Clients
        SDK[Python SDK]
        WH[Webhooks]
        UI[Vite Dashboard]
    end

    subgraph AegisAI Core
        GW[FastAPI Gateway]
        AR[Agent Registry]
        AL[Audit Logger]
        PE[Policy Engine]
        AD[Anomaly Detector]
        GUARD[Prompt Guard]
        HL[HITL Service]
        EP[Event Publisher]
        SIEM[SIEM Exporter]
    end

    subgraph Infrastructure
        PG[(PostgreSQL)]
        RD[(Redis)]
        OPA[OPA Server]
    end

    SDK --> GW
    WH --> GW
    UI --> GW
    GW --> AR
    GW --> AL
    GW --> PE
    GW --> AD
    GW --> GUARD
    GW --> HL
    GW --> EP
    AR --> PG
    AL --> PG
    PE --> OPA
    GUARD --> OPA
    GUARD --> RD
    EP --> RD
    UI -.->|WebSocket| GW

Структура репозитория¶

app/          # FastAPI: API, сервисы, модели, миграции, guard/
aegisai/      # Python SDK и интеграции (LangChain, OpenAI, Webhooks)
policies/     # OPA-движок и шаблоны Rego (включая guard.rego)
security/     # Аномалии, риск-скоринг, HITL, шифрование
dashboard/    # Устаревшая панель (Jinja2 + static)
frontend/     # SPA-панель Phase 4 (Vite)

API Gateway (FastAPI)¶

Центральная точка входа на порту 8000. Обрабатывает:

• REST API (/api/v1/*)
• WebSocket (/api/v1/ws)
• Webhooks (/webhooks/agent)
• Swagger UI (/docs)
• Устаревшую панель (/dashboard)

Аутентификация¶

Движок политик (OPA + Rego)¶

Политики описываются на языке Rego и исполняются через Open Policy Agent.

Модули политик¶

Агрегатор main.rego объединяет решения всех модулей:

allow if {
    all_modules_allow
    not hitl.deny_critical
}

risk_score := max([gdpr.risk_score, hipaa.risk_score, fz152.risk_score, hitl.risk_score, custom.risk_score])

Поток проверки политики¶

sequenceDiagram
    participant Agent
    participant API as FastAPI
    participant OPA
    participant AD as Anomaly Detector

    Agent->>API: POST /policies/check
    API->>OPA: Evaluate Rego
    OPA-->>API: allow, risk_score, required_approval
    API->>AD: Score behavior
    AD-->>API: anomaly flag
    API-->>Agent: PolicyCheckResponse

Модуль безопасности¶

Хранилище данных¶

PostgreSQL¶

Основное хранилище:

• Арендаторы, агенты, политики
• Журнал аудита
• agent_embeddings, discovery_candidates
• anomaly_training_samples, anomaly_model_versions
• Отчёты об аномалиях
• HITL-запросы
• Пользователи, роли, API-ключи, сессии

Redis¶

• Pub/sub для real-time событий
• Кэш результатов Prompt Guard (TTL)
• Rate limiting (login)
• Координация фоновых задач (экспорт аудита)

Real-time события¶

WebSocket¶

Эндпоинт /api/v1/ws?token=<JWT> обеспечивает:

• Уведомления о новых аномалиях
• Обновления HITL-очереди
• Системные статусы

Event Publisher¶

Сервис event_publisher слушает Redis и рассылает события подключённым WebSocket-клиентам с учётом tenant и роли.

Фронтенд (Vite SPA)¶

Стек: Vite 5, Vanilla JS, Tailwind CSS 3, Chart.js 4, Luxon.

Безопасность¶

Масштабирование¶