Skip to content

docs: clarify token privilege scoping - #1357

Merged
marblom007 merged 1 commit into
masterfrom
docs/token-privilege-scoping
Oct 23, 2026
Merged

marblom007 merged 1 commit into
masterfrom
docs/token-privilege-scoping

Conversation

@marblom007

Copy link
Copy Markdown
Contributor

Lands the docs change from #1101 (by @Aamodx6, who is the commit author here) as a clean tokens.md-only branch.

Why a replacement PR

#1101 also carried changes to two PR-preview workflow files that master has since deleted/replaced (build-docs-preview.yml / deploy-docs-preview.yml), which conflicted and caused its failing preview check. Dropping those files via a merge commit on the fork branch turned out not to be pushable: the merge commit deletes workflow files, and GitHub refuses workflow-file changes from an OAuth token without the workflow scope. This branch carries the identical docs change — the diff is tokens.md, +6 lines — so the contribution can land now.

Change

Adds a Privilege Scoping section to content/en/cloud/concepts/identity-and-security/tokens.md, answering #378: API tokens are identity-scoped, carrying the user's exact privileges within the organization/environment selected by the request context, and Layer5 Cloud does not currently offer fine-grained token-specific scopes.

#1101 will be closed as superseded by this PR once this merges.

Add a Privilege Scoping section to tokens.md answering
#378: API tokens are identity-scoped — they carry the
exact privileges, roles, and permissions of the user account within
the organization and environment selected by the request context.
Layer5 Cloud does not currently support fine-grained, token-specific
privilege scopes.

Content from #1101 by Aamod007, landed via this branch
because that PR's merge with master could not be pushed back to the
fork (the OAuth token used lacks the workflow scope the merge
commit's workflow-file deletions require).

Signed-off-by: Marcus <158522975+marblom007@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings October 23, 2026 06:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

@coderabbitai

coderabbitai Bot commented Oct 23, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 30 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 1ff103c9-9554-49ea-ba43-921eea40e937
📥 Commits

Reviewing files that changed from the base of the PR and between e53e17f and 5d7a9b3.

📒 Files selected for processing: 1
  • content/en/cloud/concepts/identity-and-security/tokens.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@marblom007
marblom007 merged commit e0c1407 into master Oct 23, 2026
5 checks passed
@marblom007
marblom007 deleted the docs/token-privilege-scoping branch October 23, 2026 06:03
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview deployment: https://docs.layer5.io/pr-preview/pr-1357/

Note: Preview may take a moment (GitHub Pages deployment in progress). Please wait and refresh. Track deployment here

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants