SUPPORT

24/5 Hotline Support Service

+44 (0)20 3588 3841

Open a Support Ticket

support@netsparker.com

Integrating Netsparker Enterprise with Redmine

Redmine is an issue tracking system that is part of a larger, flexible project management web application. It is free and open source, cross-platform and cross-database. Redmine is written using the Ruby on Rails framework.

This topic explains how to configure Netsparker Enterprise to send a detected vulnerability to Redmine.

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

Redmine Fields

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

Button/Section/Field

Description

Name

This is the name of the configuration that will be shown elsewhere.

Mandatory

This section contains fields that must be completed.

URL

This is the Redmine instance URL.

Api Access Key

This is the API Access Key for authentication.

Project

This is the project identifier in which to create an issue.

Priority Id

This is the priority identifier.

Title Format

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

Optional

This section contains optional fields.

Tracker Id

This is the tracker identifier.

Status Id

This is the status identifier.

Category Id

This is the category identifier.

Assignee Id

This is the assignee identifier.

Due Days

This is the number of days between the date the issue was created to the date it's due.

Is Private

This indicates whether the issue is accessible only to the assignee.

Custom Fields

This section contains user-defined custom fields.

New Custom Field

Click to create a new custom field.

Name

Enter a name for value containing the new custom field identifier.

Value

Enter a value for the new custom field identifier.

Create Sample Issue

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

How to Integrate Netsparker Enterprise with Redmine

  1. Log in to Netsparker Enterprise.
  2. From the main menu, click Integrations then New Integration.

  1. From the Issue Tracking Systems section, click Redmine. The New Redmine Integration window is displayed.

  1. In the Name field, enter a name for the integration.
  2. In the Mandatory section, complete the connection details:
    • Name (The name must be unique)
    • URL (Redmine Server)
    • Api Access Key
    • Project
    • Priority Id
    • Title Format
  3. Open Redmine.
  4. From the main menu, click Projects, then select the relevant project from the list.
  5. Click Settings, then Information. The Information tab is displayed, showing the Identifier.

  1. Copy the Identifier value from Redmine and paste it into Project field in Netsparker Enterprise.
  2. In Redmine, click Administration, then Enumerations. The Enumerations window is displayed.

  1. Click the priority name to find the Identifier value displayed in the URL in the browser bar. Then copy the value and paste into the Priority field in Netsparker Enterprise.
  2. Copy the Priority value from Redmine and paste it into the Priority field Netsparker Enterprise.
  3. In Redmine, click Administration. The Administration window is displayed.

  1. Copy the values from the Tracker ID and Status ID fields.
  2. In Netsparker Enterprise, in the Optional section, paste the values into the Tracker ID and Status ID fields.
  3. In Redmine, click Settings, then Edit for a category. The Category identifier is displayed as the URL in the browser’s address bar. (The Category ID is the URL.)

  1. Copy the Category ID value.
  2. In Netsparker Enterprise, in the Optional section, paste the value into the Category ID field.
  3. Complete the Assignee ID, Due Days and Is Private fields.
  4. If required, click New Custom Field. Two fields are displayed: Name and Value.
  5. In the Name field, enter a name for the value containing the custom field identifier.
  6. In the Value field, enter a value for the new custom field identifier.
  7. Click Create Sample Issue to confirm that Netsparker Enterprise can connect to the configured system and create a sample issue. A confirmation message is displayed to confirm that the sample issue has been successfully created.

  1. In the confirmation message, click the Issue number link to open the issue in your default browser.
  2. If Redmine integration is not configured correctly, Netsparker Enterprise will correctly route the following descriptive error messages to you. Sample error messages may be displayed as illustrated:
    • If the UTL or API Access Key was entered incorrectly

    • If the Priority was entered incorrectly

How to Export Reported Vulnerabilities to Projects in Redmine

There are several ways to send issues to Redmine with Netsparker Enterprise:

  • Once notifications have been configured, you can configure Netsparker 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. The Issues window is displayed.
    • Select one or more issues you want to send.
    • Click Send To, then Redmine.

    • A popup is displayed, with a link to the issue you have sent to Redmine. 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, click Scans then Recent Scans.

    • Next to the relevant scan, click Report. The report is displayed.
    • Scroll down to the Technical Report section.
    • From the list of detected vulnerabilities, click to select an issue and display its details.

    • Click Send To, then Redmine.

    • If you have previously submitted this vulnerability to Redmine, it will already be accessible. You cannot submit the same issue twice.
  • If you view opened problem logs in Redmine, they look like this.

Netsparker

Dead accurate, fast & easy-to-use Web Application Security Scanner

GET A DEMO