Настройка коннектора Jira

Материал из Документация Ключ-АСТРОМ

Настройка коннектора Jira

Узнайте, как настроить Jira для использования коннектора Jira. После этой настройки вы сможете использовать действия коннектора Jira в вашем Workflow.

Предварительные требования

  • Доступ к экземпляру Jira.
  • Разрешение app-engine:apps:install.

Шаги

Добавьте новый шаблон хоста во внешних запросах

Внешние запросы включают исходящие сетевые подключения из вашей среды Ключ-АСТРОМ к внешним сервисам. Они позволяют управлять доступом к публичным конечным точкам из AppEngine с помощью функций приложений и функций в Дашбордах, Блокнотах и Автоматизациях.

Перейдите в Настройки > Общие > Внешние запросы. Выберите Новый шаблон хоста. Добавьте доменные имена. Выберите Добавить. Таким образом можно детально управлять веб-сервисами, к которым могут подключаться ваши функции.

Настройте EdgeConnect

Если вы подключаетесь к самостоятельно размещённому экземпляру Jira, возможно, вам потребуется EdgeConnect для установления соединения за вашим межсетевым экраном.

  • Перейдите в Настройки > Общие > Внешние запросы > EdgeConnect.
  • Выберите Новый EdgeConnect.
  • Введите Имя соединения. Оно должно содержать только строчные буквенно-цифровые символы или дефис (-) (RFC 1123).
  • Введите Шаблоны хостов. Вводите по одному шаблону хоста на строку. Шаблон хоста должен быть допустимым IP-адресом, доменным именем или доменным именем с подстановочным знаком, где крайняя левая метка — *, за которой следуют как минимум две не подстановочные метки.
  • Выберите Создать.

Предоставьте разрешения Workflows

Некоторые разрешения требуются Workflows для выполнения действий от вашего имени. Чтобы точно настроить разрешения, предоставленные Workflows:

  • Перейдите в Workflows и выберите Настройки > Настройки авторизации.
  • Выберите следующие разрешения в дополнение к общему разрешению Workflows.
    • app-settings:objects:read

Подробнее об общих разрешениях пользователей Workflows см. в разделе Управление разрешениями Workflow.

Создайте соединение с Jira

  • Получите учётные данные для экземпляра Jira. Поддерживаются следующие методы аутентификации:
    • Базовая аутентификация: мы не рекомендуем использовать схему базовой аутентификации, но она может потребоваться для аутентификации старых версий Jira Server, которые не поддерживают personal access token.
    • Personal Access Token (PAT) (рекомендуется): это рекомендуемый метод для Jira Server. Чтобы узнать, какие версии Jira Server поддерживают personal access tokens и как их создавать, см. раздел «Using personal access tokens» в документации Atlassian Jira.
    • Jira API Token (Jira Cloud): при подключении к экземпляру Jira Cloud используйте токены Jira API. API-токены с ограниченной областью действия не поддерживаются.
  • В Ключ-АСТРОМ перейдите в Настройки и выберите Соединения.
  • Найдите Jira.
  • Выберите Соединение. Откроется диалоговое окно Создать новое соединение.
  • Введите Имя соединения. Укажите уникальное и легко идентифицируемое имя соединения для экземпляра Jira.
  • Введите URL Jira. Это URL-адрес сервера Jira.
  • Введите Тип. Это тип метода аутентификации, который следует использовать.
  • Введите Пользователь, который является именем пользователя или адресом электронной почты. Пользователь требуется только для базовой аутентификации и Jira API Token (Jira Cloud). Пользователь не нужен при использовании Personal Access Token (PAT).
  • Введите Токен для выбранного типа аутентификации.
  • Выберите Создать.

Дополнительные примечания

Для улучшения отслеживаемости и аудируемости используйте сервисного пользователя Jira для доступа к вашему экземпляру Jira. Чтобы добавить настройки соединения, вам требуются следующие разрешения:

ALLOW settings:objects:read, settings:objects:write, settings:schemas:read WHERE settings:schemaId = "app:astromkey.jira:connection"

Подробности см. в разделе «Разрешения и доступ».

Источник — https://doc.ruscomtech.ru/index.php?title=Настройка_коннектора_Jira&oldid=7121