Skip to main content

k8s-aws-oidc docs

k8s-aws-oidc republishes the Kubernetes service-account issuer metadata that AWS IAM needs to validate AssumeRoleWithWebIdentity for private clusters.

The service is small, but the full setup spans a few systems:

  • Kubernetes API server issuer and audience configuration
  • Tailscale Funnel for public OIDC discovery and JWKS
  • Helm deployment for the bridge
  • AWS IAM OIDC provider and trusted roles

This site is organized with Diátaxis:

  • Tutorials: one complete end-to-end path
  • How-to: operator tasks and targeted fixes
  • Reference: config, chart, Terraform, and endpoint details
  • Explanation: why the setup works the way it does

Start here if you are deploying the bridge for the first time: