Skip to main content
Коннектор SharePoint индексирует сайты вашего тенанта Microsoft 365 через Microsoft Graph и может воспроизводить, кто вправе читать каждый элемент, с помощью Auto Sync Permissions. Для обнаружения пользователей и индексации их личных дисков используйте коннектор OneDrive. Коннектор входит как приложение, настроенное в разделе Настройка Microsoft 365. На этой странице перечислено, что нужно SharePoint сверх этих общих шагов.

​
Что индексируется

Yahont можно настроить на индексацию всего тенанта или конкретного списка сайтов. С каждого сайта Yahont индексирует:
  • Файлы в библиотеках документов, включая любые изображения в них.
  • Страницы, опубликованные на сайте (.aspx).
Yahont раскладывает каждый документ по сайту, библиотеке и папке, откуда он получен, поэтому можно просматривать и фильтровать на любом уровне. После первого запуска каждое обновление получает только изменения.

​
Что не индексируется

  • Списки SharePoint, их элементы и вложения
  • Личные сайты OneDrive, если вы явно не перечислили URL /personal/ в Sites. Для новых настроек используйте специальный коннектор OneDrive.
  • Файлы с неподдерживаемым расширением и файлы больше ограничения размера
Yahont индексирует файлы со следующими расширениями:Устаревшие форматы Office .doc, .xls и .ppt не поддерживаются. Преобразуйте старые файлы в SharePoint, если их нужно проиндексировать.Yahont также пропускает форматы изображений .bmp, .tiff, .gif, .svg и .avif.

​
Перед началом

Вам нужен тенант Microsoft 365 с SharePoint Online и роли, перечисленные в разделе Настройка Microsoft 365. Выполните настройку Microsoft 365 со строками SharePoint из её таблицы разрешений. Для индексации нужен только Sites.Read.All, и для неё достаточно секрета клиента. Остальное — для синхронизации прав, которой нужны учётные данные с сертификатом.

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

1

Откройте коннектор SharePoint

В Yahont откройте Панель администратора → Добавить коннектор и выберите SharePoint.
2

Выберите или создайте учётные данные

Выберите существующие учётные данные из списка или нажмите Create New и введите данные из регистрации приложения Entra, как описано в разделе Настройка Microsoft 365. Нажмите Create, убедитесь, что новые учётные данные выбраны, и продолжайте.
3

Назовите коннектор и выберите сайты

Задайте коннектору понятное Connector Name.В Sites добавьте по одной записи на каждый индексируемый сайт, например https://contoso.sharepoint.com/sites/support. Оставьте список пустым, чтобы индексировать каждый сайт тенанта.
4

Настройте расширенные параметры

Выберите Advanced Options, чтобы перейти к настройкам содержимого, исключений и национального облака, описанным в разделе Настройки коннектора. По умолчанию Yahont индексирует и файлы, и страницы сайтов из каждого указанного вами сайта.
5

Выберите тип доступа

Public показывает каждый проиндексированный документ всем пользователям Yahont. Private ограничивает их выбранными группами пользователей Yahont.Auto Sync Permissions воспроизводит собственные права SharePoint и требует учётных данных с сертификатом. См. Синхронизация прав.О значении каждого типа доступа см. в разделе Управление доступом к документам.
6

Задайте дату начала индексации

В Advanced Configuration задайте Indexing Start Date, если вам не нужны все файлы независимо от возраста. Без неё первая попытка индексации читает каждый файл и страницу в каждом указанном сайте, и тенанту с миллионами файлов требуются дни, чтобы стать доступным для поиска. С датой начала Yahont индексирует файлы и страницы, созданные или последний раз изменённые в эту дату или позже, и пропускает остальные. См. Расширенная конфигурация.
7

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

Нажмите Create Connector. Yahont проверяет учётные данные и URL ваших сайтов при сохранении, поэтому большинство проблем с правами появляется здесь, а не во время индексации.Затем откройте Панель администратора → Существующие коннекторы, выберите коннектор и убедитесь, что первая попытка индексации завершилась примерно с ожидаемым числом документов.

​
Настройки коннектора

​
Ограничение сайтами, библиотеками и папками

Запись в Sites может называть сайт, библиотеку на нём или папку в этой библиотеке. Yahont читает путь после имени сайта как библиотеку, а всё после — как папку: Командные сайты (/teams/…) и личные сайты OneDrive (/personal/…) работают так же.
Указание библиотеки в URL работает только в тенантах на английском, немецком и испанском языках, потому что Yahont должен сопоставить отображаемое имя библиотеки (Shared Documents, Freigegebene Dokumente, Documentos compartidos) с именем, которое сообщает SharePoint. В тенанте на любом другом языке вместо этого введите чистый URL сайта. Запись уровня сайта находит каждую библиотеку независимо от её названия. Обратитесь к команде Yahont, если нужно добавить другой язык.

