Kimss System Architecture

Model-Agnostic Enterprise Gateway: identity, Hermis orchestration, write-only vault, and governed API calls. You hold the models; Kimss is the control plane.

expand_more

EXPLORE SYSTEM

01 Identity & Auth

Session + Key Security

Entra OAuth, Kimss session JWT, and API key fallback with role mapping.

fingerprintEntra ID
badgeSession Token
keyAPI Keys
Zero-Trust gates

Dual-layer security gateway

Scoped API key first, then iam.mcp_tool_grants SSO RBAC before an internal MCP tool runs. Marketing explainer: /zero-trust-ai-architecture.

Hermis intercept

Hermis orchestration loop

Physical pause on tool_call: kill switch, in-memory Key Vault unwrap, then tenant audit_log. Not Airflow.

02 Clients & edge

Web, docs & API clients

Vite SPA at /app, public landing and /docs, and native OpenAI or Anthropic clients on the Invisible Proxy (dual-listener).

languageKimss SPA /app
menu_bookLanding & docs
terminalOpenAI /v1/chat/completions
smart_toyAnthropic /v1/messages
03 API Orchestration Core

FastAPI + Hermis control plane

Agent SSOT, kill switch, Guardrails, governed-request meters, and vault unwrap in memory — never a second model vendor.

hubHermis loop
vpn_keyenc.v3 vault
play_arrowPOST /v1/chat/completions
forumPOST /v1/messages
play_arrowPOST /v1/agents/run
gavelGuardrails + kill switch
tollGoverned requests
04 State & Persistence

Operational State

Tenant/user metadata, audit and usage rows, cache keys, and support artifacts. Table flows: /docs/enterprise_data_model.

databasePostgreSQL
memoryRedis
folderBlob Storage
05 Customer data plane

Your data plane (not hosted by Kimss)

Vaulted Connected Infrastructure. APIM byo-proxy hops to your OpenAI-compatible endpoint or native Anthropic Messages. Customer MCP stays on your HTTPS URL.

neurologyOpenAI-compatible / Azure OpenAI
smart_toyNative Anthropic
extensionCustomer MCP

06 Telemetry & Article 12 audit

Customer inference always hits APIM byo-proxy so GatewayLogs remain the immutable hop. App telemetry records governed requests (BYO inference is zero-rated for Kimss compute). Foundry ai-proxy is not the customer path.

routeAPIM byo-proxy
functionstelemetry.ai_requests
monitoringGatewayLogs
analyticsaudit_log