All posts

Tool Use and Access Reviews: What to Know

An offboarded contractor still has a personal SSH key stored in the shared vault, and a nightly CI job continues to push database schema changes using a hard‑coded service account. Access reviews are meant to catch such drift, but they often miss tool‑driven credentials because the review process looks at user accounts, not at the secrets embedded in scripts or automation pipelines. The security team receives an alert that a sensitive table was altered, but the logs show only the service account

Free White Paper

Access Reviews & Recertification + Customer Support Access to Production: The Complete Guide

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

Free. No spam. Unsubscribe anytime.

An offboarded contractor still has a personal SSH key stored in the shared vault, and a nightly CI job continues to push database schema changes using a hard‑coded service account. Access reviews are meant to catch such drift, but they often miss tool‑driven credentials because the review process looks at user accounts, not at the secrets embedded in scripts or automation pipelines. The security team receives an alert that a sensitive table was altered, but the logs show only the service account name, not the individual who triggered the change.

These kinds of incidents highlight the disconnect between the tools engineers use daily and the organization’s access‑review processes. When a tool, whether a CLI, a CI pipeline, or an interactive shell, carries a credential, the credential often outlives the person or purpose that created it.

Access reviews are supposed to answer the question, “Does this identity still need this permission?” In practice, reviews are performed on user accounts, groups, or roles, while the credentials embedded in tools remain invisible to the review workflow. The result is a blind spot where privileged access can be exercised without ever appearing on a reviewer’s checklist.

Why access reviews matter for tool use

Tool‑driven access bypasses the human‑in‑the‑loop step that most review programs rely on. A developer may invoke kubectl or psql from a laptop that stores a long‑lived token. A build server may run aws commands with an IAM key that never rotates. When an access‑review cycle runs, the auditor sees a role assignment but has no visibility into which automated process is actually exercising that role. Without that visibility, reviewers cannot make an informed decision about whether the permission should be retained.

Current practice leaves gaps

The typical starting state looks like this:

  • Shared passwords or static API keys are checked into code repositories or stored in a central vault that many teams can read.
  • Service accounts are granted broad, standing privileges that match the maximum need of any downstream job.
  • Connections to databases, Kubernetes clusters, or SSH hosts are made directly from the client, bypassing any central enforcement point.
  • Audit logs are either absent or limited to the target system, which records only the service account name, not the originating identity or intent.

These conditions satisfy the minimal requirement for an identity to start a request (the Setup layer), but they provide no place where policy can be applied. The request reaches the target directly, leaving the organization without real‑time approval, masking, or command‑level audit.

A gateway‑centric approach

Putting a Layer 7 gateway in the data path creates the only point where enforcement can happen. hoop.dev proxies connections to databases, Kubernetes clusters, SSH hosts, and HTTP services. Because every request flows through the gateway, hoop.dev can apply the controls that access‑review programs need.

Continue reading? Get the full guide.

Access Reviews & Recertification + Customer Support Access to Production: Architecture Patterns & Best Practices

Free. No spam. Unsubscribe anytime.

hoop.dev records each session, tying the activity to the identity that presented the OIDC or SAML token. It masks sensitive fields in query results, ensuring that downstream logs do not leak data. It requires just‑in‑time approval for commands that match a risk profile, and it blocks disallowed operations before they reach the backend. All of these outcomes exist only because the gateway sits in the data path.

When a periodic access‑review cycle runs, the organization can query the hoop.dev audit store to see exactly which identities invoked which commands, what data was returned, and whether any approvals were required. This granular evidence turns a vague role‑based review into a concrete, activity‑based assessment.

Because the gateway holds the target credentials, engineers and automation agents never see the secret directly. The Setup layer still decides who may start a request, but the enforcement outcomes, session recording, inline masking, JIT approval, and command blocking, are all delivered by hoop.dev in the data path.

Getting started

To adopt this model, start with the getting‑started guide. Deploy the gateway in your network, register the resources you need to protect, and configure OIDC authentication against your identity provider. The documentation explains how to enable session replay, define masking rules, and set up approval workflows.

For deeper insight into how masking and approval policies work, explore the learn section. It walks through common patterns for limiting data exposure and enforcing just‑in‑time access across the supported connectors.

FAQ

Do I need to change my existing CI pipelines?

No. The gateway acts as a transparent proxy. CI jobs point at the hoop.dev endpoint instead of the raw target, and the underlying credentials remain managed by the gateway.

Can I still use role‑based access control in my cloud provider?

Yes. The gateway respects the permissions granted to its service identity, but it adds a second enforcement layer that records who actually used those permissions and whether any additional approvals were required.

What happens to existing audit logs?

Historical logs stay where they are. Going forward, hoop.dev provides a unified audit trail that can be exported to SIEMs or compliance tools, giving you a single source of truth for future reviews.

Explore the hoop.dev source code on GitHub to see how the gateway is built and to contribute to the project.

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