Jira

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

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

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

Коннектор работает с Jira Server / Data Center, развёрнутой в вашем контуре. Облачная Jira не поддерживается.

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

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

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

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

Коннектор авторизуется персональным токеном доступа. Пары «логин + пароль» и API-токенов Atlassian он не принимает.

Настройка в Charo

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

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

Поддерживается: Charo наследует права Jira — задачу найдёт только тот, кому она доступна в самой Jira. Вместе с правами переносится состав групп Jira, поэтому доступ, выданный группе, работает без перечисления людей.

Права в Jira плоские: у задачи нет собственных ограничений, её читатели — это читатели её проекта. Если проект открыт всем лицензированным пользователям, его задачи в Charo тоже будут доступны всем.

Права пересинхронизируются примерно раз в пять минут — изменения в Jira подхватываются с этой задержкой, а не мгновенно.

Ограничение по числу групп. Jira 8.20 отдаёт список групп одной страницей, без постраничной выдачи. Charo запрашивает до 10 000 групп и, если инсталляция вернула усечённый список, полностью отменяет синхронизацию прав — иначе синхронизация массово отозвала бы доступы у групп, не попавших в ответ.

Требуется активная лицензия; подробнее — «Права доступа».

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

Задачи, у которых описание вместе с комментариями превышает 100 КиБ текста, пропускаются целиком и попадают в отчёт об ошибках индексации.
Задачи забираются порциями по 50.
Обновления забираются инкрементально по расписанию коннектора.
Скорость ограничена лимитами API вашей Jira; большие инсталляции индексируются постепенно. При необходимости поднимите лимиты запросов для сервисной учётной записи.

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

Ошибка авторизации (HTTP 401)

Проверьте персональный токен доступа — коннектор ожидает именно его, а не пароль учётной записи.

Ошибка на проверке JQL-запроса

При сохранении коннектора Charo выполняет ваш JQL-запрос с лимитом в одну задачу. Синтаксическая ошибка или обращение к недоступному полю выявляются сразу — проверьте запрос в самой Jira.

Ошибка соединения

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

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

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

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

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