Skip to main content

Integrating Invicti Enterprise with Shortcut

This document is for:
Invicti Enterprise On-Demand, Invicti Enterprise On-Premises

Shortcut is a project management platform specifically designed for software development. Shortcut helps bring teams of all sizes together to build better products, from project planning to project creation.

This document explains how to configure Invicti Enterprise to send a detected vulnerability to Shortcut.

For further information, see What Systems Does Invicti Integrate With?.

Shortcut Fields​

This table lists and explains the Shortcut fields in the New Shortcut Integration window.

Button/Section/FieldDescription
NameThis is the name of the configuration that will be shown elsewhere
MandatoryThis section contains fields that must be completed
API TokenThis is the API token for the user
Project IDThis is the project identifier for the issue
Story TypeThis is the issue's story type. The options are: Feature, Chore, Bug
Title FormatThis is the string format that is used to create the vulnerability title
OptionalThis section contains optional fields
Epic IDThis is the epic identifier
State IDThis is the workflow state identifier of the Story
Requester IDThis the member identifier of the person who requested the issue
Owner IDsThis is a comma-separated list of the identifiers of those who own the issue
Follower IDsThis is a comma-separated list of the identifiers of those who follow the issue
Due DaysThis is the number of days from the date the issue was created to the date it's due
LabelsThis is a comma-separated list of labels
Create Sample IssueOnce all relevant fields have been configured, select to create a sample issue

How to Integrate Invicti Enterprise with Shortcut​

  1. Log in to Invicti Enterprise.

  2. From the main menu, go to Integrations > New Integration.

  3. From the Issue Tracking Systems section, select Shortcut.

Shortcut selection from issue tracking systems integration options

  1. In the Name field, enter a name for the integration.

  2. In the Mandatory section, complete the connection details:

    • Name
    • API Token
    • Project Id
    • Story Type
    • Title Format

  3. In the Optional section, complete the following fields, if required:

    • Epic Id
    • State Id
    • Requester Id
    • Owner Ids
    • Follower Ids
    • Due Days
    • Labels

  4. Select Create Sample Issue to confirm that Invicti Enterprise can connect to the configured system. A confirmation message is displayed to confirm that the sample issue has been successfully created.

    • In the confirmation message, select the Issue number link to open the issue in your default browser.

  5. Select Save to save the integration.

How to Edit the Shortcut Integration​

  1. Log in to Invicti Enterprise.
  2. From the main menu, select Integrations > Manage Integration.
  3. Next to the Shortcut, select Edit.
  4. Make the necessary changes and select Save.

How to Delete the Shortcut Integration​

  1. Log in to Invicti Enterprise.
  2. From the main menu, select Integrations > Manage Integration.
  3. Next to the Shortcut, select Delete.
  4. On the confirmation dialog, select Delete.

How to Export Reported Vulnerabilities to Projects in Shortcut​

There are several ways to send issues to Shortcut with Invicti Enterprise:

Automatic Notification Configuration​

Once notifications have been configured, you can configure Invicti Enterprise to automatically send vulnerabilities after scanning has been completed (see How to Configure a Notification to Report Vulnerabilities to an Issue Tracking System).

Send from Issues Page​

You can send one or more issues from the Issues window:

  • You must have Manage Issue permission.
  • From the main menu, select Issues, then All Issues.
  • From the Issues window, select one or more issues you want to send.
  • Select Send To, then Shortcut.

A pop-up is displayed, with a link to the issue you have sent to Shortcut. If there is an error, this information will be displayed instead.

Send from Recent Scans Page​

You can send an issue from the Recent Scans window:

  • From the main menu, select Scans > Recent Scans.
  • Next to the relevant scan, select Report.
  • Scroll down to the Technical Report section.
  • From the list of detected vulnerabilities, select an issue and display its details.
  • Select Send To > Shortcut.
warning

If you have previously submitted this vulnerability to Shortcut, it will already be accessible. You cannot submit the same issue twice.

Need help?​

Invicti Support team is ready to provide you with technical help. Go to Help Center

Was this page useful?