Соединитель Smartsheet для Jira: настройка и администрирование (в облаке и на локальном сервере)

Соединитель Smartsheet для Jira синхронизирует данные между Smartsheet и одним или несколькими экземплярами Jira. В этой статье приведены инструкции по настройке соединителя Smartsheet для Jira с помощью Jira Cloud и локального сервера Jira.

Предварительная информация

Соединитель Smartsheet для Jira — это премиальная функция.  Чтобы узнать о стоимости и приобретении услуг, свяжитесь с отделом продаж.

Чтобы настроить соединитель Smartsheet для Jira, необходимо быть администратором Jira. Кроме того, необходимо иметь одну из следующих ролей:

• в Smartsheet: системный администратор или администратор соединителя (эта роль существует на уровне учётной записи и доступна только для соединителя Smartsheet для Jira; подробнее см. в статье Типы разрешений соединителя Smartsheet для Jira);
• в Jira: системный администратор.

Ваша версия Jira должна отвечать следующим требованиям: 

• Jira Cloud или Jira версии 9 или более старой, если для неё не была прекращена поддержка. Статус вашей версии можно проверить, ознакомившись с Политикой прекращения поддержки Atlassian. 

Если вы хотите настроить соединитель для локального сервера Jira с межсетевым экраном, сначала обратитесь к статье Требования к межсетевому экрану для соединителя Jira.

Настройка соединения между Jira и Smartsheet

1. Выполните вход в соединитель Smartsheet для Jira по адресу https://connectors.smartsheet.com/c/jira. Если вам будет предложено разрешить доступ к своей учётной записи Smartsheet, выберите Разрешить.
2. Выберите меню в левом верхнем углу страницы, а затем выберите Администратор учётной записи.
3. Выберите Зарегистрировать новый сервер Jira.
4. Укажите URL-адрес нужного хоста Jira.
5. Подтвердите или измените название по умолчанию, выберите свою версию Jira, а затем выберите Продолжить.
6. Для версии Jira 9 и новее на локальном сервере для создания ссылки на приложение понадобится ключ клиента, имя клиента и публичный ключ.

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

Для установки безопасного соединения между сервисами соединитель Smartsheet для Jira предоставляет публичный ключ и ключ клиента. Скопируйте эти ключи; они понадобятся вам позже.

Чтобы создать подключение к Jira, используйте общую учётную запись электронной почты в Smartsheet и Jira (пример: smartsheet-jira@yourdomain.com). Изменить владельца подключения невозможно. При использовании общей учётной записи вам не придётся изменять подключения или рабочие процессы, если сотрудник, ответственный за работу с соединителем для Jira, покинет вашу организацию.

Создание ссылки на приложение

Чтобы установить соединение между Jira и Smartsheet, нужно создать и настроить ссылку между этими системами (в документации Jira она называется AppLink).

1. Войдите в Jira с разрешениями администратора Jira.
2. Перейдите в раздел Параметры Jira.
3. Выберите Продукты > Интеграции > Ссылки на приложения. В предыдущих версиях Jira на локальном сервере выберите     > Приложения > Ссылки на приложения.
   
   В Jira версии 9 и новее на локальном сервере выберите Создать ссылку, а затем опцию Продукт Atlassian.
   
   Она предназначена для создания ссылок на другие продукты Atlassian и внешние приложения, использующие технологию OAuth 1.0, такие как соединитель Smartsheet.
   
   
    
4. Укажите URL-адрес приложения, ссылку на которое требуется создать (https://app.smartsheet.com), а затем выберите Продолжить или Создать новую ссылку (в зависимости от версии Jira).
   Если появится одно из следующих сообщений, выберите Продолжить и оставьте новый URL-адрес без изменения. 
   • Не получен ответ от указанного URL-адреса. Возможно, он некорректен. Укажите корректный URL-адрес ниже, если это необходимо, и выберите "Продолжить".
     -ИЛИ-
   • Произошло перенаправление с указанного URL-адреса. Проверьте поле, содержащее URL-адрес, чтобы убедиться в его благонадёжности. 
5. В поле Название приложения укажите "Smartsheet". В поле Тип приложения оставьте значение по умолчанию (Универсальное приложение) и выберите Продолжить.
   

   
   Дополнительные действия для Jira версии 9 и новее на локальном сервере
   
   Проверьте значение поля Создать входящую ссылку и выберите Продолжить.
   
   Скопируйте ключ клиента, имя клиента и публичный ключ со страницы настройки соединителя Smartsheet. 

6. Выберите Продолжить.

Дальнейшие действия для Jira версии 8 и старше приведены ниже. Для Jira версии 9 и новее на локальном сервере перейдите к разделу Завершение настройки соединения с Jira версии 9 и новее.
 

Настройка ссылки на приложение для Jira версии 8 и старше (в облаке и на локальном сервере)

Используйте ключи, созданные при настройке соединения между Jira и Smartsheet. 

1. В Jira перейдите на страницу Настройка ссылок на приложения (выберите > Параметры > Приложения > Ссылки на приложения в меню).
2. Найдите ссылку на приложение Smartsheet, созданную ранее. Нажмите на значок Изменить . В предыдущих версиях Jira на локальном сервере выберите Параметры   > Приложения, а затем Ссылки на приложения.
3. В диалоговом окне Настройка выберите Входящая авторизация. Вставьте публичный ключ и ключ клиента в соответствующие поля. Ниже на странице найдите поле Публичный ключ.
4. Если Jira требует указать URL-адрес маркера запроса, URL-адрес маркера доступа или URL-адрес авторизации, используйте для этих полей следующий URL-адрес:https://api.smartsheet.com/2.0/token
5. Если нужно указать ключ клиента и общий секрет, используйте ключ клиента и публичный ключ, указанные в окне "Конфигурация" соединителя для Jira.
6. В нижней части диалогового окна выберите Сохранить > Закрыть. 

Дополнительная документация по созданию ссылок на приложения в Jira

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

• Использование AppLinks для создания ссылок на другие приложения;
• Документация по созданию ссылок на приложения.

Завершение настройки соединения с Jira версии 9 и новее

1. Вернитесь к настройке соединителя Smartsheet и выберите Продолжить.
2. На следующей странице выберите Соединить, чтобы завершить процесс подключения со стороны Smartsheet.
3. Последнее, что вам нужно будет сделать, — разрешить Smartsheet доступ к вашему приложению Jira. Для этого выберите Разрешить на следующем экране.

Соединение между Smartsheet и Jira настроено.