Confluence

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

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

Страницы Confluence — целиком выбранные пространства, отдельные страницы (при необходимости с дочерними) или результат CQL-запроса.
Вложения к страницам и комментарии.
Не индексируются: черновики и содержимое, недоступное учётным данным.

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

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

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

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

Confluence Server / Data Center (self-hosted):

Войдите под учётной записью, от имени которой будет работать коннектор (достаточно прав на чтение нужных пространств).
В профиле пользователя откройте Personal Access Tokens («Личные токены доступа») и создайте токен без срока истечения или с ротацией по вашему регламенту.
В Charo заполните «Имя пользователя Confluence» (логин) и «Токен доступа Confluence».

Confluence Cloud:

Создайте API-токен на id.atlassian.com/manage-profile/security/api-tokens.
В Charo укажите почту учётной записи и токен.

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

Настройка в Charo

Поле	Что указать
Облачная версия	выключите для Server/Data Center; включите только для Cloud
Базовый URL	адрес вашего Confluence, например `https://wiki.company.ru` (для Cloud — `https://company.atlassian.net/wiki`)
Токен с ограниченной областью	только для scoped-токенов Cloud
Как индексировать ваш Confluence?	«Всё» — все доступные страницы; «Пространство» — по ключу пространства (например, `KB`); «Страница» — идентификатор страницы, при включённом «Индексировать рекурсивно» — с дочерними; «CQL-запрос» — произвольная выборка

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

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

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

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

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

«401 Unauthorized» при проверке

Неверная пара логин/токен, либо токен истёк. Для Server/DC используется персональный токен доступа; для Cloud — почта учётной записи + API-токен.

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

Учётная запись не видит часть пространств. Откройте Confluence под ней и проверьте доступ — коннектор не может прочитать больше, чем видит пользователь.

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

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

Ошибка при индексации отдельных страниц

Чаще всего — очень большие вложения или макросы с внешним содержимым; такие страницы пропускаются с записью в журнале коннектора.