v0.4.0GitHub

Architecture & security

Trust boundaries

Data handling, persistence, and security posture for enterprise diligence.

View as Markdown

Data handling, persistence, and security posture for enterprise diligence.

What leaves the client

When blekline_mask_prompt is called, the text payload is sent over HTTPS to /api/mask on the Blekline control plane, then forwarded to Azure Cognitive Services (Text Analytics PII detection). The response returns maskedText and a tokenMap — original entities are not stored in persisted event records.

When blekline_evaluate_tool_call is called, the tool name and argument summary are evaluated locally via @blekline/contracts, and optionally checked against the workspace policy API. Full argument bodies are not stored in default event ingest.

What is stored in audit events

Audit events in workspace Activity contain metadata only:

FieldExample
kindtool_call_enforcement
actionallow / mask / block
entitiesMasked3
riskTierlow / medium / high
mcpToolNamewrite_file
clientSurfacecursor, continue, github-copilot, openhands, sourcegraph-cody, etc.
modelProvideranthropic / openai
requestIdUUID for correlation

No raw prompt text. No full tool argument bodies. No user-identifiable content in default configuration.

Data residency

  • SaaS: app.blekline.comEEA-first by default (Frankfurt compute, Ireland database, Germany West Central cloud mask). See Subprocessors.
  • US-primary hosting: available on enterprise program with signed US Processing Addendum. Contact sales with dataResidency=US.
  • Edge sidecar with BLEKLINE_MASK_FAST_PATH=local_only: no data leaves the sidecar.

Encryption and tokens

All API traffic: TLS 1.2+ in transit. Workspace tokens are scoped (mask:write, events:write), rotatable, and never logged in event records. Rotate tokens quarterly — see SSO & deployment hardening checklist.

Certifications

SOC 2 Type II: on the roadmap. Contact enterprise sales for current timeline and to request a security questionnaire.

Third-party eval (LangSmith)

LangSmith receives metadata-only exports when you forward /api/events or OTel labels — not prompt bodies by default. LangSmith is an eval platform, not a SIEM. For compliance archives use Enterprise telemetry.

Claim integrity (shipped vs roadmap)

Every capability claim in sales and marketing maps to one of these labels:

CapabilityStatusNotes
MCP mask + tool enforceShippedblekline_mask_prompt, blekline_evaluate_tool_call, MCP proxy
Cursor IDE hooksShippedChat mask, read/shell/tool/MCP guards via @blekline/cursor-hooks
Cursor Cloud Agent hooksPartialShell + preToolUse + read; no chat-submit or MCP-exec hooks (Cursor platform)
Ingress request mask/blockShipped/api/ingress/v1/chat/completions, /api/ingress/v1/messages
Ingress response maskShippedAssistant content redacted on ingress proxy return path
Activity audit + CSV exportShippedMetadata-only events in workspace Activity
SDK mask + enforceShippedPython/TS client, /api/mask, /api/mcp/enforce-tool-call
SIEM forward (JSON/CEF)ShippedGovernance+; HTTPS webhook with probe
NHIM Trust Vault (sidecar)Shipped v1VPC sidecar; encrypted vault; hydrate in-cluster only
NHIM Lineage FirewallShipped v1Destructive tool block on contaminated sessions
SAML SSOEnterprise programOIDC via dashboard today; SAML on roadmap
Extension exfil block/warnNot shippedTelemetry only (exfil_signal)
Full cross-SaaS DLPEnterprise programNot CASB replacement
SOC 2 Type IIRoadmapContact sales for questionnaire

What Blekline is not

Blekline is NHIM + AI runtime enforcement at the agent boundary (open-core MCP wedge + private runtime engine). It is not:

  • A WAF or network-level firewall
  • A full CASB/DLP system (it operates at agent, MCP, and API boundaries — not network packets)
  • A model routing marketplace

Ingress governs prompts and tool calls before models and tools. Response mask on the ingress proxy redacts sensitive content in model outputs before they return to your agent runtime. Forward audit metadata to your SIEM via /api/integrations/siem (Governance+).

This scope boundary is intentional. See Architecture.


Next steps: MCP identity pinning · Enterprise telemetry · EU AI Act mapping