Коннекторы

---

Коннекторы позволяют настроить интеграции системы с внешними сервисами. Созданные коннекторы используются в других модулях (например, в Трекерах) для отправки событий/результатов во внешние системы.

Список коннекторов

В таблице отображаются коннекторы, созданные пользователями в рамках организации.

Колонки:

• Интеграция — состояние коннектора: включен/выключен.
• Наименование — название коннектора.
• Тип — тип коннектора, выбранный при создании.
• Создано — дата создания и пользователь-создатель.
• Обновлено — дата обновления и пользователь, выполнивший обновление (если отображается в интерфейсе).
• Действия — действия с коннектором (например, удаление).

Поисковая строка

Правила синтаксиса поисковых запросов описаны в разделе «Поиск в системе». Поисковая строка поддерживает подсказки (фильтры), которые появляются при вводе.

Поддерживаемые фильтры:

• active — фильтрация по включенным/выключенным коннекторам. Пример: active:true
• created — фильтрация по дате создания коннектора
• creator.id — фильтрация по идентификатору пользователя, создавшего коннектор
• creator.name — фильтрация по имени пользователя, создавшего коннектор
• id — поиск по идентификатору коннектора
• name — поиск/фильтрация по наименованию коннектора
• type — фильтрация по типу коннектора
• updated — фильтрация по дате обновления коннектора

Логика выполнения запросов:

• Несколько условий подряд — AND.
• Для объединения условий используйте OR.
• Для исключения условий используйте NOT.

Пример: name:~"Jira" AND active:true

Создание нового коннектора

Чтобы создать коннектор, нажмите кнопку «Создать» — откроется форма.

Поля формы:

• Наименование — название коннектора.
• Тип коннектора — тип интеграции (например, Jira Cloud или Jira Server).
• Параметры подключения — набор полей зависит от выбранного типа коннектора.

Jira Cloud

Параметры:

• clientId, clientSecret - для получения данных параметров воспользуйтесь инструкцией из документации atlassian
  • https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/
  • Минимальные scopes которые необходимы: read:jira-work, write:jira-work
• cloudId - Селект, значения для которого появятся после ввода clientId и clientSecret

Jira Server

Параметры:

• baseUrl - текущий URL сервера Jira
• token - инструкция по получению токена доступна в документации atlassian https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html

Нажмите «Создать», чтобы сохранить коннектор.

Обновление коннектора

При клике на коннектор в списке открывается форма редактирования.

Особенности обновления секретов:

• Поле clientSecret (для Jira Cloud) и поле token (для Jira Server) не отображают ранее сохраненное значение.
• Эти поля используются только для замены секрета.
• Если нужно сохранить текущий секрет без изменений — оставьте соответствующее поле пустым и сохраните изменения.