Skip to main content

Set up Cases and Zendesk

Set up cases in a space to allow users in the space to keep track of security tasks and add Zendesk tickets directly from within the Mondoo Console. Cases setup involves configuring Mondoo to integrate with Zendesk.

For an overview of cases, read Track and Fix Findings with Cases and Your Ticket System.

note

Mondoo offers an alternative method for sharing cases with Zendesk: an email integration. This approach lets you tap into the automation features of Zendesk email channel. To learn how to create an email integration for cases, read Set up Cases to Email Your Ticket System.

Prerequisites

  • Owner or Editor access to the Mondoo space

  • A Zendesk account with access to the channel where you want Mondoo to add tickets

  • An API token for Zendesk account access

    To learn how to create and copy an API token, read Managing API token access to the API in the Atlassian documentation.

Add a Zendesk integration

  1. In the Mondoo Console, navigate to the space where you want to set up cases and, in the side navigation bar, select Cases.

    Configure cases in Mondoo

  2. Select the ADD INTEGRATION button.

    Configure cases in Mondoo

  3. Select Zendesk.

    Configure cases in Mondoo

  4. In the Choose an integration name box, enter a name for the integration. Make it a name that clearly shows this is a Zendesk integration.

  5. In the Zendesk domain box, your Zendesk subdomain. This is the custom part of the URL you use to access Zendesk. For example, if your Zendesk URL is lunalectric.zendesk.com then enter lunalectric in this box.

  6. In the Email address box, enter the email address you use to log into your Zendesk instance.

  7. In the API Token box, paste your API token for access to your Zendesk account. To learn how to create and copy an API token, read Managing API token access to the API in the Atlassian documentation.

  8. Select the CREATE INTEGRATION button.

    Configure cases in Mondoo

  9. Some Zendesk instances have custom fields that must be provided for each ticket. To learn about custom fields, read Using custom fields in Zendesk help.

    If your Zendesk instance has required custom fields, enter the field name and a value for all tickets Mondoo creates. To add more custom fields, select the plus sign (+).

  10. To close a case in Mondoo when the corresponding Zendesk ticket closes, enable Automatically close cases.

  11. To create a case and a corresponding Zendesk ticket when an asset becomes more exposed to attack, enable Create drift issues in this integration. To learn more, read Automatically create cases on drift.

  12. Select the FINALIZE UPDATE button.

Learn more