Как это работает
При каждом обновлении у каждого канала запрашиваются сообщения, изменившиеся с последнего запуска,
и перестраивается каждая изменившаяся ветка.
По каждому чату собрания с сообщением за последние шесть месяцев запрашивается, что изменилось,
поэтому правка или удаление в затихшем чате подхватываются при следующем обновлении. Очистка удаляет ветки, файлы,
транскрипты и дни чата, которых больше нет, а также транскрипты и дни чата старше шести месяцев.
Перед началом
Вам нужен тенант Microsoft 365 с Microsoft Teams, роли, перечисленные в разделе Настройка Microsoft 365, и администратор Teams — только для Include Meeting Transcripts.Настройка Microsoft Entra
Следуйте настройке Microsoft 365 со строками Teams из её таблицы разрешений: ветки каналов всегда и по одной строке для каждого включаемого варианта. Каждый вариант работает с секретом клиента, кроме Include Attachments, которому нужен сертификат. Держите под рукой Application (client) ID: он нужен политике доступа приложения для Include Meeting Transcripts.Настройка Microsoft Teams
Этот раздел нужен только для Include Meeting Transcripts. Трёх разрешений Graph недостаточно: если отсутствует любая из настроек ниже, Microsoft отказывает в транскриптах, даже если разрешения предоставлены.1
Разрешите доступ Microsoft Graph к транскриптам
Войдите в центр администрирования Teams как администратор Teams.
Откройте Meetings → Meeting settings.
В разделе Transcript API access переключите Microsoft Graph access в On. По умолчанию он выключен.Затем выберите Configure и включите Include speaker attribution (On), чтобы в транскриптах указывалось,
кто говорил. Если выключено, Yahont по-прежнему индексирует транскрипт, но без говорящих.То же изменение в Teams PowerShell, после См.
Manage transcript API access for Teams
meetings.
Connect-MicrosoftTeams из следующего шага:2
Предоставьте политику доступа приложения
Microsoft позволяет приложению читать собрание только от имени организатора,
у которого есть политика доступа приложения с названием этого приложения.
У политики нет страницы в центре администрирования. Она задаётся в Teams PowerShell:В тенанте одна глобальная политика доступа приложения (Global),
и она применяется к пользователям без собственной политики. Сначала выполните
Get-CsApplicationAccessPolicy.
Если Global уже называет другие приложения, создайте одну политику, называющую их все,
прежде чем предоставлять её с -Global. Пользователю с собственной политикой нужно,
чтобы приложение Yahont было названо в этой политике. Изменение может применяться до 30 минут. См.
Configure an application access
policy.3
Проверьте организаторов
Транскрипт существует, только если кто-то запустил транскрибирование на собрании.
Teams сохраняет его в OneDrive организатора, поэтому организатору нужны лицензия Teams и настроенный OneDrive.
Организатор без OneDrive не создаёт транскрипта, который мог бы отдать Microsoft.
Настройка Yahont
1
Откройте коннектор Teams
В Yahont откройте Панель администратора → Добавить коннектор и выберите Teams.
2
Создайте учётные данные
Выберите существующие учётные данные Teams или создайте их,
как описано в разделе Настройка Microsoft
365.
Include Attachments требует Certificate Authentication.
3
Выберите команды
Задайте коннектору название.
В Teams перечислите отображаемые имена команд для индексации или оставьте список пустым,
чтобы индексировать каждую команду тенанта.
4
Выберите, что индексировать
Включите Include Attachments, Include Inline Images,
Include Meeting Transcripts и Include Meeting Chats по необходимости. По умолчанию все выключены.В Meeting Organizers перечислите имена участников (UPN) организаторов,
чьи транскрипты и чаты нужно индексировать, или оставьте список пустым,
чтобы охватить каждого включённого пользователя с лицензией Teams. Если список пуст,
политика доступа приложения должна охватывать всех этих пользователей.
5
Выберите тип доступа
Выберите тип доступа коннектора:
- Public делает всё проиндексированное содержимое видимым каждому пользователю Yahont.
- Private ограничивает коннектор выбранными группами пользователей Yahont.
- Auto Sync Permissions воспроизводит, кто может читать каждый элемент в Teams.
6
Задайте дату начала индексации
В Advanced Configuration задайте Indexing Start Date,
если вам не нужна каждая когда-либо опубликованная ветка.
Без неё первая попытка индексации читает каждый канал с момента создания команды,
и тенанту с многолетней историей каналов требуются дни, чтобы стать доступным для поиска.
С датой начала Yahont индексирует ветки, последний раз изменённые после неё, поэтому старая ветка,
в которой появился ответ, индексируется целиком.
Транскрипты и чаты собраний уходят назад не более чем на шесть месяцев или только до даты начала, если она позже.
См. Расширенная конфигурация.
7
Подключите и проверьте
Нажмите Create Connector. Yahont проверяет у Microsoft каждый включённый вариант, прежде чем начать индексацию,
и называет отсутствующее разрешение или настройку, если проверка не проходит.
Разрешения для Auto Sync Permissions в эту проверку не входят.
Затем откройте Панель администратора → Существующие коннекторы, выберите коннектор и убедитесь,
что первая попытка индексации завершилась.
Проверка транскриптов собраний читает одного организатора.
Организатор без транскрипта за последние 30 дней подтверждает только разрешение на перечисление,
поэтому отсутствие политики доступа приложения может впервые проявиться как ошибка индексации для этого организатора.
Расширенные настройки
Вложения
При включённом Include Attachments каждый файл на вкладке Files канала становится отдельным документом с читателями, которых ему предоставляет SharePoint. Файлы канала находятся в библиотеке документов SharePoint, поэтому этому варианту нужны сертификат и разрешение SharePoint. Файл часто предоставляется группе, и Yahont перечисляет участников группы — для этого и нужен GroupMember.Read.All. Yahont читает читателей каждого файла во время индексации независимо от типа доступа, поэтому разрешения для этого варианта нужны даже для коннектора Public. При Sites.Selected вместо Sites.Read.All предоставьте приложению полный контроль над сайтом каждого канала. См. Ограничение приложения отдельными сайтами. ЗадайтеTEAMS_CONNECTOR_ATTACHMENT_SIZE_THRESHOLD (байты),
чтобы изменить ограничение размера 20 МБ (20 × 1024 × 1024 байт).
Транскрипты и чаты собраний
Оба варианта обходят организаторов собраний, а не команды: Microsoft перечисляет транскрипты и чаты собраний для каждого пользователя.- Индексируются транскрипты и дни чата за последние шесть месяцев. Yahont читает на шесть месяцев назад, чтобы список каждого организатора оставался коротким, а элемент, которому исполнилось шесть месяцев, покидает индекс при следующей очистке.
- Каждый запуск спрашивает Microsoft обо всех организаторах. Обновление читает только время с последнего запуска. Первая индексация, очистка и синхронизация прав читают все шесть месяцев, примерно по 10–15 секунд на организатора, даже если транскрипта нет. Yahont читает по восемь организаторов одновременно. Чтобы большой тенант оставался быстрым, перечислите организаторов, которые записывают собрания.
- Организатор, которому Microsoft отказывает (например, потерявший политику доступа приложения), ничего не перечисляет, поэтому его транскрипты и дни чата покидают индекс при следующей очистке. Остальные организаторы не затрагиваются.
- Чат собрания индексируется через организатора собрания. Чат собрания, созданного другой организацией, не отдаётся приложениям вашего тенанта, поэтому не индексируется.
Автосинхронизация прав
При Auto Sync Permissions Yahont предоставляет доступ по адресу электронной почты. Адрес электронной почты или имя участника (UPN) человека в Microsoft 365 должны совпадать с адресом пользователя в Yahont. Участники транскриптов сопоставляются по имени участника (UPN).
Ветка называет группу участников своего канала, а синхронизация групп перечисляет, кто входит в каждую группу.
Первая синхронизация групп запускается в течение минуты после создания коннектора,
и ветки нового коннектора становятся видимыми после её завершения.
После этого вход или выход в Teams доходит до Yahont при следующей синхронизации.
По умолчанию и синхронизация документов, и синхронизация групп выполняются каждые 5 минут.
Задайте
TEAMS_PERMISSION_DOC_SYNC_FREQUENCY и TEAMS_PERMISSION_GROUP_SYNC_FREQUENCY (секунды),
чтобы изменить интервалы.