Администрирование и настройка соединителя Smartsheet для Jira

Соединитель Smartsheet для Jira синхронизирует данные между Smartsheet и одним или несколькими экземплярами Jira путём создания рабочих процессов.

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

Если в рамках вашего плана приобретён соединитель Smartsheet для Jira, выполните вход для создания рабочих процессов между Smartsheet и Jira.

Войти в соединитель Smartsheet для Jira

Терминология и типы разрешений

• Соединение — это связь между Smartsheet и конкретным экземпляром Jira.
• Рабочий процесс — это механизм, который связывает элементы Jira с таблицей Smartsheet.

Пользователи могут иметь три различных разрешения для взаимодействия с соединителем Smartsheet для Jira:

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

Возможности разных типов пользователей

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

 * Если список ограничения доступа включён, системные администраторы Smartsheet и администраторы соединителя могут создавать и изменять свои рабочие процессы. Если ваш системный администратор активирует настройку Restrict Users (Ограничить пользователей) в соединителе для Jira, у вас также должна быть роль "Пользователь Jira" в Smartsheet. Подробнее об ограничении доступа.

Настройка соединения

Сначала необходимо настроить соединение между Smartsheet и экземпляром Jira, чтобы пользователи могли создавать рабочие процессы для связывания элементов в Smartsheet и Jira. Соединитель Smartsheet для Jira совместим с Jira Cloud и Jira Data Center версий 6.x–10.x.

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

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

Для настройки соединения между Smartsheet и Jira необходимы следующие разрешения:

В Jira:

• Системный администратор Jira (администратор продукта или организации)

В Smartsheet:

• Лицензированный пользователь Smartsheet (устаревшая модель) или участник (пользовательская модель)
• Роль системного администратора Smartsheet или администратора соединителя Smartsheet для Jira

Для настройки соединителя требуется только роль системного администратора Smartsheet или роль администратора соединителя Jira, однако рекомендуется иметь обе роли.

Поскольку соединитель Smartsheet для Jira поддерживает автоматические рабочие процессы, приложение должно иметь учётные данные системного администратора Jira, чтобы создать или настроить веб-перехватчик через REST API Jira. Учётные данные системного администратора Jira используются только для создания и настройки веб-перехватчиков.

Учётная запись, используемая для настройки, должна оставаться активной и иметь права администратора как в Jira, так и в Smartsheet. Если этот пользователь потеряет статус администратора, возникнет ошибка: "Missing user credentials for this endpoint" (Отсутствуют учётные данные пользователя для этой конечной точки). Если вернуть права администратора, соединение восстановится, а синхронизация рабочих процессов будет возобновлена. Если учётные данные администратора Jira будут удалены, потребуется заново создать ссылку на приложение в связи с изменением токена.

Шаги по настройке

Шаги по установке соединения зависят от типа развёртывания Jira и версии OAuth, которую вы используете. Следуйте процедуре, которая соответствует вашим условиям.

Для настройки соединения необходимы разрешения администратора Jira.

Вы можете создать до трёх подключений к одному экземпляру Jira Cloud, используя OAuth 2.0.

Jira Cloud OAuth 1.0, OAuth 2.0 или Jira Data Center OAuth 1.0

Шаг 1. Регистрация нового сервера Jira в соединителе Smartsheet для Jira

Задайте параметры межсетевого экрана, а также его конфигурацию перед установкой этого подключения.

