Как это работает
Каждое обновление читает письма, полученные каждой папкой с момента последнего запуска,
и перестраивает каждую переписку, в которой появилось новое письмо. Переписка, из которой только удалили письмо,
сохраняет старый текст, пока в ней не появится письмо или коннектор не будет переиндексирован.
Очистка удаляет переписки, которых больше нет, и события календаря, вышедшие за окно календаря.
Перед началом
Вам нужен тенант Microsoft 365 с почтовыми ящиками Exchange Online и роли, перечисленные в разделе Настройка Microsoft 365.Регистрация приложения по умолчанию может открывать каждый почтовый ящик в тенанте.
Чтобы ограничить её отдельными ящиками,
либо ограничьте разрешения Graph с помощью политики доступа
приложения,
либо замените разрешения на почту и календарь ролями с ограниченной областью через Exchange RBAC для
приложений.
В любом случае сохраните User.Read.All. Exchange применяет такое изменение от 30 минут до двух часов.
Настройка Microsoft Entra
Следуйте настройке Microsoft 365 со строками Outlook из её таблицы разрешений. Для чего нужно каждое разрешение:- Mail.Read: чтение почты и вложений в каждом почтовом ящике, который может открывать приложение
- User.Read.All: перечисление пользователей тенанта, определение адресов почтовых ящиков и построение списков прав
- Calendars.Read: чтение календарей, нужно только при включённом Include Calendar
Настройка Yahont
1
Откройте коннектор Outlook
В Yahont откройте Панель администратора → Добавить коннектор и выберите Outlook.
2
Создайте учётные данные
Выберите существующие учётные данные Outlook или создайте их,
как описано в разделе Настройка Microsoft
365.Yahont проверяет коннектор при сохранении: приложение может войти,
а пользователей тенанта можно перечислить или каждый указанный почтовый ящик доступен.
Во время индексации почтовый ящик или календарь, который приложение не может открыть,
записывается как ошибка с названием отсутствующего разрешения, если вы перечислили этот ящик,
и пропускается с записью в журнале в режиме «все ящики».
3
Выберите почтовые ящики
Задайте коннектору название. В Mailboxes перечислите имена участников (UPN)
или основные адреса электронной почты для индексации или оставьте список пустым,
чтобы индексировать ящик каждого включённого пользователя, у которого есть почтовый адрес.Общие почтовые ящики обычно отключены для входа, поэтому автоматическое обнаружение их не находит.
Перечислите их явно.
4
Выберите, что индексировать
Включите Include Attachments, чтобы индексировать текст вложенных файлов, и Include Calendar,
чтобы индексировать календарь каждого ящика наряду с почтой. По умолчанию оба выключены.
5
Выберите тип доступа
Выберите тип доступа коннектора:
- Public делает всю проиндексированную почту видимой каждому пользователю Yahont.
- Private ограничивает коннектор выбранными группами пользователей Yahont.
- Auto Sync Permissions воспроизводит владение почтовым ящиком и участие во встречах.
6
Задайте дату начала индексации
В Advanced Configuration задайте Indexing Start Date, если вам не нужны все когда-либо полученные письма.
Без неё первая попытка индексации читает каждый ящик с первого письма,
и тенанту с многолетней почтой во многих ящиках требуются дни, чтобы стать доступным для поиска.
С датой начала Yahont индексирует переписки, получившие письмо в эту дату или позже, и пропускает остальные.
У календаря собственное окно, задаваемое Calendar Past Days и Calendar Future Days ниже. См.
Расширенная конфигурация.
7
Подключите и проверьте
Нажмите Create Connector. Затем откройте Панель администратора → Существующие коннекторы,
выберите коннектор и убедитесь, что первая попытка индексации завершилась.
Расширенные настройки
Вложения
При включённом Include Attachments Yahont скачивает каждое вложенное файловое вложение и добавляет его текст к письму, к которому оно относилось. Yahont разбирает следующие типы:.csv, .docx, .eml, .epub, .html, .json,
.md, .mdx, .pdf, .pptx, .tsv, .txt, .xlsx, .xlsm, .xml, .yaml, .yml, .conf, .log и .sql.
Одно письмо вносит не более 20 вложений, а переписка прекращает скачивание после 25 попыток скачивания,
включая неудачные, или одного миллиона символов текста вложений.
Задайте OUTLOOK_CONNECTOR_ATTACHMENT_SIZE_THRESHOLD (байты),
чтобы изменить ограничение размера 20 МБ (20 × 1024 × 1024 байт).
Автосинхронизация прав
При Auto Sync Permissions Yahont предоставляет доступ по адресу электронной почты. Адрес почтового ящика должен совпадать с адресом пользователя в Yahont.
Права привязываются во время индексации,
поэтому новый коннектор доступен для поиска нужным людям с первой попытки индексации.
Затем по умолчанию каждые 5 минут выполняется синхронизация прав, обновляющая списки доступа существующих документов.
Задайте
OUTLOOK_PERMISSION_DOC_SYNC_FREQUENCY (секунды), чтобы изменить интервал.
Синхронизация прав использует те же разрешения Mail.Read и Calendars.Read, что и индексация,
и не требует дополнительных разрешений Graph. User.Read.All предоставляет адреса владельцев.
Оба метода аутентификации её поддерживают.