Links

Jira

PlexTrac offers an integration with Jira to allow red and blue teams to collaborate without switching between tools. PlexTrac provides the option to synchronize with Jira in the following ways:
  • Unidirectionally from PlexTrac to Jira
  • Unidirectionally from Jira to PlexTrac
  • Bidirectionally
  • One-time from PlexTrac to Jira
  • One-time from Jira to PlexTrac
The integration can be with one or more Jira projects, and each project can have mappings of fields and project issue types configured separately.
Only one Jira integration can exist per PlexTrac instance.

Setting up a Jira Integration

Step 1: From the Admin Dashboard, click Integrations under "Tools & Integrations".
Step 2: Click the Jira box.
Step 3: Select if the integration is with Jira Cloud or Jira Server.
Step 4: Input the correct information in the provided fields.
Step 5: Click Save & Continue.
If a successful connection is found, the tool will progress to the next tab to continue. If the connection is unsuccessful, a warning message will appear at the top of the page, and progression will only be possible once the error is resolved.
Step 6: On the Select projects tab, choose the project(s) from Jira to integrate with by clicking the box next to the desired project. Only these projects will be available when creating tickets from findings. Click Continue with all projects when finished.
Step 7: On the Map fields tab, select a project to configure from the pulldown menu "Project name."
Step 8." Select the Jira project issue type to configure from the provided list.
Step 9: Review the default mappings and adjust as desired.
PlexTrac findings cannot be created from Jira issues. Syncing from Jira to PlexTrac will occur after the initial issue creation.
The direction and synch of information between fields are identified from the symbol displayed between the PlexTrac and Jira fields.
Required fields are identified with a red asterisk and cannot be deleted.
To modify the direction, click the icon, then select the desired direction from the options provided. The icon arrow points in the direction that the information would flow between the two fields.
  1. 1.
    Jira to PlexTrac (Continuous sync)
    When a change occurs in a Jira issue, the connected PlexTrac finding will be updated. When changes occur in PlexTrac, the Jira issue will not be updated. PlexTrac findings cannot be created from Jira issues. Syncing from Jira to PlexTrac will occur after the initial issue creation.
  2. 2.
    Bidirectional (Continuous sync)
    When a change occurs in a PlexTrac finding, the connected Jira issue will be updated. When changes occur in Jira, the PlexTrac finding will be updated.
  3. 3.
    PlexTrac to Jira (Continuous sync)
    When a change occurs in a PlexTrac finding, the connected Jira issue will be updated. When changes occur in Jira, the PlexTrac finding will not be updated.
  4. 4.
    PlexTrac to Jira (One-time sync) Syncs data from PlexTrac to Jira upon ticket creation. A change in a PlexTrac finding will not be synced to the connected Jira issue.
If a bidirectional or Jira to PlexTrac direction is configured, be aware that a user in Jira could change findings values in PlexTrac despite not having access or permissions to do so within PlexTrac.
Step 10: Repeat this process for each project issue type.
The options available in the PlexTrac field pulldown menus are contextual to the values selected in the Jira column. To change the options provided for PlexTrac fields, change the field provided in the Jira column.
To add a new row for additional mappings not provided by default, click the plus icon at the bottom (after the last mapping).
Click within the pulldown menu of the previous row just added to select the new PlexTrac field.
Not all fields in PlexTrac are available for mapping to all fields in Jira. In those scenarios, fields will display a red icon when hovering over the field along with a text description of "incompatible data type" when scrolling through the list of fields.
After selecting the field in Jira to map with, use the provided field values to configure the relationship between PlexTrac and Jira by clicking the plus sign on one box and clicking on the desired box in the other system to create a visible purple line denoting the relationship.
Existing lines can be deleted by hovering over the line and clicking the red x.
To delete any row, hover over it with the cursor and click the red trashcan icon.
Step 11: Click Save & Continue.
Step 12: On the Select settings & save tab, use the pulldown menu to set how often the data will refresh between PlexTrac and Jira.
If "Every day" is selected for the refresh frequency, the daily synch time will occur at 04:45 UTC (9:45 PM MTN).
Click Save & Continue when finished.
A modal will briefly appear, confirming the success of integration.

Mapping PlexTrac Custom Fields

PlexTrac custom fields can be added for mapping to a Jira field.
Step 1: Click the plus icon at the bottom of the Map fields tab (after the last existing mapping).
Step 2: Click the pulldown menu on the Jira column of the row just added to see the available fields in Jira to map.
The Jira field must have a data type value of either "String" or "Non-Nullable String." The Jira data type is shown in the right column of the Jira fields when looking at the options provided in the Jira field pulldown menu.
A data type value of "any" is displayed when PlexTrac does not know the data type due to how the field was added to Jira through a plug-in. Mappings with a data type value of "any" may not work as intended.
Step 3: Click within the PlexTrac column pulldown menu of the row just added and select "Custom Field" from the list.
Step 4: Enter the custom field key name.
The custom field key is located on the Custom Fields tab of a finding that is found via the Reports module.
If the custom field key entered is different than what exists in PlexTrac, the mapping will not work, and a new custom field with that incorrectly entered value will be created in PlexTrac.
Step 5: Click Save.

Mapping Jira Custom Fields

Jira custom fields available for mapping can be viewed by clicking a field in the Jira column and scrolling to the bottom of the window under the label "CUSTOM."

Mapping Finding Reported Date

The finding reported date can be mapped so that any future findings will automatically update this value in Jira.
Step 1: Click the plus icon at the bottom of the Map fields tab (after the last existing mapping).
Step 2: Click the pulldown menu on the Jira column of the row just added and select "Start Date."
Step 3: Click the pulldown menu on the PlexTrac column of the same row and select "Created Date."
Step 4: Click Save.
Any linked findings in PlexTrac will now update in Jira. If the mapping is configured for bidirectional, changes in this value in Jira will update in PlexTrac the next time data synchronization occurs.

Editing a Jira Integration

Step 1: From the Admin Dashboard, click Integrations under "Tools & Integrations".
Step 2: Click the Jira box that shows the status of "Connected."
Step 3: Click Edit under the "Actions" menu of the connection to modify.
This screen is also the location to disable or delete a Jira connection.
Step 4: Go to the desired tab to adjust as desired.

Disabling a Jira Integration

Two ways exist to disable a Jira integration:
  1. 1.
    Temporarily, by toggling the button under the "Enabled" column.
2. Permanently, by clicking Delete under the "Actions" column.
Last modified 12d ago
© 2023 PlexTrac, Inc. All rights reserved.