Skip to main content
Version: 1.8.1

Действия с трекерами задач

К системе TRON.ASOC можно подключать трекеры задач для создания задач по проблемам безопасности.

Текущая версия поддерживает интеграцию со следующими трекерами задач:

  • Jira;
  • EVA Project;
  • Kaiten.

Добавление интеграции с трекером задач​

info

Для добавления интеграций с трекерами задач пользователь должен иметь как минимум следующие права доступа:

  • просмотр трекеров;
  • управление трекерами;
  • создание задач для трекера;
  • просмотр и комментирование (в пределах доступа к проблемам безопасности).

Добавление интеграции с Jira​

Чтобы добавить интеграцию с Jira, выполните следующие шаги:

  1. Перейдите в раздел Интеграции → Трекеры задач.

  2. Нажмите кнопку Добавить трекер задач.

  3. Выберите вариант Jira.

  4. В открывшемся окне введите параметры подключения:

    • название интеграции (например, Jira Tracker);
    • URL-адрес рабочей области;
    • аутентификационные данные — API-токен/логин при выборе типа Базовая или Bearer-токен при выборе типа Bearer.

    Добавление трекера задач

    Рисунок 1 — Добавление трекера задач Jira

  5. Нажмите кнопку Создать.

  6. Выберите вариант отправки задач в Jira (несколько отдельных задач/одна общая задача).

  7. Укажите параметры по умолчанию, которые будут применяться к задачам:

    • Проект;
    • Тип задачи.
    tip

    При выборе варианта отправки проблем как одну общую задачу можно установить фильтрацию проблем по системным полям (например, категория, уровень критичности, CWE/CVE/CVSS) и по пользовательским полям.

    Добавление трекера задач

    Рисунок 2 — Добавление трекера задач Jira

  8. Нажмите кнопку Сохранить.

  9. Заполните параметры маппинга задач:

    • нажмите кнопку Применить пресет для предварительного заполнения данных;
    • укажите соответствие полей TRON.ASOC с полями трекера в блоке Поля;
    • укажите соответствие статусов TRON.ASOC со статусами трекера в блоке Статусы.

    Добавление трекера задач

    Рисунок 3 — Добавление трекера задач Jira

  10. Нажмите кнопку Сохранить.

  11. Активируйте переключатель Синхронизировать комментарии, чтобы добавлять комментарии из системы в трекер задач.

Добавление трекера задач

Рисунок 4 — Добавление трекера задач Jira

  1. Нажмите кнопку Сохранить.

После успешного соединения трекер отобразится в списке трекеров задач. Активировать его можно с помощью переключателя в столбце Статус.

info

Чтобы отправлять в систему изменения из трекера задач, используйте вебхук и API-эндпоинт из блока Отправка изменений, представленных в трекере задач, в ASOC.

В плейсхолдере {UserApiToken} эндпоинта указывайте API-токен, созданный в профиле пользователя (подробнее см. раздел Создание API-токена). Это действие желательно выполнять в отдельной учетной записи, созданной для интеграции с трекером задач, так как в этом случае в истории изменений проблем безопасности будет отображаться именно пользователь трекера задач.

Подробнее о вебхуках см. в официальной документации Atlassian.

Добавление интеграции с EVA Project​

Чтобы добавить интеграцию с EVA Project, выполните следующие шаги:

  1. Перейдите в раздел Интеграции → Трекеры задач.

  2. Нажмите кнопку Добавить трекер задач.

  3. Выберите вариант EVA Project.

  4. В открывшемся окне введите параметры подключения:

    • название интеграции;
    • URL-адрес рабочей области;
    • API-токен для аутентификации.

    Добавление трекера задач

    Рисунок 5 — Добавление трекера задач EVA Project

  5. Нажмите кнопку Создать.

  6. Выберите вариант отправки задач в EVA Project (несколько отдельных задач/одна общая задача).

  7. Укажите параметры по умолчанию, которые будут применяться к задачам:

    • Проект;
    • Логический тип задачи;
    • Список/спринт.
    tip

    При выборе варианта отправки проблем как одну общую задачу можно установить фильтрацию проблем по системным полям (например, категория, уровень критичности, CWE/CVE/CVSS) и по пользовательским полям.

    Добавление трекера задач

    Рисунок 6 — Добавление трекера задач EVA Project

  8. Нажмите кнопку Сохранить.

  9. Заполните параметры маппинга задач:

    • нажмите кнопку Применить пресет для предварительного заполнения данных;
    • укажите соответствие полей TRON.ASOC с полями трекера в блоке Поля;
    • укажите соответствие статусов TRON.ASOC со статусами трекера в блоке Статусы.

    Добавление трекера задач

    Рисунок 7 — Добавление трекера задач EVA Project

  10. Нажмите кнопку Сохранить.

  11. Активируйте переключатель Синхронизировать комментарии, чтобы добавлять комментарии из системы в трекер задач.

