For the complete documentation index, see llms.txt. This page is also available as Markdown.
Jira
Connect your most important Jira boards to streamline project management.
Note: This integration is available with the Standard Plus package or above.
Prerequisites
An account with Org Admin permissions.
Steps
Start the integration setup.
In the Portal navigation sidebar, locate the Integrations page near the bottom and open it
Find the Jira integration card, and then click Add Jira Account.
Generate a Jira API token.
Log in to your Jira account
Click your profile icon, and then click Manage Account.
In the new window, click on the Security tab and then click Create and manage API tokens.
Create a new API token with a relevant name, such as Portal Integration Token. Set a long expiry, but not too long; Software Secured recommends 1 year.
Copy the token.
Connect Portal to Jira.
On Portal, continue enabling the integration.
In the server URL, enter the domain of your Jira tenant. The URL usually looks like the following example: <your-company>.atlassian.com
Enter your Jira username and the API token from step 2, and then click Next.
Add your Jira account that you want to integrate with Portal.
Select projects and boards.
Select the Jira Project that you would like to connect. When creating tickets in Jira from vulnerabilities in Portal, they will be created in this project.
Select the Portal Project that you would like to connect to.
Choose the projects and boards to integrate.
Configure field mapping.
Note
If you already have fields in Jira that match the name of the fields in Portal, they are automatically mapped to each other.
Select the Jira record type that you would like the integration to use when creating new records. You can select any record type from your project.
If necessary, customize the field mapping by selecting different fields from the dropdown menus.
Choose which fields in Portal will populate which fields in Jira.
