Control Panel > Intergrations > JIRA
JIRA is a workflow management system that lets you track your work in any scenario.
Integrating JIRA with ESP will automatically create new issues for new alerts that you subscribe to. For example, if you subscribe to failing status and the alert starts as fail, changes to pass on a later run, and then fails again, two issues will be created for each fail status.
The Evident to JIRA integration requires 5 pieces of JIRA specific information:
- Project Key
- Issue Type
The JIRA REST API is enabled by default and has the following format:
For the ESP integration, you only need the host and port portion of the URL. If you are using a standard port (80|443), you do not need to include the port number.
For more information about the JIRA REST API, please follow this link.
The JIRA integration needs to be associated with a specific JIRA Project. When you create a JIRA Project, you are required to designate Key. Include this Key when you configure the JIRA integration.
For detailed information on how to manage a JIRA Project, please refer to the JIRA documentation.
The JIRA integration needs to be associated with a specific JIRA Issue Type. Examples of the default Issue Types are Task, Bug, Improvement. You will need to decide which Issue Type to include when configuring the JIRA integration.
Given ESP’s Compliance and Security use case, consider creating a unique Issue Type for the ESP alerts such as “SecurityFinding”. For information on how to add an issue, please refer to the JIRA documentation on creating a new Issue Type.
For more detailed information on Issue Types, please refer to the JIRA documentation.
The ESP to JIRA integration uses Basic Auth so you will need to create a user with access to the Project designated in the previous step. For specifics on how to create a JIRA user and assign access, please refer to the JIRA documentation.
Test JIRA Configuration
Before configuring the ESP integration you may want to test your JIRA configuration by following these instructions. This particular example uses curl so you will need access to bash shell.
- Create a text file (example test.txt) with the following:
"summary": "JIRA configuration test",
"description": "Creating an issue via REST API",
- Use curl to create an issue:
curl -D- -u USERNAME:PASSWORD -X POST --data-binary "@FILENAME" -H "Content-Type: application/json" https://jirahost.example.com/rest/api/latest/issue/
- If the command was successful it will return similar output to the following:
HTTP/1.1 201 Created
Date: Wed, 22 Feb 2017 15:22:14 GMT
Cache-Control: no-cache, no-store, no-transform
Set-Cookie: JSESSIONID=974A7D7832157FEB89DF7EFA90EA8691; Path=/; Secure; HttpOnly
Set-Cookie: atlassian.xsrf.token=BE2J-9QGD-DHYI-2L1Q|95d23adf9a7127427b08570d0955caf2b408daca|lin; Path=/; Secure
Create JIRA Integration in ESP
- Log into ESP.
- Navigate to Control Panel > Integrations.
- Click the JIRA icon.
- Enter the information in the following fields, based on the information from the previous sections:
- Project Key
- Issue Type
- Click Save.