How-to Guides

Task-oriented recipes for installing, configuring, operating, and scaling Agent Substrate.

Operator Install

Configure the installer with a settings document, and how it resolves flags, environment, and config.

Database Configuration

PostgreSQL roles and connections for the bundled database and for bring-your-own databases.

Authentication

How clients authenticate to ate-api-server over SPIFFE mTLS or OIDC JWTs.

Authorization

How ate-api-server checks every call against an OpenFGA model, and how to manage roles and access.

CSI VolumesPreview

Attach CSI volumes to actors.

Deploying CSI DriversPreview

Deploy CSI drivers for use with Agent Substrate.

Egress Traffic

Supported outbound actor protocols, DNS relay filtering, and what actors see when egress is refused.

Network Egress

How atunnel and the egress gateway tunnel, authenticate, and apply policy to outbound actor traffic.

MITM Trust Bundle

Configure actors to trust the egress gateway’s MITM CA for HTTPS header and credential injection.

Egress Credential Injection

Put secrets into an actor’s outbound HTTPS requests without the actor ever holding them.

Observability

Logs, metrics, and traces for actors and the Agent Substrate components.

SLOs and Alerting

Define SLIs, SLOs, and Prometheus alerting rules to monitor Agent Substrate in production.

Rolling Upgrades

Runbook for a rolling upgrade of Agent Substrate.

Actor JWTs

What an actor JWT contains and how a relying party verifies it.

Actor JWT Federation

Serve the actor JWT issuer publicly and set up a relying party outside the cluster to trust it.

Actor JWT Key Rotation

The rotation steps, how long to wait between them, and replacing a compromised key.

Was this page helpful?