Skip to content

Commit 9362a99

Browse files
security: settings reporting reference table (#22444)
## Description - Adds a section to understand compliance status w/ a reference table of possible status combinations - Preview: https://deploy-preview-22444--docsdocker.netlify.app/security/for-admins/hardened-desktop/settings-management/compliance-reporting/#understand-compliance-status ## Related issues or tickets - https://docker.atlassian.net/browse/ENGDOCS-2561 ## Reviews - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <[email protected]>
1 parent cdcf7ef commit 9362a99

File tree

1 file changed

+50
-2
lines changed

1 file changed

+50
-2
lines changed

content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md

Lines changed: 50 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,54 @@ and non-compliant users.
5959
7. Select a username to view more details about their compliance status, and for
6060
steps to resolve non-compliant users.
6161

62+
## Understand compliance status
63+
64+
Docker evaluates compliance status based on:
65+
66+
- Compliance status: Whether a user has fetched and applied the latest settings. This is the primary label shown on the reporting page.
67+
- Domain status: Whether the user's email matches a verified domain.
68+
- Settings status: Whether a settings policy is applied to the user.
69+
70+
The combination of these statuses determines what actions you need to take.
71+
72+
### Compliance status reference
73+
74+
This reference explains how each status is determined in the reporting dashboard
75+
based on user domain and settings data. The Admin Console displays the
76+
highest-priority applicable status according to the following rules.
77+
78+
**Compliance status**
79+
80+
| Compliance status | What it means |
81+
|-------------------|---------------|
82+
| Uncontrolled domain | The user's email domain is not verified. |
83+
| No policy assigned | The user does not have any policy assigned to them. |
84+
| Non-compliant | The user fetched the correct policy, but hasn't applied it. |
85+
| Outdated | The user fetched a previous version of the policy. |
86+
| Unknown | The user hasn't fetched any policy yet, or their compliance can't be determined. |
87+
| Compliant | The user fetched and applied the latest assigned policy. |
88+
89+
**Domain status**
90+
91+
This reflects how the user’s email domain is evaluated based on the organization’s domain setup.
92+
93+
| Domain status | What it means |
94+
|---------------|---------------|
95+
| Verified | The user’s email domain is verified. |
96+
| Guest user | The user's email domain is not verified. |
97+
| Domainless | Your organization has no verified domains, and the user's domain is unknown. |
98+
| Unknown user | Your organization has verified domains, but the user's domain is unknown. |
99+
100+
**Settings status**
101+
102+
This shows whether and how the user is assigned a settings policy.
103+
104+
| Settings status | What it means |
105+
|-----------------|---------------|
106+
| Global policy | The user is assigned your organzation's default policy. |
107+
| User policy | The user is assigned a specific custom policy. |
108+
| No policy assigned | The user is not assigned to any policy. |
109+
62110
## Resolve compliance status
63111

64112
To resolve compliance status, you must view a user's compliance status details
@@ -80,8 +128,8 @@ Desktop settings reporting dashboard. Select a compliant user to open their
80128
compliance status details. Compliant users have the following status details:
81129

82130
- **Compliance status**: Compliant
83-
- **Domain status**: Verified domain
84-
- **Settings status**: Compliant
131+
- **Domain status**: Verified
132+
- **Settings status**: Global policy or user policy
85133
- **User is compliant** indicator
86134

87135
No resolution steps are needed for compliant users.

0 commit comments

Comments
 (0)