Actions with task trackers

Add a task tracker

info

To add task trackers, users must have at least the following permissions:

• view trackers;
• manage trackers;
• create tasks for the tracker;
• view and comment within the access scope for security issues.

To add a task tracker:

1. Go to Integrations → Task trackers.
2. In the window that opens, enter the connection parameters:
   • integration name (for example, Jira Tracker);
   • workspace URL;
   • authentication credentials—an API token or login credentials when you select Basic, or a Bearer token when you select Bearer.

3. Select Create.
4. Specify the default parameters to apply to tasks:
   • Project;
   • Task type:
     • task;
     • bug;
     • story;
   • Task submission format:
     • multiple separate tasks;
     • one combined task.

5. Select Save.
6. Complete the task mapping parameters:
   • select Apply preset to prepopulate the data;
   • map ASOC fields to tracker fields in the Fields block;
   • map ASOC statuses to tracker statuses in the Statuses block.

7. Select Save.

8. Turn on the Sync comments toggle to add comments from the system to the task tracker.

9. Select Save.

After the connection succeeds, the tracker appears in the list with the Active status.

info

To send changes from the task tracker to the system, you can use a webhook and the API endpoint in the Send changes represented in the task tracker to ASOC block.

For the endpoint's {UserApiToken} placeholder, enter the API token created in the user profile. For more information, see Create an API token. We recommend performing this action in a separate account created for the task tracker integration. This way, the task tracker user appears in the security issue change history.

For more information about webhooks, see the official Atlassian documentation.

Delete one or more task trackers

To delete one task tracker:

1. Go to Integrations → Task trackers.
2. Select the additional actions button () next to the task tracker.
3. Select Delete.
4. Confirm the task tracker deletion in the modal window that opens.

To delete multiple task trackers:

1. Select the trackers using the checkboxes ()
2. Select the delete button () above the task tracker table.
3. Confirm the task tracker deletion in the modal window that opens.