Join our Newsletter — 33% off our NHI Course

AWS OIDC Integration

AWS OIDC integration links a Teleport cluster to AWS through OpenID Connect so identity assertions can be used for access workflows. It enables the platform to authenticate users or sessions against AWS context and then apply the correct permissions, routing, and resource enrolment logic.

Expanded Definition

AWS OIDC integration connects an external identity provider or platform trust relationship to AWS using OpenID Connect, so AWS can evaluate identity assertions and issue access through federated workflows rather than fixed long-lived credentials. In practice, this sits between authentication and authorization: the token establishes who or what is asserting identity, and AWS then decides what that assertion may do.

This is not the same as generic single sign-on, nor is it equivalent to storing an AWS access key. The operational boundary matters because OIDC integration is usually used to reduce static secret handling, narrow trust scope, and make access decisions more contextual. That also means the integration is only as strong as the claims, issuer trust, token audience, and role mapping rules that define it.

Industry usage is fairly consistent on the transport and trust model, but the exact implementation varies by workflow. Some teams use OIDC for human federation, while others use it for CI/CD jobs, workload enrollment, or other machine-mediated access paths. For AWS-specific token and trust semantics, the AWS documentation on IAM roles for OpenID Connect federation is the most direct authority.

Examples and Use Cases

In cloud operations, AWS OIDC integration often appears where an external system needs temporary access without embedding AWS keys into code or pipelines. The practical pattern is usually short-lived, claim-based trust that maps a verified identity assertion to an AWS role.

  • A CI pipeline exchanges an OIDC token for a temporary AWS session so deployment jobs do not depend on stored access keys.
  • A platform team uses OIDC trust to let a Teleport-controlled session reach AWS resources with context-aware role selection.
  • An internal developer portal uses identity assertions to enroll users into the correct AWS account or resource boundary without manual key distribution.
  • A workload identity flow uses token claims to route an automation job to the right AWS permissions set based on environment, repository, or service identity.

The main tradeoff is convenience versus trust precision. OIDC reduces credential sprawl, but it also concentrates policy quality into claim design, issuer controls, and role trust policy review. If those inputs are too broad, the integration becomes an easier path to over-authorization rather than a reduction in exposure.

Security Implications

AWS OIDC integration is security-relevant because it replaces static credentials with a federated trust decision. When that trust decision is misconfigured, the failure is often not a visible login problem but an authorization problem: the wrong subject, repository, environment, or session can receive AWS permissions that were meant for a narrower workload or operator.

This creates concrete failure conditions such as claim spoofing through overly permissive trust rules, privilege escalation through broad role mapping, and silent persistence if a trusted issuer or upstream token source is compromised. It also changes detection: defenders may see legitimate-looking temporary sessions rather than obvious key theft, which can delay response.

NHIMG research shows why this matters operationally: 80% of identity breaches involved compromised non-human identities such as service accounts and API keys, and when AWS credentials are exposed publicly, attackers attempt access within an average of 17 minutes. That combination makes token trust hygiene and revocation speed especially important for AWS federation paths.

Domain and Governance Relevance

For NHI governance, AWS OIDC integration is a control point for how machine or platform identities enter AWS with usable authority. The governance question is not only whether the token is valid, but who owns the trust relationship, how claims are bounded, and how quickly the access path can be removed when the upstream identity source changes.

This is where workload identity, secrets reduction, and Zero Standing Privilege intersect. A well-governed OIDC integration can reduce the need for long-lived AWS secrets, but it also creates a policy surface that must be inventoried, reviewed, and tested like any other high-trust identity path. In practice, the boundary between identity assurance and cloud authorization becomes a shared control responsibility across platform, security, and application teams.

For teams managing non-human access at scale, the most important shift is that access is no longer governed primarily by stored credentials. It is governed by the trust contract between AWS and the external issuer, which means lifecycle, offboarding, and claim review become part of the same governance problem.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

OWASP Non-Human Identity Top 10 and MITRE ATT&CK address the attack and risk surface, while NIST CSF 2.0, CIS Controls v8 and NIST Zero Trust (SP 800-207) set the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
OWASP Non-Human Identity Top 10 NHI-01 — Identity Lifecycle and Ownership OIDC trust depends on owning and reviewing non-human identity relationships.
NHI-02 — Secrets and Credential Management OIDC is often chosen to reduce long-lived AWS credentials and secret sprawl.
NHI-03 — Authorization and Least Privilege Role mapping and claims determine how much AWS access the assertion receives.
Recommendation — Inventory each OIDC trust relationship and assign a named owner for review and revocation. Replace static AWS keys with short-lived federation wherever the workflow allows it. Constrain federated roles to the minimum AWS permissions each trusted claim set needs.
NIST CSF 2.0 PR.AC-1 — Identity Management, Authentication and Access Control OIDC integration is a federated authentication and access-control mechanism.
Recommendation — Validate federated identities before granting AWS access through role trust policies.
CIS Controls v8 6.3 — Credential Access Management OIDC reduces reliance on stored credentials and supports credential-risk reduction.
Recommendation — Eliminate embedded AWS credentials where OIDC federation can provide temporary access.
NIST Zero Trust (SP 800-207) 5.1 — Identity as the Primary Security Perimeter OIDC makes identity assertions the trust boundary for AWS access decisions.
Recommendation — Treat the OIDC issuer and claims as the control point for AWS trust enforcement.
MITRE ATT&CK T1528 — Steal Application Access Token Compromised OIDC tokens can be abused to obtain cloud access through trusted paths.
Recommendation — Hunt for token theft and unusual federation activity that leads to AWS session creation.