How bulwark-black/bb-soc-skeleton works
Bulwark Black is a self-hosted SOC interface starter centered on a private operator workflow: sign in, register an application and source, ingest normalized observations, and inspect them in bounded SOC views. Separate branches cover vendor imports, Trivy report ingestion, Sentry live monitoring, documents, setup guidance, and MCP-based administration. The graph reflects README-described capabilities and source-index imports; several subsystem implementations were not excerpted, so their internal routing is not expanded.
Main entry points: reference-runtime.js Connector runtime · live-monitoring.js Live monitoring · reference-control-plane.js Reference control plane · ingest-contract.js Ingest contract
Components 28
Operator interface
- SOC interface
public/app.js - UI contracts
public/connector-contract.js - Private sign-in
public/private-sign-in.js - Documents library
public/document-library.js
Control and administration
- Administration contract
public/administration-contract.js - Private application
server/private-application.js - Authentication
server/private-auth.js - Reference control plane
server/reference-control-plane.js - Connector runtime
server/reference-runtime.js - Administration runtime
server/reference-administration-runtime.js - Administration store
server/reference-administration-store.js
Ingestion and observation
- Ingest contract
tools/ingest-contract.js - SOC page models
server/reference-pages.js - Reference data store
server/reference-store.js - Observation coverage
server/integration-coverage.js
Collectors and integrations
- Integration sender
tools/integration-client.js - Vendor imports
public/vendor-import.js - Vendor adapters
tools/vendor-adapters.js - Trivy report import
server/scanner-ingest.js - Live monitoring
server/live-monitoring.js
Operator support
- Agent MCP
tools/agent-mcp.js - Service access
server/service-access.js - Setup assistance
public/setup-assistance.js - Technical reference
public/technical-docs.js - Document store
server/document-store.js
Other components
- Operator
- Sentry Cloud
- Slack
Connections 33
- Operator → Private sign-in: signs in
README.md - Private sign-in → Private application: opens session
README.md - Private application → Authentication: authenticates
README.md - Operator → SOC interface: uses
README.md - SOC interface → UI contracts: uses contracts
README.md - Private application → Reference control plane: serves control plane
README.md - Reference control plane → Connector runtime: delegates connector actions
server/reference-control-plane.js - Reference control plane → Administration runtime: delegates administration
server/reference-control-plane.js - Administration runtime → Administration store: uses persistence
server/reference-administration-runtime.js - Administration runtime → Administration contract: validates with
server/reference-administration-runtime.js - Connector runtime → Ingest contract: validates batches
server/reference-runtime.js - Connector runtime → Reference data store: persists state
server/reference-runtime.js - Connector runtime → UI contracts: validates with
server/reference-runtime.js - SOC interface → SOC page models: views SOC pages
README.md - SOC page models → Observation coverage: builds observation views
server/reference-pages.js - Operator → Integration sender: sends normalized records
README.md - Integration sender → Ingest contract: prepares batches
tools/integration-client.js - Operator → Vendor imports: imports exports
README.md - Vendor imports → Vendor adapters: normalizes events
README.md - Vendor adapters → Ingest contract: validates records
tools/vendor-adapters.js - Operator → Trivy report import: submits report
README.md - Trivy report import → Ingest contract: validates batch
server/scanner-ingest.js - Operator → Live monitoring: configures collector
README.md - Live monitoring → Sentry Cloud: collects events
README.md - Live monitoring → Slack: sends alerts
README.md - Live monitoring → Vendor adapters: uses mappings
server/live-monitoring.js - Operator → Agent MCP: uses tools
README.md - Agent MCP → Reference control plane: issues commands
tools/agent-mcp.js - Operator → Service access: manages credentials
README.md - Operator → Setup assistance: follows guidance
README.md - Setup assistance → Technical reference: references runbook
README.md - Operator → Documents library: manages documents
README.md - Documents library → Document store: stores versions
README.md