Skip to main content

Integrating Invicti Enterprise with YouTrack

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

YouTrack is a project management tool that can be adapted to your processes to help you track tasks and bugs, plan sprints and releases, and create workflows.

This topic explains how to configure Invicti Enterprise to send a detected vulnerability to YouTrack.

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

YouTrack Fields

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

Field/SectionDescription
NameThis is the name of the configuration that will be shown elsewhere.
MandatoryThis section contains fields that must be completed.
Server URLThis is the YouTrack server URL to which issues are sent.
Bearer TokenThis is the bearer token for authentication.
Project IDThis is the project identifier of the issue.
Title FormatThis is the string format that is used to create the vulnerability title.
OptionalThis section contains optional fields.
TagsThese are the item work tags, separated by a semicolon (;).
Custom FieldsThis section contains user-defined custom fields.
New Custom FieldClick to create a new custom field.
NameEnter a name for the new custom field.
ValueEnter a value for the new custom field.
DropdownClick the dropdown to change the input type. The options are: Text, Password, Textarea, File upload, Complex
Create Sample IssueOnce all relevant fields have been configured, click to create a sample issue.

How to Integrate Invicti Enterprise with YouTrack

  1. Log in to Invicti Enterprise.

  2. From the main menu, select Integrations > New Integration.

  3. From the Issue Tracking Systems, select YouTrack.

YouTrack integration selection in Issue Tracking Systems section showing YouTrack option
  1. In the Name field, enter a name for the integration.

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

    • Server URL
    • Bearer Token
    • Project ID
    • Title Format
  3. 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.

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

warning

If the YouTrack integration is not configured correctly, Invicti Enterprise will correctly route the following descriptive error messages to you.

  1. Select Save to save the integration.

How to Export Reported Vulnerabilities to Projects in YouTrack

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

info

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).

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

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

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

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 > YouTrack.
note

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

After sending the issue, you can view it via YouTrack.

YouTrack vulnerability export interface showing issue selection and Send To YouTrack options in Invicti Enterprise

Need help?

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

Was this page useful?