Add docs on first generation of cases - Jira only (#257)

* Add docs on first generation of cases - Jira only

* Add forgotten image

* Add forgotten image

* Tweaks

docs/platform/infra/saas/ms365/ms365-auto.md

@@ -102,7 +102,7 @@ When successful, the Azure CLI returns results like these:
 
 3. Copy the created PEM file (in the example above, it's named tmpkqyme3rm.pem) and save it; you'll need it later in this process.
 
-#### Step B: Grant permissions to access Microsoft Graph (API permissions)
+### Step B: Grant permissions to access Microsoft Graph (API permissions)
 
 1. Copy this content and save it in a file on your local your system (in this example, the file name is app-manifest.json):
 

docs/platform/maintain/jira.mdx

@@ -1,85 +1,117 @@
 ---
-title: Create Atlassian Jira Issues from Mondoo
-sidebar_label: Create Jira Issues from Mondoo
+title: Track and Fix Security Findings with Cases and Jira
+sidebar_label: Track and Fix Security Findings
 sidebar_position: 4
-description: With the Mondoo Jira integration you can create a Jira issue directly from the Mondoo Console.
+description: Cases, which integrate with Atlassian Jira, allow you to track remediation of important security findings.
 image: /img/featured_img/mondoo-feature.jpg
 ---
 
-Mondoo can create issues directly in Atlassian Jira so you can schedule remediation work within your team's existing project workflows. Without ever leaving the Mondoo Console, you can create Jira issues (tickets) that include all the details necessary for infrastructure owners to remediate findings, even if they don't have access to Mondoo.
+The work of improving your security posture can be daunting. Mondoo finds security issues in your infrastructure and prioritizes them so you know what problems to fix first. But how do you track the fixes and ensure that the work is completed? How do you communicate the most important tasks to your team?
 
-Once you set up a Jira integration, a Create Jira Issue icon on each asset's page lets team members add an issue to your Jira project:
+*Cases* allow you to turn security findings into tasks to complete. They integrate with Atlassian Jira to fit into your existing workflow.
 
-![Icon to add a Jira issue from Mondoo](/img/platform/ticket/jira-icon-closeup.png)
+When you see a security finding that requires fixing, you create a case for that finding. Mondoo automatically includes the details of the finding, information on the asset(s) that contain the finding, and instructions for fixing it. When you save the case, Mondoo automatically creates an issue containing all the same information in your Jira project.
 
-Mondoo's Jira integration even provides remediation details right in the issues, so the team members fixing issues have all the information they need.
+![Cases in Mondoo and issues in Jira](/img/platform/ticket/cases-diagram.png)
 
-![Add a Jira issue from Mondoo](/img/platform/ticket/add-jira-issue.png)
+Once Mondoo creates an issue directly in Jira, you can plan, schedule, and track remediation work within your team's existing project workflow. The Jira issues that Mondoo creates from cases include all the details necessary for infrastructure owners to remediate findings, even if they don't have access to Mondoo.
 
-## Integrate Jira with a Mondoo space
+In the Mondoo Console, if a security finding or an asset has a case associated with it, you can view the case from the finding or the asset. You can also see a list of all cases in a space.
 
-Adding a Mondoo Jira integration to a space allows users in that space to add Jira issues from within the Mondoo Console.
+You can also close cases in the Mondoo Console. When you set up cases in a Mondoo space, you choose whether closing a case in the space closes the corresponding issue in Jira.
+
+## Set up cases to automatically create Jira issues
+
+Set up cases in a space to allow users in the space to add Jira issues from within the Mondoo Console. Cases setup involves configuring Mondoo to integrate with Jira.
 
 ### Prerequisites
 
 - Owner or Editor access to the Mondoo space
 
 - A Jira account with access to the project where you want Mondoo to add issues
 
-- The _project key_ of the project where you want Mondoo to add issues
-
-  A project key is the short name that Jira adds to all issues in a project. For example, you might have a project named Security with the project key SEC. All the issues in the Security project include the key SEC in their issue IDs, such as SEC-233 or SEC-1438.
-
-  You can also view a project key in Jira by selecting the **Projects** menu and then **View all projects**. The table listing all your projects shows the key for each project.
-
 - An API token for Jira account access
 
   To learn how to create and copy an API token, read [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) in the Atlassian documentation.
 
 ### Add a Jira integration
 
-1. Access the Integrations > Add > Atlassian Jira page in one of two ways:
+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](/img/platform/ticket/cases-blank.png)
+
+2. Select the **ADD INTEGRATION** button.
+
+   ![Configure cases in Mondoo](/img/platform/ticket/cases-add-jira.png)
+
+3. In the **Choose an integration name** box, enter a name for the integration. Make it a name that clearly shows this is a Jira integration.
+
+4. In the **Jira Host** box, type the domain for your Jira instance. Do not include a slash at the end of the domain. Example: `https://lunalectric-workspace.atlassian.net`
+
+5. In the **Email address** box, enter the email address you use to log into your Jira instance.
 
-   - New space setup: After creating a new Mondoo account or creating a new space, the initial setup guide welcomes you. Select **BROWSE INTEGRATIONS** and then select **Atlassian Jira**.
+6. In the **API Token** box, paste your API token for access to your Jira account. To learn how to create and copy an API token, read [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) in the Atlassian documentation.
 
-     ![Welcome to Mondoo Page](/img/platform/start/welcome_to_mondoo.png)
+7. By default, when you close a case in the Mondoo Console, Mondoo also closes the corresponding Jira issue. To stop Mondoo from closing Jira issues, disable **Automatically close cases**.
 
-   - INTEGRATIONS page: In the side navigation bar, under **INTEGRATIONS**, select **Add New Integration**. Under Ticket Systems, select **Atlassian Jira**.
+8. Select the **CREATE INTEGRATION** button.
 
-     ![Add an integration - ticket system](/img/platform/ticket/add-int-ticket.png)
+## Create a case to add a Jira issue from Mondoo
 
-2. In the **Choose an integration name** box, enter a name for the integration. Make it a name that clearly shows this is a Jira integration.
+When a Mondoo space has the cases feature configured, any team member can create a case, which creates a new a Jira issue directly from the Mondoo Console.
 
-   ![Add a Jira integration to a Mondoo space](/img/platform/ticket/add-jira-int-top.png)
+1. In the [Mondoo Console](https://console.mondoo.com), [navigate](/platform/start/navigate) to a space that is set up to use cases.
 
-3. In the **Jira HOST** box, type the domain for your Jira instance. Do not include a slash at the end of the domain. Example: `https://lunalectric-workspace.atlassian.net`
+2. In the side navigation bar, under **Vulnerabilities**, select **Advisories**.
 
-4. In the **Email address** box, enter the email address you use to log into your Jira instance.
+3. Select the advisory you want to track using a case and a corresponding issue in Jira.
 
-5. In the **API Token** box, paste your API token for access to your Jira account. To learn how to create and copy an API token, read [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) in the Atlassian documentation.
+   ![Add a case in Mondoo](/img/platform/ticket/add-case-advisory.png)
 
-6. In the **Provide a default project** box, enter the project key for the project where you want Mondoo to add issues. To learn about project keys, read the Prerequisites section above.
+4. To the right of the asset name, select the **CREATE CASE** button and select **Selected Assets** to jump to the bottom of the page and see all assets affected by the advisory.
 
-7. Select the **CREATE INTEGRATION** button.
+   ![Create a new Jira issue in Mondoo](/img/platform/ticket/select-asset.png)
 
-## Add a Jira issue from Mondoo
+5. Check the boxes beside all the assets for which you want to track this advisory. Note that this creates a single case (and therefore a single Jira issue) for all the assets you choose. (If you want to track assets separately, create a new case for each asset.)
 
-When a Mondoo space has a Jira integration, team members can add Jira issues directly from the Mondoo Console. Any team member can add issues, as long as their email address (in Mondoo) matches the email address they use to log into the Jira instance.
+   Select the **CREATE CASE** button.
 
-1. In the [Mondoo Console](https://console.mondoo.com), [navigate](/platform/start/navigate) to a space that is integrated with Jira and.
+   ![Create a new case in Mondoo](/img/platform/ticket/new-case.png)
 
-2. [In the Inventory view, access the asset](/platform/security/posture/monitor/) for which you want to create a Jira issue.
+6. Select the Jira project in which you want Mondoo to add the issue. Edit the issue name and description as you wish and select the **CREATE CASE** button.
 
-   ![Add a Jira issue on a Mondoo asset](/img/platform/ticket/jira-icon-fleet.png)
+   Mondoo creates a new case in the space and a corresponding Jira issue in the project you selected.
 
-3. To the right of the asset name, select the Jira icon.
+## View cases and Jira issues
 
-   ![Create a new Jira issue in Mondoo](/img/platform/ticket/add-jira-issue.png)
+On the Cases page in the Mondoo Console, you can view all the cases in a space.
 
-4. Edit the issue summary and description as you wish and select the **CREATE ISSUE** button.
+![Cases in Mondoo](/img/platform/ticket/cases-list.png)
 
-In the Jira project, you can view the tickets that Mondoo creates on your behalf. It's like any other Jira issue.
+Select a case to open its corresponding issue in Jira.
 
 ![Jira issue created by Mondoo](/img/platform/ticket/issue-in-jira.png)
 
+:::note
+
+Updating a Jira issue that Mondoo created from a case does not make any changes to the case.
+
+:::
+
+## Close a case
+
+Close a case to indicate that the work is completed or to stop tracking it. By default, when you close a case in the Mondoo Console, Mondoo also closes the corresponding Jira issue. However, you can change this when you first set up cases for the space. To learn how, read the "Add a Jira integration" section above.
+
+:::note
+
+Closing an issue in Jira does not close the corresponding case in Mondoo.
+
+:::
+
+1. In the Mondoo Console's side navigation bar, select **Cases**.
+
+   ![Configure cases in Mondoo](/img/platform/ticket/cases-list.png)
+
+2. Select the **CLOSE CASE** button beside on the row of the case you want to close.
+
 ---