Skip to main content

Manage Cases

Managing cases includes:

  • Viewing open and closed cases

  • Examining case details and progress

  • Closing cases

  • Changing settings that control how cases work in a space

View cases

On the Cases page in the Mondoo Console, you can view all the open and closed cases in a space and see the progress made toward fixing the assets they track. To view cases in a space:

  1. In the Mondoo Console, navigate to the space.

  2. In the side navigation bar, select Cases.

    Status bars show progress made by fixing the assets tracked in each case.

    Cases in Mondoo

  3. Select a case to see its details.

    Case details in Mondoo

note

Changes you make to a Mondoo-case-based ticket in your ticket system do not affect the case in Mondoo. Similarly, making progress on a case in Mondoo doesn't update the corresponding ticket in your ticket system.

Close a case

Close a case to indicate that the work is completed or to stop tracking it. You can close a case from the list of cases or from the case detail page.

note

Only team members with Editor or Owner access can perform this task.

  1. In the Mondoo Console, navigate to the space.

  2. In the side navigation bar, select Cases.

    Status bars show progress made by fixing the assets tracked in each case.

    Cases in Mondoo

  3. To close the case, either:

    • Select the CLOSE CASE button on the row of the case you want to close

    Close a case in Mondoo from the open cases list

    or

    • select the case you want to close and then select the CLOSE CASE button near the top-right corner of the case detail page.

    Close a case in Mondoo from the case detail

note

Closing an ticket or issue in your ticket system or does not close the corresponding case in Mondoo. If you create cases using a direct integration with your ticket system, a space-wide setting controls whether closing a case in Mondoo automatically closes the corresponding issue/ticket in your ticket system. To learn more, read the section below.

Automatically create cases on drift

Drift occurs when, instead of improving security, an asset becomes more vulnerable to attack:

  • An asset previously passed a check in a policy but is now failing that check

  • Mondoo previously did not detect a vulnerability on an asset, but now does detect that vulnerability

It's important to catch drift quickly. Mondoo makes that possible with automatic drift detection. When an asset becomes less secure, Mondoo can automatically create a case to alert you of the change and track the work on resolving the problem.

The space setting Automatically create cases on drift controls whether Mondoo creates a case when it detects drift.

Cases space settings in Mondoo

To enable or disable automatic drift cases:

note

Only team members with Editor or Owner access can perform this task.

  1. Navigate to the space where you want to change the drift setting.

  2. In the navigation sidebar, select Settings and then select the Cases tab.

  3. Enable or disable Automatically create cases on drift.

Choose a destination for drift cases

Like all cases, Mondoo can share automatically created drift cases with your ticket system. When you add a new ticket integration for cases, you choose whether to create drift issues/tickets. You can also change this option any time in the space settings: Enable or disable Create drift issues in this integration. For direct integrations, you also specify the default destination for drift tickets/issues.

To choose a destination for automatic drift cases:

note

Only team members with Editor or Owner access can perform this task.

  1. Navigate to the space where you want to change the drift setting.

  2. In the navigation sidebar, select Settings and then select the Cases tab.

  3. Locate the settings for your integration and enable or disable Create drift issues/tickets in this integration.

  4. For direct integrations, specify where to create drift issues/tickets.

Group similar drift occurrences into one case

If the same drift occurs on multiple assets, you may not want a separate case for each asset. Mondoo can group the drift detection of multiple assets into a single case. To do this, it waits a configurable period of time before finalizing a case and creating an issue or ticket in your ticket system.

For example, suppose you configure Mondoo to create a new case and a corresponding Jira issue whenever it detects drift. You also configure Mondoo to wait four hours to group multiple instances of the same drift into one case. Mondoo scans asset 1, which fails check X. Mondoo identifies that asset 1 previously passed check X. This is drift, so Mondoo generates a case. However, Mondoo doesn't immediately save the case or create a Jira issue. Instead, Mondoo waits four hours to determine if any other assets also have incurred drift on check X. During these four hours, asset 5 and asset 6, which previously passed check X, now fail check X. Instead of creating new cases for assets 5 and 6, Mondoo adds information about assets 5 and 6 to the case initially created for asset 1. Now there is a single case with information about the three assets that incurred drift on check X. When four hours have passed, Mondoo creates a single Jira issue with the details about asset 1, asset 5, and asset 6 all incurring drift on check X.

The Aggregation window space setting controls how long Mondoo waits to group similar drift occurrences in a single case. You either choose a time period or choose No aggregation to create a unique case (and corresponding issue or ticket) for each asset that incurs the same drift.

To automatically group similar drift occurrences into one case:

note

Only team members with Editor or Owner access can perform this task.

  1. Navigate to the space where you want to change the drift settings.

  2. In the navigation sidebar, select Settings and then select the Cases tab.

  3. In the Aggregation window drop-down list, choose how long to wait to detect the same drift on other assets before finalizing a case and creating an issue/ticket in your ticket system.

Choose whether to close tickets/issues when you close cases

Space-wide cases settings

You can choose whether to close the corresponding issue or ticket in your ticket system when you close a case in the Mondoo Console. This setting applies only to direct integrations, not to email integrations.

note

Only team members with Editor or Owner access can perform this task.

  1. Navigate to the space where you want to change the closing behavior.

  2. In the navigation sidebar, select Settings and then select the Cases tab.

  3. Enable or disable Automatically close tickets.

Learn more