Skip to Content

Jira

⚠️
The Jira integration is in beta stage.

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 page and click the “Add to Jira” button.

Jira integration

A new window will open the Jira Marketplace listing for the Coana for Jira app.

Jira marketplace

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

Coana for Jira - configuration

Complete the configuration by clicking the “Connect” button. You’ll be redirected to Coana where the connection is confirmed.

Coana for Jira - activation complete

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 page and click the “Activation Code” button and enter the activation code.

Coana for Jira - activation code

Confirmation

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

Coana for Jira - configuration

Configuration

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

Jira integration - connected

Click the “Configuration” button or go to Dashboard → Issue Tracking

Configurations

Click the “Create Configuration” button and fill in all the necessary fields. See the Configuration options section below for more details.

Create configurations

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”.

Project settings

Create issues

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

Create issue

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

Create issue

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.

Issue popover

Jira issue

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

Jira issue

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 options

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.

Priority Mapping

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

Priority Mapping - Default

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

Priority Mapping - Custom

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

Priority Mapping - Active

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.

Additional fields

Click “Add entry”.

Additional fields - Dialog

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

Additional fields - New entry

Click “OK” when you are done.

Additional fields - With entry

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:

Additional fields - Team

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