ThreatCanvas for Jira Cloud
Installation
Access the app via the Atlassian marketplace
here .
Click the Get it now button and select the site on which you wish to install the app.
Admin Settings
Jira administrators can configure the app to control its availability based on specific projects, issue types, or labels.
Accessing the Configuration
Navigate to Apps in the top navigation bar and select Manage your Apps.
- Locate the app in the list and click on it to open the details view.
Click Configure to access the settings.
Configuration Options
The admin settings page provides the following options:
- Project Filter: Enable this toggle to restrict the app to specific projects.
- Issue Types & Labels Filter: Enable this toggle to restrict the app based on issue types or labels.
Once a filter is enabled, use the corresponding multi-select dropdown to choose the applicable projects, issue types, or labels.
Saving the Configuration
After selecting the desired filters, click Save to apply the settings.
Note: If a filter toggle remains off, the app will be enabled for all options in that category by default.
Usage
On an issue describing a feature or change, find SecureFlag ThreatCanvas on the right hand side and expand it. Wait for the Launch button to appear, then just press it to get your threat model!
ThreatCanvas for Jira Data Center
Installation
Ensure your Jira instance can make requests to
www.secureflag.com in case you have a firewall.
Installing directly on the Jira instance:
- Log in to your instance of Jira as an admin.
- Select the Settings dropdown menu (gear icon at the top right) and choose Manage apps.
- Select Find new apps from the left-hand menu.
- Once the screen loads, you can type SecureFlag ThreatCanvas in the search bar to find the appropriate app version.
- Select Install and follow the prompts to install the app.
- Click the Get it now button to download the plugin .obr file.
- Within Jira, navigate to the Manage apps or Manage add-ons page. You can do this by clicking on the settings icon at the top right, then selecting either Manage apps or Add-ons, depending on your Jira version. From the left sidebar, select Manage add-ons or Manage apps.
- Click on the Upload app link. Then, click Browse and navigate to where the threatcanvas-X.X.X.obr file was downloaded. Select it.
- Click Upload to install the plugin.
- A progress bar should be presented. Wait for Jira to finish installing the plugin.
- Done!
Admin Settings
Jira administrators can configure the app to control its availability based on specific projects, issue types, or labels.
Accessing the Configuration
Navigate to Settings (the gear icon on the top right) in the top navigation bar and select Manage apps.
- Select Manage apps from the left navigation pane.
- Locate the app in the list and click on it to open the details view.
Click Configure to access the settings.
Configuration Options
The admin settings page provides the following options:
- Project Filter: Enable this toggle to restrict the app to specific projects.
- Issue Types & Labels Filter: Enable this toggle to restrict the app based on issue types or labels.
Once a filter is enabled, use the corresponding multi-select dropdown to choose the applicable projects, issue types, or labels.
Saving the Configuration
After selecting the desired filters, click Save to apply the settings.
Note: If a filter toggle remains off, the app will be enabled for all options in that category by default.
Enable ThreatCanvas to Create Tasks in Jira
- In Jira Data Center, in the top right corner click on “Settings” then select “Applications".
- In the left menu, click on "Application Links".
- Click on "Create Link".
In "Application Type", select “External Application”, in “Direction” select “Incoming”, then click on “Continue".
- In “Name” type “ThreatCanvas”, in “Redirect URL” type: "https://www.secureflag.com/user/tc-jira.html”, in “Permission” select “Write”. Note: if you are using ThreatCanvas On-Premise update the domain to your custom domain (e.g. https://mythreatcanvas.company.com/user/tc-jira.html).
Then click on “Save".
The page will display the Client ID and Client Secret values, note them down.
- Login on www.secureflag.com as an Organization Admin, browse to Orgs, select your Organization and click on “Details”. Note for ThreatCanvas On-Premise,
In the “JIRA Data Center Settings” panel, toggle “Jira Data Center Status” to “Active”, and fill the “Client ID”, “Client Secret” and “JIRA Data Center Domain” information.
Usage
On an issue describing a feature or change, find SecureFlag ThreatCanvas on the right hand side and expand it. Wait for the Launch button to appear, then just press it to get your threat model!