Jira Cloud (outbound integration)

Integrate Identity Security Posture Management (ISPM) with your Jira Cloud instance to create Jira issues automatically for security issues detected by ISPM. This helps streamline your remediation workflow.

The connection is established using OAuth 2.0. This means that after you integrate, Okta ISPM is authorized to perform actions in Jira on behalf of a specific Jira user.

Before you begin

  • Ensure that you have the unique URL of the Jira instance. For example, https://your-company.atlassian.net

  • Ensure that you have the credentials for a Jira user account that will be used to authorize the connection. Ideally, use a dedicated service account in Jira to help prevent the connection interruptions if an employee leaves the company or changes roles. This service account must have the necessary project permissions to create and modify issues in the target Jira project.

Start this task

  1. In the ISPM console, go to Settings Outbound integrations.

  2. Select Jira.

  3. Enter the following parameters:

    • Integration name: Enter a name for this integration.

    • Instance URL: Paste your full Jira Cloud URL into the field. For example, https://your-company.atlassian.net

  4. Click Continue to Jira authorization. You're automatically redirected from Okta to the Atlassian authorization page.

  5. Authorize the Okta ISPM app in Jira:

    1. Sign in to the Jira user account (ideally, a dedicated service account) that you plan to use to authorize the application.

    2. Review permissions being granted to Okta ISPM to understand what actions ISPM will be able to perform using the Jira account.

    3. Click Accept to approve the connection. You're redirected to the Okta ISPM console.

  6. Click Continue to mapping.

  7. Map the ISPM issues payload to Jira tickets:

    1. In the Project field, select the relevant project for creating tickets.

    2. In the Summary and Description fields, edit the content of each field to enter text. You can also include an ISPM issue field that's available in the ISPM console by copying it to the selected Jira field. This field name should be wrapped in curly brackets.

    3. In the Issue Type field, choose the relevant issue type. The issue types available are based on the project that you chose earlier.

    4. Optional. Add more fields by choosing them from the dropdown list and then clicking Add field.

    5. Click Add mapping.

  8. Click Add automation.

  9. Select the issues for which ISPM should trigger alerts for you. You can modify the alerts and the issues at any time.

  10. Click Add automation.