> ## 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). Щоб налаштувати доставлення Nudge і Playbook, перейдіть до **Settings → Communications → Channels** і натисніть картку **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 app ID, **Bot app ID** і цільову групу користувачів для впровадження. Надайте згенерований URL для надання згоди адміністратору Microsoft Entra лише тоді, коли вмикається необов’язковий резервний пошук за адресою електронної пошти/UPN. Не передавайте сторонні облікові дані Living Security, не пов’язані з цим налаштуванням. ## Налаштування У Living Security перейдіть до **Settings → Communications → Channels** і виберіть **Microsoft Teams**. Панель показує регіон вашої організації, назву файлу пакета, Teams app ID, bot app ID, контрольну суму SHA256, стан конфігурації тенанта Microsoft, інструкції зі встановлення, елементи керування повідомленнями про встановлення, а також інструменти перевірки й тестових сповіщень. Регіон, показаний у Living Security, збігається з регіоном, де розміщено вашу організацію. У розділі **Connect your tenant** введіть ідентифікатор тенанта Microsoft Entra, якому належать користувачі та канали Teams, що отримуватимуть сповіщення, а потім натисніть **Save Microsoft tenant**. Один тенант Microsoft може належати лише одній організації Living Security. Якщо елемент керування тенантом недоступний, зверніться до відповідального за впровадження Living Security або до служби підтримки, щоб підключити чи змінити тенант до встановлення застосунку. Перш ніж продовжити, Living Security показує **Microsoft tenant connected**. За можливості підключайте тенант до встановлення застосунку Teams. Якщо застосунок уже встановлено, спочатку збережіть тенант і виберіть **Validate install**. Living Security спробує автоматично зіставити наявне встановлення; перевстановлюйте лише тоді, коли перевірка не може його виявити. Натисніть **Download Teams package**. 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%D1%96%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 app ID і bot app ID збігаються зі значеннями, показаними в Living Security * Назва застосунку відповідає регіональній назві Living Security або назві, яку ви задали, якщо виконали ребрендинг пакета * Видавцем указано **Living Security**. Ребрендинг пакета не змінює видавця * Застосунок розблоковано * Застосунок доступний потрібним користувачам або групам * Застосунок установлено через політики налаштування застосунків або цільове встановлення для користувачів і команд/каналів, які мають отримувати сповіщення Microsoft може потребувати часу для поширення змін доступності застосунку та політик налаштування. Якщо перевірка або тест завершується помилкою одразу після зміни політики застосунків, перевірте призначення політики в Microsoft Teams admin center і повторіть спробу після того, як Microsoft завершить її поширення. Розповсюдьте персональний застосунок потрібним користувачам. Щоб Living Security могла надіслати персональний тест на виявлене встановлення, принаймні один користувач має встановити або відкрити персональний застосунок Living Security в Microsoft Teams. Це дає змогу боту отримати довірену ідентифікацію користувача та посилання на персональну розмову. Лише встановлення в каналі не можна використати для персонального тесту на виявлене встановлення. Для доставлення в канал установіть застосунок у потрібну команду та канал, щоб бот міг отримати посилання на розмову цього каналу. Цільовий користувач установив або відкрив персональний застосунок, або застосунок установлено в потрібному каналі. У розділі **Install message controls** виберіть, чи надсилати повідомлення про встановлення в Teams, і налаштуйте односторонній текст для вашої організації. Доступні елементи керування: * Send install messages * Send personal install messages * Send channel install messages * Default message * Personal message * Channel message Поля повідомлень підтримують `{{installerName}}`, що замінюється відображуваним іменем користувача, який установив застосунок. Залиште персональне або канальне повідомлення порожнім, щоб використовувати налаштоване типове повідомлення. Якщо типове повідомлення також порожнє, Living Security використовує вбудоване повідомлення для відповідної області. Натисніть **Validate install** у Living Security. Перевірка визначає, що регіональний пакет доступний, конфігурація тенанта Microsoft наявна й унікальна для цієї організації Living Security, облікові дані регіонального бота налаштовано, а для підключеного тенанта виявлено активне встановлення застосунку. Перш ніж надсилати робочі сповіщення, перевірка показує **Validation passed**. Для типового персонального тесту натисніть **Send test to detected installation**. Living Security вибирає виявлене активне персональне встановлення та використовує збережену довірену ідентифікацію й посилання на розмову. Цей тест не викликає Microsoft Graph і не потребує згоди `User.Read.All`. Якщо персональне встановлення не виявлено, попросіть користувача встановити або відкрити персональний застосунок Living Security, знову виберіть **Validate install**, а потім повторно надішліть тест. Розширений цільовий тест за адресою електронної пошти/UPN використовуйте лише тоді, коли ввімкнено необов’язковий резервний пошук. Односторонє тестове сповіщення з’являється в Microsoft Teams. Якщо потрібна діагностика доставлення, перегляньте відповідну спробу в [Communication Log](/uk/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 відхилив би завантаження. Не змінюйте ці поля. Кожне з них містить ідентифікацію застосунку, бота або єдиного входу (SSO): * `id` * `botId` у `bots` * `webApplicationInfo` * `validDomains` * `contentUrl` і `websiteUrl` у `staticTabs` Зміна поля ідентифікації може призвести до того, що застосунок можна буде встановити, але він не зможе доставляти сповіщення або виконувати єдиний вхід. **Validate install** перевіряє тенант, облікові дані бота та виявлене встановлення. Вона не порівнює ваш маніфест із пакетом, створеним Living Security. Створіть новий ZIP-архів із трьох файлів. Розмістіть їх у корені архіву, без вкладеної папки. Microsoft Teams відхиляє пакет, у якому `manifest.json` міститься всередині папки. Завантажте ZIP-файл після ребрендингу в Teams admin center, а потім поверніться до Living Security і натисніть **Validate install**. Надішліть тестове сповіщення. Перевірка показує **Validation passed**, а тестове сповіщення надходить до 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 і схвалити дозвіл застосунку `User.Read.All` Microsoft Graph для регіонального застосунку 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)** у розділі Connected Integrations є окремою, загальною інтеграцією. Її облікові дані чи згоду не може повторно використати регіональний бот Teams, а згода, надана не пов’язаному застосунку Entra, не вмикає цей резервний варіант. Те, що згода є необов’язковою, не видаляє `User.Read.All` з наявних реєстрацій регіональних застосунків Living Security. Клієнти, які вже надали згоду, можуть і далі використовувати резервний пошук за адресою електронної пошти/UPN без повторного налаштування. ## Типи сповіщень Залежно від прав вашої організації та налаштованих Playbooks Living Security може надсилати: | Сповіщення | Опис | | - | - | | Призначення навчання | Сповіщають користувачів, коли навчання призначено, настав термін його завершення або його можна проходити | | Нагадування про навчання | Нагадують користувачам про наближення кінцевих термінів | | Сповіщення про ризики людського фактора | Надсилають персоналізовані оновлення Human Risk Index і рекомендовані наступні кроки | | Повідомлення про впровадження | Надсилають односторонні сповіщення про адаптацію або впровадження під час розгортання | | Оголошення в каналах | Публікують комунікації програми безпеки в налаштованих каналах Teams | ## Налаштування вигляду Сповіщення Teams використовують конфігурацію вашої організації в Living Security. Підтримувані поля охоплюють відображувану назву клієнта, підтримувані поля логотипа й бренду, текст повідомлень, заклики до дії, посилання призначення, текст про впровадження та текст підтримки/контактів. Повідомлення про встановлення можна налаштувати в **Settings → Communications → Channels → Microsoft Teams → Install message controls**. Ви можете повністю вимкнути повідомлення про встановлення, вимкнути лише персональні або канальні повідомлення про встановлення та налаштувати типовий, персональний або канальний текст. Назва застосунку 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%D1%96%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. Перед впровадженням перевірте показані app ID, bot ID і контрольну суму. * Зміни бренду не зберігаються під час оновлення пакета. Кожен новий регіональний пакет знову містить назву застосунку та значки 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%D1%96%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 показує як встановлене. * Повторно виконайте **Validate install** і надішліть ще одне тестове сповіщення після оновлення застосунку або політики. * Видалення або блокування застосунку унеможливлює проактивні сповіщення для цього користувача чи каналу. Перевстановіть застосунок і надішліть новий тест, щоб Living Security отримала актуальну подію встановлення Teams. * Якщо ви припиняєте доставлення через Teams, вилучіть Teams із відповідних Playbooks перед видаленням застосунку з 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. Відкрийте **Settings → Communications → Channels → Microsoft Teams**. Також можна скористатися **Open Microsoft Teams setup** у повідомленні про помилку в Communication Log. 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. Communication Log показує історію доставлення та діагностику; він не доставляє повторно повідомлення, яке не було доставлено. Повторне налаштування **Microsoft Entra ID (Client Credentials)** не усуває цю помилку, оскільки ця інтеграція не використовується для доставлення сповіщень Teams. * Перевірте, чи бота не було заблоковано, видалено або деінстальовано * Якщо застосунок було встановлено до підключення тенанта в Living Security, збережіть тенант і виберіть **Validate install**, щоб 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 узгоджують app ID, bot ID і кінцеву точку повідомлень із регіоном Living Security, де розміщено вашу організацію. ## Пов’язані матеріали Налаштуйте електронну пошту як канал доставлення. Налаштуйте Slack як канал доставлення. Відстежуйте стан і історію доставлення в Teams. Налаштування Microsoft Entra ID та SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.