Skip to content

Add Workers RBAC updates#16213

Closed
JoshuaYe wants to merge 8 commits into
productionfrom
jye/workers-rbac
Closed

Add Workers RBAC updates#16213
JoshuaYe wants to merge 8 commits into
productionfrom
jye/workers-rbac

Conversation

@JoshuaYe

Copy link
Copy Markdown
Contributor

Summary

  1. Update account roles documentation with new Worker roles.
  2. Create new page under Workers platform to map out Worker roles to permissions.

Screenshots (optional)

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 15, 2024

Copy link
Copy Markdown

Deploying cloudflare-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 314bff1
Status: ✅  Deploy successful!
Preview URL: https://3eb0e5ff.cloudflare-docs-7ou.pages.dev
Branch Preview URL: https://jye-workers-rbac.cloudflare-docs-7ou.pages.dev

View logs

@irvinebroque irvinebroque 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.

Am glad we are adding a table for this

Comment thread src/content/docs/workers/platform/roles-permissions.mdx Outdated
Comment thread src/content/docs/workers/platform/roles-permissions.mdx Outdated
Comment thread src/content/docs/workers/platform/roles-permissions.mdx Outdated

To check the list of members in your account, or to manage roles and permissions, refer to our [Account setup](/fundamentals/setup/manage-members/) documentation.

The following roles have permissions not restricted to Cloudflare [Workers](/workers/) but to related developer platform products too. This includes [Pages](/pages/), [Durable Objects](/durable-objects/), [KV](/kv/) and [R2](/r2/). It also provides read access to Zones, [Zone Analytics](/analytics/account-and-zone-analytics/zone-analytics/) and [Page Rules](/rules/).

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.

  1. This should live within the section below
  2. It seems like we should be able to enumerate these more specifically — otherwise how does someone reading this know something like, one needs the Workers Admin permission in order to deploy a Pages project?

@JoshuaYe JoshuaYe Aug 16, 2024

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

For 2, what do you have in mind? The copy is from a pre-existing description of Cloudflare Workers Admin role and outlines all the devplat products the role impacts.

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.

Right now, when I read this, I know that which Workers role I have somehow impacts what I am allowed to do with Pages, KV, etc. — but it's not explicit how.

I am saying that we should go figure out specifically things like, if I have the Workers Read role — what does that mean for whether I can or can't deploy a Pages project?

...and enumerate them on this page.

If we can't right now, then I don't think we should include this content about Pages, KV, etc on this page. It leaves you with more questions than answers.

Comment thread src/content/docs/workers/platform/roles-permissions.mdx
Comment thread src/content/docs/workers/platform/roles-permissions.mdx Outdated

## Workers roles

Only Super Administrators will be able to assign or remove the following roles from users in their account. They also have all the permissions of a Workers Admin. Scroll to the right to see a full list of permissions for each role.

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.

Scroll to the right to see a full list of permissions for each role.

@kodster28 should we track something internally around making it more intuitive and visible that a table that extends horizontally beyond the viewport is scrollable, so that docs authors don't need to explain it in words?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Yeah... tables are an ongoing issue that we're discussing.

I think that's one potential solution... but there's a lot of stuff in the works + mobile and tables just really don't go together.

| Vectorize Read only | Can read [Vectorize](/vectorize/) configurations. |
| Waiting Room Admin | Can edit [Waiting Room](/waiting-room/) configuration. |
| Waiting Room Read | Can read [Waiting Room](/waiting-room/) configuration. |
| Workers Admin | Can manage Cloudflare [Workers](/workers/), [Pages](/pages/), [Durable Objects](/durable-objects/), [KV](/kv/) and [R2](/r2/). Also provides read access to Zones, [Zone Analytics](/analytics/account-and-zone-analytics/zone-analytics/) and [Page Rules](/rules/).|

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.

It seems helpful for this in some way to link to the new page in the Workers docs that you are adding? (think fine if unique to Workers and other products don't do this on this page)

@JoshuaYe JoshuaYe Aug 16, 2024

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good idea, unfortunately only Zero Trust does this too. If we think two products is enough, we could add a note that links to their specific role pages.

JoshuaYe and others added 5 commits August 16, 2024 10:51
Co-authored-by: Brendan Irvine-Broque <birvine-broque@cloudflare.com>
Co-authored-by: Brendan Irvine-Broque <birvine-broque@cloudflare.com>
Co-authored-by: Brendan Irvine-Broque <birvine-broque@cloudflare.com>
@JoshuaYe
JoshuaYe requested a review from irvinebroque August 16, 2024 19:11
@KimJ15 KimJ15 assigned abstergail and unassigned kodster28 Sep 27, 2024
@github-actions
github-actions Bot deleted the jye/workers-rbac branch March 19, 2026 17:52
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.

8 participants