Локальный соединитель Microsoft Graph Confluence (предварительная версия)

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

Примечание

Локальный соединитель Confluence доступен в предварительной версии. Если вы хотите получить ранний доступ, чтобы опробовать его, зарегистрируйтесь с помощью этой формы .

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

Каждый шаг процесса установки указан ниже вместе с примечанием, которое указывает, что следует следовать общим инструкциям по установке или другим инструкциям, которые применяются только к локальному соединителю Confluence Graph, включая сведения об устранении неполадок и ограничениях.

Перед началом работы

Установка агента соединителя Graph Microsoft

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

Вы должны быть администратором Microsoft 365 клиента вашей организации и администратором сайта Confluence вашей организации.

Шаг 1. Добавление соединителя в Центр администрирования Microsoft 365

Следуйте общим инструкциям по настройке.

Шаг 2. Имя подключения

Следуйте общим инструкциям по настройке.

Шаг 3. Настройка параметров подключения

Шаг 3.1. Выбор типа развертывания

Выберите параметр "Сервер" или "Центр обработки данных", чтобы проиндексировать локальное содержимое Confluence, и нажмите кнопку "Далее".

Шаг 3.2. Ввод URL-адреса экземпляра Confluence

Чтобы подключиться к сайту Confluence, используйте URL-адрес сайта.

Шаг 3.3. Выбор агента соединителя Microsoft Graph

Выберите агент соединителя из раскрывающегося списка. Агент будет безопасно отправлять локальное содержимое Confluence в microsoft Graph индекса.

Шаг 3.4. Выбор типа проверки подлинности

Для проверки подлинности на сайте Confluence можно выбрать обычную проверку подлинности или OAuth 1.0a (рекомендуется).

Совет

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

Обычная проверка подлинности

Введите имя пользователя учетной записи службы (обычно это идентификатор электронной почты) и пароль для проверки подлинности с помощью обычной проверки подлинности.

OAuth 1.0a (рекомендуется)

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

Шаг 3.4.1. Создание пары открытого и закрытого ключей RSA

Выполните следующие команды openssl в терминале локального компьютера.

Шаг	Команда
Создание 1024-разрядного закрытого ключа	openssl genrsa -out confluence_privatekey.pem 1024
Создание сертификата X509	openssl req -newkey rsa:1024 -x509 -key confluence_privatekey.pem -out confluence_publickey.cer -days 365
Извлечение закрытого ключа (формат PKCS8) в confluence_privatekey.pcks8 файл	openssl pkcs8 -topk8 -nocrypt -in confluence_privatekey.pem -out confluence_privatekey.pcks8
Извлечение открытого ключа из сертификата в confluence_publickey.pem файл	openssl x509 -pubkey -noout -in confluence_publickey.cer > confluence_publickey.pem

Шаг 3.4.2. Создание ссылки на приложение

1. В Confluence перейдите к разделу " Администрирование" (значок шестеренки) > "Общие ссылки configurationApplication > " на боковой панели.

2. В поле "Введите URL-адрес приложения" , которое вы хотите связать, введите любой URL-адрес. Например, выберите https://example.com "Создать ссылку". Ignore No response was received from the URL you entered warning and select Continue. (Игнорировать сообщение об отсутствии ответа от введенного URL-адреса) и нажмите кнопку "Продолжить".

3. На первом экране диалогового окна "Связывание приложений" укажите имя приложения и выберите тип универсального приложения. Установите флажок "Создать входящую ссылку ". Все остальные поля являются необязательными. Нажмите Продолжить.

4. На втором экране диалогового окна "Связывание приложений " введите сведения о потребителе для примера клиента:

Поле	Рекомендуемое значение
Ключ потребителя	OAuthkey
Имя потребителя	Microsoft Graph Connector App
Открытый ключ	Скопируйте открытый ключ confluence_publickey.pem из файла, созданного на шаге 3.4.1 , и вставьте его в это поле (например, iuasge87awegrq3...).

5. Нажмите Продолжить. После успешного создания ссылка на приложение будет отображаться, как показано на следующем экране.

Шаг 3.4.3. Ввод ключа потребителя и закрытого ключа для входа

В помощнике по настройке подключения в Центр администрирования Microsoft 365 введите ключ потребителя, созданный на шаге 3.4.2 confluence_privatekey.pcks8, и закрытый ключ из файла на шаге 3.4.1. Включите всплывающее окно в браузере для Центр администрирования Microsoft 365 и выберите "Войти".

Шаг 3.4.4. Ввод кода проверки для завершения входа

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

Введите код проверки в помощнике по настройке создания подключения и нажмите кнопку "Готово войти". После успешного входа нажмите кнопку " Далее".

Шаг 4. Выбор свойств

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

С помощью строки языка запросов Confluence (CQL) можно указать условия для синхронизации страниц. Это похоже на предложение Where в инструкции SQL Select. Например, можно выбрать индексирование только страниц, измененных за последние два года. Дополнительные сведения о создании собственной строки запроса см. в разделе "Расширенный поиск с помощью CQL". По умолчанию соединитель будет индексировать все страницы.

Совет

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

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

Шаг 5. Управление разрешениями поиска

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

В локальной среде Confluence разрешения безопасности для пользователей и групп определяются с помощью разрешений на доступ к пространству и ограничений страниц. Локальный соединитель Confluence применяет действующие разрешения , предоставляемые API ограничений содержимого.

Если выбраны только пользователи с доступом к этому источнику данных, необходимо дополнительно выбрать, есть ли на сайте Confluence Azure Active Directory (AAD) или пользователи, не связанные с AAD.

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

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

Примечание

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

Шаг 6. Назначение меток свойств

Следуйте общим инструкциям по настройке.

Шаг 7. Управление схемой

Следуйте общим инструкциям по настройке.

Шаг 8. Выбор параметров обновления

Следуйте общим инструкциям по настройке.

Примечание

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

Шаг 9. Проверка подключения

Следуйте общим инструкциям по настройке.

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

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

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

Шаг настройки	Сообщение об ошибке	Возможные причины
Параметры подключения	Запрос имеет неправильный формат или содержит ошибку.	Неправильный URL-адрес сайта Confluence
Параметры подключения	Не удается подключиться к локальной службе Confluence для сайта Confluence.	Неправильный URL-адрес сайта Confluence
Параметры подключения	У клиента нет разрешения на выполнение действия.	Недопустимый пароль, предоставленный для обычной проверки подлинности
Выбор свойств	Нет результатов предварительного просмотра	Проверьте, является ли запрос CQL допустимым и соответствует ли он контенту для обхода

Ограничения

Локальный соединитель confluence имеет следующие известные ограничения в своем последнем выпуске:

• Локальный соединитель Confluence не индексирует блоги, файлы вложений и комментарии.