Overview

When SOOS provides fix recommendations for vulnerability issues, with the click of a button you can push the entire content of the recommendation directly into a new Jira ticket for your team to act on.  There's no need to copy/paste, or open another window to create a ticket.

In this article we will make the required steps to integrate Jira with SOOS.

A special note from the SOOS developers: 

We recommend creating a specific "SOOS" user in your Jira account ahead of performing the integration steps below*. 

Using the information for this "SOOS" user to perform the integration will allow all fix recommendations pushed from the SOOS app to appear with this user as the 'reporter', rather than any individual team member's Jira user. 

This also prevents future issues if an individual Jira user who set up the integration leaves your organization.  

Integration Steps

Open the SOOS App, browse to Integrate > External Connections > Jira

Required Information:

  • Cloud URL:  This is your base URL, using the following format - https://[YourCompany].atlassian.net/  If you are unsure, check with your Jira administrator.
  • User Email: The username or email used to log into Jira.  *(Use the "SOOS" user email if you are following the recommendation from the SOOS dev team above.)
  • Jira Ticket Type: This will default to 'Bug', but you may choose to customize this option based on your Jira ticketing preferences.  This is a string field.
  • Jira Ticket Priority:  This will default to 'Low', but you may choose to customize this option based on your Jira ticketing preferences.  This is a string field.
  • API Token: The API Token from Jira. *(Again, use the API token from the "SOOS" user.) You can get more information about Jira API tokens here.

After populating the required information in the SOOS app click Save. 

Once you've set up the integration, navigate to Configure in the left navigation menu in the SOOS app.

Locate the Issue Management Configuration to set the default action to Jira and assign the project key.

SOOS configuration page Issue Management Configuration

Jira settings will apply globally to SOOS, but can also be customized at the project level.  Read more about how to apply project-level settings.

Learn how to push recommended fixes into Jira to enter your development workflow.