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

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

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

Для настройки синхронизации экземпляра Jira Cloud с Lucid в режиме реального времени администратор учетной записи может выполнить следующие шаги в Lucid: 

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

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

1. Из выпадающего списка "Авторизация для" выбери свой экземпляр Jira для Lucidspark.
2. Нажмите «Принять».
   
3. Нажми Connect , чтобы пройти аутентификацию с помощью учетных данных твоего экземпляра 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 for Jira, например, « Lucidspark ».
   • Установите URL-адрес перенаправления на «https://lucid.app/jiradatacenter/oauth2/callback».
8. Установите права доступа для приложения, включив в них администратора.
9. Сохраните и скопируйте сгенерированные идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret).

Шаг 2: Настройте соединение в Lucid.

1. В Lucid выберите «Администрирование» в меню в левом нижнем углу главной страницы.
2. В меню слева выберите «Интеграция приложений».
3. В выпадающем меню выберите Lucidspark.
4. Найдите плитку «Карточки Lucid для Jira Data Center».
5. Нажмите «Настройки» на плитке (или «Установить», если вы еще не настраивали интеграцию).
6. Выберите «Добавить новый экземпляр» (или «Начать настройку», если вы еще не настраивали интеграцию).
7. Убедитесь, что URL-адрес перенаправления совпадает с тем, что вы настроили в Jira в разделе «Связь приложения».
8. Введите идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret) из 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)

Для ссылок на приложения 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 for Jira». В этом разделе подробно рассматривается использование учетных данных администратора, веб-хуки и их преимущества, а также способы защиты данных Jira.

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

Ресурсы

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

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

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

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