Andyur Technical Architecture

Secure Agent Runtime Architecture

How Andyur governs, isolates and executes enterprise AI agents on Kubernetes - with mediated identity, network authority, credentials and compute.
External architecture edition
For enterprise platform, security and infrastructure teams
October 2026

Architecture at a Glance

Andyur creates a governed execution boundary around every AI agent run. The platform separates deterministic control-plane functions from agent execution, treats the agent workload as untrusted, and mediates access to models, tools, data and enterprise services through a trusted runtime.

Core security principle: an agent should not inherit the network reachability, credentials or workload identity required to access the enterprise. Its intended outbound relationship is its own Andyur runtime, which performs authorized actions on its behalf.
G cluster_run Per-Run Security Boundary user Enterprise Users & Platforms cp Andyur Control Plane Admission • Policy • Registry Identity • Run lifecycle user->cp authenticated request px Trusted Andyur Runtime Proxy • Broker • Policy enforcement cp->px admitted run ext Models • Tools • Data Enterprise Services px->ext mediated authority ag Untrusted Agent BYOA / framework agent ag->px single intended path ag->ext no direct access
Figure 1. Andyur separates the enterprise control plane, the per-run security boundary, and downstream authority.
Govern before execution.
Admission resolves the approved agent artifact, identity, model/tool grants, runtime policy and compute constraints before a run is materialized.
Contain every run.
Each run receives its own runtime boundary, credentials, network policy and execution identity.
Mediate authority.
The trusted runtime brokers model, tool and enterprise API access so credentials do not need to live in the agent.
Make actions attributable.
Workload identity, run identity and enterprise authorization combine to make downstream actions traceable to a specific execution.

1. Control Plane and Agent Data Plane

The Andyur control plane is intentionally deterministic. It owns admission, registry resolution, policy, lifecycle, identity expectations and run state. Model-driven behavior remains inside agent runs rather than being embedded in the coordinator.

Control planePer-run data plane
Agent registry and artifact governanceTrusted Andyur proxy / broker
Policy and admissionUntrusted agent workload
User and workload identity checksModel and tool invocations
Run scheduling and lifecycleScoped runtime credentials
Audit, state and orchestration metadataExecution-specific telemetry
Kubernetes is the current compute and containment substrate. Andyur owns the run semantics; Kubernetes owns materialization, placement and resource enforcement.

2. Kubernetes Runtime Architecture

Andyur deliberately separates the trusted runtime from the untrusted agent into different pods. That decision allows Kubernetes NetworkPolicy to give the runtime broader, explicitly approved connectivity without giving the same network authority to the agent.

G cluster_run One Andyur Run cluster_agent Untrusted Agent Pod cluster_proxy Trusted Proxy Pod a Agent Process non-root • restricted filesystem p Andyur Proxy / Broker identity • credentials • policy a->p approved runtime / tool channel cp Andyur Control Plane a->cp m Approved Model Endpoint a->m t Approved Tools / MCP a->t p->cp p->m p->t
Figure 2. The trusted runtime and untrusted agent are separate pods so network authority can be enforced independently.

Each admitted run is materialized as a bounded set of Kubernetes resources such as service accounts, per-run secrets, a proxy service, default-deny policies and the workload pods. Runtime resources are derived from the admitted run rather than selected by the agent image.

3. Network Containment

The run network is designed around default deny. The agent receives only the connectivity required to speak to its own Andyur runtime. The trusted runtime receives a separately governed set of outbound destinations for the specific model, tool, control-plane and telemetry services that the run is authorized to use.

G a Untrusted Agent p Own Andyur Proxy a->p ALLOW dns Cluster DNS a->dns DENY api Kubernetes API a->api DENY other Other Runs a->other DENY net Internet / Enterprise Network a->net DENY data Platform Data a->data DENY
Figure 3. The untrusted workload is treated as a sink: the intended egress path is its own trusted runtime.

No general DNS or cluster reachability for the agent

Removing unnecessary resolver and cluster reachability reduces both discovery and exfiltration paths. Service resolution required by the trusted runtime remains outside the agent's authority.

Fail-closed containment activation

