Browsing the catalog and checking readiness are free for any workspace
member. Installing a pack is a workspace Admin action and
requires a paid plan — the gateway enforces both server-side, so a
direct API call can’t bypass the gate.
1. What “install a compliance pack” actually does
One install call writes three things atomically into your workspace:A guardrail (content plane)
A guardrail (content plane)
The pack’s content-plane controls merge into one named guardrail —
<Pack> (Compliance) (e.g. SOC 2 (Compliance)). In observe mode every action (and every
per-entity action) is coerced to flag, so it annotates matches
without blocking or masking real traffic.A firewall policy (tool-call plane)
A firewall policy (tool-call plane)
The pack’s tool-call controls merge into one named firewall policy —
<Pack> (Compliance — tools) (e.g. SOC 2 (Compliance — tools)) — created with shadow_mode on,
so it evaluates and logs every covered call as [shadow] would …
but never denies.An install record
An install record
A workspace compliance-pack row links the two materialized policies,
pins the catalog version, records which controls you selected, and
stamps who installed it — plus an audit-log entry.
firewall_policy_id — just
like any policy you authored by hand.
2. Install a compliance pack from the console
Compliance configuration uses your console session (UserAuth), not a relay key. Do it in the console:Open the compliance catalog
Go to Compliance in the workspace console. Browse the catalog and
open the framework you need — for example SOC 2 (
soc2) or the
OWASP LLM Top-10 (owasp_llm). Each pack lists its controls,
which plane each control lands on, and the official reference.Pick controls (or take them all)
Install the whole framework, or select a subset of controls. An
empty selection installs every control in the pack.
Install
As workspace Admin on a paid plan, click Install. The pack
materializes in observe mode immediately. Re-installing an
already-installed pack is idempotent — it returns the existing
record, not a duplicate.
Watch the evidence, then go live
Let the shadow guardrail and firewall accumulate would-have-blocked
matches. When the posture looks right, take the pack live to flip
the declared actions on and (optionally) promote the policies to your
workspace default. See Observe vs enforce.
3. The underlying call
The console drives one endpoint. It’s documented here so you can see the shape, audit it, or script an internal provisioning flow — but the gateway requires a workspace Admin session token and a paid plan to reach it:mode: observe, and the ids of the materialized guardrail_id and
firewall_policy_id so you can open them straight away.
4. After installing
| Then | Where |
|---|---|
| See what’s in the pack | Pack contents |
| Take it live | Observe vs enforce |
| Generate signed evidence | Signed report |
Why a paid plan to install and not just to enforce? Materializing a
framework into live-editable policy is the value moment — the gateway
gates it at install and again at go-live so the upgrade boundary is
explicit, never a surprise 403 mid-rollout.
5. Related
Plan gating
Exactly which compliance actions are free, and which need a paid plan.
Observe vs enforce
How observe mode collects evidence and what changes at go-live.
Control matrix
How each framework control maps onto gateway guardrails and firewall
rules.
OWASP LLM Top 10
The pack that maps onto the agent-security threats in this section.
Guardrails reference
The content plane an install materializes — rules, PII, actions.
Agent Firewall reference
The tool-call plane an install materializes — verdicts and surfaces.
