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 access to security issues).

To add a task tracker, follow these steps:

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 when you select the Basic type, or a Bearer token when you select the Bearer type.

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. To do this:
   • select Apply preset to prepopulate the data;
   • map ASOC fields to tracker fields in the Fields section;
   • map ASOC statuses to tracker statuses in the Statuses section.

7. Select Save.

8. Turn on the Synchronize 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 the webhook and API endpoint from the Send changes represented in the task tracker to ASOC section.

In the endpoint's {UserApiToken} placeholder, specify 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's 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, follow these steps:

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

To delete multiple task trackers, follow these steps:

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.