Autotask integration

NAVIGATION  Global Settings > API Integrations

The Autotask integration automatically creates and organizes tickets for every pentest finding directly in Autotask. Tickets are created only when the report is released, ensuring findings are finalized before tickets are sent to Autotask.

Benefits

  • Eliminates manual work by automatically creating and organizing tickets for pentest findings.
  • Prevents duplication and ticket clutter by detecting existing open tickets from previous assessments and updating them instead of creating new ones.
  • Improves remediation speed with structured, severity-based tickets and direct links back to detailed vPenTest results.

Integration features

Feature Description
Automatic ticket creation Creates tickets automatically for pentest findings after a report is released.
Priority mapping Maps vPenTest severity levels to Autotask ticket priorities.
Duplicate handling Updates existing open tickets or creates new tickets with a cross-reference to older ones.
Organization mapping Maps vPenTest organizations to Autotask organizations for ticket synchronization.
Manual ticket creation Allows users to manually create tickets for findings after the report has been released.

How to...

BEFORE YOU BEGIN  In Autotask, create a ticket category for your vPenTest tickets. If you already have a preconfigured ticket category in Autotask, you can use it instead of creating a new one.

To enable the Autotask integration, complete the following steps in vPenTest:

  1. In the left navigation menu, click Global Settings.
  2. Click the API Integrations tab.
  3. Turn on the toggle to enable the Autotask integration.

When the integration is enabled, a three-step setup form appears. You can select Save or Close at any point if you do not want to complete setup immediately.

Step 1: Details

  1. Click Authenticate with Autotask.
  2. Once redirected to Autotask, click Authorize to grant vPenTest access.

After authentication is successful, the button changes to Authenticated. This status is visible to all users in the account.

Step 2: Mapping

This step displays all organizations available in vPenTest for the logged-in user. Refer to Creating and managing organizations. The user can map these vPenTest organizations to their corresponding Autotask organizations using the drop-down menus in the Existing Organization in Autotask column.

Once mapped, organizations show an Autotask icon on the List of Organizations page in vPenTest.

Step 3: Ticket Settings

  1. From the Ticket category drop-down menu, select the ticket category you created in Autotask.

    2. NOTE  If you haven't already done so, review the Autotask instructions for creating a ticket category and create the category at this time.

  2. In the Ticket priority mapping section, select which severities should trigger automatic ticket creation and map them to Autotask priorities using the drop-down menus in the Autotask Priority column.
  3. Select which reports to attach to created tickets, if needed.
  4. In the existing ticket settings, choose whether vPenTest should add a comment to an existing open ticket or create a new ticket with a cross-reference to the previous one.
  5. Click Complete Integration.

To edit your automatic ticket creation settings at any time, complete the following steps:

  1. In the left navigation menu, click Global Settings.
  2. Click the API Integrations tab.
  3. From the Manage Integration drop-down menu, select Edit Integration Details.
  4. Click Next until you reach the Ticket Settings step.
  5. Make the required changes.
  6. Click Complete Integration.

If automatic ticket creation did not create a ticket for a specific finding, you can create one manually after the report has been released as follows:

  1. Navigate to the assessment and open the findings table.
  2. Click the three-dot actions menu for the finding you want to create a ticket for.
  3. Select Create Ticket.

    4. NOTE  The Create Ticket option is available only after the report has been released. If a ticket already exists for the finding, this option does not appear.

The ticket is created in Autotask using the same settings configured in your integration.

The findings table includes an Autotask Ticket column that displays the current ticket status with color-coded indicators:

  • Blue: New
  • Green: Completed
  • Gray: Any other status

Click the status or the open icon to navigate directly to the ticket in Autotask.

Organizations that are mapped to an Autotask organization display an Autotask icon on the List of Organizations page. This helps you quickly identify which organizations are synced.

If an organization in vPenTest is mapped to an Autotask organization, the Organization Profile page displays the sync details.

To change the mapped organization, complete the following steps:

  1. From the left navigation menu, click Organizations.
  2. Click the organization you want to update.
  3. Click Edit Details.
  4. Click the Integrations tab.
  5. From the drop-down menu in the Organization Mapping column, select the Autotask organization you want to sync with the vPenTest organization.

If an organization is not already mapped and the Autotask integration is enabled, the Organization Profile page displays a Match to an Autotask Organization option.

To disable the Autotask integration, complete the following steps in vPenTest:

  1. In the left navigation menu, click Global Settings.
  2. Click the API Integrations tab.
  3. Turn off the Autotask integration toggle.
  4. In the confirmation pop-up window, click Yes, I'm Positive to execute the disabling.

NOTE  If you re-enable the integration later, previously mapped organizations remain mapped. You only need to map new organizations.