Skip to content

Commit e8b93bd

Browse files
daniel-m-ddBnjis
andauthored
[On-Call] Add on-call granular access doc (#30678)
* Add on-call granular access doc * feedback of documentation --------- Co-authored-by: Benjamin Lienart <benjamin.lienart@datadoghq.com>
1 parent 70bac09 commit e8b93bd

File tree

2 files changed

+39
-0
lines changed

2 files changed

+39
-0
lines changed

content/en/account_management/rbac/granular_access.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Use the different principals to control access patterns in your organization and
2525
| [Integration Webhooks][11] | {{< X >}} | {{< X >}} | {{< X >}} |
2626
| [Monitors][3] | {{< X >}} | {{< X >}} | {{< X >}} |
2727
| [Notebooks][4] | {{< X >}} | {{< X >}} | {{< X >}} |
28+
| [On-Call][22] | {{< X >}} | {{< X >}} | {{< X >}} |
2829
| [Private Action Runner][18] | {{< X >}} | {{< X >}} | {{< X >}} |
2930
| [Powerpacks][5] | {{< X >}} | {{< X >}} | {{< X >}} |
3031
| [Reference tables][12] | {{< X >}} | {{< X >}} | {{< X >}} |
@@ -62,3 +63,4 @@ A user with the `user_access_manage` permission can elevate their access to any
6263
[19]: /real_user_monitoring
6364
[20]: /account_management/org_settings/cross_org_visibility/#permissions
6465
[21]: /sheets/#permissions
66+
[22]: /service_management/on-call/#granular-access-control

content/en/service_management/on-call/_index.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,41 @@ A schedule defines specific times when Team members are assigned to respond to P
4141

4242
{{< img src="service_management/oncall/schedule.png" alt="A sample schedule, with multiple layers for JP, EU, and US business hours." style="width:80%;" >}}
4343

44+
## Granular access control
45+
46+
Use [granular access controls][3] to limit the [roles][4], teams, or users that can access On-Call resources. By default, access to On-Call schedules, escalation policies, and team routing rules is unrestricted.
47+
48+
Granular access controls are available for the following On-Call resources:
49+
- **Schedules**: Control who can view, edit, and override schedules
50+
- **Escalation policies**: Control who can view and edit escalation policies
51+
- **Team routing rules**: Control who can view and edit team routing rules
52+
53+
### Supported resources and permissions
54+
55+
| On-Call resource | Viewer | Overrider | Editor |
56+
|------------------|--------|-----------|--------|
57+
| **Schedules** | Can view schedules | Can view schedules and override shifts | Can view, edit schedules, and override shifts |
58+
| **Escalation policies** | Can view escalation policies | - | Can view and edit escalation policies |
59+
| **Team routing rules** | Can view team rules | - | Can view and edit team rules |
60+
61+
### Restrict access to On-Call resources
62+
63+
To restrict access to an On-Call resource:
64+
65+
1. Navigate to the specific On-Call resource (schedule, escalation policy, or team routing rules).
66+
1. Click **Manage**.
67+
1. Select **Permissions** from the dropdown menu.
68+
1. Click **Restrict Access**.
69+
1. Select one or more roles, teams, or users from the dropdown menu.
70+
1. Click **Add**.
71+
1. Select the level of access you want to associate with each of them from the dropdown menu next to their name:
72+
- **Viewer**: Read-only access to view the resource
73+
- **Overrider** (schedules only): Can view and create schedule overrides
74+
- **Editor**: Full access to view and modify the resource
75+
1. Click **Save**.
76+
77+
**Note**: To maintain your edit access to the resource, Datadog requires you to include at least one role that you are a member of before saving.
78+
4479
## Start using Datadog On-Call
4580

4681
To get started with On-Call, [onboard an On-Call Team][1] and ensure that all Team members configure their [On-Call profile settings][2] to receive notifications.
@@ -59,3 +94,5 @@ To get started with On-Call, [onboard an On-Call Team][1] and ensure that all Te
5994

6095
[1]: /service_management/on-call/teams
6196
[2]: /service_management/on-call/profile_settings
97+
[3]: /account_management/rbac/granular_access/
98+
[4]: /account_management/rbac/#role-based-access-control

0 commit comments

Comments
 (0)