01
Uncontrolled provider access
Direct AI access can bypass organisation policy, identity boundaries, and consistent operational controls.
ProxiAI is a tenant-aware AI gateway that applies policy, protects sensitive information, and records auditable operational evidence before approved requests reach an AI provider.
Interactive demo may be started on demand.
PROXIAI CONTROL BOUNDARY
WHY A GATEWAY
ProxiAI inserts one trusted control boundary between employees and the external model path.
01
Direct AI access can bypass organisation policy, identity boundaries, and consistent operational controls.
02
Prompts may carry contact, financial, government, credential, internal-secret, or business-confidential data.
03
Security and operations teams need bounded audit, usage, policy, and delivery evidence without storing raw sensitive values.
SYSTEM SHAPE
The Express API stays authoritative. Every tenant-owned query uses trusted organisation context, while provider SDK details remain inside adapters.
Tenant records, append-only usage/audit, encrypted or metadata-only history
Idempotency, rate limits, workers, health, and durable enqueue recovery
Low-cardinality metrics, safe logs, dashboards, alerts, and runbooks as code
REAL REQUEST LIFECYCLE
Security checks happen before provider execution. Persistence and background work happen only through approved boundaries after the outcome is known.
Approved prompt continues to the configured provider path.
Only the masked providerPrompt crosses the provider boundary.
The request stops before streaming; zero provider calls are made.
PRODUCT SURFACES
The product UI exposes the same backend truth rather than recreating policy, billing, or provider rules in the browser.
SURFACE 1
Conversation navigation, policy-aware streaming, safe Markdown, and explicit retention context.
SURFACE 2
Decision, risk score, detected category counts, masking state, and authoritative provider routing.
SURFACE 3
Tenant users, teams, policy, budget, retention, sessions, alerts, analytics, and append-only audit export.
SECURITY DESIGN
Implemented controls are explicit, tenant scoped, and tested. ProxiAI does not convert planned capabilities into public claims.
Rule-based detection preserves source spans, classifies without raw values, scores risk, and masks derived prompts without mutating the original request.
AES-256-GCM storage uses a versioned runtime keyring, unique IVs, and tenant/resource-bound AAD. Encryption failure is strict: there is no plaintext fallback.
METADATA_ONLY
No message content is stored.
ENCRYPTED_STORAGE
Completed user and assistant content is stored as ciphertext for owner-authorized reads.
Access tokens identify the session; current user status, organisation status, role, and canonical permissions are reloaded from the database.
EMPLOYEE
Restricted chat and own-conversation access through canonical permissions.
TEAM_LEAD
Team-scoped capabilities only when current permissions and tenant context allow them.
ORG_ADMIN
Tenant administration, policy, billing, audit, and user operations through audited mutations.
RELIABILITY + ASYNC
Provider execution and background accounting use separate, bounded failure paths so chat delivery does not invent billing truth.
Canonical adapters normalize completion, streaming, health, usage, and failures. Bounded retry and circuit state are reusable across candidates.
Groq is the only enabled production provider. The ordered fallback abstraction is tested, but the current production chain has one candidate.
Append-only RequestLog records known usage. Idempotent BullMQ workers reconcile billing and tenant-scoped analytics without mutating the source record.
Unknown provider usage remains unknown; no synthetic token or cost value is created.
Worker heartbeats, provider-health state, failed-job retention, analytics/anomaly processing, and durable enqueue recovery make background failure visible and bounded.
Prompt, response, PII, credentials, and raw provider errors stay out of job payloads and logs.
OBSERVABILITY BOUNDARY
Safe structured logs, a protected Prometheus-compatible metrics endpoint, low-cardinality labels, dashboard and alert definitions, and runbooks are implemented. Continuous hosted collection and alert delivery can remain intentionally deferred while the demo environment is deep-stopped.
VERIFIED RELEASE EVIDENCE
This is dated internal release evidence from the repository audit baseline. It is not an external certification and does not silently track later commits.
789136c269 / 269
Backend tests
28 / 28
Frontend tests
63 / 63
Isolated integration
78.24%
Backend line coverage
77.62%
Frontend line coverage
CANONICAL DEPLOYMENT
Immutable ECR images define separate frontend, API, and worker ECS/Fargate services. Secrets stay in AWS Secrets Manager rather than the frontend bundle or image layers.
The low-traffic demo uses one task per service and snapshot-driven deep stop/start for cost control. This is not a multi-task high-availability claim.
HONEST LIMITATIONS
A trustworthy demo states what is deferred and what cannot be recovered, rather than filling the gaps with synthetic evidence.
The public demo account is restricted to employee chat permissions and must not be used with real personal or confidential data.