Skip to content

Document which Auth0 tenant issues each API v1 token - #4331

Merged
anth-volk merged 2 commits into
masterfrom
docs/auth0-tenant-token-issuers
Nov 18, 2026
Merged

anth-volk merged 2 commits into
masterfrom
docs/auth0-tenant-token-issuers

Conversation

@anth-volk

Copy link
Copy Markdown
Collaborator

Fixes #4330

Summary

  • Adds "Auth0 tenants and tokens" to docs/migration/cloud-run-operations.md. It lists the four tenants (policyengine, policyengine-dev, policyengine-api, policyengine-api-staging), each token API v1 accepts or requests in production and staging, how API v1 tells the tenants apart, and which provider holds each setting.
  • Corrects docs/migration/stage-12a-user-login.md, which said every environment uses a custom domain. Only production does (auth.policyengine.org). Staging's issuer is https://policyengine-dev.uk.auth0.com/.
  • Changes documentation only. No setting, workflow or Auth0 configuration changes.

Testing

  • No tests were added or changed. The pre-commit checks (make quality) passed.
  • Compared the issuers and audiences with the GitHub staging and production variables and with the environment variables on the policyengine-api and policyengine-api-staging Cloud Run services on 2026-11-18.
  • Confirmed the settings' providers: GitHub environment variables and secrets, GitHub organization secrets for GATEWAY_AUTH_*, and Secret Manager versions named by the *_SECRET_RESOURCE settings.
  • Read policyengine directly from Auth0 on 2026-11-18: its API definitions, client grants, custom domain, and the host and audience in recent token logs.
  • The API definitions and sign-in connections of policyengine-dev, policyengine-api and policyengine-api-staging come from Auth0 readings made between 2026-11-14 and 2026-11-17. Their published issuers were re-read on 2026-11-18.

🤖 Generated with Claude Code

Add a section to the Cloud Run reference listing the four Auth0 tenants,
the tokens each issues in staging and production, how API v1 tells them
apart, and where each setting comes from.

Correct the Stage 12A document, which said every environment uses a custom
domain: only production does, and staging's issuer is the tenant's own
domain.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.67%. Comparing base (06d29c8) to head (1fee946).

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #4331      +/-   ##
==========================================
- Coverage   93.69%   93.67%   -0.03%     
==========================================
  Files         397      397              
  Lines       22885    22885              
  Branches     3651     3651              
==========================================
- Hits        21443    21438       -5     
- Misses        839      845       +6     
+ Partials      603      602       -1     
Flag Coverage Δ
integration 57.69% <ø> (ø)
unit 90.95% <ø> (-0.03%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@anth-volk
anth-volk merged commit 9951114 into master Nov 18, 2026
23 checks passed
@anth-volk
anth-volk deleted the docs/auth0-tenant-token-issuers branch November 18, 2026 18:55

This branch was previously deployed

1 inactive deployment
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.

Document which Auth0 tenant issues each API v1 token

1 participant