Для администраторов: настройка карточек Lucid для Jira

Настройка экземпляра Jira Cloud для «живой» синхронизации

Для выполнения следующих шагов потребуются права администратора и в Jira, и в Lucidspark. Администратор, настраивающий эту интеграцию, должен иметь лицензию Lucidspark. Также рекомендуем использовать сервисный аккаунт Jira или аккаунт администратора Jira.

Чтобы настроить экземпляр Jira Cloud для «живой» синхронизации с Lucid, администратор учетной записи может выполнить следующие действия в Lucid: 

1. На главной странице Lucid нажмите Администрирование в левой нижней части навигационного меню.
2. Нажмите Интеграция приложений в меню слева. 
3. Из выпадающего списка выберите Lucidspark.
4. Найдите плитку «Карточки Lucid для Jira Cloud» и нажмите Настройки.
5. Выберите Добавить новый экземпляр.
   

Откроется страница «Настройки Jira Cloud», на которой нужно выполнить следующие действия:

1. В раскрывающемся списке «Authorize for» выберите свой экземпляр Jira для Lucidspark.
2. Нажми Принять.
   
3. Нажмите Подключить, чтобы пройти авторизацию с учетными данными своего экземпляра Jira.
4. Выбери Отправить.

Интеграция настроена для «живой» синхронизации. 

Включить экземпляр Jira Data Center

Выполните указанные ниже шаги, чтобы настроить экземпляр Jira Data Center. Мы рекомендуем использовать OAuth 2.0 для новых интеграций. Если ваша учетная запись ранее была подключена с помощью Application Links (OAuth 1.0), переключаться не нужно: существующее подключение продолжит работать. Если нужна поддержка OAuth 1.0, ознакомьтесь с этой публикацией в сообществе.

Хотя меню Jira, показанные в этом разделе, могут отличаться в зависимости от версии Jira Data Center, общий процесс настройки остается тем же.

Убедись, что твой экземпляр Jira доступен серверам Lucid

Убедись, что настроен публичный DNS, и разреши входящие запросы со статических IP-адресов, указанных ниже.

Если ты работаешь в среде FedRAMP, убедись, что разрешены входящие и исходящие запросы со статических IP-адресов, указанных ниже.

Привязка Lucidspark к Jira Data Center с помощью OAuth 2.0

Чтобы выполнить следующие действия, понадобятся права администратора как Jira, так и Lucidspark, а также лицензия Lucidspark.

Шаг 1. Создайте приложение OAuth 2.0 в Jira Data Center

В экземпляре Jira Data Center создайте входящую ссылку на приложение OAuth 2.0:

1. В Jira перейди в Настройки Jira.
2. Перейди в Приложения.
3. Выбери Ссылки на приложения.
4. Выбери Создать ссылку.
5. Выбери Внешнее приложение с направлением «Входящее».
6. Выберите Продолжить.
7. Укажи название приложения.
   • Выбранное название должно отражать функционал карточек Lucid для Jira, например Lucidspark.
   • Укажи в качестве URL перенаправления «https://lucid.app/jiradatacenter/oauth2/callback».
8. Установи разрешения приложения так, чтобы они включали ADMIN.
9. Сохрани и скопируй сгенерированные Client ID и Client Secret.

Шаг 2: Настройка подключения в Lucid

1. В Lucid выберите Администрирование в меню в левом нижнем углу главной страницы.
2. В меню слева выберите Интеграция приложений.
3. В раскрывающемся меню выберите Lucidspark.
4. Найдите плитку «Карточки Lucid для Jira Data Center».
5. Нажмите Настройки на плитке (или Установить, если интеграция еще не была настроена ранее).
6. Выберите Добавить экземпляр (или Начать настройку, если ранее не настраивали интеграцию).
7. Убедись, что URL-адрес перенаправления совпадает с тем, что настроено в Jira для ссылки на приложение.
8. Введите идентификатор и секретный ключ клиента из Jira.
9. Введи URL-адрес экземпляра Jira Data Center.
   • Это, например, может выглядеть примерно так: «https://jira.yourcompany.com».
   • Если обратный прокси-сервер настроен на перехват входящего трафика до того, как он поступит на ваш инстанс, можно указать URL этого обратного прокси-сервера. Этот обратный прокси-сервер должен разрешать входящий трафик с наших IP-адресов, перечисленных здесь.

