Integration

How to connect Sandswap to the systems and clients around it — from provisioning an agent to swapping the VMM.

  1. Human HTTP Integration — the control-plane workflow: create agents and SandFS, how ids stay unique.
  2. Auth Integration — the two auth surfaces; OIDC and mTLS integration for the control plane.
  3. Agent HTTP Integration — connecting an agent over plain HTTP/JSON: auth, connection handling, abort contract, examples.
  4. Agent MCP Integration — the MCP server: transport, the minimal client walkthrough, server instructions.
  5. VMM Integration — the contract a third-party VMM/hypervisor must satisfy to replace sandvmm.
  6. Storage Backends — no backend type restriction: the contract, the options (local disk, NFS, cloud managed services, distributed/parallel filesystems), and how to choose.
  7. OCI Registry Integration — auth methods and the template push/pull lifecycle.
  8. Prometheus Integration — scraping /metrics, the metric catalogue, starter alerts.
  9. Egress Integration — building per-agent egress policy on the identity binding: enablement, reader access, consumption rules, solution patterns (the mechanism is Egress Enabler Contract).
  10. Volume-Name Seed Integration — supplying the volume-name seed from an external secret manager (Vault, a cloud secrets manager, systemd credentials, ESO/CSI): the injection contract, the channel options, verification, and how rotation runs through each channel.

Table of contents