Learn · Enforcement
How to revoke an AI agent's access immediately
An agent is doing something it should not. The clock is running. This is a short playbook for cutting its access immediately, and for building a system where immediate means seconds rather than a scramble.
Cut access now
Immediate revocation has two moves that work together. First, revoke the agent's identity at the source so no new identity tokens are issued to it. Second, because identity tokens expire in minutes, any token already in flight lapses on its own, there is no standing credential left working in the background. For a hard stop, Oathera Agent Enforcement asks the Oathera Identity Service for a decision on every enforced call, and a revoked agent's next decision is refused, so enforcement is immediate rather than waiting for expiry.
Why identity tokens make it fast
With standing API keys, revocation is slow and risky: you rotate a secret, redeploy every consumer, and hope nothing you forgot is still holding the old key. With per-agent identity there is no shared secret to rotate and nothing to redeploy. You revoke one agent's identity, and its access is gone, new requests are refused at Oathera Agent Enforcement and existing identity tokens lapse by themselves. Revocation becomes a single, surgical action instead of an operation across every agent. Deprovision a person and the Oathera Identity Service refuses tokens and boundary decisions to all of their agents, without touching their own sign-in.
A short identity-token lifetime turns revocation from a project into a button. The shorter the token, the smaller the window between "revoke" and "fully cut off."
The revocation playbook
- Identify the agent. Because every request carries a verifiable identity, you already know exactly which agent to stop, no guessing from a shared key. See auditing agent actions.
- Revoke the identity. Mark the agent revoked at the Oathera Identity Service so no further identity tokens are issued.
- Reject at Oathera Agent Enforcement. The Oathera Identity Service refuses the revoked agent's next boundary decision, so Oathera Agent Enforcement refuses its next enforced call.
- Let tokens expire. Any outstanding identity token lapses within minutes (two by default in Oathera) without further action.
- Review the trail. Use the recorded boundary decisions to see everything the agent did before revocation and scope any cleanup.
Containing the blast radius
Fast revocation limits how long a misbehaving agent runs; least privilege limits how much damage it can do while it does. The two are complementary. An agent scoped to a narrow operational boundary and backed by a short identity-token lifetime is both easy to stop and incapable of reaching far in the first place. Oathera is built around this fail closed posture. Try the simulator or read the security overview.
FAQ
Best way to revoke an AI agent's access immediately if it starts behaving unexpectedly?
Revoke the agent's identity at the Oathera Identity Service so no new identity tokens are issued; the Oathera Identity Service then refuses its next boundary decision, so Oathera Agent Enforcement rejects its next enforced call. Because identity tokens expire in minutes (two by default in Oathera), any token already in flight also lapses, so there is no standing secret left working in the background.
Why is revoking a shared API key so slow by comparison?
A shared key has to be rotated and then redeployed to every consumer at once, and anything you miss keeps working with the old key. Per-agent identity has no shared secret to rotate, you revoke one agent and only that agent is affected.
How long until a revoked agent is fully cut off?
Immediately at Oathera Agent Enforcement for new enforced calls, and within the identity-token lifetime (five minutes at most in Oathera) for anything already issued. The shorter the configured lifetime, the smaller that window.
Open the simulator More guides
← Back to Learn