Шаг 3: Авторизуй подключение

1. Нажмите «Включить», чтобы запустить процесс авторизации OAuth 2.0.

Для подтверждения доступа вы перейдете в свой экземпляр Jira Data Center. После подтверждения вы вернетесь обратно в Lucid. Теперь интеграция настроена для «живой» синхронизации.

После завершения настройки администратором конечные пользователи смогут пройти аутентификацию со своими учетными данными Jira, чтобы импортировать и создавать задачи Jira в Lucidspark. При первом подключении каждый пользователь будет перенаправлен на экран согласия Jira Data Center.

Для учетных записей, использующих авторизацию через SSO с Jira

Серверы Lucid должны иметь доступ к вашему экземпляру Jira Data Center. Если ваш экземпляр Jira Data Center защищен поставщиком услуг SSO, это может вызвать проблемы, поскольку SSO предназначен для аутентификации пользователей в браузере и зачастую не может быть пройден серверной службой, выполняющей вызовы API.

Решение этой проблемы зависит от конкретных настроек SSO и сети. Потребуется настроить SSO или сетевую инфраструктуру так, чтобы межсерверный трафик Lucid шел в обход перехвата SSO. К распространенным подходам относятся исключение на основе путей на уровне SSO или маршрутизация трафика Lucid полностью в обход SSO. 

Использование OAuth 1.0 с SSO

Для Application Links на базе OAuth 1.0 см. обходное решение Atlassian в этом посте в сообществе.

Настройка экземпляра Atlassian Government Cloud для «живой» синхронизации

Для выполнения следующих действий понадобятся права администратора как в Jira, так и в Lucidspark. Необходимо, чтобы у администратора, настраивающего эту интеграцию, была лицензия Lucidspark. Также рекомендуем использовать аккаунт администратора Jira.

Чтобы настроить экземпляр Atlassian Government Cloud для «живой» синхронизации с Lucid, администратор учетной записи может выполнить следующие шаги в Lucid: 

1. На главной странице Lucid нажмите Администрирование в левой нижней части навигационного меню.
2. Нажмите Интеграция приложений в меню слева. 
3. В раскрывающемся списке выберите Lucidspark.
4. Нажми Добавить новый экземпляр Atlassian Government Cloud.
5. Ознакомься с разрешениями и нажми Принять.

Интеграция настроена для «живой» синхронизации. 

Часто задаваемые вопросы

Зачем мне как администратору включать интеграцию с Jira Cloud или Atlassian Government Cloud, если это необязательно?
С января 2023 года Lucidspark использует вебхуки для синхронизации данных из Jira. Это обновление позволяет доскам получать обновления из Jira в режиме реального времени. Lucidspark сможет создавать вебхуки и управлять ими только после однократной аутентификации в ходе выполнения шагов по настройке интеграции из этой статьи. Если пользователь установит интеграцию индивидуально до выполнения этих шагов, интеграция будет работать, но карточки будут синхронизировать обновления из Jira примерно каждые 2 минуты вместо режима реального времени.

Что делать, если при попытке настроить интеграцию карточек Lucid в Jira Data Center появляется сообщение об ошибке?
Если при настройке интеграции с Jira Data Center возникает ошибка приложения, см. публикацию Советы по устранению распространенных ошибок при настройке карточек Lucid для Jira Data Center в сообществе.

Как работает эта интеграция и какие разрешения мне нужны?
Подробное описание того, как работает эта интеграция и какие разрешения вам потребуются в зависимости от наличия учетных данных пользователя или администратора Jira, см. в нашем ресурсе Технические часто задаваемые вопросы о карточках Lucid для Jira. В этом ресурсе подробно рассматривается использование учетных данных администратора, веб-хуки и их преимущества, а также способы защиты данных Jira.

Почему меня перенаправляет на lucid.app при попытке настроить интеграцию карточек Lucid для Jira со своим экземпляром Atlassian Government Cloud?
Чтобы избежать перенаправления на lucid.app, перед настройкой интеграции карточек Lucid для Jira потребуется использовать SSO для входа в свой экземпляр Atlassian Government Cloud.

Ресурсы

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

Посты в сообществе

Устранение неполадок Jira: не удается отредактировать поле в Lucid — сообщение об ошибке «Edit not supported»
Устранение неполадок Jira: добавление столбцов на разных языках в динамическую таблицу

Оставьте отзыв об этой статье