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

Соединитель Microsoft Graph Confluence Cloud

  • Статья

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

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

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

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

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

  1. Вы должны быть администратором клиента Microsoft 365 вашей организации и администратором сайта Confluence вашей организации.
  2. Проверка подлинности. Убедитесь, что у вас есть учетные данные проверки подлинности с правильным доступом.

Ограничения

  • Не индексировать файлы вложений или комментарии.

Важно!

  • Atlassian не рекомендует набор облачных API Confluence (версия 1) и выпускает новые API (версия 2). Вы можете прочитать об их объявлениях здесь или здесь. Некоторые из этих устаревших API версии 1 используются соединителем только для подключений OAuth . Таким образом, после этого изменения существующие подключения Confluence могут перестать работать. Это изменение запланировано на 24 января.
  • Изменение перехода на новые API версии 2 было выпущено для всех клиентов в декабре 2023 г. После этого выпуска существующие подключения должны пройти повторную проверку подлинности. Новые API версии 2 также требуют некоторых дополнительных областей (по сравнению с предыдущими API версии 1), которые необходимо предоставить во время повторной проверки подлинности. Новый набор обязательных областей (полный список) — read:group:confluence, read:user:confluence, read:content-details:confluence, Read:space:confluence, Read:permission:confluence, read:audit-log:confluenceи read:content.metadata:confluenceread:page:confluence.

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

В этом видео содержится пошаговое руководство по добавлению соединителя Microsoft Graph Confluence Cloud.

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

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

2. URL-адрес облака Confluence

Чтобы подключиться к сайту Confluence, используйте URL-адрес сайта. URL-адрес облачного сайта Confluence обычно выглядит как https://< organization_name.atlassian.net/>.

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

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

Совет

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

А. Обычная проверка подлинности
Чтобы пройти проверку подлинности с помощью базовой проверки подлинности, введите имя пользователя (обычно адрес электронной почты) и маркер API. Инструкции по созданию маркера API см. в руководстве Atlassian.

Б. OAuth 2.0 (рекомендуется)
Зарегистрируйте приложение в Confluence Cloud, чтобы приложение Поиска (Майкрософт) и Microsoft 365 Copilot могли получить доступ к экземпляру. Дополнительные сведения см. в документации по поддержке Atlassian о том, как включить OAuth 2.0.

Ниже приведены инструкции по регистрации приложения.

  1. Войдите в консоль разработчика Atlassian с учетной записью администратора Atlassian Confluence.

  2. Щелкните Создать и выберите OAuth 2.0 integration.

  3. Укажите соответствующее имя приложения и создайте новое приложение.

  4. Перейдите к Permissions из области навигации слева. Нажмите кнопку Добавить для Confluence API. После добавления щелкните Настроить и Изменить области и выберите следующие области.

    Имя области Code Описание
    Просмотр сведений о содержимом read:content-details:confluence Обход контента, удовлетворяющего критериям.
    Просмотр групп read:group:confluence Доступ к разрешениям группы содержимого.
    Просмотр сведений о пользователе read:user:confluence Для доступа к отдельным сведениям о пользователе для поддержки разрешений.

  5. Нажмите кнопку Сохранить.

  6. Перейдите к Authorization из области навигации слева. Добавьте URL-адрес обратного вызова для Microsoft 365 корпоративный: https://gcs.office.com/v1.0/admin/oauth/callback, для Microsoft 365 для государственных организаций: https://gcsgcc.office.com/v1.0/admin/oauth/callback и сохраните изменения.

  7. Перейдите в раздел Параметры в области навигации слева. На этой странице вы получите идентификатор клиента и секрет .

    Выполните шаг параметров подключения, используя идентификатор клиента и секрет.

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

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

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

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

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

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

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

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

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

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

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

Если ограничений страниц нет, соединитель проверяет разрешения на уровне пространства.

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

Важно!

Разрешения управляются только на уровне пространства и страницы, а разрешения родительской страницы не учитываются.

Если выбран параметр Только пользователи с доступом к этому источнику данных, необходимо дополнительно выбрать, есть ли на сайте 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 (CQL) можно указать условия для синхронизации страниц. Это похоже на предложение Where в инструкции SQL Select . Например, можно проиндексировать только те страницы, которые были изменены за последние два года. Сведения о создании собственной строки запроса см. в статье Расширенный поиск с помощью CQL. По умолчанию соединитель индексирует все блоги и страницы.

Совет

Вы можете использовать фильтр CQL для индексирования содержимого, измененного после определенного времени с помощью метода lastModified >= "12/2018/31"

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

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

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

Свойство Source Метка Описание
авторов authors Имя пользователей, которые участвовали в работе над элементом в источнике данных или совместно работали над элементом.
CreatedByName createdBy Имя пользователя, который последним изменил элемент в источнике данных.
CreatedOn createdDateTime Дата и время создания элемента в источнике данных.
IconUrl iconUrl URL-адрес связанного значка элемента.
Название title Заголовок элемента, который должен отображаться в поиске и других интерфейсах.
UpdatedByName lastModifiedBy Имя пользователя, который последним изменил элемент в источнике данных.
UpdatedOn lastModifiedDateTime Дата и время последнего изменения элемента в источнике данных.
Url url Целевой URL-адрес элемента в источнике данных.

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

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

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

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

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

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

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