diff --git a/docs/platform/start/organize/workspaces.md b/docs/platform/start/organize/workspaces.md index be0c7166..ea6c68ca 100644 --- a/docs/platform/start/organize/workspaces.md +++ b/docs/platform/start/organize/workspaces.md @@ -6,7 +6,7 @@ description: This page provides detailed information about workspaces in Mondoo image: /img/featured_img/mondoo-feature.jpg --- -FOO BAR BAZ start with a screenshot +![Mondoo workspaces](/img/platform/start/workspaces-cards.png) Workspaces are ad hoc groups of assets you want to view together. You might have a workspace for a project, another for monitoring urgent problems across your infrastructure, and another for a type of asset. @@ -48,7 +48,7 @@ Mondoo currently supports these conditions for including assets in, or excluding |------------------|----------------------------------------------------------------------------------------------------------------------| | Platform | Alpine Linux, Atlassian Jira, AWS S3 bucket, GitHub repository, Kubernetes pod, macOS, Slack team, Terraform plan ... | | Platform version | 3, 4.5, 12.75 ... | -| Risk rating | Critical, High, Medium, Low, None | +| Risk rating | Critical, High, Medium, Low, None (fixed values) | | Asset name | test, 2024, win, us-east-1, docker- ... | :::note @@ -79,11 +79,11 @@ You can also combine conditions. These are examples of simple queries with multi Mondoo workspaces support complex queries as well. For example, this query defines a workspace for viewing all older versions of three popular Linux distributions: - (Is a Debian device and version is not 12) +- (Is a Debian device and version is not 12) and - (Is a Fedora device and version is not 40 or 41) +- (Is a Fedora device and version is not 40 or 41) and - (Is a Red Hat (RHEL) device and is not version 9.5) +- (Is a Red Hat (RHEL) device and is not version 9.5) ### Workspaces are dynamic @@ -155,12 +155,62 @@ If you define more than one asset selection in a query (using the + ADD ASSET SE 7. Select the **CREATE WORKSPACE** button. +Mondoo builds the workspace based on your criteria and then displays a security overview of the assets in the workspace. + ## View workspaces +![Mondoo workspace navigation](/img/platform/start/workspace-topnav.png) + +Quickly access a workspace from any page in the Mondoo Console using the top navigation bar. + +![Mondoo workspace navigation drop-down](/img/platform/start/workspace-dropdown.png) + +The drop-down menu shows all the workspaces in the current space. If you have a long list of workspaces, you can type part or all of the workspace name to filter the list. Select a workspace to see a security overview of the assets in the workspace. + +![Mondoo workspace overview](/img/platform/start/workspace-dash.png) + ## Manage workspaces +You can change the query that defines the assets in a workspace. You can also delete a workspace. + ### Edit a workspace +You can modify a workspace by changing the criteria that determine what assets are and are not included in the workspace. You can also change the name or description. + +1. Navigate to the workspace you want to edit. For instructions, read the [View workspaces section](#view-workspaces) above. + + ![Mondoo workspace overview](/img/platform/start/workspace-dash.png) + +2. Near the top-right corner of the page, select **Show Details**. + + ![Mondoo workspace overview](/img/platform/start/workspace-details.png) + +3. Near the top-right corner of the page, select **Edit**. + + ![Mondoo workspace overview](/img/platform/start/workspace-settings.png) + +4. Change the query that defines which assets are included in or excluded from the workspace, or change the workspace name or description. + + Mondoo saves your changes as you work. + ### Remove a workspace +1. Navigate to the workspace you want to remove. For instructions, read the [View workspaces section](#view-workspaces) above. + + ![Mondoo workspace overview](/img/platform/start/workspace-dash.png) + +2. Near the top-right corner of the page, select **Show Details**. + + ![Mondoo workspace overview](/img/platform/start/workspace-details.png) + +3. Near the top-right corner of the page, select **Edit**. + + ![Mondoo workspace overview](/img/platform/start/workspace-settings.png) + +4. Scroll to the **Danger zone** at the bottom of the page. + + ![Mondoo workspace delete](/img/platform/start/workspace-delete.png) + +5. Check the box to confirm that you want to delete the workspace and then select the **DELETE** button. + --- diff --git a/static/img/platform/start/create-workspace.png b/static/img/platform/start/create-workspace.png index 75914227..9343b1e9 100644 Binary files a/static/img/platform/start/create-workspace.png and b/static/img/platform/start/create-workspace.png differ diff --git a/static/img/platform/start/luna-org-1.png b/static/img/platform/start/luna-org-1.png index 81904c6b..b2473c52 100644 Binary files a/static/img/platform/start/luna-org-1.png and b/static/img/platform/start/luna-org-1.png differ diff --git a/static/img/platform/start/luna-org-2.png b/static/img/platform/start/luna-org-2.png index c2e006a5..5df04107 100644 Binary files a/static/img/platform/start/luna-org-2.png and b/static/img/platform/start/luna-org-2.png differ diff --git a/static/img/platform/start/lunalectric-aws-space.png b/static/img/platform/start/lunalectric-aws-space.png index a6867aba..7f783cfe 100644 Binary files a/static/img/platform/start/lunalectric-aws-space.png and b/static/img/platform/start/lunalectric-aws-space.png differ diff --git a/static/img/platform/start/mars-rover-space.png b/static/img/platform/start/mars-rover-space.png index c0064f6d..4d32ec4a 100644 Binary files a/static/img/platform/start/mars-rover-space.png and b/static/img/platform/start/mars-rover-space.png differ diff --git a/static/img/platform/start/name-workspace.png b/static/img/platform/start/name-workspace.png index 116cc712..04c1d556 100644 Binary files a/static/img/platform/start/name-workspace.png and b/static/img/platform/start/name-workspace.png differ diff --git a/static/img/platform/start/no-workspaces.png b/static/img/platform/start/no-workspaces.png index 6db96e01..c7dc40c1 100644 Binary files a/static/img/platform/start/no-workspaces.png and b/static/img/platform/start/no-workspaces.png differ diff --git a/static/img/platform/start/organize-basics.png b/static/img/platform/start/organize-basics.png index 301bcac4..848d3c2f 100644 Binary files a/static/img/platform/start/organize-basics.png and b/static/img/platform/start/organize-basics.png differ diff --git a/static/img/platform/start/qb-two-conditions-not.png b/static/img/platform/start/qb-two-conditions-not.png index 921a9588..fb93fa8c 100644 Binary files a/static/img/platform/start/qb-two-conditions-not.png and b/static/img/platform/start/qb-two-conditions-not.png differ diff --git a/static/img/platform/start/qb-two-conditions.png b/static/img/platform/start/qb-two-conditions.png index 23e6e88c..38b54d90 100644 Binary files a/static/img/platform/start/qb-two-conditions.png and b/static/img/platform/start/qb-two-conditions.png differ diff --git a/static/img/platform/start/qb-two-selections.png b/static/img/platform/start/qb-two-selections.png index f3ccd62e..922c7d96 100644 Binary files a/static/img/platform/start/qb-two-selections.png and b/static/img/platform/start/qb-two-selections.png differ diff --git a/static/img/platform/start/qb-two-values.png b/static/img/platform/start/qb-two-values.png index 078af525..9d1f45a8 100644 Binary files a/static/img/platform/start/qb-two-values.png and b/static/img/platform/start/qb-two-values.png differ diff --git a/static/img/platform/start/workspace-assets.png b/static/img/platform/start/workspace-assets.png index 52d86a2f..9495d578 100644 Binary files a/static/img/platform/start/workspace-assets.png and b/static/img/platform/start/workspace-assets.png differ diff --git a/static/img/platform/start/workspace-dash.png b/static/img/platform/start/workspace-dash.png index 2667d686..b0e0068a 100644 Binary files a/static/img/platform/start/workspace-dash.png and b/static/img/platform/start/workspace-dash.png differ diff --git a/static/img/platform/start/workspace-delete.png b/static/img/platform/start/workspace-delete.png new file mode 100644 index 00000000..fa3fc325 Binary files /dev/null and b/static/img/platform/start/workspace-delete.png differ diff --git a/static/img/platform/start/workspace-details.png b/static/img/platform/start/workspace-details.png new file mode 100644 index 00000000..ebebe975 Binary files /dev/null and b/static/img/platform/start/workspace-details.png differ diff --git a/static/img/platform/start/workspace-settings.png b/static/img/platform/start/workspace-settings.png new file mode 100644 index 00000000..13d41722 Binary files /dev/null and b/static/img/platform/start/workspace-settings.png differ diff --git a/static/img/platform/start/workspaces-cards.png b/static/img/platform/start/workspaces-cards.png new file mode 100644 index 00000000..4ff320af Binary files /dev/null and b/static/img/platform/start/workspaces-cards.png differ diff --git a/static/img/platform/start/workspaces-dropdown.png b/static/img/platform/start/workspaces-dropdown.png new file mode 100644 index 00000000..82004a80 Binary files /dev/null and b/static/img/platform/start/workspaces-dropdown.png differ diff --git a/static/img/platform/start/workspaces-topnav.png b/static/img/platform/start/workspaces-topnav.png new file mode 100644 index 00000000..f2c4b4ba Binary files /dev/null and b/static/img/platform/start/workspaces-topnav.png differ