In this article:
Jira App is available with a paid SecurityScorecard plan. See our plans page for more information about levels of features and access.
Use Jira App in Integrate360° Marketplace to automate ticket creation in Jira, based on scorecard changes and events. You design rules that are triggered by these events to create tickets with the following information:
- Event name
- Description
- Link to the Security Scorecard associated with the event
You can then assign and update the ticket like you would with any other Jira ticket.
Note: The capability to automatically update existing Jira tickets is in development. Also, automatic ticket assignment is not supported.
Install the App
Tip: The Jira App integration works with Jira Cloud or Jira Server/Datacenter installations.
Follow the simple setup instructions below, or watch this video to get started.
First, make sure you have the following:
- SecurityScorecard account with a paid plan
- Jira account with administrative permissions or approval to integrate the app from your Jira administrator
Then, take the following steps:
- Select Marketplace from the top menu in the SecurityScorecard platform.
- On the Marketplace page, start typing Jira in the search box and then select Jira App to go to the installation page.
- On the Jira App page, click Install.
- Select whether you have Jira Cloud or Jira Server/Data Center installation. If you are unsure, ask your Jira administrator.
- Depending on the type of Jira installation enter the requested information to authorize the connection between Jira and SecurityScorecard, and then click Confirm.
For Jira Cloud:
- Your Atlassian API token (Click the link in the form to retrieve or create a token.)
- Your Jira login email address
- Your Jira site host (Log into Jira and copy the URL from your browser navigation bar, or ask your Jira administrator for help.)
Examples:
mycompany.atlassian.net
zitenote.atlassian.net
For Jira Server/Datacenter:
- Your Atlassian personal access token (Click the link in the form for guidance to obtain the token.)
- Your Jira site host (Log into Jira and copy the URL from your browser navigation bar, or ask your Jira administrator for help.)
Examples:
mycompany.atlassian.net
zitenote.atlassian.net
On successful authorization, you see a success message.
Create a Rule to Activate Ticket Creation
Note: You can create up to 25 rules with this app integration.
Take the following steps to create a rule that automates ticket creation with a scorecard event:
- From the Jira App page, select Rules & Actions.
- In the drop-down list, select an option:
- Create your own custom rule.
- Use a predefined rule provided by SecurityScorecard.
- In Rule Builder, create the details of your rule:
- Enter a name to help you remember the rule.
- Select the event that will trigger the rule, such as:
- Grade drop or rise
- Overall score drop or rise
- Overall score percentage drop
- Select a scorecard or portfolio that the rule applies to.
- Select the action(s) that the rule initiates, in this case, creating a Jira ticket.
- Save the rule.
Jira tickets are then automatically created every time the rule is triggered, with more details for your team to take action.
Note: SecurityScorecard only tracks the following Jira data from your app integration:
- Details of the event that triggered the rule
- Your user name, email, and organization
Turn off SecurityScorecard Notifications
To disable notifications, turn off each alert individually:
- Select My Settings from your profile avatar in the top right corner of the platform interface.
- Select the Rules tab from the left to edit, delete or pause each rule individually.
Uninstall the Jira App Integration
First delete the rules configured for the Jira integration.
Then, on the Jira App page, click Uninstall.
Get Help or Share Feedback
If you need help, have questions, or would like to share feedback, submit a Support request.