Atlassian Jira

Purpose

This document provides setup information on the Atlassian Jira integration.

Introduction

Jira is a ticketing system which is implemented in both OUTSCAN and HIAB. It can be used in many ways and has different projects to organize the various usages. Tickets (issues) can be created with an assignee who is responsible for getting it done and a reporter who created it. When Jira is enabled, it will be visible as a ticket system, both in Assign Task and Event Notifications. Recently, 

Configuring OAuth in Jira

To set up OAuth in Jira:  

1. Login to OUTSCAN/HIAB.

2. Go to Settings >Integrations and click on the Keys tab. If it has no content, click the Generate new button and copy the public key.

3. Go to Jira and log in (as administrator).

4. Go to Jira administration > Applications > Application links.
   

5. Enter the url to OUTSCAN or your HIAB and click on Create new link.

6. Click Continue.

7. Now we set up the actual connection:

   1. Application Name: Provide a name for this connection to view in Jira.

   2. Application Type: Generic Application.

8. Click the Create incoming link checkbox and click on continue.

9. Fill in the remaining details:

   1. Consumer key: Any text string but maybe a randomly generated one.

   2. Consumer Name: Provide a name. It can be same as application name.

   3. Public Key: Paste the public key that is copied from OUTSCAN/HIAB.

10. Click on Register Application.

Set Up Jira Integration

Prerequisites

• HTTPS certificate from the Jira server.

• The user should have permission to read issues and to create new issues.

• It is required to have Jira set up to accept sub-tasks and priority fields, these must also be set as required in Jira.

• It is important that no custom fields are set up to be required, since nor the HIAB or OUTSCAN does provide information fore those fields.

Setting up

To set up Jira:

1. Download the HTTPS certificate from your Jira server.

2. Go to Main Menu > Settings > Integrations.

3. Select the Jira tab.
   

4. Fill in the forms in the Integration Settings window for Jira. Depending on the type of authentication chosen, the options vary.

   1. When Basic Auth is selected:

      

       

b. When OAuth is selected:

5. Click Save to save the current settings. 

Tickets

If you scan a lot of targets, it is recommended to have a separate Jira project for these tickets, since they can easily reach high in numbers. Every new finding can create one or more new tickets in your Jira server.

There is no maintenance needed except synchronizing configuration if you re-configure your Jira in any way. Synchronization between Jira and OUTSCAN/HIAB is periodic.

Creating a Ticket

After enabling Jira, use any of the following ways to create a ticket:

Method 1

1. Go to Main Reporting Tools > Findings.

2. Right click on any finding, select Assign task.
   

   

   
   

3. Select Jira in the ticket system drop-down menu.

4. Click Save to create a ticket.

Method 2

1. Go to PCI scanning > Reports.

2. Right click on a finding, select Assign task.

3. Select Jira in the ticket system drop-down menu.

4. Click Save to create a ticket.

Method 3

1. Go to Event Notifications.

2. Click +New.

3. Select Jira in the Action drop-down menu.

4. Click Save to create tickets whenever a report is created with findings of the type of the event.

Related Articles