Skip to main content
Version: v5.7.0

Control

packs:security-governance

A control is a named, owned, reviewable statement about enforcement — "this is governed, this role owns it" — distinct from the enforcement instruments (policies, mandates, windows, grants) that implement it. Controls anchor the governance surfaces: cadences schedule their reviews, campaigns review them, waivers record exceptions against them. Served by the v2 GovernanceService: ListControls, GetControl, CreateControl and UpdateControl (controls retire; they are never deleted).

Control​

Control is a named, owned, reviewable statement about enforcement — not an enforcement instrument itself.

FieldTypeMeaning
created_attimestampWhen the record was created.
created_bystringUsername of the creating identity.
descriptionstringFree-text description.
domainstringThe governance domain: "security" | "change" | "agent".
idstringThe record's identity.
instrument_refsarray of InstrumentRefThe instruments implementing this control; empty means a procedural control attested by humans.
keystringThe unique catalog key, e.g. "path-rbac-posture".
namestringDisplay name.
owner_rolestringThe role accountable for the control's reviews.
statusstring"active" | "retired".
updated_attimestampWhen the record was last updated.

InstrumentRef​

InstrumentRef points a control at one mechanism that implements it by {kind, id}, leaving the instrument's schema untouched.

FieldTypeMeaning
idstringThe instrument's id in its own table.
kindstringThe instrument family, e.g. "authorisation_policy", "notification_mandate", "maintenance_window", "trust_grant".
  • opschain docs governance — the controls register and the review lifecycle around it.
  • opschain docs resources/cadence — the review schedule a control carries.
  • opschain docs resources/waiver — exceptions recorded against a control.
  • opschain docs governance-matrix — how controls map onto the enforcement instruments.