Linear runbook for regulated in-VPC pilots — platform and security teams implementing Blekline NHIM sidecar enforcement before production rollout.
Default posture: audit-only (log would-deny, no live block) until two admins activate enforce via the dashboard.
For IDE-heavy teams, run the Cursor DPO verification checklist in parallel on pilot laptops.
Honesty box
| Topic | Status |
|---|---|
| Audit-first default | Shipped — values-audit-profile.yaml |
| Dual-control enforce | Shipped — Operations → Enforcement |
| Enterprise OIDC + SCIM | Shipped — SSO & deployment |
| SAML SP | Enterprise program — contact sales |
| SOC 2 Type II / pentest attestation | Roadmap — do not claim in committee packs |
| eBPF kernel-plane on OpenShift | R4 — separate privileged SCC review — ebpf-kernel-plane |
Full OWASP ASI + AIUC-1 control matrices ship in the enterprise sandbox (NDA) — see Compliance evidence.
Preconditions
| Item | Default |
|---|---|
| Entry path | in_vpc — Enterprise in-VPC |
| Enforcement stage | audit |
| Control plane | local (air-gap) unless SaaS Activity sync is contract-approved |
| Vault | Customer-held keys on PVC — Blekline cannot hydrate without customer approval |
| Contacts | Named security + platform owner for dual-control activation |
npx @blekline/init --path in_vpc
# maskBackend: sidecar — never hosted /api/mask for production agents
Phase 1 — Posture and audit deploy
- NHIM static audit — run [NHIM audit quickstart](/docs/get-started/nhim-audit-quickstart); upload JSON to Operations → Posture.
- Resolve critical gaps — mandatory-hop bypass, missing sidecar, webhook not wired — before committee review.
- Deploy sidecar (audit profile) — Helm with audit overlay:
helm upgrade --install sidecar blekline-ingress \
-n blekline --create-namespace \
-f deploy/k8s/sidecar/values-production.yaml \
-f deploy/k8s/values-audit-profile.yaml
- Pilot IDE laptops — if developers use Cursor, confirm hooks use sidecar mask (no double hosted
/api/maskagainst production SaaS). See Cursor verification. - Collect would-deny events — Operations → Activity and Runtime log; no production blocks yet.
- Identity smoke — OIDC dashboard login + SCIM provision/deprovision E2E when IdP is ready (SSO guide).
OpenShift / CRC
OpenShift values overlay and CRC validation checklist ship in the enterprise sandbox deploy pack (NDA). Sidecar runs non-privileged under restricted-v2 for audit/enforce v1. eBPF kernel-plane requires a separate privileged DaemonSet and SCC review — see eBPF kernel plane.
Phase 2 — Dual-control activate
- Admin A requests
enforcein Operations → Enforcement (pending activation appears in approver inbox). - Admin B approves in the Approver inbox — same user cannot self-approve.
- Export committee pack from Operations → Compliance for risk committee review.
- Air-gap tenants — download signed activation artifact; apply via Helm/GitOps.
- Apply enforce profile:
helm upgrade sidecar blekline-ingress \
-n blekline \
-f deploy/k8s/sidecar/values-production.yaml \
-f deploy/k8s/values-enforce-profile.yaml
- Probe — confirm live block/mask events with enforce metadata (not would-deny only).
See Kubernetes deployment for topology A (standalone ClusterIP) vs B (mutating webhook inject).
Phase 3 — Evidence and operate
- Export posture, enforcement stats, and honesty box from Operations → Compliance.
- Map findings to your control framework (DORA, GDPR, internal risk language) — Blekline provides evidence enablement, not certification.
- Trust Vault key ceremony — customer generates
BLEKLINE_VAULT_MASTER_KEYin HSM or sealed secret store; mount via External Secrets / AKV — never commit to Git. - PVC backup — snapshot Trust Vault PVC before sidecar upgrades (
Recreatestrategy = brief outage).
| Committee artifact | Source in Blekline |
|---|---|
| Dual-control evidence | Audit log enforcement.activation_* — two distinct admin user IDs |
| Posture baseline | NHIM audit JSON + Deployment hub |
| Runtime enforce proof | Activity + committee pack export |
| Exit / portability | Vault export API + MSA annex (executed DPA on request) |
Related guides
| Topic | Link |
|---|---|
| Eval journey (Track 01/02) | Eval journey |
| Trust Vault | Trust Vault sidecar |
| Lineage | Lineage enforcement |
| Claim integrity | NHIM verification |
| Procurement | Procurement pack |
Next steps: Enterprise in-VPC · Cursor verification · Compliance evidence · Open workspace