Confluence
Atlassian Confluence Server и Data Center. Откуда KnowledgeBase забирает документы.
Обходит дерево страниц пространства через REST API с персональным токеном. Страница и её вложения попадают в индекс одним документом: текст вложений дописывается в документ страницы. Изменилось вложение, и страница переиндексируется целиком.
Что умеет
Обход от домашней страницы пространства или от заданных поддеревьев
Вложения и картинки индексируются внутри страницы, а не отдельными документами
Версия страницы учитывает версии вложений, поэтому изменения не теряются
Путь страницы, пространство и ссылка передаются индексатору как сведения об источнике
При ошибке чтения страницы массового удаления из индекса не происходит
Несколько пространств подключаются отдельными экземплярами без правки кода
Параметры экземпляра · 7
- Адрес Confluence
cfl_urlобязательноБазовый URL сервера Confluence.
- Персональный токен
cfl_tokenобязательносекретPAT пользователя с правом чтения пространства. Храните в .secrets.toml.
- Ключ пространства
space_keyобязательноБез root_page_ids обход начинается с домашней страницы пространства.
- Корневые страницы
root_page_idsОграничивает обход заданными поддеревьями. Для одной страницы есть root_page_id.
- Индексировать страницы
index_pagesПри false в индекс попадают только вложения, отдельными документами.
- Проверять TLS
verify_connectionПроверка сертификата сервера.
- Тенант
tenant_idТенант в индексе. Через него EVA ограничивает доступ групп пользователей.
Пример настройки
[[default.plugins]]
role = "data_source"
type = "confluence"
instance_id = "confluence_docs"
tenant_id = "default"
cfl_url = "https://confluence.example.com/"
space_key = "DOCS"
index_pages = true
extractor_instance_id = "paleograph_default"
indexer_instance_id = "hippocampus_default"Как подключить
- Установите пакет коннектора в окружение KnowledgeBase и добавьте его в
plugin_packages. - Опишите экземпляр блоком
[[default.plugins]]с уникальнымinstance_id. - Секреты положите в
.secrets.tomlстрокой с тем жеinstance_idили передайте черезplugin_secrets. - Перезапустите KnowledgeBase и дождитесь первой синхронизации.
Как устроены роли и что должен реализовать коннектор: Контракт коннекторов. Все коннекторы: Маркетплейс.