All posts

ISO 27001 for Subagents

When an ISO 27001 audit asks for proof that every subagent action is traceable, approved, and protected, the ideal report shows a complete, immutable trail of who did what, when, and how sensitive data was handled. Auditors expect documented policies, controlled access, real‑time monitoring, and evidence that privileged commands cannot bypass oversight. Why subagents often fall short of iso 27001 evidence In many organizations, teams grant subagents – scripts, CI runners, or automated service

Free White Paper

ISO 27001: The Complete Guide

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

Free. No spam. Unsubscribe anytime.

When an ISO 27001 audit asks for proof that every subagent action is traceable, approved, and protected, the ideal report shows a complete, immutable trail of who did what, when, and how sensitive data was handled. Auditors expect documented policies, controlled access, real‑time monitoring, and evidence that privileged commands cannot bypass oversight.

Why subagents often fall short of iso 27001 evidence

In many organizations, teams grant subagents – scripts, CI runners, or automated services – long‑lived credentials and copy those credentials across environments. Organizations store the credentials in shared vaults or plain‑text files, and the agents connect directly to databases, Kubernetes clusters, or SSH hosts. The result is a black box: the subagent talks to the target, but no central system records the request, the exact query, or the response. When a breach occurs, the team can tell that a subagent participated, but they cannot prove which command triggered the event, whether the data returned contained PII, or whether an approval step bypassed the process.

Even when organizations adopt least‑privilege IAM roles or short‑lived tokens, the enforcement still happens on the client side. The request reaches the target directly, and the target has no visibility into who authorized the operation or whether the response needed redaction. Consequently, the audit trail fragments, and the organization cannot demonstrate compliance with ISO 27001 clauses that require controlled access (A.9.2), protection of information in use (A.12.4), and audit logging (A.12.4.1).

What must change before you can hand an auditor a complete package

The organization issues each subagent identity through a trusted identity provider and ensures the token carries only the permissions required for the specific job. This setup defines who the request is, but it does not enforce any guardrails on the traffic itself. The subagent still talks straight to the database or Kubernetes API, meaning the organization lacks a single point where policies such as just‑in‑time approval, command‑level blocking, or inline data masking can be applied.

Without a gateway in the data path, the organization cannot guarantee that every command is recorded, that sensitive fields are masked before they leave the target, or that a human can intervene on risky operations. In other words, the missing piece is a control surface that sits between the subagent and the resource and enforces the policies required by iso 27001.

hoop.dev as the data‑path enforcement layer

hoop.dev fulfills that missing layer. It is a Layer 7 gateway that proxies connections to databases, Kubernetes clusters, SSH hosts, and internal HTTP services. The gateway runs an agent inside the customer network, so the target never sees the subagent’s credentials. All traffic passes through hoop.dev, which is the only place where enforcement can happen.

Setup: The organization handles identity via OIDC or SAML. The IdP issues a token that the subagent presents, and hoop.dev validates the token, extracting group membership and attributes that drive policy decisions. This step decides who may start a session, but it does not, by itself, provide audit evidence.

Continue reading? Get the full guide.

ISO 27001: Architecture Patterns & Best Practices

Free. No spam. Unsubscribe anytime.

The data path: After the system accepts the token, hoop.dev becomes the proxy for the subagent’s request. Because the gateway sits in the data path, it inspects each protocol message, applies inline masking to columns that contain personal data, and blocks commands that match a deny list before they reach the backend.

Enforcement outcomes: hoop.dev records every session, capturing the full command stream and the corresponding responses. It stores approval events when a risky operation requires a human sign‑off, and it masks sensitive fields in real time, helping keep audit logs free of raw personal data.

Mapping hoop.dev artifacts to iso 27001 controls

  • A.9.2 – Privileged access management: hoop.dev enforces just‑in‑time access, granting subagents the exact rights needed for the duration of the session.
  • A.12.4 – Protection of log information: You retain recorded sessions according to your policy, and you apply inline masking so that logs omit raw personal data.
  • A.12.4.1 – Event logging: hoop.dev logs every command and response with user identity, timestamp, and outcome, providing the immutable audit trail auditors require.
  • A.12.6 – Technical vulnerability management: hoop.dev blocks dangerous commands, reducing the attack surface and demonstrating proactive risk mitigation.

When an auditor requests evidence, you can export the session recordings, approval records, and masked logs directly from hoop.dev. Those files show exactly which subagent performed which action, the approval workflow that preceded it, and the sanitized data that was returned. The evidence aligns with iso 27001’s requirement for “documented, verifiable records of access and activity”.

Getting started with hoop.dev for subagents

To build the required evidence chain, start with the official getting‑started guide, which walks you through deploying the gateway, registering a subagent connection, and configuring OIDC authentication. The learn portal provides deeper explanations of session recording, approval policies, and inline masking rules.

Once the gateway is in place, define policies that require approval for any DDL statement, enable masking for columns that store credit‑card numbers, and set up alerts for command‑level blocks. The system automatically generates the logs and audit artifacts you need for iso 27001 compliance.

Frequently asked questions

Do I need to change my existing subagent code?

No. hoop.dev works with standard clients (psql, kubectl, ssh, etc.). The subagent simply points to the gateway endpoint instead of the raw target, preserving existing workflows.

How long are session recordings retained?

You configure retention in the gateway settings. Choose a period that satisfies your organization’s policy and iso 27001 evidence‑retention requirements.

Can I export the audit data for an external auditor?

Yes. hoop.dev provides export endpoints that deliver the recorded sessions, approval logs, and masked data in common formats (JSON, CSV). Those files can be handed to the auditor without exposing raw credentials.

Take the next step

Explore the source code, contribute improvements, or spin up a test deployment by visiting the GitHub repository:

hoop.dev 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