Integrating Invicti Enterprise with Freshservice

This document is for:

Invicti Enterprise On-Demand, Invicti Enterprise On-Premises

Freshservice is a cloud-based IT help-desk and service management system. It enables organizations to collaborate between agents, isolate problems, and form links between incidents.

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

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

Freshservice Fields

This table lists and explains the Freshservice fields in the New Freshservice 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.
Server URL	This is the Freshservice server URL to which issues are sent.
API Key	This is the API key for authentication.
Requester ID	This is the member identifier of the person who requested the issue.
Title Format	This is the string format that is used to create the vulnerability title.
Optional	This section contains optional fields.
Group ID	This is the group identifier to which the problem is assigned.
Agent ID	This is the identifier of the agent to which the problem is assigned.
Priority ID	This is the priority identifier.
Due Days	The number of days from the date the issue was created to the date it's due.
Create Sample Issue	Once all relevant fields have been configured, select to create a sample issue.

How to Integrate Invicti Enterprise with Freshservice

Log in to Invicti Enterprise.
From the main menu, go to Integrations > New Integration > Freshservice

The New Freshservice Integration wizard is displayed, open at the General Information step.

In the Name field, enter a name for the integration.
In the Title Format field, enter the required format.
Select Next.

From the Authentication step, complete the Server URL and API Key fields, and select Test Credentials. If the Server URL and API key you entered are correct, a 'Success' status message is displayed.
Select Next. The Requester step is displayed.

From the Requester ID drop-down, select an option. Then, select Next.

In the Group step, select an option from the Group ID drop-down, if required.
Select Next.

In the Agent step, select an Agent ID, if required.
Select Next.

In the Priority step, select an option from the Priority ID drop-down, if required.
Select Next.

In the Other Fields step, enter the number of days in the Due Days field, if required.
Select Finish.
The newly-added integration is displayed on the Integrations page.

If you want to update the information, select Edit and change the details.

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, click the Issue number link to open the issue in your default browser.

Select Save to save the integration.

How to Delete the Freshservice Integration

Log in to Invicti Enterprise.
From the main menu, select Integrations > Manage Integration.
Next to the Freshservice, select Delete.
On the confirmation dialog, select Delete.

How to Export Reported Vulnerabilities to Projects in Freshservice

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

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:
- From the main menu, select Issues > All Issues. The Issues window is displayed.
- From the Issues window, select one or more issues you want to send.
- Select Send To > Freshservice.
- A pop-up is displayed, with a link to the issue you have sent to Freshservice. 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, click Report.
- Scroll down to the Technical Report section.
- From the list of detected vulnerabilities, click to select an issue and display its details.
- Select Send To > Freshservice.

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