Support
Integrations

Integrating Invicti Standard with YouTrack

This document is for:
Invicti Standard

YouTrack is a JetBrains web-based issue tracking and project management platform. YouTrack is optimized for developers and agile teams.

This topic explains how to configure Invicti Standard to send a detected vulnerability to YouTrack (including using the wizard).

For further information, see Configuring the User Interface for Custom Send To Actions in Invicti Standard and Configuring Auto Send To Actions in Invicti Standard and What Systems Does Invicti Integrate With?.

YouTrack Fields

This table lists and explains the YouTrack fields in the Send to Actions tab.

Button/Section/Field

Description

Add

Click to add an integration.

Delete

Click to delete the integration and clear all fields.

Configure Send To

Click to configure the integration using the Settings Wizard instead of using it manually.

Create Sample Issue

Once all relevant fields have been configured, click to create a sample issue.

Action

This section contains general fields about the Send to Action.

Display Name

This is the name of the configuration that will be shown in menus.

Mandatory

This section contains fields that must be completed.

Server URL

This is the YouTrack server URL to which issues are sent.

Bearer Token

This is the bearer token for authentication.

Project ID

This is the project identifier.

Vulnerability

This section contains fields with vulnerability details.

Body Template

This is the template file that is used to create description fields.

Title Format

This is the string format that is used to create the vulnerability title.

Optional

This section contains optional fields.

Tags

These are the work item tags, separated by a semicolon (;).

Custom Fields

Click the ellipsis to open the Custom Fields Editor dialog.

How to Integrate Invicti Standard with YouTrack

  1. Open Invicti Standard.
  2. From the Home tab on the ribbon, click Options. The Options dialog is displayed.
  3. Click Send To Actions.

  1. From the Add dropdown, select YouTrack. The YouTrack fields are displayed.

  1. In the Mandatory section, complete the connection details:
    • Server URL
    • Bearer Token
    • Project ID
  2. In the Vulnerability section, you can change the default Body Template and Title Format.

Body templates are stored in %userprofile%\Documents\Invicti\Resources\Send To Templates. If you use your own custom templates, store them in this location.

  1. In the Optional section you can specify:
    • Tags
    • Custom Fields
  2. To set custom field values, in the Custom Fields field, click the ellipsis button.
  3. In the Edit Custom Field Value field, enter the relevant value.

This table shows some sample fields and values.

Priority

Major, Critical, Normal

Type

Bug, Task, Exception

State

Submitted, Open, InProgress

Due Date

@Raw(System.DateTime.UtcNow.AddDays(7).ToString(“yyyy-MM-dd”))

  1. Click OK.
  2. Click Create Sample Issue to confirm that Invicti Standard can connect to the configured system. A Send To Action Test confirmation dialog is displayed.

  1. In the Send To Action Test dialog, click the Issue number link to open the issue in YouTrack in the default browser.

[a]

How to Integrate Invicti Standard with YouTrack Using the Wizard

Instead of configuring the settings manually, the configuration wizard can help you with the settings.

  1. Open Invicti Standard.
  2. From the Home tab on the ribbon, click Options. The Options dialog is displayed.
  3. Click Send To Actions.                                        
  4. From the Add dropdown, select YouTrack. The YouTrack fields are displayed.

  1. Click Configure Send To to launch the wizard. The Send To Configuration dialog is displayed.

  1. Click Next. The Authentication step is displayed.

  1. Complete the Server URL and Bearer Token fields, and click Test Credentials.
  2. When the confirmation message, Your credentials are confirmed, is displayed, click Next. The Project step is displayed.

  1. Select a project, and click Next. The Priority step is displayed.

  1. If required, complete the Tags field, and click Next. The Summary step is displayed.

  1. Review your settings, and click Finish. The Settings are applied automatically. You are returned to the Send To Actions fields.

How to Export Reported Vulnerabilities to Projects in YouTrack

Please ensure that you have first configured YouTrack integration (see How to Integrate Invicti Standard with YouTrack).

  1. Open Invicti Standard.
  2. From the ribbon, select the File tab. Local Scans are displayed. Double-click the relevant scan to display its results.

  1. In the Issues panel, right click the vulnerability you want to export and select Send to YouTrack. (Alternatively, from the ribbon, click the Vulnerability tab, then Send To YouTrack.) A confirmation message and link is displayed at the bottom of the screen.

  1. Click the YouTrack Send To Action is executed for the selected vulnerability. link to view the newly-created issue in YouTrack.
  2. The vulnerability is automatically exported to YouTrack. You can view it in YouTrack's Issues tab.

[b]

Invicti Help Center

Our Support team is ready to provide you with technical help.

Go to Help Center This will redirect you to the ticketing system.