Добавление трекера задач

Рисунок 8 — Добавление трекера задач EVA Project

  1. Нажмите кнопку Сохранить.

После успешного соединения трекер отобразится в списке трекеров задач. Активировать его можно с помощью переключателя в столбце Статус.

note

Задачи в трекере создаются правилами реагирования с типом Создание задач. Правила срабатывают при загрузке результатов сканирования и при изменении проблем безопасности. Список событий см. в разделе События типа реагирования «Создание задач».

Добавление интеграции с Kaiten​

Чтобы добавить интеграцию с Kaiten, выполните следующие шаги:

  1. Перейдите в раздел Интеграции → Трекеры задач.

  2. Нажмите кнопку Добавить трекер задач.

  3. Выберите вариант Kaiten.

  4. В открывшемся окне введите API-токен для подключения к Kaiten.

    Добавление трекера задач

    Рисунок 9 — Добавление трекера задач Kaiten

  5. Нажмите кнопку Создать.

  6. Выберите вариант отправки задач в Kaiten (несколько отдельных задач/одна общая задача).

  7. Укажите параметры по умолчанию, которые будут применяться к задачам:

    • Тип карточки;
    • Пространство;
    • Доска;
    • Дорожка;
    • Колонка.
    tip

    При выборе варианта отправки проблем как одну общую задачу можно установить фильтрацию проблем по системным полям (например, категория, уровень критичности, CWE/CVE/CVSS) и по пользовательским полям.

    Добавление трекера задач

    Рисунок 10 — Добавление трекера задач Kaiten

  8. Нажмите кнопку Сохранить.

  9. Заполните параметры маппинга задач:

    • нажмите кнопку Применить пресет для предварительного заполнения данных;
    • укажите соответствие полей TRON.ASOC с полями трекера в блоке Поля;
    • укажите соответствие статусов TRON.ASOC со статусами трекера в блоке Статусы.

    Добавление трекера задач

    Рисунок 11 — Добавление трекера задач Kaiten

  10. Нажмите кнопку Сохранить.

  11. Активируйте переключатель Синхронизировать комментарии, чтобы добавлять комментарии из системы в трекер задач.

Добавление трекера задач

Рисунок 12 — Добавление трекера задач Kaiten

  1. Нажмите кнопку Сохранить.

После успешного соединения трекер отобразится в списке трекеров задач. Активировать его можно с помощью переключателя в столбце Статус.

Редактирование интеграции с трекером задач​

Чтобы отредактировать интеграцию с трекером задач, выполните следующие шаги:

  1. Перейдите в раздел Интеграции → Трекеры задач.
  2. Убедитесь, что редактируемая интеграции в статусе «Активна» (для активации переместите переключатель в столбце Статус).
  3. Нажмите кнопку дополнительных действий (Доп.действия) возле интеграции.
  4. Выберите вариант Редактировать.
  5. Внесите изменения в интеграцию.
  6. Нажмите кнопку Сохранить.

После сохранения данные интеграции будут обновлены в системе.

Удаление интеграции с трекером задач​

Чтобы удалить одну интеграцию с трекером задач, выполните следующие шаги:

  1. Перейдите в раздел Интеграции → Трекеры задач.
  2. Нажмите кнопку дополнительных действий (Доп.действия) возле необходимой интеграции.
  3. Выберите вариант Удалить.
  4. Подтвердите удаление трекера задач в открывшемся модальном окне.

Подтверждение удаления одной интеграции

Рисунок 13 — Подтверждение удаления одной интеграции

Чтобы удалить несколько интеграций, выполните следующие шаги:

  1. Выберите интеграции с трекерами задач с помощью флажков (Флажок).
  2. Нажмите кнопку удаления (Удалить), расположенную над таблицей трекеров задач.
  3. Подтвердите удаление трекеров задач в открывшемся модальном окне.

Подтверждение удаления нескольких интеграций

Рисунок 14 — Подтверждение удаления нескольких интеграций