Dynamic network policy can take time to become effective after a pod is created. Andyur uses a containment barrier so the untrusted workload does not begin until isolation is observed as active. If the required boundary cannot be established, the run is refused rather than started with broader connectivity.

G w Run Controller pol Create Network Policy + Run Resources w->pol barrier Containment Barrier Verify isolation is active pol->barrier agent Start Untrusted Agent barrier->agent isolation verified refuse Refuse to Start barrier->refuse isolation not active
Figure 4. The untrusted workload starts only after the runtime verifies that required isolation is active.

4. Identity and Delegated Authority

Andyur separates three questions that are often collapsed into a single bearer credential: who is the workload, which run is acting, and what authority has been delegated.

G spire SPIFFE / SPIRE Workload Identity proxy Trusted Andyur Runtime spire->proxy who is calling run Run Identity Agent + Run + Workflow run->proxy which execution auth Enterprise Authorization Audience / Scope / Delegation auth->proxy what it may do ext Enterprise Tool / Model / API proxy->ext scoped request
Figure 5. Workload identity, run identity and enterprise authorization are distinct but composable controls.
LayerPurpose
Workload identitySPIFFE/SPIRE establishes cryptographic identity for trusted platform and run-side workloads.
Run identityAgent, run and workflow context binds requests to a specific execution rather than a generic service role.
Delegated authorityEnterprise authorization constrains audience, scope and permitted downstream actions.
Agent exclusion matters. The untrusted agent does not need direct access to the workload identity issuance path. Identity-bearing operations remain in the trusted runtime.

5. Credential Isolation

Traditional agent deployments often place provider keys, OAuth tokens or service credentials directly in the agent process. Andyur's runtime model instead keeps downstream credentials in trusted infrastructure and applies them only when an authorized operation is performed.

Credential-control propertySecurity effect
Reduced secret exposureA compromised model context has fewer downstream credentials available to steal.
Scoped downstream actionsThe runtime can apply credentials appropriate to the approved audience and operation.
Independent revocationAuthority can be removed without changing the agent image.
Auditable mediationModel and tool actions pass through an enforcement point that can emit policy and trace evidence.

6. Governed Agent Supply Chain

Execution begins from governed artifacts, not mutable image tags or ad hoc runtime configuration. An agent package and manifest are resolved through the registry and admission layers, then bound to an immutable run specification.

G src Agent Package / Manifest reg Governed Agent Registry versioned • signed • policy checked src->reg admit Andyur Admission resolve grants & constraints reg->admit run Immutable Run Specification image digest • identity • policy • compute admit->run k Compute Provider Kubernetes run->k
Figure 6. The governed registry and admission layer bind approved artifacts and runtime constraints before compute is created.

The resulting run specification can include the immutable workload artifact, agent identity, model and tool grants, resource bounds, network destinations, run lifetime and isolation requirements. This makes the compute layer an implementation of an already-approved contract rather than the place where policy is invented.

7. Bring Your Own Agent

Andyur is designed to govern existing agents and containers rather than requiring every workload to be rewritten around a proprietary SDK. The runtime contract provides the agent with only the approved interfaces and configuration needed for the run, while infrastructure-specific identity, credentials and network policy remain outside the agent.

BYOA principle: the workload image does not decide its own network authority, downstream credentials, model entitlement, execution identity or compute isolation. Those are resolved by the platform from governed configuration and policy.

8. Compute and Run Lifecycle

Andyur keeps execution semantics separate from Kubernetes objects. A run has a stable identity and execution generation; the run controller turns that admitted intent into exactly one active runtime and observes it through completion.

G trig Trigger / Schedule adm Admission policy + registry trig->adm rec Run Execution Controller generation + idempotency adm->rec cp Compute Provider Kubernetes rec->cp iso Isolated Run Group proxy + agent cp->iso fin Artifacts / Audit / Terminal State iso->fin
Figure 7. Admission and run semantics remain Andyur-owned; Kubernetes is one compute provider that materializes the runtime.

Resource requests and limits can be resolved independently for the trusted runtime and agent workload. This supports predictable CPU, memory and ephemeral-storage bounds while allowing enterprises to map higher-risk or GPU workloads to different node pools and runtime classes.

