DOCS/REFERENCE
REFERENCE13 MIN READUPDATED 03 SEP 2026

REFERENCE / 05

The security model is a boundary—not a promise.

Threats, controls, cryptography, deployment responsibilities, and pre-production checks.
SHREDDAR reduces unnecessary disclosure when the gateway runs inside a boundary you control. Its controls do not compensate for an untrusted host, leaked runtime secrets, unsafe upstream selection, or an agent instructed to bypass the route decision.
THREAT MAP

Seven exposure paths

RISKCONTROLRESIDUAL RESPONSIBILITY
Raw source sent to an upstreamPre-inference compiler plus route gateVerify the actual outbound request with a test double
Credential or private key in contextDeterministic secret detector and BLOCK actionMaintain an authorized adversarial corpus
Identity mapping exposed to an agentVault credentials and reconstruction omitted from MCPKeep application secrets outside model context
Sensitive value introduced by a modelOutput guard before reconstructionInspect application-side post-processing
Cross-session placeholder replaySession-bound tokens, TTL, and authenticated contextProtect storage, key files, and backups
Receipt becomes a shadow prompt logMetadata-only schema and raw-content telemetry falseReview downstream logs and analytics
Failed privacy path is bypassedFail-closed Agent Skill and local_only routeTest outage, denial, and timeout behavior
VAULT CRYPTOGRAPHY

Separate purposes, authenticated mappings

  • AES-256-GCM encrypts reversible mappings with a random 96-bit nonce.
  • HKDF-SHA-256 derives separate encryption, fingerprint, and receipt-integrity keys from the master material.
  • Session id, placeholder, and entity type are authenticated data, binding a ciphertext to its intended context.
  • Receipt records form a SHA-256-linked local integrity chain; the anchor payload endpoint does not submit an onchain transaction.
DEPLOYMENT CHECKLIST

Before authorized data enters the system

  1. 01

    ISOLATE

    Bind the gateway only to required private networks and place public TLS at a reviewed ingress.

  2. 02

    AUTHENTICATE

    Enable public mode only with rotated API credentials and exact CORS origins.

  3. 03

    HARDEN

    Use non-root, read-only containers, dropped capabilities, resource limits, and dedicated labeled volumes.

  4. 04

    PROVE FAILURES

    Test blocked secrets, local_only routes, invalid reconstruction, upstream timeout, and unsafe model output.

  5. 05

    RECOVER

    Back up the database and key material separately, verify integrity, and rehearse restore and rollback.

  6. 06

    OBSERVE SAFELY

    Measure latency, counts, and integrity without adding raw source or Vault mappings to logs.

SHARED RESPONSIBILITY

The deployer still owns the environment

01

SHREDDAR

Strict schemas, deterministic controls, policy enforcement, bounded Vault, output guard, and privacy-minimized receipts.

02

DEPLOYER

Authorization, lawful data use, host security, identity, networking, upstream selection, backup, recovery, and incident response.

03

APPLICATION

Purpose binding, route obedience, safe secret handling, output inspection, and deliberate reconstruction.

04

UPSTREAM

Its own processing, retention, training, regional, legal, and security behavior for the protected context it receives.

SHREDDAR DOCSYOUR DOC. YOUR DATA. YOUR CONTROL.

Public alpha documentation. Capability labels describe implementation state, not certification or guaranteed suitability.