Agent Substrate is in a pre-release (preview) state. This policy is intentionally minimal for that stage and will be revisited as part of the General Availability (GA) milestone, see Road to GA below.
In particular, all of the following currently apply:
- Reports can be made exclusively via GitHub advisories.
- Maintainers triage and fix advisories on a best-effort basis.
- There is no bug bounty.
- There is no security mailing list for announcements.
- There are no SLOs on fix timeline.
- There are no embargos.
- Though we do wait to publish advisories until fixes have been merged, details may appear in PRs prior to publishing.
Do not open a public GitHub issue or pull request for security vulnerabilities.
Use GitHub Private Vulnerability Reporting to report privately. This is the only supported reporting channel; there is no security mailing list at this stage. There is no bug bounty, and this project is not eligible for the Google Open Source Software Vulnerability Rewards Program.
Please include:
- The affected component and version (commit SHA).
- Steps to reproduce, or a proof of concept.
- The potential impact, and mitigations if known.
- You think you found a potential security vulnerability in Agent Substrate.
- You are unsure whether an issue affects Agent Substrate.
- You found a vulnerability in a project Agent Substrate depends on and it is exploitable through Agent Substrate. If that project has its own disclosure process, please report it there first.
- You need help securing or tuning a deployment (open a regular issue or discussion).
- The issue is not security related.
See the threat model for the trust boundaries and assumptions this section is based on.
In scope: the Agent Substrate control plane (ateapi), node supervisor
(atelet, ateom), networking stack (atenet), and CLI (kubectl-ate).
Agent Substrate multiplexes many actors onto a smaller pool of shared workers, so its most important security boundaries are between actors and between actors and the platform. Reports in these classes are the most valuable, listed roughly from most to least severe:
- Cross-actor access: an actor reading or modifying another actor's state (memory, filesystem, working memory) on a shared worker, or acting across atespace boundaries.
- Snapshot integrity and confidentiality: reading another actor's suspend/resume snapshot, or resuming an actor from a tampered snapshot.
- Routing: traffic intended for one actor delivered to another.
- Identity: forging session identity (for example session JWTs).
- Control-plane authentication and authorization bypass: reaching
ateapiRPCs without valid credentials (mTLS or JWT auth modes), misusing workerpool client certificates, or acting beyond what valid credentials are authorized to do. - Actor-to-platform escalation: an actor compromising
atelet,ateom, or the control plane, whether while the actor is still actively running or beyond its own lifecycle. - Node lateral movement: using a compromised worker node to reach other nodes, atespaces, or the control plane.
- Network isolation bypass: an actor sending or receiving traffic that
atenetpolicy was meant to prevent.
- The underlying Kubernetes cluster or cloud infrastructure.
- The sandbox runtimes (gVisor, Kata Containers); report those to their respective projects.
- The demo applications under
demos/; they are examples, not production code. - Known limitations listed in docs/roadmap.md and AGENTS.md, at the time of your report. These are living docs and can lag reality; if you're unsure whether a listed limitation is still accurate, report it anyway and let a maintainer make the call.
- Denial of service against workloads deployed without resource limits.
- Issues that require cluster-admin permissions or root on the node; that level of access already controls the platform.
- Vulnerability scanner or CVE reports about dependencies without an exploitable path through Agent Substrate (see Dependencies).
- Sandbox escapes contained entirely within gVisor or Kata Containers; report those upstream (see Out of scope).
If you are unsure whether something qualifies, report it privately anyway.
While the project is in preview there is no dedicated security team or response committee. Reports are triaged and fixed by the project maintainers, who own the repository.
What to expect at this stage:
- We aim to acknowledge reports within a few business days, but there are no formal response or fix time SLOs yet.
- Fixes are best effort and land on
main. All valid reports will be patched by GA. - There is no embargo process and no pre-disclosure notification to downstream users or vendors. Though we do wait to publish advisories until fixes have been merged, some details may appear in PRs prior to publishing.
We ask reporters to keep vulnerability details private until an advisory is published; we prefer to disclose as soon as a fix is available.
We expect security research against Agent Substrate to be done in good faith, meaning:
- Test only against clusters and deployments you own or are authorized to test.
- Do not access, modify, or destroy data that is not yours; use test workloads to demonstrate impact.
- Do not degrade service for others while testing.
This policy covers the Agent Substrate open source project only. It does not authorize testing of anyone else's deployment of Agent Substrate; those are governed by the respective operator's own policies.
Dependency vulnerabilities are tracked with govulncheck in CI, and fixes
are applied by updating the dependency on main. If a dependency
vulnerability is exploitable through Agent Substrate, report it to us
privately as well as upstream; otherwise a regular issue or pull request
bumping the dependency is enough.
There are no stable releases yet. Security fixes are applied to main only;
there are no release branches and no backports.
After a fix is merged, we publish a
GitHub Security Advisory
describing the vulnerability and the fix, and request a CVE through GitHub
when warranted. We publish as soon as the fix is verified on main; there
is no coordinated embargo or pre-disclosure period at this stage.
Reporters are credited in the advisory unless they prefer to remain anonymous.
As the project matures we expect to define, at or before GA:
- What triggers the switch from this preview policy to the full process.
- A defined triage process and ownership (for example a security response committee or rotation).
- Response and fix SLOs by severity.
- A security announcements channel (for example a mailing list).
- An embargo and coordinated disclosure process, including pre-disclosure notification for downstream distributors.
- A patch and release process for supported release branches, including backports.
- Whether to incentivize reports with a bug bounty program.
Until then, the preview-state process above applies.