Настройка коннектора 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"

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