mirror of
https://github.com/coder/coder.git
synced 2025-07-12 00:14:10 +00:00
chore(docs): add documentation on custom roles (#15280)
These docs were overwritten in the restructure merge.
This commit is contained in:
@ -31,6 +31,30 @@ Roles determine which actions users can take within the platform.
|
|||||||
A user may have one or more roles. All users have an implicit Member role that
|
A user may have one or more roles. All users have an implicit Member role that
|
||||||
may use personal workspaces.
|
may use personal workspaces.
|
||||||
|
|
||||||
|
## Custom Roles (Premium) (Beta)
|
||||||
|
|
||||||
|
Starting in v2.16.0, Premium Coder deployments can configure custom roles on the
|
||||||
|
[Organization](./organizations.md) level. You can create and assign custom roles
|
||||||
|
in the dashboard under **Organizations** -> **My Organization** -> **Roles**.
|
||||||
|
|
||||||
|
> Note: This requires a Premium license.
|
||||||
|
> [Contact your account team](https://coder.com/contact) for more details.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Clicking "Create custom role" opens a UI to select the desired permissions for a
|
||||||
|
given persona.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
From there, you can assign the custom role to any user in the organization under
|
||||||
|
the **Users** settings in the dashboard.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Note that these permissions only apply to the scope of an
|
||||||
|
[organization](./organizations.md), not across the deployment.
|
||||||
|
|
||||||
### Security notes
|
### Security notes
|
||||||
|
|
||||||
A malicious Template Admin could write a template that executes commands on the
|
A malicious Template Admin could write a template that executes commands on the
|
||||||
|
BIN
docs/images/admin/users/roles/assigning-custom-role.PNG
Normal file
BIN
docs/images/admin/users/roles/assigning-custom-role.PNG
Normal file
Binary file not shown.
After Width: | Height: | Size: 62 KiB |
BIN
docs/images/admin/users/roles/creating-custom-role.PNG
Normal file
BIN
docs/images/admin/users/roles/creating-custom-role.PNG
Normal file
Binary file not shown.
After Width: | Height: | Size: 82 KiB |
BIN
docs/images/admin/users/roles/custom-roles.PNG
Normal file
BIN
docs/images/admin/users/roles/custom-roles.PNG
Normal file
Binary file not shown.
After Width: | Height: | Size: 105 KiB |
Reference in New Issue
Block a user