When secrets management works for nested agents, each retrieves only the exact secret it needs, and that request is logged, approved, and never exposed in plaintext, teams can trust automation without fearing credential sprawl.
Current practice leaves secrets exposed
In many organizations a top‑level automation agent runs inside a private subnet and then launches helper processes – the so‑called nested agents – to perform short‑lived tasks. Those helpers often inherit a static API key or database password baked into the parent image. The key is passed to the child process via environment variables, shared files, or command‑line flags. Because the secret travels directly from the parent to the child, there is no central point that can verify who asked for the secret, whether the request matches a policy, or whether the secret should be redacted in logs. When a breach occurs, investigators find dozens of copies of the same credential scattered across logs, container layers and backup snapshots.
Why identity alone is not enough
Most modern stacks have already replaced hard‑coded passwords for the initial agent with OIDC or SAML tokens. The primary identity provider now asserts who the top‑level service is, and least‑privilege roles limit what that service can do. However, once the top‑level identity is established, the nested agents inherit the same token or continue to use the original static secret. The request still reaches the secret store directly, bypassing any enforcement point. Without a gateway in the data path, there is no way to require just‑in‑time approval, to mask the secret in transit, or to record the exact query for later audit.
hoop.dev as the enforcement point
hoop.dev is designed to sit in the data path between any identity (including the tokens that the parent agent presents) and the secret store that the nested agents need to query. By acting as a Layer 7 gateway, hoop.dev can inspect each request, apply policy, and forward only approved traffic. The gateway holds the credential needed to talk to the secret store, so the nested agents never see the raw secret. All authentication still originates from the identity provider, but the actual secret retrieval is mediated by hoop.dev.
How hoop.dev changes secrets management
Setup. Organizations configure OIDC or SAML integration once, defining which groups may request which categories of secrets. Provisioning is done through role‑based policies that describe “read‑only secret X” or “write‑only secret Y”. These policies decide who may start a request, but they do not enforce the request itself.
The data path. Every secret‑fetch request from a nested agent is forced through hoop.dev. The gateway can:
