All posts

ISO 27001 for Agent Runtimes

During an ISO 27001 audit, organizations must present evidence that every privileged interaction with agent runtimes is traceable, approved, and that any confidential data that traverses the system is protected. In practice, teams often run agents with long‑lived service accounts, embed credentials in scripts, and allow direct connections to databases or containers. Those connections generate raw logs that contain secrets and provide no built‑in mechanism to require approval before a destructive

Free White Paper

ISO 27001 + Open Policy Agent (OPA): The Complete Guide

Architecture patterns, implementation strategies, and security best practices. Delivered to your inbox.

Free. No spam. Unsubscribe anytime.

During an ISO 27001 audit, organizations must present evidence that every privileged interaction with agent runtimes is traceable, approved, and that any confidential data that traverses the system is protected. In practice, teams often run agents with long‑lived service accounts, embed credentials in scripts, and allow direct connections to databases or containers. Those connections generate raw logs that contain secrets and provide no built‑in mechanism to require approval before a destructive command runs. Without a control point that sits between the identity provider and the target system, auditors see only unstructured logs and cannot verify who approved high‑risk actions or whether sensitive fields were redacted. The missing piece is a layer‑7 gateway that can enforce policies, mask data, record sessions, and tie every request to a verified identity.

What auditors expect for agent runtimes

ISO 27001 requires organizations to demonstrate control over privileged access, to retain logs that show who did what, and to protect confidential information during processing. For agent runtimes, processes that execute code on behalf of users, CI pipelines, or automated bots, this means capturing the full command stream, recording the output, and linking each interaction to a verified identity. Auditors also look for evidence that teams do not expose any data classified as personal or confidential, and that they retain those logs for the required retention period.

Why the current approach falls short

Many teams run agent runtimes with static service accounts or long‑lived API keys. The runtime connects directly to the target system, and teams often leave the connection open for weeks or months. Engineers embed credentials in scripts, CI pipelines store them in plain‑text variables, and the runtime itself logs every command without any redaction. The result is a flood of raw logs that contain passwords, tokens, or PII, and no central point where teams can enforce policy.

Even when organizations adopt identity‑aware tokens, the request still reaches the target system directly. Teams cannot guarantee that they review each command, mask sensitive fields, or replay a session for forensic analysis. In short, the setup satisfies authentication but provides no visibility or control over the actual data path.

How hoop.dev bridges the gap

hoop.dev sits in the data path between the identity provider and the agent runtime’s target system. By proxying every connection, hoop.dev becomes the only place where enforcement can happen. It records each session, masks sensitive fields in real time, and routes high‑risk operations to a human approver before they reach the target. Because the gateway holds the credential, the runtime never sees the secret, and the gateway generates the audit trail outside the process that executes the command.

Session recording for immutable evidence

hoop.dev records the full request and response stream for every interaction. The recorded artifact includes the identity that initiated the session, a timestamp, and integrity metadata that can be validated later. Auditors can replay the session to see exactly what was typed, what the system returned, and how the policy engine responded. This satisfies ISO 27001’s requirement for traceability and non‑repudiation.

Inline data masking

When a response contains credit‑card numbers, social security numbers, or other regulated data, hoop.dev applies inline masking before the data reaches the user or log collector. hoop.dev never persists the original value in plain text, reducing the risk of accidental exposure and ensuring that audit logs contain only redacted information. This directly addresses the standard’s control on protecting data in transit and at rest.

Continue reading? Get the full guide.

ISO 27001 + Open Policy Agent (OPA): Architecture Patterns & Best Practices

Free. No spam. Unsubscribe anytime.

Just‑in‑time access and approval workflows

High‑impact commands, such as deleting a production database, restarting a critical service, or modifying IAM policies, are flagged by hoop.dev. hoop.dev pauses the request and sends it to an approval queue where a designated reviewer can grant or deny permission. hoop.dev records the approval decision alongside the session, providing the documented evidence of “authorized by” that ISO 27001 expects for privileged actions.

Policy‑driven command blocking

Administrators can define patterns that are never allowed, such as commands that drop tables or expose raw environment variables. hoop.dev evaluates each command against these rules and blocks any that violate policy before they are sent to the target. This proactive control reduces the blast radius of accidental or malicious actions, fulfilling the standard’s requirement for preventive controls.

Putting it all together for ISO 27001 evidence

When you deploy hoop.dev in front of your agent runtimes, the following artifacts become available for audit:

  • Authenticated identity for every session, sourced from your OIDC or SAML provider.
  • Immutable session recordings that teams can replay on demand.
  • Redacted logs that never expose regulated data.
  • Approval records that tie high‑risk actions to a specific reviewer.
  • Policy violation reports that show which commands hoop.dev blocked.

All of these are generated by the gateway, not by the runtime itself, which means the gateway prevents the evidence from being altered by the monitored process. This separation of duties aligns with ISO 27001’s Annex A controls on segregation of duties and audit logging.

To get started, follow the hoop.dev getting started guide. The documentation explains how to configure OIDC authentication, define masking rules, and set up approval workflows. For deeper insight into each feature, explore the hoop.dev feature documentation. The open‑source repository on GitHub provides the full implementation and example configurations.

FAQ

Do I need to change my existing agent code?

No. hoop.dev works as a transparent proxy. Your agents continue to use their usual client libraries; the only change is the endpoint they connect to, which points at the gateway.

Can I use hoop.dev with multiple identity providers?

Yes. hoop.dev acts as a relying party for any OIDC or SAML provider, allowing you to centralise authentication while keeping enforcement in the data path.

How long are session recordings retained?

Retention is a policy decision you configure in the gateway. The recordings are stored outside the agent runtime, so you can keep them for the period required by ISO 27001 without impacting the runtime’s performance.

View the source on GitHub

Open source

Save the open-source gateway for agent data access

Hoop is MIT-licensed infrastructure for controlling how AI agents reach production data. Star hoophq/hoop so you can inspect it, deploy it, or share it when your team starts governing agent access.

Star and save the repo →More posts