Security

Security

To report a vulnerability, follow SECURITY.md. This page is for operators.

Secrets

Secret	Protection
Upstream headers, mTLS client keys, OAuth client secrets	Versioned AES-256-GCM envelopes with entity/purpose/tenant AAD and key IDs; write-only; never exported
Agent keys, admin tokens	Only hashes stored; shown once
VMCP_ADMIN_TOKEN, VMCP_MASTER_KEY	Environment; replace the development defaults
SSO sessions	Signed cookies (8h) backed by revocable PostgreSQL sessions; CSRF header on writes

Back up master/recovery keys separately from the database. cmd/rotate-secrets supports restartable re-encryption with an old/new keyring. Deploy compatible readers first, retain recovery keys and verify restoration before retiring old keys. Legacy ciphertext lacks context binding until rotated. See security operations.

Hardening checklist

• Terminate TLS in front of both services; restrict who can reach the control plane and UI.
• Set VMCP_TRUSTED_PROXIES correctly; use ipAllowlist on agent keys; give keys the minimum virtualServers.
• Use deny/read_only policies for destructive tools and PII masking for sensitive data.
• Use per-upstream CAs rather than disabling verification (not possible anyway): Upstream TLS.
• Set rate limits and review the audit log.
• Prefer SSO + read scoped tokens; rotate and expire tokens.
• When enabling OAuth for agents, set VMCP_AGENT_OIDC_AUDIENCE and configure restrictive identity bindings.

Trust model and known limits

• Upstream URLs remain privileged editor/admin configuration. Outbound MCP and token requests enforce operator-owned host/CIDR policy at connection time; private/loopback destinations need explicit authorization. Metadata destinations, redirects and environment proxies are blocked. Legacy SSE message endpoints must share the stream origin. See MCP network security.
• Browser MCP clients need an approved VMCP_ALLOWED_ORIGINS entry. Native clients without Origin remain supported. Origin checks do not replace authentication or grant browser CORS access.
• Tool descriptions come from upstreams and are passed to models; a malicious or compromised upstream can try prompt injection through them. Use description overrides and policies to constrain what agents see.
• PII masking is pattern-based and best effort.
• SSO logout revokes the shared browser session. Operators can revoke a subject's sessions; role changes apply at the next sign-in. Agent JWT containment uses an exact-token denylist, not universal IdP introspection.
• The optional approval hook gates request metadata/digests; it does not inspect returned prompt instructions. Treat upstream content as untrusted.