Overview

WhiteSource Issue Tracker enables you to create an issue in a ticketing system according to a policy you defined in the WhiteSource application. Currently, WhiteSource supports integrations with Jira Cloud, Jira Server (starting v 8.5.4) and Work Items.

NOTE: WhiteSource has created a new ability to integrate with issue tracking systems; refer here for details.

Jira Integration

Entering Your Jira Credentials

1. In WhiteSource, click Admin to go to Organization Administration.
2. In Integration, click Issue Tracker Settings.
3. Enter your Jira credentials. Ensure that the URL points to a valid Jira server, and that user name and password are valid user credentials.
   
4. Click Save. WhiteSource verifies the combination of URL+ username + password/API token.

Creating a Policy with an Issue Action

1. From the menu bar, select Policies > Add Policy.

2. Fill in Name and select a Match.

3. In Action, select Issue.

4. In Issue Settings, enter the required fields:
   
5. Click Save.

Reviewing the Newly-Created Issue

After scanning a project matching the policy you created in the above steps, go to your Jira account. The new issue will be displayed.

Note: The CVE links are displayed only if there are applicable CVE records that have been verified by the NVD.

Work Items Integration

Entering Your Work Items Credentials

Using Personal Access Tokens (RECOMMENDED)

1. Go to your Azure DevOps account.
2. Click the profile button and select Security.
3. Click Personal Access Tokens.
4. Click New Token.
5. In Create a New Personal Access Token, do as follows:
   • In Name, enter WhiteSource Integration.
   • In Organization, select your organization.
   • In Expiration, select your preferred expiration date. 
   • In Scopes, select Full access.
6. Click Create.
7. In the Success screen, copy the personal access token (for use later in this procedure).
8. Click Close.
9. In WhiteSource, click Admin to go to Organization Administration.
10. In Integration, click Issue Tracker Settings.
11. Enter your Work Items URL and User Name. In Password, enter (paste) the token that you created previously in this procedure.
    
12. Click Save.

Using Alternate Credentials

1. Go to your Azure DevOps account.
2. Click the profile button and select Security.
3. Click Alternate credentials.
4. Select the Enable alternate authentication credentials checkbox and create a password.
5. Click Save.
6. In WhiteSource, click Admin to go to Organization Administration.
7. In Integration, click Issue Tracker Settings.
8. Enter your Work Items URL and User Name and enter the password that was created in the above steps.
   
9. Click Save.

Creating a Policy with an Issue Action

1. From the menu bar, select Policies > Add Policy.

2. Fill in Name and select a Match.

3. In Action, select Issue.

4. In Issue Settings, enter the required fields.
5. Click Save.

Reviewing the Newly-Created Issue

After scanning a project matching the policy you created in the above steps, go to your Azure DevOps account. The new issue will be displayed.

...