1. Выполните вход в соединитель Smartsheet для Jira. Если вам будет предложено разрешить доступ к своей учётной записи Smartsheet, выберите Allow (Разрешить).
2. Выберите меню в левом верхнем углу страницы, а затем — Account Admin (Администратор учётной записи).
3. Выберите Register New Jira Server (Зарегистрировать новый сервер Jira).
4. На странице Settings (Параметры):
   1. Введите URL-адрес JIRA Host (хост JIRA) для среды Jira, которую хотите подключить к среде Smartsheet (https://mbfcorp.atlassian.net/). 
   2. JIRA API URL (URL-адрес API JIRA), скорее всего, совпадает с вашим адресом JIRA Host (хост JIRA). 
   3. В поле Name (Имя) оставьте имя по умолчанию или измените его на более понятное. 
   4. Выберите версию JIRA: Jira Server 7 или Cloud для облачных экземпляров Jira.

Brandfolder Image

5. После выполнения этих пунктов на странице Settings (Параметры) нажмите Continue (Продолжить).
6. На странице Configuration (Конфигурация) будут указаны значения Consumer Key (Потребительский ключ), Consumer Name (Потребительское имя) и Public Key (Публичный ключ). Скопируйте их: они понадобятся в следующих шагах.
7. Выберите Continue (Продолжить), чтобы перейти на следующую страницу.

Шаг 2. Создание ссылки (AppLink) на приложение Smartsheet в Jira

Если вы используете OAuth 2.0, пропустите этот шаг.

1. Войдите в Jira (необходимы разрешения администратора Jira).

2. Откройте в Jira раздел Settings (Параметры) > Products (Продукты).
    

   Brandfolder Image

   

3. На боковой панели Products (Продукты) в разделе Integrations (Интеграции) выберите Application links (Ссылки на приложения).

   В предыдущих версиях Jira на локальном сервере выберите Settings (Параметры) > Applications (Приложения) и выберите Application links (Ссылки на приложения).

   Brandfolder Image

   
4. Нажмите Create link (Создать ссылку). Откроется окно Create link (Создание ссылки). Заполните поля следующим образом:

   • Для Jira Cloud выберите Direct application link (Прямая ссылка на приложение) и введите https://app.smartsheet.com в качестве URL-адреса приложения. Затем нажмите Next (Далее).

     Brandfolder Image

     

   • Для локальных версий Jira 9 и выше выберите Atlassian product (Продукт Atlassian) и введите https://app.smartsheet.com для URL-адреса приложения. Затем выберите Continue (Продолжить).

     Brandfolder Image

     
5. Если появится одно из следующих сообщений, выберите Continue (Продолжить) и оставьте новый URL-адрес без изменений.
   • Если вы не получили ответ от введённого URL-адреса, он может быть недействительным. При необходимости исправьте URL-адрес ниже и нажмите Continue (Продолжить).
   • Произошло перенаправление с указанного URL-адреса. Проверьте поле, содержащее URL-адрес, чтобы убедиться в его благонадёжности.
6. Откроется окно Review link (Проверить ссылку) или Link applications (Связать приложения). Заполните поля следующим образом:
   • В поле Application Name (Название приложения) укажите Smartsheet.
   • В поле Application Type (Тип приложения) оставьте значение по умолчанию Generic Application (Универсальное приложение).
   • Для локальных версий Jira 9 и выше установите флажок Create incoming link (Создать входящую ссылку).

   • Нажмите Continue (Продолжить).

     Brandfolder Image

     

Шаг 3. Редактирование ссылки на приложение

Если вы используете OAuth 2.0, пропустите этот шаг.

1. Для ссылки на приложение, созданной в шаге 2, нажмите меню с тремя точками, которое появляется при наведении курсора на ссылку, или значок Edit (Редактирование) (зависит от версии). 

2. Откроется окно Configure (Настроить). Выберите Incoming Authentication (Входящая аутентификация).
    

   Brandfolder Image

   
3. Заполните поля следующим образом: 
   • Service Provider Name (Имя поставщика услуг) (при необходимости): Smartsheet
   • Consumer Name (Потребительское имя): вставьте значение Consumer Name (Потребительское имя), скопированное из соединителя Jira в шаге 1.
   • Consumer Key (Потребительский ключ): вставьте значение Consumer Key (Потребительский ключ), скопированное из соединителя Jira в шаге 1.
   • Public Key/Shared Secret (Публичный ключ / общий секретный ключ): вставьте значение Public Key (Публичный ключ), скопированное из соединителя Jira в шаге 1.
   • Description (Описание): добавьте описание по желанию.
   • Если параметры Request Token URL (URL-адрес маркера запроса), Access Token URL (URL-адрес маркера доступа) или Authorize URL (URL-адрес разрешения) требуются в вашей среде Jira, используйте для этих полей следующий URL-адрес: https://api.smartsheet.com/2.0/token.
4. В нижней части окна Incoming Authentication (Входящая аутентификация) нажмите Save (Сохранить), а затем Close (Закрыть) в правом нижнем углу.

Шаг 4: Завершение подключения Smartsheet к Jira

1. Перейдите к конфигурации соединителя Smartsheet для Jira.
2. На экране Connect (Соединение) выберите Connect (Соединить), чтобы завершить процесс подключения со стороны Smartsheet.

Появится диалоговое окно с запросом разрешить приложению Smartsheet чтение и запись данных в среде Jira. 

3. Если вы используете OAuth 2.0, выберите хост в раскрывающемся списке Use app on (Использование приложения). Если нет, переходите к следующему шагу. 

Brandfolder Image

4. Выберите Allow (Разрешить). 

Соединение между Smartsheet и Jira успешно настроено. Теперь лицензированные пользователи или участники вашей учётной записи могут создавать рабочие процессы между элементами Jira и таблицами Smartsheet. 

С помощью соединителя Smartsheet для Jira можно подключить несколько сред Jira к учётной записи Smartsheet. Повторите описанные выше шаги для каждого экземпляра Jira, который нужно зарегистрировать. 

Jira Data Center OAuth 2.0

Шаг 1. Создание ссылки (AppLink) на приложение Smartsheet в Jira

1. Войдите в систему Jira.
2. Откройте в Jira раздел Settings > Applications (Параметры > Приложения).
3. На боковой панели Applications (Приложения) в разделе Integrations (Интеграции) выберите Application links (Ссылки на приложения).

Если пункт Applications (Приложения) не отображается в разделе Settings (Параметры), перейдите в раздел Products (Продукты) и на боковой панели Products (Продукты) найдите Application Links (Ссылки на приложения) в разделе Integrations (Интеграции).

4. Выберите Create link (Создать ссылку). Откроется окно Create link (Создание ссылки). Заполните поля следующим образом:
   • Выберите External Application (Внешнее приложение) для параметра Application Type (Тип приложения).
   • Выберите Incoming (Входящее) для параметра Direction (Направление).
   • Нажмите Continue (Продолжить).

Brandfolder Image

5. Настройте входящую ссылку. Заполните поля следующим образом:
   1. Для параметра Name (Имя) задайте понятное описание.
   2. Redirect URL (URL-адрес перенаправления): {smartsheet-connector-host}/c/jira/signInCallback}. Обратите внимание: хост соединителя для Smartsheet отличается у разных регионов:

      • США: https://connectors.smartsheet.com

      • Австралия: https://connectors.smartsheet.au

      • ЕС: https://connectors.smartsheet.eu
   3. Для параметра Application Permission, (Разрешение приложения) выберите System Admin (Системный администратор).
