Предварительные требования
Перед настройкой Microsoft Teams убедитесь, что у вас есть:- Администратор Microsoft Teams, который может загружать и одобрять приложения организации. Обе роли администратора может выполнять один и тот же человек.
- Администратор Microsoft Entra — только если вы хотите включить необязательный резервный поиск по электронной почте/UPN с общетенантным согласием приложения
User.Read.All - Права администратора Living Security
- Активная организация Living Security
- Названия команд и каналов, в которые должны доставляться объявления по безопасности, если включены объявления в каналах
- Идентификатор вашего тенанта Microsoft Entra, доступный в разделе Microsoft Entra admin center → Identity → Overview
Распределение обязанностей
Настройка
Откройте панель настройки Microsoft Teams
Подключите тенант Microsoft
Скачайте региональный пакет Teams
Загрузите и установите пакет в Teams admin center
- Идентификатор приложения Teams и идентификатор приложения бота совпадают со значениями, отображаемыми в Living Security
- Название приложения — региональное название Living Security либо название, заданное вами при ребрендинге пакета
- Издатель — Living Security. Ребрендинг пакета не меняет издателя
- Приложение разблокировано
- Приложение доступно нужным пользователям или группам
- Приложение установлено с помощью политик настройки приложений или целевой установки для пользователей и команд/каналов, которые должны получать уведомления
Установите или откройте приложение
Настройте сообщения об установке
- Отправлять сообщения об установке
- Отправлять персональные сообщения об установке
- Отправлять сообщения об установке в каналы
- Сообщение по умолчанию
- Персональное сообщение
- Сообщение для канала
{{installerName}}, которое заменяется отображаемым именем пользователя, установившего приложение. Оставьте персональное сообщение или сообщение для канала пустым, чтобы использовать настроенное сообщение по умолчанию. Если сообщение по умолчанию также пусто, Living Security использует встроенное сообщение для соответствующей области.Проверьте настройку
Отправьте тестовые уведомления
User.Read.All.Если персональная установка не обнаружена, попросите пользователя установить или открыть
персональное приложение Living Security, снова выберите Проверить установку, а затем
повторите отправку теста. Расширенный целевой тест по электронной почте/UPN используйте, только если
включён необязательный резервный поиск.Ребрендинг регионального пакета
Региональный пакет — это ZIP-архив из трёх файлов:manifest.json, color.png и outline.png. Перед загрузкой вы можете задать в этом пакете собственное название приложения и значки. Living Security поддерживает такой сценарий для региональных пакетов, которые администратор Teams загружает напрямую.
Выполняйте эти действия после скачивания и проверки пакета и до его загрузки в Teams admin center.
Распакуйте пакет
manifest.json, color.png и outline.png.Замените значки
color.png и outline.png своими значками. Сохраните те же два
имени файлов.Задайте название приложения
manifest.json измените следующие два поля:-
name.short— название, отображаемое в заголовке приложения Teams и в других областях с ограниченным пространством. Не более 30 символов. -
name.full— название, отображаемое в каталоге приложений и в сведениях о приложении. Не более 100 символов.Если приложение Living Security уже загружено в Teams admin center, задайте дляversionзначение выше установленной там версии. Microsoft Teams отклоняет обновление, в котором версия не увеличена, а заново скачанный пакет может содержать ту же версию, что и уже установленный пакет, или более низкую.Узнайте установленную версию в Teams admin center в разделе Teams apps → Manage apps на странице сведений о приложении. Сравните её со значениемversionв только что скачанномmanifest.jsonи задайте значение, превышающее оба. Сохраните форматMAJOR.MINOR.PATCHиз трёх чисел.Например, если установлено приложение1.1.1, а новый скачанный пакет имеет версию1.1.0, задайте1.1.2. Если повысить скачанную версию1.1.0до1.1.1, она совпадёт с установленной, и Teams отклонит загрузку.
Оставьте поля идентификации без изменений
-
id -
botIdвbots -
webApplicationInfo -
validDomains -
contentUrlиwebsiteUrlвstaticTabs
Снова упакуйте три файла в ZIP
manifest.json находится внутри папки.Загрузите и проверьте
Издатель и контрольная сумма
Ребрендинг задаёт название приложения и значки. Два момента он не меняет:- Издателем остаётся Living Security. Поля манифеста
developerуказывают Living Security и содержат ссылки на веб-сайт Living Security, политику конфиденциальности и условия использования. Вместе они определяют компанию, которая эксплуатирует сервис, поэтому Teams по-прежнему показывает Living Security как издателя на странице сведений о приложении, в диалогах согласия на разрешения и в отчётах об использовании приложения. Ваши название и значки пользователи видят в заголовке приложения, в каталоге приложений и в уведомлениях. - Контрольная сумма SHA256 перестаёт совпадать. Контрольная сумма, отображаемая в Living Security, относится к пакету в том виде, в котором он был скачан. Проверьте её до редактирования файлов, затем зафиксируйте контрольную сумму вашего пакета с новым оформлением в документации по развёртыванию.
Необязательно: включение резервного поиска по электронной почте/UPN
Обычная персональная доставка использует доверенный идентификатор объекта Microsoft Entra, уже известный Living Security, вместе со ссылкой на диалог с ботом, полученной, когда пользователь устанавливает или открывает приложение. Доставка в каналы использует сохранённую ссылку на диалог канала. Ни один из этих способов не требует Microsoft Graph. Если у получателя нет доверенного идентификатора объекта Entra, Living Security может дополнительно использовать Microsoft Graph, чтобы определить получателя по адресу электронной почты или UPN. Чтобы включить этот резервный механизм, попросите администратора Microsoft Entra нажать Grant optional User.Read.All consent на панели настройки Teams и подтвердить разрешение приложения Microsoft GraphUser.Read.All для регионального приложения
Living Security Teams.
Процесс предоставления согласия администратора соответствует следующему шаблону Microsoft Entra:
- Teams app ID идентифицирует устанавливаемый пакет приложения в Microsoft Teams admin center.
- Bot app ID идентифицирует приложение Microsoft Entra регионального бота и является идентификатором клиента (client ID), используемым в необязательном процессе предоставления согласия администратора.
User.Read.All из существующих региональных
регистраций приложений Living Security. Клиенты, которые уже предоставили
согласие, могут продолжать использовать резервный поиск по электронной почте/UPN без повторной настройки.Типы уведомлений
В зависимости от прав вашей организации и настроенных плейбуков Living Security может отправлять:Настройка оформления
Уведомления Teams используют конфигурацию вашей организации в Living Security. Поддерживаемые поля включают отображаемое название клиента, поддерживаемые поля логотипа и фирменного стиля, текст сообщений, призывы к действию, ссылки назначения, текст о запуске и текст со сведениями о поддержке и контактах. Сообщения об установке настраиваются в разделе Настройки → Связь → Каналы → Microsoft Teams → Элементы управления сообщениями об установке. Вы можете полностью отключить сообщения об установке, отключить только персональные сообщения или сообщения для каналов, а также настроить текст по умолчанию, персональный текст или текст для конкретного канала. Название и значки приложения Teams берутся из регионального пакета. Чтобы задать собственные, см. раздел Ребрендинг регионального пакета.Обновление и удаление приложения
- Когда Living Security предоставляет обновлённый региональный пакет, скачайте его на панели канала Microsoft Teams и загрузите через Teams admin center. Перед развёртыванием сверьте отображаемые идентификатор приложения, идентификатор бота и контрольную сумму.
- Изменения оформления не сохраняются при обновлении пакета. Каждый новый региональный пакет снова содержит название и значки приложения Living Security. Повторно примените свои изменения, выполнив инструкции из раздела Ребрендинг регионального пакета, прежде чем загружать новый пакет. Храните в доступном месте свои значки, два значения названия и версию, которую вы загружали в последний раз, — тогда каждое обновление сведётся к краткому повтору тех же шагов. Новый пакет не всегда имеет более высокую версию, чем установленный, поэтому задавайте версию исходя из того, что Teams показывает как установленное.
- После обновления приложения или политики повторно запустите Проверить установку и отправьте ещё одно тестовое уведомление.
- Удаление или блокировка приложения не позволяет отправлять проактивные уведомления этому пользователю или в этот канал. Переустановите приложение и отправьте новый тест, чтобы Living Security получила актуальное событие установки Teams.
- Если вы прекращаете доставку через Teams, удалите Teams из соответствующих плейбуков, прежде чем удалять приложение из Microsoft Teams.
Устранение неполадок
Пользователь не получает персональное уведомление
Пользователь не получает персональное уведомление
- Убедитесь, что персональное приложение Living Security Teams установлено и пользователь его открывал, чтобы у Living Security была актуальная ссылка на диалог
- Убедитесь, что настроенный идентификатор тенанта Microsoft соответствует тенанту, в котором находится пользователь
- Если диагностика показывает, что была предпринята попытка резервного поиска по электронной почте/UPN, убедитесь, что согласие администратора
User.Read.Allбыло предоставлено для отображаемого Bot app ID в нужном тенанте - Если используется резервный поиск по электронной почте/UPN, проверьте, что адрес электронной почты или UPN пользователя в Living Security совпадает с данными в Microsoft Entra ID
- Попросите пользователя разблокировать или переустановить приложение, если он ранее удалял или блокировал его
Объявление в канале не отображается
Объявление в канале не отображается
- Убедитесь, что приложение Living Security Teams установлено в целевой команде или канале.
- Убедитесь, что сопоставление каналов в Living Security использует правильную команду и канал.
- Проверьте, не был ли канал удалён, переименован, архивирован или ограничен.
- Переустановите приложение в целевой команде или канале и отправьте ещё одно тестовое уведомление.
Не работает необязательный поиск по электронной почте/UPN или предоставление согласия
Не работает необязательный поиск по электронной почте/UPN или предоставление согласия
- Убедитесь, что администратор Microsoft Entra предоставил общетенантное согласие на
Microsoft Graph
User.Read.Allдля отображаемого Bot app ID. - Убедитесь, что настроенный идентификатор тенанта соответствует тенанту, в котором находятся пользователи и Teams.
- Убедитесь, что пользователь существует в Microsoft Entra ID и не является гостем из другого тенанта.
Журнал связи показывает, что требуется согласие администратора Microsoft
Журнал связи показывает, что требуется согласие администратора Microsoft
TEAMS_ADMIN_CONSENT_REQUIRED или ошибка Microsoft AADSTS7000229 означает, что при поиске получателя по электронной почте/UPN была предпринята попытка использовать необязательный резервный механизм Microsoft Graph, но у регионального приложения Living Security Teams нет субъекта-службы (корпоративного приложения) в подключённом тенанте Microsoft Entra. Маршруты по умолчанию, использующие доверенный идентификатор и сохранённый диалог, не требуют этого согласия. Это не означает истечение срока действия секрета Living Security.- Откройте Настройки → Связь → Каналы → Microsoft Teams. Также можно воспользоваться командой Open Microsoft Teams setup в сообщении об ошибке журнала связи.
- Убедитесь, что подключён правильный идентификатор тенанта Microsoft Entra.
- Если требуется резервный поиск по электронной почте/UPN, попросите администратора Microsoft Entra нажать Grant optional User.Read.All consent и подтвердить
User.Read.Allдля отображаемого Bot app ID. В противном случае убедитесь, что получатель открывал персональное приложение и что у Living Security есть его доверенный идентификатор объекта Entra. - После того как Microsoft завершит обработку согласия, отправьте расширенный целевой тест по электронной почте/UPN из настроек Microsoft Teams. Журнал связи показывает историю доставки и диагностику; он не выполняет повторную доставку неудавшегося сообщения.
Приложение установлено, но уведомления не доставляются
Приложение установлено, но уведомления не доставляются
- Проверьте, не был ли бот заблокирован, удалён или деинсталлирован
- Если приложение было установлено до подключения тенанта в Living Security, сохраните тенант и выберите Проверить установку, чтобы Living Security могла связать существующую установку
- Переустанавливайте приложение, только если проверка не смогла обнаружить существующую установку
- Убедитесь, что целевой пользователь или канал получил последнее событие установки приложения
- После переустановки приложения отправьте новое тестовое уведомление
Безопасность
Living Security использует Microsoft GraphUser.Read.All только для необязательного резервного поиска получателей по электронной почте/UPN. По умолчанию маршрутизация персональных уведомлений использует доверенный идентификатор объекта Entra из данных сущностей Living Security и ссылку на диалог с ботом, полученную из Microsoft Teams. Идентификаторы объектов и ссылки на диалоги, переданные вызывающей стороной, не считаются доверенными данными маршрутизации. Сообщения Microsoft Teams доставляются через бота Teams Living Security, предназначенного только для уведомлений, с использованием проактивных сообщений Microsoft Teams.
Living Security не требует от клиентов создавать собственную регистрацию приложения Microsoft Entra или передавать клиентский секрет, принадлежащий клиенту, для стандартной настройки приложения Teams.
Региональные пакеты Teams обеспечивают соответствие идентификатора приложения, идентификатора бота и конечной точки сообщений региону Living Security, в котором размещена ваша организация.

