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

Локальный соединитель 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 для обеспечения совместимости.

Ограничения

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

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

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

Важно!

Рекомендуется: глобальный администратор Confluence должен создать подключение
.Кто является глобальным администратором Confluence? Администратор Confluence — это пользователь, имеющий полные административные разрешения.

  • Чтобы проверка разрешения: перейдите в раздел Администрирование>Общая конфигурация>Глобальные разрешения.
  • Найдите группу Confluence-administrators, для которой включены все разрешения, включая " Может использовать", "Личное пространство", "Создать пространство", "Администратор Confluence" и "Системный администратор".
  • Любой пользователь, создающий маркер, должен быть членом этой группы.

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

Если вы хотите изменить любое из этих значений, необходимо выбрать 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. Существует два типа интервалов обновления: полный обход контента и добавочный обход контента. Дополнительные сведения см. здесь. При необходимости можно изменить значения интервала обновления по умолчанию.

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

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

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

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

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