What are the benefits of integrating Jira with the ARMO Platform?

ARMO Platform provides bi-directional integration with Jira which reflects the ticket status.
It supports multiple issue types and allows you to set the reporter and assignee.
It supports mandatory fields and shows indicators for visibility and tracking.
The platform also provides a link within the ticket for easy access to the ARMO Platform.

Set up your Jira integration

Go to the Jira integration settings page. This page allows you to configure your Jira site integration(s).
Start the Integration Process: Click the Connect button.

Jira Cloud Integration

Choose Installation Type: Select the Cloud option and click the Next button.

Authenticate with Atlassian: Click the Accept button on the Atlassian authentication page to allow ARMO to access your Jira account.

Select Projects: Click the Select Projects button and choose the projects you want to integrate with ARMO.

Jira Server Integration

Choose Installation Type: Select the Server option and click the Next button.
Enter API Token and Jira URL:

In the "API Token" field, enter the API token you generated in Jira. (Refer to the steps below on how to generate this token in Jira.)
In the "JIRA URL" field, enter the URL of your Jira server. The URL should follow the format https://your-jira-server.example.com.
Click the Next button to proceed with the configuration.
If you need to cancel the configuration at any point, click the Cancel button.

Generating an API Token in Jira

To generate an API token in Jira, follow these steps under your Jira server:

Log in to your Jira account.
Access Account Settings: Click on your profile icon in the top right corner and select Account settings.
Navigate to Security: Go to the Security section.
Create API Token:

Under API tokens, click on Create and manage API tokens.
Click on Create API token.
Give your token a label/name and click Create.
Copy the generated API token. You will need this for the ARMO configuration.

Create a ticket

After you set up the Jira integration connection, you can create a Jira issue for any security finding on the ARMO Platform by clicking the 3 dots menu --> Create ticket

When you click Create ticket, a Jira ticket creation form appears. This form includes the details of ARMO Platform's findings, which are copied into the associated fields. You can review and edit this form before creating the ticket.

Select the Jira project and the Issue type to which you want to send the ticket. The fields in the example below are based on the specific Project, so different Projects may show different options.

Jira ticket indicator and status

After opening a Jira ticket, you will find a Jira icon on that security issue, indicating there is a ticket assigned. When you mouse hover over that Jira icon, you can see the attached ticket including the Jira status

Unlink a Jira ticket

In case you want to unlink a Jira ticket that is attached to a security issue, simply click the Unlink button, and approve the Unlink action on the dialog