​
Ограничение приложения отдельными сайтами

С Sites.Selected вместо Sites.Read.All приложение читает только те сайты, которые вы ему предоставили, и Sites не может быть пустым. Предоставьте read для индексации и fullcontrol для синхронизации прав. См. Ограничение приложения отдельными сайтами.

​
OneDrive

Для новых настроек используйте специальный коннектор OneDrive. Он обнаруживает пользователей, отслеживает изменения каждого диска и поддерживает синхронизацию прав OneDrive.
Существующие коннекторы SharePoint, в которых перечислены URL личных сайтов, продолжают работать. Переносить их не обязательно, если вам не нужны обнаружение пользователей и обновления на уровне дисков специального коннектора.

​
Синхронизация прав

При включённой синхронизации прав каждый документ сохраняет свой доступ SharePoint. Пользователь Yahont находит документ в поиске, только если может открыть его в SharePoint.
Синхронизация прав — платная функция: тарифы Business и Enterprise в Yahont Cloud и Enterprise Edition при самостоятельном размещении. Она также требует учётных данных с сертификатом.
Yahont запускает две синхронизации по собственным расписаниям, отдельно от индексации: Синхронизация групп запускается сразу после создания коннектора, а синхронизация документов — после завершения первой индексации, поэтому права готовы до того, как что-либо станет доступным для поиска. Доступ пользователя складывается из его собственного аккаунта и групп, в которые он входит, как групп сайтов SharePoint, так и групп безопасности Entra ID, включая вложенные. Задайте SHAREPOINT_PERMISSION_DOC_SYNC_FREQUENCY и SHAREPOINT_PERMISSION_GROUP_SYNC_FREQUENCY (секунды), чтобы изменить интервалы при самостоятельном размещении. Для чего нужно каждое разрешение Graph: GroupMember.Read.All определяет, кто входит в группу, включая вложенные группы. Group.Read.All отличает группы безопасности от групп Microsoft 365. Directory.Read.All читает связи пользователей и групп между собой. User.Read.All сопоставляет людей в вашем каталоге с их аккаунтами в Yahont. Member.Read.Hidden читает состав групп, участники которых скрыты в Entra ID. Yahont считает элементы, доступные по ссылке, приватными, если вы не включите Treat sharing links as public. Он игнорирует пользователей и группы, у которых есть только роль SharePoint Limited Access, потому что эта роль позволяет пройти через папку, но не открыть её содержимое.

​
Ограничения

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

Проблемы с учётными данными, согласием и сертификатом, которые может показывать каждый коннектор Microsoft 365, см. в разделе Настройка Microsoft 365.
У приложения нет Sites.FullControl.All, согласие администратора не дано или сайту в Sites.Selected не предоставлен полный контроль. Добавьте разрешение в разделе SharePoint, а не Microsoft Graph.
Добавьте Microsoft Graph → GroupMember.Read.All как разрешение приложения, затем снова дайте согласие администратора.
Запись в Sites не является полным URL https://, содержащим /sites/, /teams/ или /personal/.
Запись в Sites указывает на другой тенант, чем тот, которому принадлежат учётные данные. Один коннектор охватывает один тенант. URL OneDrive на хосте -my тенанта принимается.
Index Documents и Index ASPX Sites оба выключены. Включите хотя бы один.
Authority Host и Graph API Host описывают разные облака. Сопоставьте их и суффикс домена с одной строкой раздела Национальные облака.
Для обнаружения сайтов по всему тенанту нужен Sites.Read.All. В режиме Sites.Selected перечислите сайты явно.
В режиме Sites.Selected проверьте, что каждый сайт предоставлен приложению. Одно согласие ничего не предоставляет. См. Ограничение приложения отдельными сайтами.
Yahont пропускает сайты, которые не может прочитать, а также заблокированные и архивные сайты, чтобы остальной тенант индексировался. Проверьте список ошибок коннектора на предмет затронутых URL.
Личные сайты индексируются, только если перечислены в Sites. Добавьте URL личного сайта. В режиме Sites.Selected предоставьте приложению роль и на этом личном сайте.
Имена библиотек распознаются только в тенантах на английском, немецком и испанском языках. Используйте вместо этого чистый URL сайта. См. Ограничение сайтами, библиотеками и папками.
Макет страницы повреждён, поэтому SharePoint не возвращает её содержимое. Yahont сохраняет страницу, а не отбрасывает её. Открытие страницы в SharePoint и повторное сохранение обычно исправляет это.
Yahont пропускает файлы больше 20 МБ. См. Ограничения.
Учётные данные используют секрет клиента или развёртывание не на платном тарифе.