> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Интеграция с Microsoft Teams > Подключите Living Security к Microsoft Teams, чтобы отправлять уведомления об обучении, оповещения о безопасности и объявления в каналах. Интеграция с Microsoft Teams отправляет уведомления Living Security пользователям и в каналы через приложение Living Security Teams. Используйте её для назначений обучения, оповещений о человеческом риске, сообщений о запуске и объявлений службы безопасности. Эта интеграция работает только на отправку уведомлений. Пользователи не отправляют команды боту в Microsoft Teams. После установки приложения бот сохраняет ссылку на диалог в Teams для последующих проактивных уведомлений. Сообщения об установке являются односторонними; их можно настраивать или отключать в соответствии с требованиями корпоративного развёртывания. Администратор Microsoft Teams по-прежнему должен загрузить, одобрить и распространить приложение Living Security Teams. Согласие администратора Microsoft Entra `User.Read.All` является необязательным и включает только резервный поиск по адресу электронной почты или имени участника-пользователя (UPN). Для настройки доставки подсказок и плейбуков перейдите в **Настройки → Связь → Каналы** и нажмите карточку **Microsoft Teams**. На этой странице описана базовая конфигурация приложения Teams. ## Предварительные требования Перед настройкой Microsoft Teams убедитесь, что у вас есть: * Администратор Microsoft Teams, который может загружать и одобрять приложения организации. Обе роли администратора может выполнять один и тот же человек. * Администратор Microsoft Entra — только если вы хотите включить необязательный резервный поиск по электронной почте/UPN с общетенантным согласием приложения `User.Read.All` * Права администратора Living Security * Активная организация Living Security * Названия команд и каналов, в которые должны доставляться объявления по безопасности, если включены объявления в каналах * Идентификатор вашего тенанта Microsoft Entra, доступный в разделе **Microsoft Entra admin center → Identity → Overview** ## Распределение обязанностей | Роль | Ответственность | | - | - | | **Администратор Living Security** | Подключает тенант Microsoft, скачивает региональный пакет, настраивает сообщения об установке, проверяет настройку и отправляет тестовые уведомления | | **Администратор Microsoft Teams** | Загружает приложение и разрешает его использование, распространяет его среди нужных пользователей или групп и назначает политики настройки приложений | | **Администратор Microsoft Entra**, при необходимости | Предоставляет согласие приложения `User.Read.All` для идентификатора приложения бота (Bot app ID) региона, если требуется резервный поиск по электронной почте/UPN | | **Владелец команды Teams**, если используется доставка в каналы | Устанавливает или одобряет приложение для нужной команды и канала | Эти роли могут выполняться разными людьми. Передайте администратору Microsoft Teams контрольную сумму пакета, идентификатор приложения Teams, **Bot app ID** и состав пользователей, для которых планируется развёртывание. Передавайте сформированный URL для предоставления согласия администратору Microsoft Entra только при включении необязательного резервного поиска по электронной почте/UPN. Не передавайте никакие другие учётные данные Living Security. ## Настройка В Living Security перейдите в **Настройки → Связь → Каналы** и выберите **Microsoft Teams**. На панели отображаются регион вашей организации, имя файла пакета, идентификатор приложения Teams, идентификатор приложения бота, контрольная сумма SHA256, состояние конфигурации тенанта Microsoft, инструкции по установке, элементы управления сообщениями об установке, а также инструменты проверки и отправки тестовых уведомлений. Регион, отображаемый в Living Security, совпадает с регионом, в котором размещена ваша организация. В разделе **Подключение тенанта** введите идентификатор тенанта Microsoft Entra, которому принадлежат пользователи и каналы Teams, получающие уведомления, затем нажмите **Сохранить тенант Microsoft**. Один тенант Microsoft может принадлежать только одной организации Living Security. Если элемент управления тенантом недоступен, обратитесь к ответственному за внедрение Living Security или в службу поддержки, чтобы подключить или изменить тенант до установки приложения. Прежде чем продолжить, убедитесь, что Living Security показывает **Тенант Microsoft подключён**. По возможности подключайте тенант до установки приложения Teams. Если приложение уже установлено, сначала сохраните тенант и выберите **Проверить установку**. Living Security попытается автоматически связать существующую установку; переустанавливайте приложение, только если проверка не смогла её обнаружить. Нажмите **Скачать пакет Teams**. Living Security предоставляет для вашей организации ZIP-пакет, специфичный для региона. Прежде чем что-либо менять, сверьте скачанный файл с контрольной суммой SHA256, отображаемой в Living Security. Чтобы задать приложению собственное название и значки, после этой проверки и до загрузки пакета выполните инструкции из раздела [Ребрендинг регионального пакета](#%D1%80%D0%B5%D0%B1%D1%80%D0%B5%D0%BD%D0%B4%D0%B8%D0%BD%D0%B3-%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0). Контрольная сумма скачанного файла совпадает с контрольной суммой SHA256, отображаемой в Living Security. В Microsoft Teams admin center перейдите в **Teams apps → Manage apps → Actions → Upload new app** и загрузите ZIP-файл, скачанный из Living Security. Убедитесь, что: * Идентификатор приложения Teams и идентификатор приложения бота совпадают со значениями, отображаемыми в Living Security * Название приложения — региональное название Living Security либо название, заданное вами при ребрендинге пакета * Издатель — **Living Security**. Ребрендинг пакета не меняет издателя * Приложение разблокировано * Приложение доступно нужным пользователям или группам * Приложение установлено с помощью политик настройки приложений или целевой установки для пользователей и команд/каналов, которые должны получать уведомления Распространение изменений доступности приложения и политик настройки в Microsoft может занять некоторое время. Если проверка или тест завершается ошибкой сразу после изменения политики приложения, убедитесь в Microsoft Teams admin center, что политика назначена, и повторите попытку после завершения распространения изменений в Microsoft. Распространите персональное приложение среди нужных пользователей. Прежде чем Living Security сможет отправить персональный тест на обнаруженную установку, как минимум один пользователь должен установить или открыть персональное приложение Living Security в Microsoft Teams. Это позволяет боту получить доверенную идентичность пользователя и ссылку на его персональный диалог. Одной установки в канале недостаточно для персонального теста на обнаруженной установке. Для доставки в каналы установите приложение в нужную команду и канал, чтобы бот мог получить ссылку на диалог этого канала. Целевой пользователь установил или открыл персональное приложение, либо приложение установлено в нужном канале. В разделе **Элементы управления сообщениями об установке** выберите, нужно ли отправлять сообщения об установке Teams, и настройте текст односторонних сообщений для вашей организации. Доступные элементы управления: * Отправлять сообщения об установке * Отправлять персональные сообщения об установке * Отправлять сообщения об установке в каналы * Сообщение по умолчанию * Персональное сообщение * Сообщение для канала Поля сообщений поддерживают `{{installerName}}`, которое заменяется отображаемым именем пользователя, установившего приложение. Оставьте персональное сообщение или сообщение для канала пустым, чтобы использовать настроенное сообщение по умолчанию. Если сообщение по умолчанию также пусто, Living Security использует встроенное сообщение для соответствующей области. Нажмите **Проверить установку** в Living Security. Проверка подтверждает, что региональный пакет доступен, конфигурация тенанта Microsoft присутствует и уникальна для этой организации Living Security, учётные данные регионального бота настроены, а для подключённого тенанта обнаружена активная установка приложения. Перед отправкой рабочих уведомлений убедитесь, что отображается **Проверка пройдена**. Для персонального теста по умолчанию нажмите **Отправить тест на обнаруженную установку**. Living Security выбирает обнаруженную активную персональную установку и использует сохранённую для неё доверенную идентичность и ссылку на диалог. Этот тест не обращается к Microsoft Graph и не требует согласия `User.Read.All`. Если персональная установка не обнаружена, попросите пользователя установить или открыть персональное приложение Living Security, снова выберите **Проверить установку**, а затем повторите отправку теста. Расширенный целевой тест по электронной почте/UPN используйте, только если включён необязательный резервный поиск. Одностороннее тестовое уведомление появилось в Microsoft Teams. Если требуется диагностика доставки, изучите соответствующую попытку в [журнале связи](/ru/features/communications/log). ## Ребрендинг регионального пакета Региональный пакет — это ZIP-архив из трёх файлов: `manifest.json`, `color.png` и `outline.png`. Перед загрузкой вы можете задать в этом пакете собственное название приложения и значки. Living Security поддерживает такой сценарий для региональных пакетов, которые администратор Teams загружает напрямую. Выполняйте эти действия после скачивания и проверки пакета и до его загрузки в Teams admin center. Извлеките содержимое ZIP-файла. В корне архива находятся ровно три файла: `manifest.json`, `color.png` и `outline.png`. Замените `color.png` и `outline.png` своими значками. Сохраните те же два имени файлов. | Файл | Требование | | - | - | | `color.png` | Полноцветный PNG, 192 × 192 пикселей, без прозрачности | | `outline.png` | PNG с прозрачностью, 32 × 32 пикселя | В `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` Изменение поля идентификации может привести к тому, что приложение будет устанавливаться, но не сможет доставлять уведомления или выполнять единый вход. Функция **Проверить установку** проверяет тенант, учётные данные бота и обнаруженную установку. Она не сравнивает ваш манифест с пакетом, собранным Living Security. Создайте новый ZIP-архив из трёх файлов. Поместите их в корень архива без вложенной папки. Microsoft Teams отклоняет пакет, в котором `manifest.json` находится внутри папки. Загрузите ZIP-файл с новым оформлением в Teams admin center, затем вернитесь в Living Security и нажмите **Проверить установку**. Отправьте тестовое уведомление. Отображается **Проверка пройдена**, а тестовое уведомление приходит в Microsoft Teams с названием и значками вашего приложения. ### Издатель и контрольная сумма Ребрендинг задаёт название приложения и значки. Два момента он не меняет: * **Издателем остаётся 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 Graph `User.Read.All` для регионального приложения Living Security Teams. Процесс предоставления согласия администратора соответствует следующему шаблону Microsoft Entra: ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security формирует этот URL из идентификатора подключённого тенанта и значения **Bot app ID**, отображаемого на панели настройки. Эти идентификаторы служат разным целям: * **Teams app ID** идентифицирует устанавливаемый пакет приложения в Microsoft Teams admin center. * **Bot app ID** идентифицирует приложение Microsoft Entra регионального бота и является идентификатором клиента (client ID), используемым в необязательном процессе предоставления согласия администратора. Не подставляйте Teams app ID в URL согласия. Интеграция **Microsoft Entra ID (Client Credentials)** в разделе «Подключённые интеграции» — отдельная универсальная интеграция. Её учётные данные или согласие не могут быть использованы региональным ботом Teams, а согласие, предоставленное стороннему приложению Entra, не включает этот резервный механизм. Отказ от обязательности согласия не удаляет `User.Read.All` из существующих региональных регистраций приложений Living Security. Клиенты, которые уже предоставили согласие, могут продолжать использовать резервный поиск по электронной почте/UPN без повторной настройки. ## Типы уведомлений В зависимости от прав вашей организации и настроенных плейбуков Living Security может отправлять: | Уведомление | Описание | | - | - | | Назначения обучения | Уведомляют пользователей о назначении обучения, приближении срока или готовности к прохождению | | Напоминания об обучении | Напоминают пользователям о приближающихся сроках | | Оповещения о человеческом риске | Отправляют персонализированные обновления Индекса человеческого риска и рекомендуемые дальнейшие шаги | | Сообщения о запуске | Отправляют односторонние вводные уведомления или уведомления о запуске в ходе развёртывания | | Объявления в каналах | Публикуют сообщения программы безопасности в настроенных каналах Teams | ## Настройка оформления Уведомления Teams используют конфигурацию вашей организации в Living Security. Поддерживаемые поля включают отображаемое название клиента, поддерживаемые поля логотипа и фирменного стиля, текст сообщений, призывы к действию, ссылки назначения, текст о запуске и текст со сведениями о поддержке и контактах. Сообщения об установке настраиваются в разделе **Настройки → Связь → Каналы → Microsoft Teams → Элементы управления сообщениями об установке**. Вы можете полностью отключить сообщения об установке, отключить только персональные сообщения или сообщения для каналов, а также настроить текст по умолчанию, персональный текст или текст для конкретного канала. Название и значки приложения Teams берутся из регионального пакета. Чтобы задать собственные, см. раздел [Ребрендинг регионального пакета](#%D1%80%D0%B5%D0%B1%D1%80%D0%B5%D0%BD%D0%B4%D0%B8%D0%BD%D0%B3-%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0). ## Обновление и удаление приложения * Когда Living Security предоставляет обновлённый региональный пакет, скачайте его на панели канала Microsoft Teams и загрузите через Teams admin center. Перед развёртыванием сверьте отображаемые идентификатор приложения, идентификатор бота и контрольную сумму. * Изменения оформления не сохраняются при обновлении пакета. Каждый новый региональный пакет снова содержит название и значки приложения Living Security. Повторно примените свои изменения, выполнив инструкции из раздела [Ребрендинг регионального пакета](#%D1%80%D0%B5%D0%B1%D1%80%D0%B5%D0%BD%D0%B4%D0%B8%D0%BD%D0%B3-%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0), прежде чем загружать новый пакет. Храните в доступном месте свои значки, два значения названия и версию, которую вы загружали в последний раз, — тогда каждое обновление сведётся к краткому повтору тех же шагов. Новый пакет не всегда имеет более высокую версию, чем установленный, поэтому задавайте версию исходя из того, что 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 * Попросите пользователя разблокировать или переустановить приложение, если он ранее удалял или блокировал его Категория ошибки `TEAMS_ADMIN_CONSENT_REQUIRED` или ошибка Microsoft `AADSTS7000229` означает, что при поиске получателя по электронной почте/UPN была предпринята попытка использовать необязательный резервный механизм Microsoft Graph, но у регионального приложения Living Security Teams нет субъекта-службы (корпоративного приложения) в подключённом тенанте Microsoft Entra. Маршруты по умолчанию, использующие доверенный идентификатор и сохранённый диалог, не требуют этого согласия. Это не означает истечение срока действия секрета Living Security. 1. Откройте **Настройки → Связь → Каналы → Microsoft Teams**. Также можно воспользоваться командой **Open Microsoft Teams setup** в сообщении об ошибке журнала связи. 2. Убедитесь, что подключён правильный идентификатор тенанта Microsoft Entra. 3. Если требуется резервный поиск по электронной почте/UPN, попросите администратора Microsoft Entra нажать **Grant optional User.Read.All consent** и подтвердить `User.Read.All` для отображаемого **Bot app ID**. В противном случае убедитесь, что получатель открывал персональное приложение и что у Living Security есть его доверенный идентификатор объекта Entra. 4. После того как Microsoft завершит обработку согласия, отправьте расширенный целевой тест по электронной почте/UPN из настроек Microsoft Teams. Журнал связи показывает историю доставки и диагностику; он не выполняет повторную доставку неудавшегося сообщения. Повторная настройка **Microsoft Entra ID (Client Credentials)** не устраняет эту ошибку, поскольку эта интеграция не используется для доставки уведомлений Teams. * Проверьте, не был ли бот заблокирован, удалён или деинсталлирован * Если приложение было установлено до подключения тенанта в Living Security, сохраните тенант и выберите **Проверить установку**, чтобы Living Security могла связать существующую установку * Переустанавливайте приложение, только если проверка не смогла обнаружить существующую установку * Убедитесь, что целевой пользователь или канал получил последнее событие установки приложения * После переустановки приложения отправьте новое тестовое уведомление Пример полей события установки, используемых для устранения неполадок: ```json theme={null} { "type": "installationUpdate", "action": "add", "channelData": { "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" }, "team": { "id": "19:team-id@thread.tacv2" }, "channel": { "id": "19:channel-id@thread.tacv2" } }, "conversation": { "id": "19:channel-id@thread.tacv2", "conversationType": "channel", "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8" } } ``` ## Безопасность Living Security использует Microsoft Graph `User.Read.All` только для необязательного резервного поиска получателей по электронной почте/UPN. По умолчанию маршрутизация персональных уведомлений использует доверенный идентификатор объекта Entra из данных сущностей Living Security и ссылку на диалог с ботом, полученную из Microsoft Teams. Идентификаторы объектов и ссылки на диалоги, переданные вызывающей стороной, не считаются доверенными данными маршрутизации. Сообщения Microsoft Teams доставляются через бота Teams Living Security, предназначенного только для уведомлений, с использованием проактивных сообщений Microsoft Teams. Living Security не требует от клиентов создавать собственную регистрацию приложения Microsoft Entra или передавать клиентский секрет, принадлежащий клиенту, для стандартной настройки приложения Teams. Региональные пакеты Teams обеспечивают соответствие идентификатора приложения, идентификатора бота и конечной точки сообщений региону Living Security, в котором размещена ваша организация. ## См. также Настройте электронную почту как канал доставки. Настройте Slack как канал доставки. Отслеживайте статус и историю доставки через Teams. Настройка Microsoft Entra ID и единого входа. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.