Skip to content

reference: widen the definition of RBAC#55291

Open
orangecms wants to merge 1 commit intokubernetes:mainfrom
orangecms:patch-1
Open

reference: widen the definition of RBAC#55291
orangecms wants to merge 1 commit intokubernetes:mainfrom
orangecms:patch-1

Conversation

@orangecms
Copy link
Copy Markdown
Contributor

Description

Entities in access controls are not necssarily individual people. System accounts, for example, are often managed by a team, and the respective system account is assigned the task related roles, e.g. for storage management or specific network configuration matters.

Issue

The current wording might be confusing, since "individual users within your organization" sounds like it only means human entities. The later paragraph "User-facing roles" makes clear that there are also system entities in RBAC.

Entities in access controls are not necssarily individual people.
System accounts, for example, are often managed by a team, and the respective system account is assigned the task related roles, e.g. for storage management or specific network configuration matters.
@k8s-ci-robot
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign sayakmukhopadhyay for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot requested a review from deads2k April 8, 2026 08:23
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language labels Apr 8, 2026
@k8s-ci-robot k8s-ci-robot requested a review from liggitt April 8, 2026 08:23
@k8s-ci-robot k8s-ci-robot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Apr 8, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 8, 2026

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit b12f004
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69d6106a90d4720008b53175
😎 Deploy Preview https://deploy-preview-55291--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Member

@Arhell Arhell left a comment

Choose a reason for hiding this comment

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

Lgtm

@CodesbyUnnati
Copy link
Copy Markdown

LGTM

Copy link
Copy Markdown
Contributor

@Caesarsage Caesarsage left a comment

Choose a reason for hiding this comment

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

Thanks @orangecms for your contributions. I left some comments you could check out

Comment on lines 13 to +15
Role-based access control (RBAC) is a method of regulating access to computer or
network resources based on the roles of individual users within your organization.
network resources based on the roles of individual users within an organization or
other entities in a system, such as system accounts performing specific tasks.
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.

changing it from your to an make it less direct to readers which is against the style guide (https://kubernetes.io/docs/contribute/style/style-guide/#address-the-reader-as-you)

other entities is vague.

A cleaner wording could be

Role-based access control (RBAC) is a method of regulating access to computer or network resources based on the roles of *subjects* (users, groups, or service accounts) within your organization.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I call them principals; see https://deploy-preview-50364--kubernetes-io-main-staging.netlify.app/docs/reference/access-authn-authz/authentication/ (preview for how PR 50364 plans to update the authn page).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We can talk about both principals (which doesn't include groups) and subjects (which does / can).

Copy link
Copy Markdown
Member

@lmktfy lmktfy left a comment

Choose a reason for hiding this comment

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

I definitely agree that the current wording doesn't seem right. You've already helped a lot by pointing that out.

I do have some other feedback.

Comment on lines +14 to +15
network resources based on the roles of individual users within an organization or
other entities in a system, such as system accounts performing specific tasks.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think the word "individual" could still mislead. I'm afraid I would reword again:

Suggested change
network resources based on the roles of individual users within an organization or
other entities in a system, such as system accounts performing specific tasks.
network resources based on the roles of specific users within an organization.
As well as being useful to define access for individuals and groups of individuals,
you can use Kubernetes RBAC to authorize other identity principals, such as [ServiceAccounts](/docs/concepts/security/service-accounts/).

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

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants