All posts

Autonomous agents: what they mean for your access reviews (on BigQuery)

Are you confident that autonomous agents accessing your BigQuery data are being reviewed correctly? Most organizations treat an autonomous agent like any other service account: a static credential is created, that credential is granted a broad set of BigQuery roles, and the agent is allowed to run queries whenever it decides. The credential lives in a secret store, is shared across multiple pipelines, and rarely changes. When a quarterly access review comes around, auditors scan IAM policies, c

Free White Paper

Access Reviews & Recertification + Single Sign-On (SSO): The Complete Guide

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

Free. No spam. Unsubscribe anytime.

Are you confident that autonomous agents accessing your BigQuery data are being reviewed correctly?

Most organizations treat an autonomous agent like any other service account: a static credential is created, that credential is granted a broad set of BigQuery roles, and the agent is allowed to run queries whenever it decides. The credential lives in a secret store, is shared across multiple pipelines, and rarely changes. When a quarterly access review comes around, auditors scan IAM policies, check which service accounts have the bigquery.dataViewer role, and sign off based on the list. They have no visibility into which queries were actually run, whether the data returned was sensitive, or if the agent ever exceeded its intended purpose. The result is a compliance surface that looks tidy on paper but hides real‑time risk.

This situation fixes the problem of “who can connect” by assigning a role, but it leaves the request to hit BigQuery directly, without any runtime guardrails. No audit trail of individual queries is captured, no inline masking of PII occurs, and there is no just‑in‑time approval step before a potentially expensive or data‑exposing query runs. In short, the access review process remains static while the agent’s behavior is dynamic and invisible.

Enter hoop.dev. hoop.dev is a Layer 7 gateway that sits between the autonomous agent and BigQuery. It authenticates the agent via OIDC, proxies the connection, and enforces policies at the protocol level. Because hoop.dev sits in the data path, it can record every query, apply inline data masking, require just‑in‑time approvals for risky statements, and replay sessions for forensic analysis. The enforcement outcomes, query‑level audit, masking, JIT approval, session recording, exist only because hoop.dev is the only place that can inspect and control traffic before it reaches the database.

Why access reviews need a runtime gate

Traditional access reviews focus on static permissions: who has bigquery.dataViewer, who can create datasets, and so on. That model assumes the principal’s behavior is predictable, which is false for autonomous agents that can be updated, re‑trained, or repurposed without a new IAM review. Without a runtime gate, a single credential can be used to run ad‑hoc analytical queries, export large tables, or even join with external data sources, all without triggering any alert.

When hoop.dev proxies the connection, it becomes the enforcement point for the following outcomes:

  • Query‑level audit: every SQL statement is logged with the agent’s identity, timestamp, and result metadata.
  • Inline masking: fields tagged as sensitive (e.g., SSN, credit‑card numbers) are redacted in the response before the agent sees them.
  • Just‑in‑time approval: queries that match a risk pattern (large scans, cross‑project joins) are paused and routed to a human reviewer.
  • Session recording and replay: the full request/response stream is stored for later forensic review.

All of these capabilities directly support effective access reviews. Auditors can now see not just which service accounts exist, but exactly what data each autonomous agent accessed, when, and under what approval conditions. The evidence generated by hoop.dev satisfies the documentation requirements of many compliance frameworks without claiming any certification.

Continue reading? Get the full guide.

Access Reviews & Recertification + Single Sign-On (SSO): Architecture Patterns & Best Practices

Free. No spam. Unsubscribe anytime.

How hoop.dev integrates with autonomous agents

Agents authenticate to hoop.dev using an OIDC token issued by the organization’s identity provider. hoop.dev validates the token, extracts group membership, and maps it to a policy that defines what BigQuery actions are allowed. The agent never receives the underlying BigQuery credentials; hoop.dev holds them and presents them to BigQuery on behalf of the agent. Because the gateway is the only component that can see the raw SQL, it is the sole place where masking, approval, and logging can be applied.

Implementing the gate for BigQuery

Deploying hoop.dev for BigQuery follows a straightforward, high‑level flow:

  1. Run the hoop.dev gateway using the provided Docker Compose file or a Kubernetes manifest. The quick‑start guide walks you through the deployment steps.
  2. Register a BigQuery connection in the hoop.dev UI, supplying the project ID and a service account that has the minimal required roles. hoop.dev stores this credential securely.
  3. Configure OIDC authentication by pointing hoop.dev at your IdP metadata URL. Define a group that represents autonomous agents and map it to a policy that limits query size, enforces masking rules, and requires approval for high‑risk statements.
  4. Update the autonomous agent’s configuration to point its BigQuery client at the hoop.dev endpoint instead of the native Google endpoint. The agent continues to use its existing client libraries; hoop.dev handles the protocol translation.

After these steps, every query the agent issues passes through hoop.dev. The gateway enforces the policies you defined, records the session, and produces audit evidence that can be reviewed during the next access review cycle.

For detailed instructions, see the getting‑started guide and the broader feature documentation on the learn site. Both resources walk you through deployment, connection registration, and policy authoring without exposing any low‑level configuration snippets.

FAQ

Do autonomous agents need to be rewritten to work with hoop.dev?
No. Agents continue to use their standard BigQuery client libraries. The only change is the endpoint they connect to, which points at the hoop.dev gateway.

Can hoop.dev mask data without breaking the agent’s workflow?
Yes. Masking happens inline on the response stream before it reaches the agent, preserving the shape of the result set while redacting sensitive fields.

What happens if an approval is required but no reviewer is available?
The query remains paused until a reviewer approves or rejects it. This prevents accidental execution of high‑impact statements when no human is present.

By placing a runtime enforcement layer between autonomous agents and BigQuery, organizations can turn static access reviews into a dynamic, evidence‑rich process that truly reflects what data is accessed and how.

Explore the open‑source repository on GitHub to get started: github.com/hoophq/hoop.

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