Document immutable subject claims for GitHub Actions OIDC tokens#45221
Open
paulSambolin wants to merge 2 commits into
Open
Document immutable subject claims for GitHub Actions OIDC tokens#45221paulSambolin wants to merge 2 commits into
paulSambolin wants to merge 2 commits into
Conversation
|
Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines. |
Contributor
How to review these changes 👓Thank you for your contribution. To review these changes, choose one of the following options: A Hubber will need to deploy your changes internally to review. Table of review linksNote: Please update the URL for your staging server or codespace. The table shows the files in the
Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server 🤖 This comment is automatically generated. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why:
GitHub Actions OIDC tokens now include immutable numeric IDs for the repository owner and repository in the default
subclaim, protecting against attacks that rely on recycling repository or organization names. This is enabled by default for repositories created or renamed on or after July 15, 2026.This behavior is not yet documented in the OpenID Connect concepts page. See the changelog: https://github.blog/changelog/2026-04-23-immutable-subject-claims-for-github-actions-oidc-tokens/
What's being changed (if available, include any code snippets, screenshots, or gifs):
Adds an Immutable subject claims subsection under "Understanding the OIDC token" in
content/actions/concepts/security/openid-connect.md. The new content:subclaim now embeds immutable owner and repository IDs, appended to each name with an@delimiter (e.g.repo:octocat@123456/my-repo@456789:ref:refs/heads/main), and contrasts it with the earlier name-only format.The section is wrapped in
{% ifversion fpt or ghec %}because the changelog states the change applies to GitHub.com only and does not affect GitHub Enterprise Server.Check off the following:
Generated with Claude Code