Skip to content

Integrating Boost Security to Jira

Boost Security supports creating tickets in Jira directly from the dashboard.

When this integration is enabled, a link will appear alongside Boost Security findings to create an issue in Jira with the details pre-populated. In addition, Boost Security will display information on the integration, such as its current status.

Prerequisite Integration Steps

  1. Log in to the dashboard.
  2. Once logged in, locate the left sidebar and click on the Integrations tab.
  3. Navigate to the Available tab.

  4. Look for Atlassian JIRA and click the "Install" button.

    JIRA Integration

There are two ways to enable the JIRA integration to Boost Security:

1. Install Boost Security from the JIRA Marketplace

  1. Follow the prerequisite integration steps.

  2. Click "MarketPlace App" on the next page and click the Install MarketPlace App button.

    Install MarketPlace App

  3. You will be directed to our Atlassian Marketplace app.

  4. On the Atlassian Marketplace app page, click Get it now in the top-right corner.

    Get it Now

  5. Choose the specific Jira installation to integrate with.

    Note

    You will require Administrative privileges in Jira to continue with the installation.

  6. Click Install now.

  7. Click Get started to continue the activation once installed.
  8. Finally, select the Jira project you wish to use with the integration.

2. Install the JIRA Integration with an Access Token

  1. Follow the prerequisite integration steps.

  2. On the Access Token tab, provide the following details

    • Username
    • Base URL
    • Access Token

    Provide Details

    Note

    The Jira token needs to be created by a Jira Admin, i.e., the token needs admin privileges.

  3. Click on the Next button.

  4. A list of projects is provided, which you would be required to select from.
  5. Select a default project.

Once complete, you will then see the Jira icon on your findings page:

add-new

When you add a new Issue, it will be tracked:

added

And it will provide details:

details

Uninstalling Boost Security Integration for JIRA

To uninstall the Boost Security JIRA Integration from your JIRA projects, follow these steps:

  1. Log in to your JIRA account with Administrative privileges.
  2. Navigate to the Administration settings in Jira.
  3. From the left sidebar, find and select Add-ons or Manage Apps.
  4. Look for the Boost Security integration in the list of installed apps.
  5. Click on the Uninstall button next to the integration.
  6. Confirm the uninstallation when prompted.
  7. The integration will be removed from your JIRA projects.

Configure an Issue Type for each JIRA project

When configuring your JIRA integration, you can now select a default Issue Type for each connected JIRA project directly from the Issue Types column on the integration page.

The Issue Types column displays the available issue types for each selected JIRA project, allowing you to define how Boost Security findings are created and categorized in JIRA.

Select Project Issue Type

How to Configure Issue Types

  1. Navigate to the Integrations page in Boost Security.
  2. Locate your installed JIRA integration.
  3. In the project list, find the Issue Types column.
  4. For each project, select the preferred issue type from the dropdown list.
  5. Save your configuration.

Once configured, all findings pushed to JIRA for that project will be created using the selected issue type.

Available Issue Types

The available issue types include:

  • Story: Represents a feature or requirement described from the user’s perspective. Use this when a finding requires structured work that contributes to a broader feature or initiative.

  • Task: A general-purpose work item. This is the most flexible option and is commonly used for operational or remediation activities that don’t require detailed user stories.

  • Bug: Used to track defects or issues. This is typically the most appropriate option for security findings, as it represents a problem that needs to be fixed.

  • Epic: A large body of work that can be broken down into smaller tasks or stories. This is less commonly used for individual findings but may be applicable for grouping related issues.

Note

The list of available issue types is retrieved directly from your JIRA project configuration. Sub-task issue types are currently not included in the Issue Types list and cannot be selected when configuring the integration.

FAQ

How do I see Jira tickets created by Boost Security?

issue.property[boostsec].finding-id is not EMPTY

By default, Boost Security creates Jira tickets with a finding-id property, which you can easily filter for in jql queries.

issue.property[boostsec].finding-id is not EMPTY

How to resolve JIRA installation error

Suppose JIRA indicates that the Boost Security app is already installed but does not appear on your Installed Apps page. In that case, you can fix the issue by uninstalling the app and reinstalling it.

How to update the JIRA Personal Access Token

You can update the Jira access tokens without disrupting active connections by:

  1. Navigate to the Configuration tab of your installed JIRA integration.

  2. Click the "Update Jira Personal Access Token" icon.

    JIRA PAT Icon

  3. Input the new token and click the "Update" button to save the settings.

    Update PAT