Skip to content

[RDE-534] Document OIDC cloud authentication for RDE sessions - #382

Draft
gaborszakacs wants to merge 4 commits into
mainfrom
rde-oidc
Draft

gaborszakacs wants to merge 4 commits into
mainfrom
rde-oidc

Conversation

@gaborszakacs

@gaborszakacs gaborszakacs commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

RDE-534

Draft until the RDE backend and the session helper ship. The helper name (rde-id-token) and its one flag are the proposed design from the RFC and must be re-checked against the implementation before this merges.

TLDR

  • New page: Cloud authentication with OIDC, under RDE › Configuration
  • OIDC overview gains a short "Identity tokens for Remote Dev Environments" section with the session subject format
  • AWS and GCP pages get a one-admonition pointer; their provider-side steps stay the single source for both CI and RDE
  • New page listed in static/llms.txt

Tokens are requested on demand, not refreshed

The helper is one-shot: it prints a token and exits. The recipes have the cloud SDKs call it whenever they need a credential, AWS through credential_process and GCP through an executable-sourced credential, and cache the exchanged credential until it expires. No background refresher and no token file on the machine. This is the same pull model as the git credential helper the GitHub integration uses, and it came out of the review thread on the RFC: https://bitrise.atlassian.net/wiki/spaces/ENGI/pages/5293735999

The provider-side setup (IAM identity provider, trust policy, workload identity pool) is identical for builds and sessions, so it stays on the existing AWS and GCP pages rather than being duplicated.

No changelog entry yet; it gets added when this merges so the date is right.

Testing

  • npm ci && npm run build: passes for both locales; the only broken-anchor warnings are pre-existing ones on four /ja/ pages this PR does not touch

🤖 Generated with Claude Code

New page under RDE > Configuration covering the session subject and claims,
requesting a token with the rde-id-token helper, and AWS and GCP template
recipes. The OIDC overview, AWS and GCP pages point to it; their provider-side
steps stay the single source for both builds and sessions.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant