Інтеграція з 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, не пов’язані з цим налаштуванням.

Налаштування

Відкрийте панель налаштування Microsoft Teams

У Living Security перейдіть до Settings → Communications → Channels і виберіть Microsoft Teams.Панель показує регіон вашої організації, назву файлу пакета, Teams app ID, bot app ID, контрольну суму SHA256, стан конфігурації тенанта Microsoft, інструкції зі встановлення, елементи керування повідомленнями про встановлення, а також інструменти перевірки й тестових сповіщень.

Регіон, показаний у Living Security, збігається з регіоном, де розміщено вашу організацію.

Підключіть ваш тенант Microsoft

У розділі Connect your tenant введіть ідентифікатор тенанта Microsoft Entra, якому належать користувачі та канали Teams, що отримуватимуть сповіщення, а потім натисніть Save Microsoft tenant. Один тенант Microsoft може належати лише одній організації Living Security.Якщо елемент керування тенантом недоступний, зверніться до відповідального за впровадження Living Security або до служби підтримки, щоб підключити чи змінити тенант до встановлення застосунку.

Перш ніж продовжити, Living Security показує Microsoft tenant connected.

За можливості підключайте тенант до встановлення застосунку Teams. Якщо застосунок уже встановлено, спочатку збережіть тенант і виберіть Validate install. Living Security спробує автоматично зіставити наявне встановлення; перевстановлюйте лише тоді, коли перевірка не може його виявити.

Завантажте регіональний пакет Teams

Натисніть Download Teams package. Living Security надає ZIP-пакет для вашої організації, специфічний для регіону.Перш ніж щось змінювати, звірте завантажений файл із контрольною сумою SHA256, показаною в Living Security. Щоб задати застосунку власну назву та значки, після цієї перевірки й до завантаження пакета виконайте кроки з розділу Ребрендинг регіонального пакета.

Контрольна сума завантаженого файлу збігається з контрольною сумою SHA256, показаною в Living Security.

Завантажте й установіть пакет у Teams admin center

У 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.

Ребрендинг регіонального пакета

Регіональний пакет — це 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

Створіть новий 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:

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 і значки надходять із регіонального пакета. Щоб задати власні, див. Ребрендинг регіонального пакета.

Оновлення або видалення застосунку

Коли Living Security надає оновлений регіональний пакет, завантажте його з панелі каналу Microsoft Teams і завантажте цей пакет через Teams admin center. Перед впровадженням перевірте показані app ID, bot ID і контрольну суму.
Зміни бренду не зберігаються під час оновлення пакета. Кожен новий регіональний пакет знову містить назву застосунку та значки Living Security. Повторно застосуйте свої зміни за допомогою розділу Ребрендинг регіонального пакета, перш ніж завантажувати новий пакет. Зберігайте свої значки, два значення назви та версію, яку ви завантажували востаннє, в доступному місці, щоб кожне оновлення було коротким повторенням тих самих кроків. Новий пакет не завжди має вищу версію, ніж встановлений вами, тому задавайте версію, виходячи з того, що 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
Попросіть користувача розблокувати або перевстановити застосунок, якщо він раніше його видалив чи заблокував

Оголошення в каналі не з’являється

Переконайтеся, що застосунок Living Security Teams установлено в цільовій команді або каналі.
Переконайтеся, що зіставлення каналу в Living Security використовує правильну команду та канал.
Перевірте, чи канал не було видалено, перейменовано, заархівовано або обмежено.
Перевстановіть застосунок у цільовій команді або каналі та надішліть ще одне тестове сповіщення.

Необов’язковий пошук за адресою електронної пошти/UPN або надання згоди завершується помилкою

Переконайтеся, що адміністратор Microsoft Entra надав згоду на рівні тенанта для Microsoft Graph User.Read.All показаному Bot app ID.
Переконайтеся, що налаштований ідентифікатор тенанта є тенантом, у якому розташовані користувачі та Teams.
Переконайтеся, що користувач існує в Microsoft Entra ID і не є гостем з іншого тенанта.

Communication Log показує, що потрібна згода адміністратора Microsoft

Категорія помилки TEAMS_ADMIN_CONSENT_REQUIRED або помилка Microsoft AADSTS7000229 означає, що під час пошуку отримувача за адресою електронної пошти/UPN було здійснено спробу використати необов’язковий резервний варіант Microsoft Graph, але регіональний застосунок Living Security Teams не має суб’єкта служби (корпоративного застосунку) у підключеному тенанті Microsoft Entra. Типові маршрути з довіреним ідентифікатором і збереженою розмовою не потребують цієї згоди. Це не означає, що термін дії секрету Living Security сплив.

Відкрийте Settings → Communications → Channels → Microsoft Teams. Також можна скористатися Open Microsoft Teams setup у повідомленні про помилку в Communication Log.
Переконайтеся, що підключено правильний ідентифікатор тенанта Microsoft Entra.
Якщо потрібен резервний пошук за адресою електронної пошти/UPN, попросіть адміністратора Microsoft Entra натиснути Grant optional User.Read.All consent і схвалити User.Read.All для показаного Bot app ID. Інакше переконайтеся, що отримувач відкривав персональний застосунок і що Living Security має його довірений ідентифікатор об’єкта Entra.
Після того як Microsoft завершить обробку згоди, надішліть розширений цільовий тест за адресою електронної пошти/UPN з налаштувань Microsoft Teams. Communication Log показує історію доставлення та діагностику; він не доставляє повторно повідомлення, яке не було доставлено.

Повторне налаштування Microsoft Entra ID (Client Credentials) не усуває цю помилку, оскільки ця інтеграція не використовується для доставлення сповіщень Teams.

Застосунок установлено, але сповіщення не надходять

Перевірте, чи бота не було заблоковано, видалено або деінстальовано
Якщо застосунок було встановлено до підключення тенанта в Living Security, збережіть тенант і виберіть Validate install, щоб Living Security могла зіставити наявне встановлення
Перевстановлюйте лише тоді, коли перевірка не може виявити наявне встановлення
Переконайтеся, що цільовий користувач або канал отримав останню подію встановлення застосунку
Надішліть нове тестове сповіщення після перевстановлення застосунку

Приклад полів події встановлення, що використовуються для усунення несправностей:

{
  "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

Налаштуйте Slack як канал доставлення.

Communication Log

Відстежуйте стан і історію доставлення в Teams.

Автентифікація

Налаштування Microsoft Entra ID та SSO.

Integrations

Налаштування інтеграції

Каталог

Вихідні канали

Передумови

Хто що виконує

Налаштування

Ребрендинг регіонального пакета

Видавець і контрольна сума

Необов’язково: увімкнення резервного пошуку за адресою електронної пошти/UPN

Типи сповіщень

Налаштування вигляду

Оновлення або видалення застосунку

Усунення несправностей

Безпека

Пов’язані матеріали

Інтеграція з електронною поштою

Інтеграція зі Slack

Communication Log

Автентифікація

Integrations

Налаштування інтеграції

Каталог

Вихідні канали

​Передумови

​Хто що виконує

​Налаштування

​Ребрендинг регіонального пакета

​Видавець і контрольна сума

​Необов’язково: увімкнення резервного пошуку за адресою електронної пошти/UPN

​Типи сповіщень

​Налаштування вигляду

​Оновлення або видалення застосунку

​Усунення несправностей

​Безпека

​Пов’язані матеріали

Інтеграція з електронною поштою

Інтеграція зі Slack

Communication Log

Автентифікація

Передумови

Хто що виконує

Налаштування

Ребрендинг регіонального пакета

Видавець і контрольна сума

Необов’язково: увімкнення резервного пошуку за адресою електронної пошти/UPN

Типи сповіщень

Налаштування вигляду

Оновлення або видалення застосунку

Усунення несправностей

Безпека

Пов’язані матеріали