Integrate with Atlassian Jira

You can integrate Tenable.cs with Atlassian Jira to manage cloud alerts and create Jira tickets for issues. Tenable.cs requires access to your Jira domain, email account, and API token for Jira integration.

Before you begin:

  • As a Jira administrator, you must add a new issue type named Security Issue in your Jira project to integrate Jira with Tenable.cs and to escalate violations. Configure this Security Issue issue type with the following Required fields:

    • Project

    • Summary

    • Description

    • Reporter

    • Assignee

    • Priority

    Caution: Set only these fields as mandatory. The Jira ticket creation fails if you set any additional fields as mandatory.

    For more information, see Add a new issue type and Specifying field behavior in Atlassian documentation.

  • Generate a Jira API token for your Atlassian account.

    For more information, see Create an API token in Atlassian documentation.

  • For generic users, you must ensure that the users have permissions to create issues within the JIRA project that is selected when integrating with Tenable.cs.

To integrate Jira Cloud with Tenable.cs:

  1. Access Tenable.cs.

  2. In the left pane, click Integrations.

    The All Integrations page appears.

  3. Click Configure Jira Integration.

    The Jira Integration page appears.

  4. Select the Jira Cloud option to integrate Jira with Tenable.cs.

  5. Click Continue to select your authentication system.

  6. Select the API Token option to use Jira API token for authentication.

  7. Click Continue to enter your Jira credentials.

  8. In the Enter your credentials section, provide the following details:

    • In the Jira Domain box, enter the name of Jira domain that you want to integrate with Tenable.cs.

    • In the Email box, type the email ID associated with the Jira API token.

    • In the Token box, copy and paste the value of the Jira API token for your Atlassian account.

  9. Click Continue to proceed with your Jira configuration.

  10. In the Set up Jira Configuration section, provide the following details:

    • In the Project drop-down box, select the Jira project.

      All Jira projects in your domain appear in the Project drop-down box.

    • In the Issue type drop-down box, select the issue type as Security Issue.

    • In the Reporter drop-down box, select the username of the reporter for the Jira tickets.

    • In the Assignee drop-down box, select the username of the assignee for the Jira tickets.

      Note: Only the users that are part of the selected Jira Project are displayed in the Reporter and Assignee fields.

    You can view a read-only generic summary of issues. When you create a Jira ticket, Tenable.cs automatically populates the issue summary and description based on the failing policy.

  11. Click Continue to view a summary of the configuration for Jira integration.

  12. Click Setup Jira to integrate Tenable.cs with Jira.

You can now create issues for any failing policies from Tenable.cs. For more information about creating tickets, see Create a Ticket for an Issue.