Jira

Подключение Jira Server/Data Center (и Cloud) к Charo — токен доступа, выбор проектов или JQL, синхронизация прав.

Что индексируется

Задачи Jira с комментариями и метаданными: автор, исполнитель, приоритет, статус, метки, сроки.
Область: все задачи, конкретный проект или произвольный JQL-запрос.

Коннектор работает и с Jira Server / Data Center в вашем контуре (типовой случай для российских компаний), и с Jira Cloud.

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

Jira Server / Data Center с REST API, доступная с сервера Charo, — либо Jira Cloud.
Учётная запись с доступом на чтение нужных проектов.

Получение учётных данных

Jira Server / Data Center (self-hosted):

Войдите под учётной записью, от имени которой будет работать коннектор.
В профиле пользователя откройте Personal Access Tokens («Личные токены доступа») и создайте токен.
В Charo укажите его в поле «API-токен или персональный токен доступа»; поле email для Server/DC можно не заполнять.

Jira Cloud:

Создайте API-токен на id.atlassian.com/manage-profile/security/api-tokens.
В Charo заполните «Email пользователя Jira (обязателен для Jira Cloud)» и токен.

Облачная Jira (*.atlassian.net) — внешний сервис: регистрация и оплата Atlassian Cloud из России ограничены, API может быть недоступен. Server / Data Center в вашем контуре этих ограничений не имеет.

Настройка в Charo

Поле	Что указать
Базовый URL Jira	адрес вашей Jira, например `https://jira.company.ru` (для Cloud — `https://company.atlassian.net`)
Токен с ограниченной областью	только для scoped-токенов Cloud
Как индексировать ваш Jira?	«Всё» — все доступные задачи; «Проект» — по ключу проекта; «JQL-запрос» — произвольная выборка
Чёрный список email для комментариев	комментарии этих авторов не индексируются (например, служебные боты)

Синхронизация прав

Поддерживается (в том числе для Server/Data Center): Charo переносит права проектов и задач — задачу найдёт только тот, кому она доступна в Jira. Требуется активная лицензия; подробнее — «Права доступа».

Ограничения и частота обновления

Обновления забираются инкрементально по расписанию коннектора.
Скорость ограничена лимитами API вашей Jira; большие инстансы индексируются постепенно. На Server/DC при необходимости поднимите лимиты запросов для сервисной учётной записи.

Устранение неполадок

«401 Unauthorized»

Для Server/DC — проверьте персональный токен доступа (не пароль!). Для Cloud нужна пара email + API-токен от одной учётной записи.

Ошибка соединения (Server/DC)

Базовый URL должен быть доступен с сервера Charo: проверьте DNS, межсетевой экран и сертификат TLS.

Проиндексировано меньше задач, чем ожидали

Учётная запись не видит часть проектов, либо JQL-запрос сужает выборку. Проверьте доступ под этой учётной записью в самой Jira.

Лишние комментарии ботов в ответах

Добавьте адреса ботов в «Чёрный список email для комментариев».