Skip to content
2.12.0

Confluence ​

Коннектор KnowledgeBase. Карточка собрана из описания в каталоге коннекторов.
ГотовИсточник данныхtype: confluenceeap-connector-confluenceверсия 1.2.0

Atlassian Confluence Server и Data Center. Откуда KnowledgeBase забирает документы.

Обходит дерево страниц пространства через REST API с персональным токеном. Страница и её вложения попадают в индекс одним документом: текст вложений дописывается в документ страницы. Изменилось вложение, и страница переиндексируется целиком.

Что умеет

  • Обход от домашней страницы пространства или от заданных поддеревьев

  • Вложения и картинки индексируются внутри страницы, а не отдельными документами

  • Версия страницы учитывает версии вложений, поэтому изменения не теряются

  • Путь страницы, пространство и ссылка передаются индексатору как сведения об источнике

  • При ошибке чтения страницы массового удаления из индекса не происходит

  • Несколько пространств подключаются отдельными экземплярами без правки кода

Параметры экземпляра · 7

  • Адрес Confluencecfl_urlобязательно

    Базовый URL сервера Confluence.

  • Персональный токенcfl_tokenобязательносекрет

    PAT пользователя с правом чтения пространства. Храните в .secrets.toml.

  • Ключ пространстваspace_keyобязательно

    Без root_page_ids обход начинается с домашней страницы пространства.

  • Корневые страницыroot_page_ids

    Ограничивает обход заданными поддеревьями. Для одной страницы есть root_page_id.

  • Индексировать страницыindex_pages

    При false в индекс попадают только вложения, отдельными документами.

  • Проверять TLSverify_connection

    Проверка сертификата сервера.

  • Тенантtenant_id

    Тенант в индексе. Через него EVA ограничивает доступ групп пользователей.

Пример настройки

toml
[[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"

Как подключить ​

  1. Установите пакет коннектора в окружение KnowledgeBase и добавьте его в plugin_packages.
  2. Опишите экземпляр блоком [[default.plugins]] с уникальным instance_id.
  3. Секреты положите в .secrets.toml строкой с тем же instance_id или передайте через plugin_secrets.
  4. Перезапустите KnowledgeBase и дождитесь первой синхронизации.

Как устроены роли и что должен реализовать коннектор: Контракт коннекторов. Все коннекторы: Маркетплейс.

Документация экосистемы EVA 2.1