Jira

The Jira integration allows you to:

• Connect Coana with your Jira workspace
  The installation allows Coana to create and update issues in Jira.
• Create configurations that integrate with Jira
  Configurations hold information about the Jira project key, issue type, priority and other settings.
  You can have multiple configurations, and configurations can be used by multiple projects.
• Create Jira issues from any vulnerability by manual request
  Automatic creation of Jira issues is not yet supported, but you can create Jira issues manually from any vulnerability.

Installation

Install the Coana for Jira app

Go to Settings → Integrations (opens in a new tab) page and click the "Add to Jira" button.

A new window will open the Jira Marketplace listing for the Coana for Jira (opens in a new tab) app.

Click the "Get it now" button, select the site and click "Install app".

Configure the Jira integration

After installing the app, you need to configure the app to connect to your Coana account. Click the "Get Started" button and click the "Configure" button.

Option 1 - Automatic activation

Complete the configuration by clicking the "Connect" button. You'll be redirected to Coana where the connection is confirmed.

Option 2 - Manual activation

If you don't have access to Coana, copy the activation code shown on the configuration page in Jira and send it to the person who has access.
Note: the code will expire after 24 hours. Refresh the page to generate a new code.

Go to the Settings → Integrations (opens in a new tab) page and click the "Activation Code" button and enter the activation code.

Confirmation

Refreshing the page in Jira will confirm when the activation has been completed.

Configuration

When the Jira integration is listed as "connected", you can create configurations for your Jira projects.

Click the "Configuration" button or go to Dashboard → Issue Tracking (opens in a new tab)

Click the "Create Configuration" button and fill in all the required fields for the configuration. See the Configuration section below for more details.

Note: "Automatic actions" are not yet available.

Enable Jira integration for a project

Once you have created a configuration, you can enable it for a project.

Find the project settings for the project you want to edit, and click the "Enable Issue Tracking" button. Select the configuration to use, and remember to click "Save".

Create issues

For any vulnerability, you can now create a Jira issue by clicking the "Actions" and "Create issue...".

The dialog will preview the issue that will be created. Click "Create issue" to create the issue in Jira.

When there's an issue related to the vulnerability, you can see the issue on the left side. There's a link to the issue in Jira, and you can also see the status of the issue.

Jira issue

Here's an example of a Jira issue created from Coana.

Issues created through the integration are tracked, and will automatically have their status updated in Coana. Additionally, if the issue is deleted in Jira, the issue will also be deleted in Coana.

Configuration

Priority Mapping

The default priority schema in Jira use the following values:

• Highest
• High
• Medium
• Low
• Lowest

If you use a different priority schema, you need to map the priorities in Coana to the priorities in Jira.

Click the "Mapping" button. In the opened dialog you can see the default mapping schema.

Change the preset to "Custom" and type in the corresponding priorities in Jira.

Click "OK" when you are happy with the mapping. Remember to press "Save & Close" to save the configuration.

The mapping button will now change color to inform you that custom mapping is active.

Additional fields

You might have additional fields in Jira that you want to populate when creating an issue from Coana. You can add these fields in the configuration.

Click the "Additional fields" button to open the dialog.

Click "Add entry".

Fill in the key and value for the field you want to add. See below for an example of adding a "Team" field.

Click "OK" when you are done. Remember to press "Save & Close" to save the configuration.

Team field example

The "Team" field in Jira can be added to a number of issue types. However, under the hood it's a custom field with an id, here's an example: customfield_10001.

You'll need the Team custom field ID, and the Team ID.

Custom Field ID:

• In Jira, go to Settings (cog icon in top-right) > Issues
• Select Custom Fields from the left-hand menu
• Search for the "Team" field
• Next, select the breadcrumbs (...) in line with the field, and choose View field information
• The ID is in the URL - eg. ?customFieldId=10001

And Team ID:

• In Jira, on the top navigation bar, select Teams > Search people and teams
• Locate and select your Team
• The ID is in the URL, and is a long alphanumeric phrase - eg. /team/5p4894e7-1ef5-6wp1-8erq-7r3hgq43ej9q

With the Custom Field ID and Team ID, you can now add the Team field to the configuration, like this:

Make sure to type the key exactly like this: customfield_10001. Casing is important.