6. Нажмите Save (Сохранить).

После выполнения этих действий вы получите значения Client ID (Идентификатор клиента) и Client Secret (Секретный ключ клиента). Скопируйте их оба перед выполнением следующих шагов.

Шаг 2. Регистрация нового сервера Jira в соединителе Smartsheet для Jira, настройка параметров межсетевого экрана

1. Выполните вход в соединитель Smartsheet для Jira. Если вам будет предложено разрешить доступ к своей учётной записи Smartsheet, выберите Allow (Разрешить).
2. Выберите меню в левом верхнем углу страницы, а затем — Account Admin (Администратор учётной записи).
3. Выберите Register New Jira Server (Зарегистрировать новый сервер Jira).
4. На странице Settings (Параметры):
   1. Введите URL-адрес хоста JIRA для среды Jira, которую хотите подключить к среде Smartsheet (https://mbfcorp.atlassian.net/).
   2. URL-адрес API JIRA, скорее всего, совпадает с адресом вашего хоста JIRA.
   3. В поле Name (Имя) оставьте имя по умолчанию или измените его на более понятное.
   4. Выберите версию JIRA.
5. После выполнения этих пунктов на странице Settings (Параметры) нажмите Continue (Продолжить).
6. На странице Configuration (Конфигурация) вы увидите параметры Client ID (Идентификатор клиента) и Client Secret (Секретный ключ клиента). Вставьте значения, полученные в шаге 1.

Шаг 3: Завершение подключения Smartsheet к Jira

1. После ввода значений Client ID (Идентификатор клиента) и Client Secret (Секретный ключ клиента) нажмите Continue (Продолжить).
2. На экране Connect (Соединение) выберите Connect (Соединить), чтобы завершить процесс подключения со стороны Smartsheet.

Появится диалоговое окно с запросом разрешить приложению Smartsheet чтение и запись данных в среде Jira. Выберите Allow (Разрешить).

Соединение между Smartsheet и Jira успешно настроено. Теперь лицензированные пользователи или участники вашей учётной записи могут создавать рабочие процессы между элементами Jira и таблицами Smartsheet.

Ограничение доступа к соединителю Smartsheet для Jira

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

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

Ограничение доступа

Системный администратор Smartsheet или администратор Jira может включить параметр Restrict Access (Ограничить доступ), чтобы ограничить круг пользователей, которые могут создавать рабочие процессы с помощью соединителя для Jira.

1. Войдите в соединитель Smartsheet для Jira, используя свои учётные данные Smartsheet.
2. В левом верхнем углу страницы нажмите значок меню и выберите пункт User Management (Управление пользователями).

3. Установите флажок Restrict which users can access the Smartsheet JIRA Integration (Ограничить круг пользователей с доступом к интеграции Smartsheet для JIRA). 

   Brandfolder Image

   
4. Добавьте в список адреса тех, кому нужно разрешить доступ к соединителю.

Отзыв доступа

После удаления из списка пользователь больше не сможет создавать рабочие процессы или изменять их.

1. Войдите в соединитель Smartsheet для Jira, используя свои учётные данные Smartsheet.
2. Откройте раздел User Management (Управление пользователями).
3. Выберите значок Delete (Удалить) справа от информации об учётной записи этого пользователя.