Snyk Security in Jira Cloud Integration

Jira Server and Jira Data Center are not supported.

Snyk Security in Jira Cloud helps developers identify, prioritize, and triage security vulnerabilities related to their code repositories directly from the Jira interface.

The Snyk Security in Jira Cloud integration mirrors your Snyk scan results from the Snyk platform to Jira. You can view Snyk results in your native Jira environment and create Jira issues for your results as needed. You can see which Snyk Organizations are connected and which Snyk Targets are associated with your Jira projects.

Prerequisites for installation of Snyk Security in Jira Cloud

Snyk Security in Jira Cloud is a Jira app.

To install and configure the Jira app, you must be a Jira Cloud administrator in the site-admins, administrators, or jira-administrators group. Contact your IT team to support your effort in installing the Snyk Security in Jira Cloud app.

To connect the Jira app to Snyk, you must be a Snyk Organization administrator.

To activate Security in Jira Cloud in Jira, navigate to Project Settings > Features > Development > Security and toggle Security ON.

Ensure you have the following permission scopes in Jira, which are required for the integration to operate.

Required scope in Jira	Purpose
Write data to the host application	Synchronize vulnerabilities in Snyk with Jira so they appear in the Security tab in Jira.
Read data from the host application	Read vulnerabilities from Jira to optimize the issues synchronization process.
Delete data from the host application	Remove vulnerabilities from Jira when a Snyk Organization is removed from Jira.

Install Snyk Security in Jira Cloud

Follow these steps to install Snyk Security in Jira Cloud from the Atlassian Marketplace.

1. In Jira, navigate to Apps > Find new apps.

2. Search for Snyk Security in Jira Cloud. If you are installing Jira for EU or AU you must install the dedicated EU or AU app from the Atlassian app marketplace

3. Click the app and then select Get it now.

4. Review the information about the app, and select Get it now.

5. Follow the instructions to install the app.

Configure the Snyk Security in Jira Cloud app

1. Go to Apps > Manage apps.

2. In the left menu, select Snyk Security in Jira.

3. Log in to your Snyk account, or sign up for a new Snyk account.

4. In Snyk, select Grant access to allow Snyk to read your Jira Software account information.

5. Select the specific Snyk Organizations to connect to your Jira site, and select Grant app access.

Link code repositories to Jira projects

When you have completed the following steps to connect Snyk to Jira, you can start triaging security issues in Jira.

Typically research and development engineering managers do his task because they own the Jira projects and know their team's code repositories.

1. In Jira, navigate to Project settings > Toolchain and find Snyk in the list of tools. See What is the project toolchain in Jira Software?

2. Select the Add connection plus sign button for Snyk.

3. Choose the container code repository from the list and select Add container. This is a Snyk Target. You can connect more than one code repository to Jira.

Developers can now use the security feature to view recent vulnerabilities found in the linked code repositories and start creating Jira issues from those vulnerabilities or linking them to existing Jira issues.

Only security vulnerabilities will be shown on the Jira Security tab.

Deleting a target or repository

To delete a target or repository from Snyk that you have connected to Jira, you must first delete the container code repository in Jira, through the Security panel in each Jira Project. Then you can remove the target or repository from Snyk.

Remove connected security containers in the Jira Security panel

Manage security vulnerabilities in Jira

After installing and configuring the Snyk Security in Jira Cloud app, you can view vulnerabilities on the security tab on the Jira project page.

Snyk Security in Jira Cloud tab

To find vulnerabilities, navigate to the Vulnerabilities section. Snyk shows the severity, status, and identifiers. Click the title to see the details in Snyk Web UI.

Search, filter, and sort vulnerabilities

Use the search bar and filters in the Vulnerabilities section to customize the list of vulnerabilities to show those relevant to your Organization.

Ignored and closed vulnerabilities are not shown in the Vulnerabilities section by default, but you can view them using the Vuln. status filter.

Select the title of a column in the table to sort all vulnerabilities by that attribute.

Create a Jira issue from a vulnerability

When triaging issues, you can add a Jira issue to the sprint or backlog to ensure the required work for resolving the vulnerability is planned and tracked.

Snyk provides vulnerability information to Jira, enabling users to have comprehensive data for resolving issues.

To add a Jira issue, navigate to the Snyk Security tab, find a vulnerability, and click Create issue.

Jira issue created from a vulnerability found by Snyk

Link an existing Jira issue to a vulnerability

If the vulnerability already has a Jira issue, you can link the vulnerability to the existing Jira issue by clicking the three dots in the Actions column and selecting Link issue.

Auto-close resolved vulnerabilities in security in Jira

These steps describe how to use Jira automation and JQL to automatically close or change the status of tickets for vulnerabilities that are now in a closed state.

1. In Jira on your Project, navigate to Project Settings and then Automation.

2. Click he Create Rule button.

3. Click Scheduled and then Scheduled.

Add Scheduled trigger

1. Select the checkbox that says Run a JQL search and enter status != Done AND vulnerability[status] = CLOSED in the field. Then click Next.

Set up a scheduled JQL search

1. Add a new component and choose THEN: Add an action. Select Issue actionsandchoose Transition issue.

Transition issue action

1. Set the Destination status to Done or another status depending on your workflow.

Set up the transition to Done status

1. Now that the setup is complete, give it a name and click on Turn on rule.

Now, according to your schedule, Jira will search for any issues for which the vulnerability is closed, but the issues are not closed, and close each Jira issue.

Uninstall Snyk Security in Jira Cloud

Uninstalling Snyk Security in Jira Cloud will disconnect Snyk vulnerabilities from their associated Jira issues. To uninstall a Jira app, you must be an administrator in the site-admins, administrators, or jira-administrators groups.

1. In Jira, navigate to Apps in the main menu and select Manage your apps.

2. Select Snyk Security in Jira.

3. Click the Uninstall button.