From 10a855a168ece51a7c80b0aa0ed386a431ddca45 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 16 Dec 2024 12:15:27 -0800 Subject: [PATCH 01/12] Add compliance-reporting.md to generate URL --- .../hardened-desktop/settings-management/compliance-reporting.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md new file mode 100644 index 00000000000..e69de29bb2d From 015867f6c579ec23392696e238b92b069346b1c8 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 16 Dec 2024 12:32:40 -0800 Subject: [PATCH 02/12] Add content --- .../compliance-reporting.md | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index e69de29bb2d..9e9d8971ebd 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -0,0 +1,61 @@ +--- +description: Understand how to use the Desktop Settings Compliance reporting dashboard +keywords: Settings Management, docker desktop, hardened desktop, compliance reporting +title: Compliance reporting +linkTitle: Compliance Reporting +weight: 30 +--- + +Compliance reporting is a feature of Desktop Settings Management that tracks and reports user compliance with the settings that are assigned to them. This lets administrators to track the application of settings and monitor what actions they need to take to make users compliant. + +This guide provides steps for accessing the reporting dashboard, viewing compliance status, and resolving non-compliant users. + +## Access compliance reporting dashboard + +1. Sign in to the [Admin Console](https://app.docker.com/admin). +2. Select your **organization** from the **Choose profile** page. +3. Under Security and access, select **Desktop Settings reporting**. + +This opens the Desktop Settings Management Compliance dashboard. From here you can: + +- Use the **Search bar** to search by username or email address +- Filter by policies +- Hide or un-hide compliant users +- View a user’s compliance status and what policy is assigned to the user +- Download a CSV file of user compliance information + +## View compliance status + +1. Sign in to the [Admin Console](https://app.docker.com/admin). +2. Select your **organization** from the **Choose profile** page. +3. Under Security and access, select **Desktop Settings reporting**. +4. By default, non-compliant users are displayed. +5. Optional. Select the **Hide compliant users** checkbox to show compliant and non-compliant users. +6. Use the search bar to search by username or email address. +7. Hover over a user’s compliance status indicator to quickly view their status. +8. Select a **username** to view more details about their compliance status, and for steps to resolve non-compliant users. + +## Resolve compliance status + +To resolve compliance status, you must open a user's compliance status details. This window provides the following information: + +- **Compliance status**: Indicates whether the user is compliant with the settings applied to them +- **Domain status**: Indicates whether the user’s email address is associated with a verified domain +- **Settings status**: Indicates whether the user has settings applied to them +- **Resolution steps**: If a user is non-compliant, this provides information on how to resolve the user’s compliance status + +### Compliant + +When a user is compliant, a Compliant icon appears next to their name on the Desktop Settings Management Compliance ****dashboard. Select a compliant user to open their compliance status details, they will have the following status details: + +- **Compliance status**: Compliant +- **Domain status**: Verified domain +- **Settings status**: Compliant +- **User is compliant** indicator + +No resolution steps are needed for compliant users. + +### Non-compliant + +When a user is non-compliant, a Non-compliant or Unknown icon appears next to their name on the Desktop Settings Management Compliance dashboard. Non-compliant and Unknown statuses need resolved to become compliant. + From c88743017a7a1c44d456a6c30f0e7af4c2b87cdf Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Tue, 17 Dec 2024 09:06:15 -0800 Subject: [PATCH 03/12] First proofread --- .../compliance-reporting.md | 30 +++++++++++-------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 9e9d8971ebd..94fa867576b 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -1,22 +1,22 @@ --- -description: Understand how to use the Desktop Settings Compliance reporting dashboard -keywords: Settings Management, docker desktop, hardened desktop, compliance reporting -title: Compliance reporting -linkTitle: Compliance Reporting +description: Understand how to use the Desktop settings reporting dashboard +keywords: Settings Management, docker desktop, hardened desktop, reporting, compliance +title: Desktop settings reporting +linkTitle: Desktop Settings Reporting weight: 30 --- -Compliance reporting is a feature of Desktop Settings Management that tracks and reports user compliance with the settings that are assigned to them. This lets administrators to track the application of settings and monitor what actions they need to take to make users compliant. +Desktop settings reporting is a feature of Desktop Settings Management that tracks and reports user compliance with the settings that are assigned to them. This lets administrators to track the application of settings and monitor what actions they need to take to make users compliant. This guide provides steps for accessing the reporting dashboard, viewing compliance status, and resolving non-compliant users. -## Access compliance reporting dashboard +## Access Desktop settings reporting 1. Sign in to the [Admin Console](https://app.docker.com/admin). 2. Select your **organization** from the **Choose profile** page. -3. Under Security and access, select **Desktop Settings reporting**. +3. Under Docker Desktop, select **Reporting**. -This opens the Desktop Settings Management Compliance dashboard. From here you can: +This opens the Desktop settings reporting dashboard. From here you can: - Use the **Search bar** to search by username or email address - Filter by policies @@ -28,16 +28,16 @@ This opens the Desktop Settings Management Compliance dashboard. From here you c 1. Sign in to the [Admin Console](https://app.docker.com/admin). 2. Select your **organization** from the **Choose profile** page. -3. Under Security and access, select **Desktop Settings reporting**. +3. Under Docker Desktop, select **Reporting**. 4. By default, non-compliant users are displayed. -5. Optional. Select the **Hide compliant users** checkbox to show compliant and non-compliant users. +5. Optional. Select the **Hide compliant users** checkbox to show both compliant and non-compliant users. 6. Use the search bar to search by username or email address. 7. Hover over a user’s compliance status indicator to quickly view their status. 8. Select a **username** to view more details about their compliance status, and for steps to resolve non-compliant users. ## Resolve compliance status -To resolve compliance status, you must open a user's compliance status details. This window provides the following information: +To resolve compliance status, you must view a user's compliance status details by selecting their username from the Desktop settings reporting page. These details include the following information: - **Compliance status**: Indicates whether the user is compliant with the settings applied to them - **Domain status**: Indicates whether the user’s email address is associated with a verified domain @@ -46,7 +46,7 @@ To resolve compliance status, you must open a user's compliance status details. ### Compliant -When a user is compliant, a Compliant icon appears next to their name on the Desktop Settings Management Compliance ****dashboard. Select a compliant user to open their compliance status details, they will have the following status details: +When a user is compliant, a "Compliant" icon appears next to their name on the Desktop settings reporting dashboard. Select a compliant user to open their compliance status details. Compliant users will have the following status details: - **Compliance status**: Compliant - **Domain status**: Verified domain @@ -57,5 +57,9 @@ No resolution steps are needed for compliant users. ### Non-compliant -When a user is non-compliant, a Non-compliant or Unknown icon appears next to their name on the Desktop Settings Management Compliance dashboard. Non-compliant and Unknown statuses need resolved to become compliant. +When a user is non-compliant, a "Non-compliant" or "Unknown" icon appears next to their name on the Desktop settings reporting dashboard. Non-compliant users must have their compliance status resolved: + +1. Select a username from the Desktop settings reporting dashboard. +2. On the compliance status details page, follow the resolution steps provided to resolve the compliance status. +3. Refresh the page to ensure the resolution steps resolved the compliance status. From 521ca0eda7dbfa3791f0a365cf51c2750a729d04 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Tue, 17 Dec 2024 15:00:04 -0800 Subject: [PATCH 04/12] Add company option to choose profile page flow --- .../settings-management/compliance-reporting.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 94fa867576b..2b17cad5d81 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -13,7 +13,7 @@ This guide provides steps for accessing the reporting dashboard, viewing complia ## Access Desktop settings reporting 1. Sign in to the [Admin Console](https://app.docker.com/admin). -2. Select your **organization** from the **Choose profile** page. +2. Select your **organization** or **company** from the **Choose profile** page. 3. Under Docker Desktop, select **Reporting**. This opens the Desktop settings reporting dashboard. From here you can: @@ -27,7 +27,7 @@ This opens the Desktop settings reporting dashboard. From here you can: ## View compliance status 1. Sign in to the [Admin Console](https://app.docker.com/admin). -2. Select your **organization** from the **Choose profile** page. +2. Select your **organization** or **company** from the **Choose profile** page. 3. Under Docker Desktop, select **Reporting**. 4. By default, non-compliant users are displayed. 5. Optional. Select the **Hide compliant users** checkbox to show both compliant and non-compliant users. @@ -61,5 +61,4 @@ When a user is non-compliant, a "Non-compliant" or "Unknown" icon appears next t 1. Select a username from the Desktop settings reporting dashboard. 2. On the compliance status details page, follow the resolution steps provided to resolve the compliance status. -3. Refresh the page to ensure the resolution steps resolved the compliance status. - +3. Refresh the page to ensure the resolution steps resolved the compliance status. \ No newline at end of file From c85301acbfda167ee9676c299d5f8103769a20cc Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:36:59 -0800 Subject: [PATCH 05/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 2b17cad5d81..561e06baa01 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -6,7 +6,7 @@ linkTitle: Desktop Settings Reporting weight: 30 --- -Desktop settings reporting is a feature of Desktop Settings Management that tracks and reports user compliance with the settings that are assigned to them. This lets administrators to track the application of settings and monitor what actions they need to take to make users compliant. +Desktop settings reporting is a feature of Desktop Settings Management that tracks and reports user compliance with the settings that are assigned to them. This lets you track the application of settings and monitor what actions they need to take to make users compliant. This guide provides steps for accessing the reporting dashboard, viewing compliance status, and resolving non-compliant users. From a81c344495d3466d6e1b33cdf917f5f9355d0e0d Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:37:13 -0800 Subject: [PATCH 06/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 561e06baa01..23d2c19a6c5 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -57,7 +57,7 @@ No resolution steps are needed for compliant users. ### Non-compliant -When a user is non-compliant, a "Non-compliant" or "Unknown" icon appears next to their name on the Desktop settings reporting dashboard. Non-compliant users must have their compliance status resolved: +When a user is non-compliant, a **Non-compliant** or **Unknown** icon appears next to their name on the Desktop settings reporting dashboard. Non-compliant users must have their compliance status resolved: 1. Select a username from the Desktop settings reporting dashboard. 2. On the compliance status details page, follow the resolution steps provided to resolve the compliance status. From ea3783e6f16fc33aabceb5c80f78fe248418cb0f Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:37:25 -0800 Subject: [PATCH 07/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 23d2c19a6c5..cdc1d74f6ca 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -46,7 +46,7 @@ To resolve compliance status, you must view a user's compliance status details b ### Compliant -When a user is compliant, a "Compliant" icon appears next to their name on the Desktop settings reporting dashboard. Select a compliant user to open their compliance status details. Compliant users will have the following status details: +When a user is compliant, a **Compliant** icon appears next to their name on the Desktop settings reporting dashboard. Select a compliant user to open their compliance status details. Compliant users have the following status details: - **Compliance status**: Compliant - **Domain status**: Verified domain From 500361f1a69b99aca3e38844233631dd374ec739 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:37:40 -0800 Subject: [PATCH 08/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index cdc1d74f6ca..c6df5c88c20 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -33,7 +33,7 @@ This opens the Desktop settings reporting dashboard. From here you can: 5. Optional. Select the **Hide compliant users** checkbox to show both compliant and non-compliant users. 6. Use the search bar to search by username or email address. 7. Hover over a user’s compliance status indicator to quickly view their status. -8. Select a **username** to view more details about their compliance status, and for steps to resolve non-compliant users. +8. Select a username to view more details about their compliance status, and for steps to resolve non-compliant users. ## Resolve compliance status From 5dda91b91d9423b0016786e847ed0b8afd2b839c Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:37:49 -0800 Subject: [PATCH 09/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index c6df5c88c20..bbc32729231 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -31,7 +31,7 @@ This opens the Desktop settings reporting dashboard. From here you can: 3. Under Docker Desktop, select **Reporting**. 4. By default, non-compliant users are displayed. 5. Optional. Select the **Hide compliant users** checkbox to show both compliant and non-compliant users. -6. Use the search bar to search by username or email address. +6. Use the **Search** field to search by username or email address. 7. Hover over a user’s compliance status indicator to quickly view their status. 8. Select a username to view more details about their compliance status, and for steps to resolve non-compliant users. From 451b9447f8bbb4351a17cf4ee8203840ef6efdc7 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:38:02 -0800 Subject: [PATCH 10/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index bbc32729231..e7463b0a092 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -18,7 +18,7 @@ This guide provides steps for accessing the reporting dashboard, viewing complia This opens the Desktop settings reporting dashboard. From here you can: -- Use the **Search bar** to search by username or email address +- Use the **Search** field to search by username or email address - Filter by policies - Hide or un-hide compliant users - View a user’s compliance status and what policy is assigned to the user From 23bf3ca78c49a819d9051de387bc2cfc59fc2a02 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:38:12 -0800 Subject: [PATCH 11/12] Update content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- .../settings-management/compliance-reporting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index e7463b0a092..1b873f4c3cb 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -13,7 +13,7 @@ This guide provides steps for accessing the reporting dashboard, viewing complia ## Access Desktop settings reporting 1. Sign in to the [Admin Console](https://app.docker.com/admin). -2. Select your **organization** or **company** from the **Choose profile** page. +2. Select your organization or company from the **Choose profile** page. 3. Under Docker Desktop, select **Reporting**. This opens the Desktop settings reporting dashboard. From here you can: From 00897ff79befd3679a49a0e7ff62381edb6eef02 Mon Sep 17 00:00:00 2001 From: Sarah Sanders Date: Mon, 23 Dec 2024 09:42:42 -0800 Subject: [PATCH 12/12] Update nit for bolding --- .../settings-management/compliance-reporting.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md index 1b873f4c3cb..ca79dc73930 100644 --- a/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md +++ b/content/manuals/security/for-admins/hardened-desktop/settings-management/compliance-reporting.md @@ -27,7 +27,7 @@ This opens the Desktop settings reporting dashboard. From here you can: ## View compliance status 1. Sign in to the [Admin Console](https://app.docker.com/admin). -2. Select your **organization** or **company** from the **Choose profile** page. +2. Select your organization or company from the **Choose profile** page. 3. Under Docker Desktop, select **Reporting**. 4. By default, non-compliant users are displayed. 5. Optional. Select the **Hide compliant users** checkbox to show both compliant and non-compliant users. @@ -61,4 +61,4 @@ When a user is non-compliant, a **Non-compliant** or **Unknown** icon appears ne 1. Select a username from the Desktop settings reporting dashboard. 2. On the compliance status details page, follow the resolution steps provided to resolve the compliance status. -3. Refresh the page to ensure the resolution steps resolved the compliance status. \ No newline at end of file +3. Refresh the page to ensure the resolution steps resolved the compliance status.