9. Enterprise Production Topology

A production deployment scales the control plane independently from agent compute. Server replicas remain stateless over shared durable state and object storage; run controllers materialize agent workloads into appropriate compute pools; SPIFFE/SPIRE and telemetry span both planes.

G user Enterprise Clients ingress WAF / Enterprise Load Balancer user->ingress lb Internal Andyur Service ingress->lb s1 Server Replica A lb->s1 s2 Server Replica B lb->s2 pg HA State Store s1->pg obj Object Storage s1->obj spire SPIFFE / SPIRE s1->spire otel Telemetry s1->otel workers Run Controllers / Workers s1->workers s2->pg s2->obj s2->spire s2->otel s2->workers nodes Agent Compute Node Pools CPU • GPU • high-isolation workers->nodes nodes->spire eg Controlled Egress Gateway nodes->eg ext Models • Tools • Enterprise Services eg->ext
Figure 8. Representative enterprise topology with horizontally scalable control services, dedicated agent compute, centralized identity and controlled egress.

Compute segmentation

Compute classExample use
Standard CPUInternal and lower-risk agents
High-isolationThird-party/BYOA workloads using stronger sandbox runtimes
High-memoryLarge context processing, data transformation and retrieval workloads
GPULocal inference, vision and accelerated agent workloads
Tenant-dedicatedDeployments requiring stronger infrastructure tenancy boundaries

10. Controlled Egress

Cluster-local policy can precisely constrain pod and namespace destinations. Public SaaS and enterprise endpoints may require an egress gateway or an FQDN-aware network control so outbound policy remains stable even when external service IPs change.

Deployment integration point: Andyur's mediated runtime is designed to compose with enterprise egress gateways, service meshes, cloud firewalls and private connectivity rather than bypass them.

11. Composable Infrastructure

Andyur's architecture separates orchestration, run execution and compute so enterprises can evolve infrastructure without changing the agent security contract.

G adm Andyur Admission Policy + Identity + Registry orch Orchestration Provider Local • Temporal • Enterprise adm->orch rec Andyur Run Execution Controller orch->rec compute Compute Provider Kubernetes • Docker • Future rec->compute runtime Per-Run Security Boundary compute->runtime
Figure 9. Provider-neutral boundaries allow durable orchestration and compute backends to evolve independently.
BoundaryExamples
Orchestration providerLocal execution, Temporal, enterprise durable workflow systems
Compute providerKubernetes, Docker and future cloud/managed compute backends
Isolation technologyContainers, sandboxed runtimes, microVM-based isolation
IdentitySPIFFE/SPIRE and enterprise workload-identity integrations
AuthorizationEnterprise identity provider, policy decision point and authorization server
SecretsEnterprise vault and cloud-native secret systems

Specific integrations and deployment modes depend on the selected Andyur release and enterprise environment.

12. What the Architecture Means for Enterprise Security

Architecture mechanismEnterprise outcome
Separate agent and trusted runtime podsA compromised agent does not automatically inherit the runtime's downstream network authority.
Default-deny networkingAgents cannot freely roam the cluster or enterprise network.
Credential mediationProvider and tool secrets do not need to be resident in the agent process.
Per-run workload identityActions can be associated with a specific execution rather than a generic shared service identity.
Immutable governed artifactsApproved code and configuration cannot silently drift at launch time.
Fail-closed containment barrierThe workload is not started until required network isolation is active.
Resource and compute policyRunaway or high-risk agents can be bounded and placed on appropriate infrastructure.
Mediated egress and telemetryModel/tool actions pass through enforceable, observable runtime paths.

Architecture Statement

Andyur is a policy-driven agent execution control plane that compiles an admitted agent run into a short-lived, identity-bound, network-contained compute environment with mediated access to models, tools, data and enterprise authority.

This architecture allows enterprises to bring agent frameworks and workloads into a common runtime security model while preserving their existing identity, authorization, networking, observability and compute infrastructure.

This document describes Andyur's external architecture model. Exact capabilities, integrations and deployment topology can vary by release and customer environment. Security-sensitive deployments should validate the selected configuration and controls against their own threat model.