Support
Configuring Integrations

Configuring user mappings

This document is for:
Invicti Enterprise On-Demand, Invicti Enterprise On-Premises

User mappings state the relationship between Invicti and the integrations in use. If you want to assign an issue to a user in one of Issue Tracking Systems, you must first add a user mapping for that integration. This enables Invicti to recognize the user in that integration space.

For example, if you want to assign an issue in JIRA to a developer who pushed a commit to Jenkins CI:

  • You must declare two mappings – one for Jenkins and another for JIRA. This ensures that Invicti matches the Jenkins user to the Invicti user.
  • Once you define the mappings, you can then configure the Assigned To property in the New Integration window for that developer. If a developer’s commit later creates a vulnerability, then after a scan, that vulnerability will be assigned to the same developer.

User Mappings must be unique. If you attempt to add a user mapping which has the same Integration System and user as an existing mapping, you will encounter an error.

You can add as many user mappings as you want. Users with Administrator permissions will be able to manage all other team members’ user mappings.

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

How to configure a user mapping

  1. Log in to Invicti Enterprise. 
  2. From the main menu, select Integrations > New User Mapping.

New User Mappings Image

  1. From the Integration System drop-down, select the relevant system.
  2. In the Integration User field, enter the username used in the system you selected above.

If you select Jira from the Integration System drop-down, enter User Account ID instead of email. For further information about your account ID, see Atlassian Community.

  1. From the Invicti Enterprise User drop-down, select the relevant username.
  2. Select Save.

How to clone a user mapping

  1. From the main menu, select Integrations Manage User Mappings.

Integration User Mapping Image

  1. Next to the relevant user mapping, select Clone.
  2. From the New User Mapping window, complete the fields (see How to Configure a User Mapping).
  3. Select Save.

How to edit a user mapping

  1. From the main menu, select Integrations Manage User Mappings.
  2. Next to the relevant user mapping, select Edit.
  3. From the New User Mapping window, complete the fields (see How to Configure a User Mapping).
  4. Select Save.

How to delete a user mapping

  1. From the main menu, select Integrations Manage User Mappings.
  2. Next to the relevant user mapping, select Delete.

Delete User Mapping Image

  1. Select Delete.