Skip to main content
Коннектор Confluence индексирует страницы, которые видит его учётная запись коннектора. Он также индексирует комментарии к страницам, метки, последних редакторов, иерархию и вложения, если включена обработка вложений. После первой полной синхронизации Yahont по умолчанию проверяет обновления каждые 30 минут. Интервал обновления можно изменить в настройках коннектора.

Выбор развёртывания

Atlassian прекратила поддержку Confluence Server 15 февраля 2024 года. Yahont по-прежнему использует для Server путь интеграции Data Center, но Atlassian рекомендует перейти на Cloud или Data Center. См. уведомление Atlassian о прекращении поддержки Server.

Настройка коннектора в Yahont

Сначала выполните шаги аутентификации из руководства для вашего развёртывания. Затем откройте Панель администратора > Коннекторы, выберите Confluence и выполните следующие шаги.
1

Добавьте учётные данные

Нажмите Создать. Введите понятное название, учётную запись коннектора и токен из руководства для вашего развёртывания.
  • Cloud: введите адрес электронной почты аккаунта Atlassian и его API-токен.
  • Data Center или Server: введите имя пользователя владельца PAT и сам PAT. Yahont отправляет PAT как bearer-токен. Форма учётных данных Confluence
2

Задайте развёртывание и URL

Введите название коннектора и настройте поля развёртывания:
  • Is Cloud: включайте только для Confluence Cloud.
  • Wiki Base URL: для Cloud включите /wiki. Для Data Center или Server введите корень сайта или настроенный контекстный путь. Не добавляйте /rest/api.
  • Using scoped token: включайте только для API-токена Confluence Cloud, созданного с областями. Оставьте выключенным для Cloud-токена без областей и для Data Center или Server. Настройки коннектора Confluence Cloud
3

Выберите, что индексировать

Выберите одну область:Запрос CQL должен использовать type=page как единственный фильтр типа содержимого. Не добавляйте фильтр lastmodified. Yahont добавляет собственные временные фильтры при инкрементальной синхронизации. Фильтр в вашем запросе может с ними конфликтовать. Yahont по-прежнему получает комментарии и включённые вложения для возвращённых страниц. См. документацию CQL от Atlassian.
4

Выберите обработку вложений

Оставьте Include Attachments включённым, чтобы извлекать поддерживаемые документы-вложения из проиндексированных страниц. Анализ вложений-изображений также требует настройки извлечения и анализа изображений в Yahont. Отключите обработку вложений, если нужны только текст страниц и комментарии.
5

Выберите управление доступом

Выберите Advanced и выберите тип доступа:
  • Public делает каждый проиндексированный документ доступным каждому пользователю Yahont.
  • Private ограничивает каждый проиндексированный документ назначенными коннектору группами Yahont.
  • Sync Permissions воспроизводит права на пространства Confluence, ограничения страниц и унаследованные ограничения родительских страниц.
Синхронизация прав требует Yahont Enterprise Edition или Yahont Cloud. Она сопоставляет пользователей Confluence с пользователями Yahont по адресу электронной почты и синхронизирует группы Confluence. Прочитайте руководство для вашего развёртывания, прежде чем включать её.
6

Создайте и проверьте

Нажмите Create Connector. Коннектор проверяет учётные данные, читая хотя бы одно видимое пространство.Откройте страницу статуса коннектора и дождитесь завершения первой попытки индексации. Затем найдите в Yahont известную страницу. Откройте ссылку на источник результата и убедитесь, что она ведёт на нужную страницу Confluence.

Поведение синхронизации прав

Yahont применяет ближайшее ограничение чтения в таком порядке:
  • Ограничение страницы.
  • Ближайшая родительская страница с ограничением.
  • Права на пространство страницы.
Yahont сопоставляет пользователей по адресу электронной почты. Отсутствующий, скрытый, замаскированный или другой адрес электронной почты не позволяет сопоставить идентификатор Confluence с пользователем Yahont. Проверьте хотя бы одну страницу с каждым вариантом ограничений, который используется на вашем сайте.

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