All posts

Configuring autonomous agents access to EKS with OIDC/SSO

Autonomous agents can reach an EKS cluster using a single OIDC/SSO identity, with permissions granted only for the exact operation they need, while every command is recorded and any sensitive data is masked. In that model the agent never holds long‑lived AWS keys, and the cluster sees a short‑lived, purpose‑bound session that expires automatically. Teams gain confidence that a bot cannot wander beyond its intended scope, and auditors have a complete audit trail of what was run. The combination o

Free White Paper

EKS Access Management + Protocol Translation (SAML to OIDC): The Complete Guide

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

Free. No spam. Unsubscribe anytime.

Autonomous agents can reach an EKS cluster using a single OIDC/SSO identity, with permissions granted only for the exact operation they need, while every command is recorded and any sensitive data is masked. In that model the agent never holds long‑lived AWS keys, and the cluster sees a short‑lived, purpose‑bound session that expires automatically. Teams gain confidence that a bot cannot wander beyond its intended scope, and auditors have a complete audit trail of what was run. The combination of just‑in‑time access, real‑time approval, and command‑level audit turns a potential security blind spot into a controllable surface.

Why oidc/sso matters for EKS access

OIDC/SSO provides a federated identity that can be mapped to AWS roles and, ultimately, to Kubernetes RBAC. By using a single identity provider, organizations can retire static IAM users for bots, enforce MFA at the source, and centralise group membership. The identity itself is trustworthy, but without a gateway the request still travels directly to the cluster, leaving the control plane exposed to unchecked commands.

Current practice and its gaps

Many teams provision autonomous agents with long‑lived IAM access keys that are stored in secret managers or embedded in CI pipelines. The keys often have broad permissions, read/write across all namespaces, ability to create new resources, and sometimes even cluster‑admin rights. Because the agent talks straight to the EKS API, there is no record of which command was issued, no way to mask secrets that appear in logs, and no inline approval step for privileged actions. If a credential is compromised, the attacker can move laterally across the entire cluster with no visibility.

The missing enforcement layer

Even when OIDC/SSO is in place, the request still reaches the Kubernetes control plane directly. The setup decides who may start a session, but it does not enforce what the session may do. Without a data‑path enforcement point, you cannot apply command‑level guardrails, capture a complete audit trail, or perform real‑time data masking. The security guarantees you need exist only when a gateway sits between the identity and the cluster.

hoop.dev as the data‑path gateway

hoop.dev is a Layer 7 gateway that proxies every connection to EKS. It verifies the OIDC/SSO token, extracts group claims, and then uses a dedicated IAM role that the gateway agent assumes. That role is mapped to a Kubernetes RBAC binding, so the session inherits the exact permissions required for the requested operation. Because the gateway holds the credential, the agent never sees it.

How hoop.dev enforces oidc/sso for EKS

  • Identity verification – hoop.dev validates the OIDC/SSO token against the configured IdP and reads group membership.
  • Just‑in‑time role assumption – The gateway agent assumes the EKS‑specific IAM role defined on the connection, which is linked to a Kubernetes ClusterRoleBinding for the session.
  • Command‑level guardrails – Before any kubectl command reaches the API server, hoop.dev inspects the request. Dangerous verbs such as delete on cluster‑wide resources can be blocked or routed for manual approval.
  • Inline data masking – Responses that contain secret fields are filtered in real time, preventing sensitive values from appearing in logs or downstream tools.
  • Session recording – Every command and its result are recorded by hoop.dev, creating a replayable audit trail that auditors can query without needing access to the cluster itself.
  • Approval workflows – For actions that exceed a predefined risk threshold, hoop.dev pauses the request and notifies a reviewer. Once approved, the command proceeds; otherwise it is denied.

All of these outcomes are possible only because hoop.dev occupies the data path between the identity provider and the EKS control plane.

Continue reading? Get the full guide.

EKS Access Management + Protocol Translation (SAML to OIDC): Architecture Patterns & Best Practices

Free. No spam. Unsubscribe anytime.

Benefits of the integrated approach

By centralising OIDC/SSO verification and enforcement in a single gateway, you achieve:

  • Reduced blast radius – agents receive only the permissions they need for the duration of the session.
  • Comprehensive audit – Every kubectl invocation is logged, enabling forensic analysis and compliance reporting.
  • Secret protection – Inline masking ensures that credentials never leak into log aggregation systems.
  • Human oversight – Approval workflows add a manual checkpoint for high‑risk operations without slowing down routine work.
  • Simplified operations – Teams manage one set of OIDC/SSO policies instead of juggling per‑agent IAM keys.

These capabilities turn a previously opaque bot‑to‑cluster relationship into a transparent, controllable process.

Getting started

For a step‑by‑step walkthrough of deploying hoop.dev, configuring the EKS connector, and enabling OIDC/SSO, see the getting‑started guide. The learn section provides deeper explanations of masking, guardrails, and approval flows.

FAQ

Can I use an existing OIDC provider? Yes. hoop.dev works with any OIDC‑compatible IdP, including Okta, Azure AD, and Google Workspace. The provider issues the token; hoop.dev validates it and extracts the claims needed for RBAC mapping.

What happens if the gateway goes down? Because the gateway holds the credentials, agents cannot reach the cluster without it. This forces a fail‑closed posture, ensuring that no unauthorised access occurs during an outage.

Do I still need IAM policies on the underlying nodes? Minimal policies are required for the gateway agent to assume the dedicated EKS role. All fine‑grained permissions are enforced by hoop.dev at the request level.

Explore the source code, contribute enhancements, and see the full implementation 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