Skip to content

docs: correct tailscale trust credential subject - #10

Merged
jmgilman merged 1 commit into
masterfrom
docs/tailscale-subject-claim
Aug 18, 2026
Merged

docs: correct tailscale trust credential subject#10
jmgilman merged 1 commit into
masterfrom
docs/tailscale-subject-claim

Conversation

@jmgilman

Copy link
Copy Markdown
Contributor

Summary

Corrects the trust credential subject recorded in the Tailscale policy
reference. The published value used plain names, which never matches: this
organization issues GitHub OIDC subjects in immutable form with numeric
organization and repository IDs.

Observed claim from a GitHub Actions run in GilmanLab/networking:

sub: repo:GilmanLab@66194346/networking@1334494603:ref:refs/heads/<branch>
aud: api.tailscale.com/<client id>
iss: https://token.actions.githubusercontent.com
  • reference/networking/tailscale-policy.md — records the immutable subject and
    explains why the name-based form fails with HTTP 403.
  • runbooks/tailscale-policy-change.md — adds the token exchange failed with status 403 escalation path pointing at the expected subject.

Validation

mise exec -- moon run docs:build --summary minimal passes with strict: true,
including the new cross-document anchor link.

The GilmanLab organization issues GitHub OIDC subjects in immutable form with
numeric organization and repository IDs. A name-based subject pattern never
matches and the token exchange fails with HTTP 403, which is what the first
apply attempt hit.
@jmgilman
jmgilman merged commit c1ed11b into master Aug 18, 2026
2 checks passed
@jmgilman
jmgilman deleted the docs/tailscale-subject-claim branch August 18, 2026 23:45
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