Создание тикетов для неудачных проверок осанки

Предпосылки

• Пользователь с Обзором пространств и Созданием рабочих объектов разрешениями

Шаг 1: Настройка обязательных параметров в Jira

Чтобы настроить параметры в Jira:

1. В вашей учетной записи Atlassian нажмите на ваш профиль в правом верхнем углу и затем нажмите Настройки учетной записи.

2. На вкладке Безопасность в разделе API tokens, нажмите Создать и управлять токенами API.

3. Вы можете создать токен API с областями или без них:

   1. Чтобы создать токен API с областями:

      1. Нажмите Создать токен API с областями.

      2. Добавьте Имя и дату истечения.
         Примечание: Мы рекомендуем выбрать максимальную дату истечения срока длительностью 365 дней.

      3. Нажмите Далее и выберите приложение Jira

      4. Нажмите Далее и выберите область write:jira-work

      5. Нажмите Создать.

   2. Чтобы создать токен API без областей:

      1. Нажмите Создать токен API.

      2. Добавьте Имя и дату истечения.
         Примечание: Мы рекомендуем выбрать максимальную дату истечения срока длительностью 365 дней.

      3. Нажмите Создать.

4. Скопируйте и сохраните токен, чтобы его можно было ввести в CMA.

5. В вашей учетной записи Atlassian на боковой панели нажмите три точки рядом с Пространства.

6. Нажмите Управление пространствами.

7. Скопируйте и сохраните Ключ пространства, в котором вы хотите создать тикеты, чтобы он мог быть введен в CMA.

8. Если вы создали токен с областями, в веб-браузере введите https://<your-site>.atlassian.net/_edge/tenant_info и скопируйте значение cloudId, чтобы оно могло быть введено в CMA.
   Если вы не создали токен с областью, этот шаг не требуется.

Шаг 2: Настройка Webhook в CMA

Для настройки вебхука в CMA:

1. В CMA, перейдите в Учетная запись > Подписки.

2. На вкладке Webhooks, нажмите Новый.

3. Добавьте Имя.

4. Из выпадающего меню Начать с шаблона, выберите Jira Create Posture Check Ticket.

5. В поле URL:

   1. Для токена API с областями: https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue, где <cloudId> — это скопированное вами значение cloudId на Шаге 1.

   2. Для API-токена без сфер применения: https://<ваш-сайт>.atlassian.net/rest/api/2/issue, где <ваш-сайт> - это имя вашего сайта Jira.

6. Добавьте Имя пользователя пользователя, который создал API-токен на шаге 1.

7. В поле Пароль введите API-ключ, созданный на шаге 1.

8. В разделе Пользовательское Тело замените <YOUR-SPACE-KEY> на ключ пространства, который вы скопировали на шаге 1.

9. (Опционально) Если ваше пространство не использует тип работы Задача или требует дополнительных полей для новых рабочих элементов, отредактируйте тело соответствующим образом.

10. Нажмите Тест.
    В пространстве Jira создается тестовый рабочий элемент, и отображается сообщение "Тест успешно пройден". После этого вы можете удалить тестовый рабочий элемент.

11. Нажмите Сохранить.

Необходимые условия

• Пользователь с ролью itil роль

Шаг 1: Настройка обязательных параметров в ServiceNow

Чтобы настроить параметры в ServiceNow:

1. Войдите в свою учетную запись ServiceNow как администратор и перейдите в Администрирование пользователей > Пользователи.

2. Нажмите Новый.

3. Введите Идентификатор пользователя и адрес электронной почты и выберите Доступ только к веб-сервисам.

4. Кликните Отправить.

5. Откройте запись пользователя, которую вы создали:

   1. Нажмите Установить пароль, затем Сгенерировать пароль. Скопируйте и сохраните пароль, чтобы его можно было ввести в CMA.

   2. Нажмите Сохранить пароль.  

   3. На вкладке Роли нажмите Редактировать и добавьте роль itil

   4. Нажмите Сохранить

Шаг 2: Настройка вебхука в CMA

Чтобы настроить вебхук в CMA:

1. В CMA перейдите в Учетная запись > Подписки.

2. На вкладке Webhooks нажмите Новый.

3. Добавить Имя.

4. Из выпадающего меню Начать с шаблона выберите ServiceNow Create Posture Check Ticket.

5. В поле URL замените <YOUR-INSTANCE-NAME> на имя вашего экземпляра ServiceNow, чтобы URL был https://<instance>.service-now.com/api/now/table/incident.

   Ваше имя экземпляра является первой частью вашего URL ServiceNow. Например, если вы входите в https://acme.service-now.com, имя экземпляра — acme, а URL — https://acme.service-now.com/api/now/table/incident.

6. В поле Имя пользователя введите идентификатор пользователя ServiceNow, созданного на Шаге 1.

7. В поле Пароль введите пароль пользователя ServiceNow, созданного на Шаге 1.

8. (Опционально) В разделе Пользовательское тело измените приоритет по умолчанию, срочность и воздействие инцидентов или добавьте поля, такие как assignment_group.

9. Нажмите Тест.
   Тестовый инцидент создан в ServiceNow, и сообщение «Тест успешно пройден» показано. Вы можете разрешить или закрыть тестовый рабочий элемент позже.

10. Нажмите Сохранить.

Если создание тикета не удается, сообщение об ошибке показывает статус, возвращенный системой тикетов:

• 401 (Unauthorized): Учетные данные неверны или срок действия токена истек. Проверьте поля Имя пользователя и Пароль webhook, затем нажмите Тест. Для Jira используйте адрес электронной почты пользователя и токен API. Если срок действия токена истек, создайте новый токен и обновите поле Пароль webhook.

• 403 (Forbidden): У пользователя нет необходимых разрешений. Для Jira убедитесь, что у пользователя есть разрешения Обзор пространств и Создание рабочих элементов в соответствующем пространстве. Для ServiceNow убедитесь, что у пользователя есть роль itil.

• 400 (Bad Request): Система тикетов отклонила тело запроса. Проверьте на наличие неверного ключа пространства или отсутствующего обязательного поля в Пользовательском теле.

• ID тикета отсутствует: Тикет был создан, но Cato не смог прочитать его ID из ответа. Убедитесь, что сопоставление ответа webhook соответствует шаблону.