Problem

Problem statement

SOC playbooks drift — copy-pasted branches across tenants, inconsistent enrichment, and consequential actions automated without approval gates.

Stakes

Why it matters

Standardizing the consequential steps makes response faster and reviewable. Blueprints turn one-off playbooks into a versioned library a team can trust and maintain.

Threat Model

Threat model

  • Consequential actions automated without an approval gate.
  • Inconsistent enrichment producing unreliable decisions.
  • Unversioned branches nobody owns.
  • No structured audit per run.
Architecture

Architecture

Every blueprint declares its inputs, its approval requirements, and its audit fields.

Features

Key features

  • Versioned blueprints per alert class.
  • Shared enrichment and decision library.
  • Approval-gate patterns for state-changing actions.
  • Per-run structured audit schema.
  • Portability layer across SOAR platforms.
Controls

Guardrails & controls

Versioned blueprintsShared enrichment libraryApproval gatesStructured audit
Testing

Test scenarios

  • Phishing triage end-to-end against real alert shapes.
  • EDR isolation approval flow with revoke window.
  • Suspicious-login enrichment and escalation.
  • Malware-hash investigation branch coverage.
Workflow

Example workflow

01

Match blueprint

The alert class selects a versioned blueprint.

02

Enrich

Shared library enriches indicators consistently.

03

Decide & gate

The blueprint recommends an action; consequential ones require approval.

04

Act & audit

Approved action executes; the run is recorded with structured fields.

Stack

Tech stack

Format
YAML blueprints
Platforms
XSOAR · Tines · Sentinel · QRadar
Library
Shared enrichment/decision
Audit
Per-run structured schema
Docs
Handover documentation
Visuals

Screenshots

Visual placeholders. Replace with real screenshots and a demo video.

UI · BLUEPRINT EDITOR
DEMO · RUN AUDIT
Lessons

Lessons learned

  • A shared enrichment library removes most playbook drift.
  • Approval gates are a product surface, not a checkbox.
  • Portability comes from patterns, not platform features.
Roadmap

Future roadmap

  • More blueprints (cloud, identity, OT).
  • Blueprint linter for approval/audit completeness.
  • Reference implementations per platform.
Put this to work

Want this pattern in your stack?

These blueprints, with a shared enrichment library and approval gates, are open work — get in touch if you're building something similar or want to compare notes.