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 SDK or REST clients call the same FastAPI surface.

languageKimss SPA /app
menu_bookLanding & docs
terminalSDK & REST
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/agents/run
gavelGuardrails + kill switch
tollGoverned requests
04 State & Persistence

Operational State

Tenant/user metadata, audit and usage rows, cache keys, and support artifacts.

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 (zero Kimss credits on BYO). Foundry ai-proxy is not the customer path.

routeAPIM byo-proxy
functionstelemetry.ai_requests
monitoringGatewayLogs
analyticsaudit_log