Primary containment controls the agent at the point where it runs, using sandboxing, endpoint privilege restriction, and tool-level enforcement. Secondary containment sits between the agent and the enterprise, using proxies, OS-level controls, and session mediation. The first limits what the agent can do locally. The second prevents a local failure from becoming an enterprise-wide breach.
Why the distinction matters for AI agent containment
Primary containment is the control point closest to execution, so it is where you stop an agent from using local privilege, unsafe tools, or broad filesystem and network access in the first place. Secondary containment is the backstop, designed to absorb a failure that slips past the first layer and keep it from reaching shared services, data stores, or enterprise workflows. That separation matters because agent risk is usually not a single-control problem, it is a boundary problem.
In practice, teams often discover that the first control failed only after the agent already had enough authority to act on behalf of the organisation. When that happens, containment quality is judged by blast-radius reduction, not by whether the agent behaved well during testing.
How primary and secondary containment work in practice
Primary containment lives where the agent executes. It typically includes sandboxing, restricted local permissions, process isolation, tight tool whitelisting, and explicit limits on what the agent can read, write, launch, or call. If the agent is a coding assistant, that usually means constraining its ability to modify files, invoke shell commands, or reach secrets stores unless those actions are deliberately allowed. If the agent is a workflow operator, it means limiting which actions can be triggered and which resources can be reached directly.
Secondary containment sits one layer out and assumes the local runtime may still fail. That is why it uses mediation mechanisms such as proxies, OS-level policy enforcement, session brokering, request inspection, and transaction gates between the agent and enterprise systems. The goal is not to make the agent harmless everywhere, but to ensure that even if the local environment is compromised, the enterprise still has a chance to block, inspect, or narrow the resulting action. OWASP Top 10 for Agentic Applications 2026 is a useful external reference for the kinds of tool abuse, privilege misuse, and agent trust failures that make this layering necessary.
- Primary containment answers, “What can the agent do on the box or runtime where it executes?”
- Secondary containment answers, “What still gets through if the local runtime is subverted?”
- Primary controls reduce direct capability, secondary controls reduce downstream reach.
These controls tend to break down when the agent is granted direct network, filesystem, or credential access that bypasses the mediation layer entirely.
Common edge cases and where the boundary gets blurry
Tighter containment often increases friction, so organisations have to balance autonomy against operational overhead. Agent developers frequently want broader local access because it makes demos, debugging, and task completion easier, but that convenience can erase the practical difference between a contained agent and a privileged operator.
One common edge case is a tool-heavy agent that looks safely sandboxed but is allowed to call high-impact APIs through a pre-approved session. In that setup, primary containment may still be strong while secondary containment becomes the real control that decides whether a bad request reaches production systems. Another edge case is a host-level policy that is treated as “secondary” in design but actually behaves like primary containment because it is the first meaningful restriction on execution.
Guidance is still evolving on how much enforcement belongs in the runtime versus the mediation layer, but the practical rule is simple: if the agent can cause material harm without leaving the local environment, primary containment is too weak. CSA MAESTRO agentic AI threat modeling framework is useful here because it reinforces the need to model controls across agent, tool, and environment boundaries rather than treating containment as a single switch.
Risk and Threat Considerations
Agent containment is primarily about limiting compromise propagation. The risk is not only that an agent makes a bad decision, but that a compromised agent inherits enough trust to turn one execution mistake into data exposure, destructive change, or lateral access across connected systems.
Failure mechanism: Attackers and abuse paths typically exploit overbroad tool permissions, token reuse, weak session boundaries, or direct access to enterprise APIs. If the local agent runtime is not tightly restricted, primary containment fails first; if the enterprise-facing mediation layer is weak, secondary containment fails and the impact spreads outward.
Impact: The practical consequence is blast-radius expansion. A local prompt injection, poisoned instruction, or runtime compromise can become unauthorized file changes, credential use, data extraction, or destructive automation if either containment layer leaves a live path to production systems.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Agentic AI Top 10 and CSA MAESTRO address the attack and risk surface, while NIST AI RMF and NIST CSF 2.0 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| OWASP Agentic AI Top 10 | Agentic AI Top 10 | AI agent containment maps to tool misuse, privilege abuse and runtime trust failures. |
| Recommendation — Apply agentic AI controls to constrain tool access and runtime authority. | ||
| CSA MAESTRO | MAESTRO | Containment must be modelled across agent, tool and environment layers. |
| Recommendation — Use MAESTRO to separate agent execution, mediation and enterprise boundaries. | ||
| NIST AI RMF | AI Risk Management Framework | Primary and secondary containment are AI risk controls for reducing unsafe impact. |
| Recommendation — Manage agent containment as part of AI risk governance and control validation. | ||
| NIST CSF 2.0 | PR.AC-4 — Access Permissions Management | Containment depends on limiting what the agent can access and invoke. |
| PR.PS-1 — Configuration Management | Sandboxing and runtime restriction are configuration-driven containment controls. | |
| DE.CM-8 — Monitoring for anomalies and malicious activity | Secondary containment relies on detecting and blocking abnormal agent behaviour. | |
| Recommendation — Enforce least-privilege access for agent actions and connected systems. Harden agent runtime settings to reduce local execution capability. Monitor agent sessions for unsafe requests and unexpected tool use. | ||
Practitioner Guidance
What to prioritise: Treat primary containment as the control that removes ambient capability, and secondary containment as the control that filters residual reach. If both layers control the same action, the stronger design is usually the one that makes the dangerous action impossible locally, not merely visible at the boundary.
What to verify: Confirm that the agent cannot bypass the mediation layer with direct credentials, cached tokens, or unmediated network paths. Also verify that a successful local escape does not automatically inherit enterprise-wide trust, because that is the point where containment becomes theatre rather than protection.
Practitioner takeaway: The real test is not whether an agent is “contained” in abstract terms, but whether a local failure can still be stopped before it becomes an enterprise action.
Related resources from NHI Mgmt Group
- What is the difference between managed identities and hardcoded secrets for AI agents?
- What is the difference between workload identity and API keys for AI agents?
- What is the difference between logging actions and logging intent for AI agents?
- What is the difference between human identity governance and AI agent governance?