Skip to content

Commit c5bb4e1

Browse files
Better explanation of Managed vs Custom roles? (#31793)
* Better explanation of Managed vs Custom roles? I'm looking at ways to reduce the confusion around roles & permissions. I noticed the docs don't explicitly cover the main distinction between managed and custom roles, and would like to fix it. * Get rid of "will" tense word * grammar nit --------- Co-authored-by: Ursula Chen <[email protected]>
1 parent 436ede3 commit c5bb4e1

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

content/en/account_management/rbac/permissions.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -48,18 +48,20 @@ Preview mode gives your organization's administrators the ability to opt into ce
4848

4949
By default, existing users are associated with one of the three managed roles:
5050

51-
- Datadog Admin
52-
- Datadog Standard
53-
- Datadog Read Only
51+
- Datadog Admin Role
52+
- Datadog Standard Role
53+
- Datadog Read Only Role
5454

55-
All users with one of these roles can read all data types, except for [individually read-restricted][1] resources. Admin and Standard users have write permissions on assets. Admin users have additional read and write permissions for sensitive assets relating to user management, org management, billing, and usage.
55+
All users with one of these roles can read data, except for [individually read-restricted][1] resources. Admin and Standard users have write permissions on assets. Admin users have additional read and write permissions for sensitive assets relating to user management, org management, billing, and usage.
5656

5757
Managed roles are created and maintained by Datadog. Their permissions may be automatically updated by Datadog as new features are added or permissions change. Users cannot modify managed roles directly, but they can clone them to create [custom roles](#custom-roles) with specific permissions. If necessary, users can delete managed roles from their account.
5858

5959
### Custom roles
6060

6161
Create a custom role to combine permissions into new roles. A custom role gives you the ability to define a persona, for example, a billing administrator, and then assign the appropriate permissions for that role. After creating a role, assign or remove permissions to this role directly by [updating the role in Datadog][2], or through the [Datadog Permission API][3].
6262

63+
Unlike Managed Roles, custom roles do not receive new permissions when Datadog releases new products and features. Custom roles only receive new permissions to maintain compatibility when Datadog releases a new permission gating existing functionality.
64+
6365
**Note**: When adding a new custom role to a user, make sure to remove the managed Datadog role associated with that user to enforce the new role permissions.
6466

6567
## Permissions list
@@ -79,4 +81,4 @@ Each managed role inherits all of the permissions from the less powerful roles.
7981

8082
[1]: /account_management/rbac/granular_access
8183
[2]: /account_management/users/#edit-a-user-s-roles
82-
[3]: /api/latest/roles/#list-permissions
84+
[3]: /api/latest/roles/#list-permissions

0 commit comments

Comments
 (0)