Skip to content

docs: fix GitHub token regeneration attribution in Terraform proxy flow - #4311

Merged
AmberAlston merged 1 commit into
mainfrom
amber/terraform-proxy-step4-attribution
Jul 28, 2026
Merged

docs: fix GitHub token regeneration attribution in Terraform proxy flow#4311
AmberAlston merged 1 commit into
mainfrom
amber/terraform-proxy-step4-attribution

Conversation

@AmberAlston

Copy link
Copy Markdown
Member

What

Corrects the step-4 description of the Terraform proxy registry download flow on the Include Terraform Modules page.

Why

The doc attributed regenerating the fresh GitHub token to the proxy-registry worker. In the actual implementation, the worker validates the JWT and calls the Replicated API's session endpoint, and it is the API that regenerates the fresh, short-lived GitHub token server-side and returns the installation credentials to the worker. The worker only uses those credentials to fetch and stream the tarball.

This matters for anyone reasoning about the trust boundary: the token is minted server-side in the API, not at the edge worker.

Evidence

  • Worker receives (does not mint) the token from the session endpoint: proxy-registry/src/terraform.ts (getTerraformSession → uses session.githubToken)
  • API regenerates the token per session: handlers/vendor-api/replv3/proxy/get_terraform_session.go

The end-state the doc describes (fresh, short-lived, server-side, never exposed to the customer) is unchanged and remains accurate. This is a wording/attribution fix only.

🤖 Generated with Claude Code

…y flow

The step-4 description attributed regenerating the fresh GitHub token to
the proxy-registry worker. The worker validates the JWT and receives the
installation credentials from the Replicated API's session endpoint, which
is where the fresh, short-lived token is actually minted server-side.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AmberAlston
AmberAlston requested a review from a team as a code owner July 28, 2026 20:02
@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit e9fc9e5
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a690aeb7495f80008d4ac7c
😎 Deploy Preview https://deploy-preview-4311--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit e9fc9e5
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a690aeb90e8bb00080b4693
😎 Deploy Preview https://deploy-preview-4311--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added type::docs Improvements or additions to documentation type::feature labels Jul 28, 2026
Comment thread docs/vendor/enterprise-portal-v2-terraform.mdx
@AmberAlston
AmberAlston merged commit f56194e into main Jul 28, 2026
6 checks passed
@AmberAlston
AmberAlston deleted the amber/terraform-proxy-step4-attribution branch July 28, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant