Поделиться через

Локальный соединитель Microsoft Graph Confluence

  • Статья

Соединитель Confluence On-Premises Microsoft Graph позволяет вашей организации индексировать содержимое сервера Confluence или центра обработки данных. После настройки соединителя и индексов с сайта Confluence конечные пользователи смогут искать это содержимое в поиске (Майкрософт) и Microsoft 365 Copilot.

Эта статья предназначена для администраторов Microsoft 365, которые отвечают за настройку, запуск и мониторинг локального соединителя Microsoft Graph Confluence. Он дополняет общие инструкции по настройке соединителей Microsoft Graph в Центр администрирования Microsoft 365.

Преимущества

  • Расширенные возможности поиска: пользователи могут задавать вопросы на естественном языке о вики-содержимом в Copilot, например:
    • Сводные данные по архитектуре
    • Получение доступа к порталу
  • Поддержка семантического поиска. Пользователи могут выполнять запросы на естественном языке для получения точных ответов.
  • Совместимость. Поддерживает confluence версии выше 8.0.

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

  1. Установка GCA [агент соединителя Graph]. Убедитесь, что GCA установлена на компьютере Windows в той же сети, что и источник данных, к которому можно получить доступ через URL-адрес Confluence. Дополнительные сведения об агенте соединителя Microsoft Graph
  2. Установка подключаемого модуля. Скачайте и установите подключаемый модуль confluence on-prem из Atlassian Marketplace при настройке слияния. Получите подключаемый модуль из локального подключаемого модуля Microsoft Graph Connectors Confluence | Atlassian Marketplace
  3. Проверка подлинности. Убедитесь, что у вас есть учетные данные проверки подлинности с правильным доступом.

Начало работы

1. Отображаемое имя

Отображаемое имя используется для идентификации каждой ссылки в Copilot, помогая пользователям легко распознавать связанный файл или элемент. Отображаемое имя также означает доверенное содержимое. Отображаемое имя также используется в качестве фильтра источника содержимого. Для этого поля используется значение по умолчанию, но его можно настроить на имя, которое распознают пользователи в вашей организации.

2. Локальный URL-адрес confluence

Чтобы подключиться к локальным данным Confluence, вам потребуется URL-адрес экземпляра Confluence вашей организации. URL-адрес экземпляра Confluence вашей организации обычно выглядит как "https://contoso.atlassian.net".

3. Агент соединителя Graph (GCA)

Чтобы проиндексировать содержимое сервера Confluence или центра обработки данных, необходимо установить и зарегистрировать агент соединителя. Дополнительные сведения см. в статье Установка агента соединителя Microsoft Graph . Вы должны быть администратором клиента Microsoft 365 вашей организации и администратором сайта Confluence вашей организации.

Примечание.

GCA можно установить на другом компьютере Windows и не обязательно находиться на том же компьютере, что и локальный сервер. Компьютер может помочь создать идентификатор приложения и секрет, которые можно использовать для установки. Необходимо убедиться, что компьютер GCA включен во время обхода контента. Ответы на распространенные вопросы, связанные с GCA, можно найти в разделе часто задаваемых вопросов .

4. Установка локального подключаемого модуля Confluence

Убедитесь, что установлен подключаемый модуль Microsoft Graph Connectors Confluence On-prem. Вам не нужно устанавливать подключаемый модуль для каждого соединителя confluence; Если он уже установлен в экземпляре Confluence, этот шаг можно пропустить для последующих локальных подключений Confluence.

Примечание.

Подключаемый модуль поддерживается для confluence версии выше 8.0.

5. Тип проверки подлинности

Для проверки подлинности и синхронизации содержимого из Confluence On-prem выберите один из трех поддерживаемых методов:

А. Обычная проверка подлинности
Чтобы пройти проверку подлинности в экземпляре, введите имя пользователя и пароль учетной записи Confluence.

Б. OAuth1.0a
Создайте пару открытых и закрытых ключей и создайте ссылку на приложение на локальном сайте Confluence, чтобы агент соединителя смог получить доступ к экземпляру. Дополнительные сведения см. в шаге 1 в документации разработчика Atlassian по настройке OAuth 1.0a.

c. OAuth 2.0 (рекомендуется)
Ниже приведены инструкции по регистрации приложения Настройка входящей ссылки.

  1. Перейдите в раздел Администрирование > Общая конфигурация > Ссылки на приложения.
  2. Выберите Создать ссылку
  3. Выберите Внешнее приложение, а затем в качестве направления выберите Входящие.
  4. Заполните
  • URL-адрес перенаправления: https://gcs.office.com/v1.0/admin/oauth/callback
  • Область: Администратор или чтение
  1. Выполните шаг параметров подключения, используя идентификатор клиента и секрет.

6. Развертывание для ограниченной аудитории

Разверните это подключение в ограниченной базе пользователей, если вы хотите проверить его в Copilot и других поверхностях поиска, прежде чем развернуть развертывание для более широкой аудитории. Чтобы узнать больше об ограниченном выпуске, щелкните здесь.

На этом этапе вы можете создать подключение для ServiceNow Knowledge. Вы можете нажать кнопку "Создать", и соединитель Microsoft Graph начнет индексировать страницу из учетной записи Confluence.

Для других параметров, таких как разрешения доступа, правила включения данных, схема, частота обхода контента и т. д., мы устанавливаем значения по умолчанию в зависимости от того, что лучше всего подходит для данных Confluence. Значения по умолчанию:

пользователи;  
Разрешения доступа Только пользователи, имеющие доступ к содержимому в источнике данных.
Сопоставление удостоверений Удостоверения источников данных, сопоставленные с помощью идентификаторов Microsoft Entra.
Контент  
Включение и исключение пространства Все
Управление свойствами Чтобы проверка свойства по умолчанию и их схему, щелкните здесь.
Синхронизация  
Добавочный обход контента Частота: каждые 15 минут
Полный обход контента Частота: каждый день

Если вы хотите изменить любое из этих значений, необходимо выбрать Custom Setup параметр .

Настраиваемая настройка

Пользовательская настройка предназначена для администраторов, которые хотят изменить значения по умолчанию для параметров, перечисленных в таблице по умолчанию. Щелкнув этот параметр, вы увидите Custom Setup еще три вкладки: Пользователи, Содержимое и Синхронизация.

Пользователи

Разрешения доступа

Соединитель Confluence On-Premises Microsoft Graph поддерживает разрешения на поиск, видимые всем или только пользователям с доступом к этому источнику данных. При выборе параметра Все индексированные данные отображаются в результатах поиска для всех пользователей. Если выбран параметр Только пользователи с доступом к этому источнику данных, индексированные данные будут отображаться в результатах поиска для пользователей, имеющих доступ к ним. В локальной среде Confluence разрешения безопасности для пользователей и групп определяются с помощью разрешений на пространство и ограничений страниц. Соединитель Confluence On-Premises Microsoft Graph применяет действующие разрешения, предоставляемые API ограничений содержимого.

Если выбран параметр Только пользователи с доступом к этому источнику данных, необходимо дополнительно выбрать, есть ли на сайте Confluence Microsoft Entra ID подготовленных пользователей или пользователей, не являющихся пользователями AAD.

Чтобы определить, какой вариант подходит для вашей организации:

  1. Выберите параметр Microsoft Entra ID, если идентификатор электронной почты пользователей Confluence совпадает с именем пользователя UserPrincipalName (UPN) пользователей в Microsoft Entra ID.
  2. Выберите параметр, отличный от AAD, если идентификатор электронной почты пользователей Confluence отличается от userPrincipalName (UPN) пользователей в Microsoft Entra ID.

Важно!

  • Если вы выбрали Microsoft Entra ID в качестве типа источника удостоверений, соединитель сопоставляет идентификаторы электронной почты пользователей, полученные из Confluence, непосредственно со свойством имени участника-пользователя из Microsoft Entra ID.
  • Если для типа удостоверения выбран параметр "не AAD", инструкции по сопоставлению удостоверений см. в статье Сопоставление удостоверений, отличных от Azure AD. Этот параметр можно использовать для предоставления регулярного выражения для сопоставления от идентификатора электронной почты к имени участника-пользователя.
  • Обновления для пользователей или групп, управляющих разрешениями доступа, синхронизируются только при полном обходе контента. Добавочные обходы в настоящее время не поддерживают обработку обновлений разрешений.

Содержимое

Включение или исключение данных, которые требуется индексировать

На этом шаге можно добавить или удалить доступные свойства из источника данных Confluence. Microsoft 365 выбирает несколько свойств. По умолчанию соединитель будет индексировать все пробелы. Однако вы можете включить или исключить определенные пробелы с помощью параметра фильтра пространства.

Введите список пробелов, которые вы хотите включить или исключить, и вы увидите предварительный просмотр результатов. Введите пробел. Каждое пространство Confluence имеет пробел, который представляет собой короткий уникальный идентификатор, который является частью URL-адреса для этого пространства. Чтобы получить пробел, обратитесь к администратору confluence. Дополнительные сведения см. в разделе Пробелы.

Фильтр страницы

На этом шаге можно указать диапазон дат для индексирования документов. Ниже приведены параметры.

  • Дата последнего создания: дата создания документа. Индексируются только документы, измененные после этой даты.
  • Дата последнего изменения: дата изменения документа. Индексируются только документы, измененные после этой даты.

Важно!

  • Убедитесь, что даты находятся в хронологическом порядке. "Дата последнего создания" не должна быть позже "Дата последнего изменения".
  • Если даты не указаны, все документы будут рассматриваться для индексирования.

Управление свойствами

Здесь можно добавить или удалить доступные свойства из локального источника данных Confluence. Назначьте схему свойству (определите, доступно ли свойство для поиска, с возможностью запроса, с возможностью извлечения или уточнения). Кроме того, можно изменить семантические метки и добавить псевдоним в свойство . Свойства по умолчанию:

Свойство source Label Схема
Автор authors Запрос, извлечение
Содержимое Поиск
CreatedByName Автор Поиск, запрос, извлечение
CreatedOn Дата создания Запрос, извлечение
Id Запрос, извлечение
PageTree Восстанавливать
SpaceName Поиск, запрос, извлечение
Название title Поиск, извлечение
UpdatedByName lastModifiedBy Восстанавливать
UpdatedOn lastModifiedDateTime Запрос, извлечение, уточнение
URL-адрес url Восстанавливать

Предварительный просмотр данных

Используйте кнопку предварительного просмотра результатов, чтобы проверить выбранные свойства и фильтры.

Примечание.

Обратите внимание, что предварительная версия учитывает только фильтрацию на уровне пространства.

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

Интервал обновления определяет частоту синхронизации данных между источником данных и индексом соединителя Graph. Существует два типа интервалов обновления: полный обход контента и добавочный обход контента. Дополнительные сведения см. здесь. При необходимости можно изменить значения интервала обновления по умолчанию.

Проверка и проверка подключения

Если для поиска MS необходимо настроить страницу результатов поиска. Дополнительные сведения о настройке результатов поиска см. в разделе Настройка страницы результатов поиска.

Ограничения

  • Не индексирует блоги, файлы вложений или комментарии.
  • Индексирует только текущие страницы; архивные страницы исключаются.
  • CQL[Язык запросов Confluence] не поддерживается для локальной среды Confluence, однако мы поддерживаем фильтр на уровне пространства и страницы.

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

После публикации подключения можно просмотреть состояние на вкладке Источники данных в Центре администрирования. Сведения об обновлении и удалении см. в статье Управление соединителем. Инструкции по устранению распространенных проблем можно найти здесь.

Если у вас возникли проблемы или вы хотите отправить отзыв, обратитесь в Microsoft Graph | Поддержка.