Skip to content

Document OIDC subject claim behaviour#3118

Draft
sathvikkumar-octo wants to merge 1 commit intomainfrom
sk/oidc-subject-claim-docs
Draft

Document OIDC subject claim behaviour#3118
sathvikkumar-octo wants to merge 1 commit intomainfrom
sk/oidc-subject-claim-docs

Conversation

@sathvikkumar-octo
Copy link
Copy Markdown
Contributor

@sathvikkumar-octo sathvikkumar-octo commented Apr 27, 2026

Summary

When a selected OIDC subject key has no value at runtime (e.g. tenant on an untenanted deployment), both the key and the value are dropped from the generated sub claim — not just the value. The docs didn't say this, and the documented "default format" included a tenant: segment that doesn't actually appear for untenanted deployments. Reported internally after an AWS IAM trust policy was configured against the documented format and didn't match the actual subject.

This PR:

  • Documents the drop-when-empty rule
  • Shows both the tenanted and untenanted resulting subjects, plus a matched example pair on the AWS account page
  • Adds the missing Project Group key (already allowed in the code)
  • Removes Feed from the Deployments and Runbooks allowed parts (Feed has its own subject config)

Source of truth: OidcSubjectGenerator.cs

Clarifies that requested subject keys with no value in the current
execution context (e.g. tenant on an untenanted deployment) are
omitted entirely from the generated subject - both key and value -
not just left with an empty value. Customers configuring AWS IAM
trust policies for untenanted projects had to discover this by
trial and error.

Replaces the single 'default format' line with the default keys plus
both the tenanted and untenanted resulting subjects, adds the missing
Project Group key part, removes Feed from the Deployments and
Runbooks allowed parts (Feed has its own subject config), and adds a
tenanted/untenanted example pair to the AWS account doc.
@sathvikkumar-octo sathvikkumar-octo changed the title Document OIDC subject claim drop-when-empty behaviour Document OIDC subject claim behaviour Apr 27, 2026
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