Integrace Microsoft Teams

Integrace Microsoft Teams odesílá oznámení Living Security uživatelům a do kanálů prostřednictvím aplikace Living Security pro Teams. Použijte ji pro přidělení školení, upozornění na lidské riziko, zprávy k zavedení a oznámení bezpečnostního týmu. Tato integrace slouží pouze k odesílání oznámení. Uživatelé neposílají botovi v Microsoft Teams žádné příkazy. Po instalaci aplikace bot uloží referenci konverzace v Teams pro budoucí proaktivní oznámení. Instalační zprávy jsou jednosměrné a lze je upravit nebo zakázat podle požadavků na podnikové zavedení.

Správce Microsoft Teams musí aplikaci Living Security pro Teams i nadále nahrát, schválit a distribuovat. Souhlas správce Microsoft Entra User.Read.All je volitelný a umožňuje pouze záložní vyhledávání podle e-mailu nebo hlavního názvu uživatele (UPN).

Pro nastavení doručování postrčení a playbooků začněte v části Nastavení → Komunikace → Kanály a klikněte na kartu Microsoft Teams. Tato stránka popisuje základní konfiguraci aplikace pro Teams.

Předpoklady

Před konfigurací Microsoft Teams se ujistěte, že máte k dispozici:

Správce Microsoft Teams, který může nahrávat a schvalovat aplikace organizace. Obě role správce může zastávat tatáž osoba.
Správce Microsoft Entra, pouze pokud chcete povolit volitelné záložní vyhledávání podle e-mailu/UPN se souhlasem s aplikačním oprávněním User.Read.All pro celého tenanta
Oprávnění správce Living Security
Aktivní organizaci v Living Security
Názvy týmů a kanálů, do kterých se mají doručovat bezpečnostní oznámení, pokud jsou povolena oznámení v kanálech
ID vašeho tenanta Microsoft Entra, které najdete v Microsoft Entra admin center → Identita → Přehled

Kdo za co odpovídá

Role	Odpovědnost
Správce Living Security	Připojí tenanta Microsoft, stáhne regionální balíček, nakonfiguruje instalační zprávy, ověří nastavení a odešle testy
Správce Microsoft Teams	Nahraje a povolí aplikaci, distribuuje ji zamýšleným uživatelům nebo skupinám a přiřadí zásady nastavení aplikací
Správce Microsoft Entra, volitelně	Udělí aplikační souhlas `User.Read.All` regionální aplikaci bota (Bot app ID), pokud je vyžadováno záložní vyhledávání podle e-mailu/UPN
Vlastník týmu v Teams, při doručování do kanálů	Nainstaluje nebo schválí aplikaci pro zamýšlený tým a kanál

Může se jednat o různé osoby. Sdílejte se správcem Microsoft Teams kontrolní součet balíčku, ID aplikace Teams, Bot app ID a zamýšlenou skupinu uživatelů pro zavedení. Vygenerovanou adresu URL pro souhlas sdílejte se správcem Microsoft Entra pouze při povolování volitelného záložního vyhledávání podle e-mailu/UPN. Nesdílejte žádné nesouvisející přihlašovací údaje Living Security.

Nastavení

Otevřete panel nastavení Microsoft Teams

V Living Security přejděte do Nastavení → Komunikace → Kanály a vyberte Microsoft Teams.Panel zobrazuje region vaší organizace, název souboru balíčku, ID aplikace Teams, ID aplikace bota, kontrolní součet SHA256, stav konfigurace tenanta Microsoft, pokyny k instalaci, ovládací prvky instalačních zpráv, ověření a nástroje pro testovací oznámení.

Region zobrazený v Living Security odpovídá regionu, ve kterém je vaše organizace hostována.

Připojte svého tenanta Microsoft

V části Connect your tenant zadejte ID tenanta Microsoft Entra, do kterého patří uživatelé a kanály Teams přijímající oznámení, a poté klikněte na Save Microsoft tenant. Jeden tenant Microsoft může patřit pouze jedné organizaci v Living Security.Pokud je ovládací prvek pro tenanta nedostupný, obraťte se před instalací aplikace na vlastníka implementace Living Security nebo na podporu, aby tenanta připojili nebo změnili.

Před pokračováním Living Security zobrazí Microsoft tenant connected.

Pokud je to možné, připojte tenanta před instalací aplikace pro Teams. Pokud je aplikace již nainstalována, uložte tenanta a nejprve vyberte Validate install. Living Security se pokusí existující instalaci přiřadit automaticky; aplikaci přeinstalujte pouze v případě, že ji ověření nedokáže zjistit.

Stáhněte regionální balíček pro Teams

Klikněte na Download Teams package. Living Security poskytne pro vaši organizaci balíček ZIP specifický pro region.Než cokoli změníte, ověřte stažený soubor podle kontrolního součtu SHA256 zobrazeného v Living Security. Chcete-li aplikaci dát vlastní název a ikony, postupujte po této kontrole a před nahráním balíčku podle části Vlastní branding regionálního balíčku.

Kontrolní součet staženého souboru odpovídá kontrolnímu součtu SHA256 zobrazenému v Living Security.

Nahrajte a nainstalujte balíček v Teams admin center

V Microsoft Teams admin center přejděte do Teams apps → Manage apps → Actions → Upload new app a nahrajte soubor ZIP stažený z Living Security.Ověřte následující:

ID aplikace Teams a ID aplikace bota odpovídají hodnotám zobrazeným v Living Security
Název aplikace je regionální název Living Security, nebo název, který jste nastavili při vlastním brandingu balíčku
Vydavatelem je Living Security. Vlastní branding balíčku vydavatele nemění
Aplikace není blokována
Aplikace je dostupná zamýšleným uživatelům nebo skupinám
Aplikace je nainstalována prostřednictvím zásad nastavení aplikací nebo cílené instalace pro uživatele a týmy/kanály, které mají oznámení přijímat

Šíření dostupnosti aplikace a změn zásad nastavení v Microsoftu může chvíli trvat.

Pokud ověření nebo test selže bezprostředně po změně zásad aplikace, zkontrolujte přiřazení zásady v Microsoft Teams admin center a zkuste to znovu po dokončení jejího šíření v Microsoftu.

Nainstalujte nebo otevřete aplikaci

Distribuujte osobní aplikaci zamýšleným uživatelům. Aby mohla Living Security odeslat osobní test na zjištěnou instalaci, musí alespoň jeden uživatel v Microsoft Teams nainstalovat nebo otevřít osobní aplikaci Living Security. Tím bot získá důvěryhodnou identitu uživatele a referenci jeho osobní konverzace. Samotná instalace v kanálu nelze pro osobní test na zjištěnou instalaci použít.Pro doručování do kanálu nainstalujte aplikaci do zamýšleného týmu a kanálu, aby bot mohl získat referenci konverzace tohoto kanálu.

Cílový uživatel nainstaloval nebo otevřel osobní aplikaci, nebo je aplikace nainstalována v zamýšleném kanálu.

Nakonfigurujte instalační zprávy

V části Install message controls zvolte, zda se instalační zprávy v Teams odesílají, a upravte jednosměrné znění pro svou organizaci.Dostupné ovládací prvky:

Send install messages
Send personal install messages
Send channel install messages
Default message
Personal message
Channel message

Pole zpráv podporují {{installerName}}, které se nahradí zobrazovaným jménem uživatele, který aplikaci nainstaloval. Ponecháte-li osobní nebo kanálovou zprávu prázdnou, použije se vaše nakonfigurovaná výchozí zpráva. Pokud je prázdná i výchozí zpráva, Living Security použije pro daný rozsah vestavěnou zprávu.

Ověřte nastavení

V Living Security klikněte na Validate install. Ověření kontroluje, zda je dostupný regionální balíček, zda je konfigurace tenanta Microsoft přítomná a jedinečná pro tuto organizaci v Living Security, zda jsou nakonfigurovány přihlašovací údaje regionálního bota a zda byla pro připojeného tenanta zjištěna aktivní instalace aplikace.

Před odesíláním ostrých oznámení ověření zobrazí Validation passed.

Odešlete testovací oznámení

Pro výchozí osobní test klikněte na Send test to detected installation. Living Security vybere zjištěnou aktivní osobní instalaci a použije její uloženou důvěryhodnou identitu a referenci konverzace. Tento test nevolá Microsoft Graph a nevyžaduje souhlas User.Read.All.Pokud není zjištěna žádná osobní instalace, požádejte uživatele, aby nainstaloval nebo otevřel osobní aplikaci Living Security, znovu vyberte Validate install a poté test odešlete znovu. Pokročilý cílený test podle e-mailu/UPN použijte pouze v případě, že je povoleno volitelné záložní vyhledávání.

Jednosměrné testovací oznámení se zobrazí v Microsoft Teams.

Pokud potřebujete diagnostiku doručení, prohlédněte si příslušný pokus v protokolu komunikace.

Vlastní branding regionálního balíčku

Regionální balíček je archiv ZIP se třemi soubory: manifest.json, color.png a outline.png. Před nahráním můžete v tomto balíčku nastavit vlastní název aplikace a ikony. Living Security tuto možnost podporuje u regionálních balíčků, které správce Teams nahrává přímo. Postupujte po stažení a ověření balíčku a před jeho nahráním v Teams admin center.

Rozbalte balíček

Rozbalte soubor ZIP. Obsahuje přesně tři soubory v kořenovém adresáři archivu: manifest.json, color.png a outline.png.

Nahraďte ikony

Nahraďte color.png a outline.png vlastními ikonami. Zachovejte stejné dva názvy souborů.

Soubor	Požadavek
`color.png`	Plnobarevný PNG, 192 × 192 pixelů, bez průhlednosti
`outline.png`	Průhledný PNG, 32 × 32 pixelů

Nastavte název aplikace

V manifest.json upravte tato dvě pole:

name.short — název zobrazený v záhlaví aplikace v Teams a v dalších oblastech s omezeným prostorem. Maximálně 30 znaků.
name.full — název zobrazený v katalogu aplikací a v podrobnostech aplikace. Maximálně 100 znaků.
Pokud je aplikace Living Security již v Teams admin center nahrána, nastavte version na vyšší hodnotu, než je verze zde nainstalovaná. Microsoft Teams odmítne aktualizaci, která verzi nezvýší, a nově stažený balíček může mít stejnou nebo nižší verzi než balíček, který jste již nainstalovali.Nainstalovanou verzi zjistíte v Teams admin center v části Teams apps → Manage apps na stránce podrobností aplikace. Porovnejte ji s hodnotou version v právě staženém manifest.json a nastavte hodnotu vyšší než obě. Zachovejte formát MAJOR.MINOR.PATCH se třemi čísly.Například pokud je nainstalovaná aplikace 1.1.1 a nově stažená verze je 1.1.0, nastavte 1.1.2. Zvýšení staženého 1.1.0 na 1.1.1 by zopakovalo nainstalovanou verzi a Teams by nahrání odmítl.

Pole identity ponechte beze změny

Tato pole neměňte. Každé z nich nese identitu aplikace, bota nebo jednotného přihlášení:

id
botId v bots
webApplicationInfo
validDomains
contentUrl a websiteUrl v staticTabs
Změna pole identity může způsobit, že aplikaci bude možné nainstalovat, ale nebude schopna doručovat oznámení ani dokončit jednotné přihlášení. Validate install kontroluje tenanta, přihlašovací údaje bota a zjištěnou instalaci. Neporovnává váš manifest s balíčkem sestaveným společností Living Security.

Znovu zabalte tři soubory do ZIP

Vytvořte nový archiv ZIP ze tří souborů. Umístěte je do kořenového adresáře archivu, bez nadřazené složky. Microsoft Teams odmítne balíček, jehož manifest.json je uvnitř složky.

Nahrajte a ověřte

Nahrajte ZIP s vlastním brandingem v Teams admin center, poté se vraťte do Living Security a klikněte na Validate install. Odešlete testovací oznámení.

Ověření zobrazí Validation passed a testovací oznámení dorazí do Microsoft Teams pod vaším názvem aplikace a s vašimi ikonami.

Vydavatel a kontrolní součet

Vlastní branding nastavuje název aplikace a ikony. Nemění dvě věci:

Vydavatelem zůstává Living Security. Pole developer v manifestu uvádějí Living Security a odkazují na web Living Security, zásady ochrany osobních údajů a smluvní podmínky. Společně identifikují společnost, která službu provozuje, proto Teams nadále zobrazuje jako vydavatele Living Security na stránce podrobností aplikace, v dialozích souhlasu s oprávněními a ve zprávách o používání aplikace. Váš název a ikony uživatelé uvidí v záhlaví aplikace, v katalogu aplikací a v oznámeních.
Kontrolní součet SHA256 již neodpovídá. Kontrolní součet zobrazený v Living Security popisuje balíček tak, jak byl stažen. Ověřte ho před úpravou souborů a poté zaznamenejte kontrolní součet vlastního balíčku s upraveným brandingem pro své záznamy o zavedení.

Volitelné: Povolení záložního vyhledávání podle e-mailu/UPN

Běžné doručování osobních oznámení využívá důvěryhodné ID objektu Microsoft Entra, které Living Security již zná, spolu s referencí konverzace bota získanou při instalaci nebo otevření aplikace uživatelem. Doručování do kanálů využívá uloženou referenci konverzace kanálu. Žádná z těchto cest nevyžaduje Microsoft Graph. Pokud příjemce nemá důvěryhodné ID objektu Entra, může Living Security volitelně použít Microsoft Graph k vyhledání příjemce podle e-mailové adresy nebo UPN. Chcete-li toto záložní vyhledávání povolit, požádejte správce Microsoft Entra, aby v panelu nastavení Teams klikl na Grant optional User.Read.All consent a schválil aplikační oprávnění Microsoft Graph User.Read.All pro regionální aplikaci Living Security pro Teams. Tok souhlasu správce odpovídá tomuto vzoru Microsoft Entra:

https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}

Living Security tuto adresu URL vygeneruje z ID připojeného tenanta a Bot app ID zobrazeného v panelu nastavení. ID slouží k různým účelům:

Teams app ID identifikuje instalovatelný balíček aplikace v Microsoft Teams admin center.
Bot app ID identifikuje aplikaci Microsoft Entra regionálního bota a je ID klienta používaným pro volitelný tok souhlasu správce.

V adrese URL pro souhlas nenahrazujte Bot app ID hodnotou Teams app ID. Integrace Microsoft Entra ID (Client Credentials) v části Connected Integrations je samostatná, obecná integrace. Její přihlašovací údaje ani souhlas nemůže regionální bot pro Teams znovu použít a souhlas udělený nesouvisející aplikaci Entra toto záložní vyhledávání neumožní.

Skutečnost, že souhlas je volitelný, neodstraňuje User.Read.All ze stávajících regionálních registrací aplikací Living Security. Zákazníci, kteří souhlas již udělili, mohou záložní vyhledávání podle e-mailu/UPN nadále používat bez nové konfigurace.

Typy oznámení

V závislosti na oprávněních vaší organizace a nakonfigurovaných playbookách může Living Security odesílat:

Oznámení	Popis
Přidělení školení	Upozorní uživatele, když je školení přiděleno, má termín nebo je připraveno k dokončení
Připomenutí školení	Připomene uživatelům blížící se termíny
Upozornění na lidské riziko	Odesílá personalizované aktualizace Indexu lidského rizika a doporučené další kroky
Zprávy k zavedení	Odesílá jednosměrná oznámení k zaškolení nebo zavedení během nasazení
Oznámení v kanálech	Zveřejňuje komunikaci bezpečnostního programu v nakonfigurovaných kanálech Teams

Přizpůsobení

Oznámení v Teams využívají konfiguraci vaší organizace v Living Security. Podporovaná pole zahrnují zobrazovaný název zákazníka, podporovaná pole loga a značky, text zpráv, výzvy k akci, cílové odkazy, text k zavedení a text podpory/kontaktů. Instalační zprávy lze konfigurovat v části Nastavení → Komunikace → Kanály → Microsoft Teams → Install message controls. Instalační zprávy můžete zcela zakázat, zakázat pouze osobní nebo kanálové instalační zprávy a nakonfigurovat výchozí, osobní nebo kanálově specifické znění. Název aplikace a ikony v Teams pocházejí z regionálního balíčku. Chcete-li nastavit vlastní, viz Vlastní branding regionálního balíčku.

Aktualizace nebo odebrání aplikace

Když Living Security poskytne aktualizovaný regionální balíček, stáhněte jej z panelu kanálu Microsoft Teams a nahrajte jej prostřednictvím Teams admin center. Před zavedením ověřte zobrazené ID aplikace, ID bota a kontrolní součet.
Úpravy brandingu aktualizaci balíčku nepřežijí. Každý nový regionální balíček opět obsahuje název aplikace a ikony Living Security. Před nahráním nového balíčku své úpravy znovu použijte podle části Vlastní branding regionálního balíčku. Své ikony, obě hodnoty názvu a naposledy nahranou verzi uchovávejte na dohledatelném místě, aby byla každá aktualizace krátkým opakováním stejných kroků. Nový balíček nemusí vždy nést vyšší verzi než ta, kterou jste nainstalovali, proto nastavte verzi podle toho, co Teams zobrazuje jako nainstalované.
Po aktualizaci aplikace nebo zásad znovu spusťte Validate install a odešlete další test.
Odebrání nebo zablokování aplikace zabrání proaktivním oznámením danému uživateli nebo kanálu. Aplikaci znovu nainstalujte a odešlete nový test, aby Living Security obdržela aktuální událost instalace v Teams.
Pokud doručování přes Teams ukončujete, odeberte Teams z příslušných playbooků dříve, než aplikaci z Microsoft Teams odeberete.

Řešení potíží

Uživatel neobdrží osobní oznámení

Ověřte, že je osobní aplikace Living Security pro Teams nainstalována a uživatel ji otevřel, aby Living Security měla aktuální referenci konverzace
Ověřte, že nakonfigurované ID tenanta Microsoft je tenant, ve kterém se uživatel nachází
Pokud diagnostika ukazuje, že bylo vyzkoušeno záložní vyhledávání podle e-mailu/UPN, ověřte, že byl souhlas správce User.Read.All udělen zobrazenému Bot app ID pro správného tenanta
Při použití záložního vyhledávání podle e-mailu/UPN ověřte, že se e-mail nebo UPN uživatele v Living Security shoduje s Microsoft Entra ID
Požádejte uživatele, aby aplikaci odblokoval nebo znovu nainstaloval, pokud ji dříve odebral nebo zablokoval

Oznámení v kanálu se nezobrazí

Ověřte, že je aplikace Living Security pro Teams nainstalována v cílovém týmu nebo kanálu.
Ověřte, že mapování kanálu v Living Security používá správný tým a kanál.
Zkontrolujte, zda kanál nebyl odstraněn, přejmenován, archivován nebo omezen.
Aplikaci v cílovém týmu nebo kanálu znovu nainstalujte a odešlete další testovací oznámení.

Volitelné vyhledávání podle e-mailu/UPN nebo souhlas selhává

Ověřte, že správce Microsoft Entra udělil souhlas pro celého tenanta pro Microsoft Graph User.Read.All zobrazenému Bot app ID.
Ověřte, že nakonfigurované ID tenanta je tenant, ve kterém se nacházejí uživatelé a Teams.
Ověřte, že uživatel existuje v Microsoft Entra ID a není hostem z jiného tenanta.

Protokol komunikace zobrazuje, že je vyžadován souhlas správce Microsoft

Kategorie chyby TEAMS_ADMIN_CONSENT_REQUIRED nebo chyba Microsoftu AADSTS7000229 znamená, že vyhledání příjemce podle e-mailu/UPN zkusilo volitelné záložní řešení přes Microsoft Graph, ale regionální aplikace Living Security pro Teams nemá v připojeném tenantovi Microsoft Entra žádný instanční objekt služby (podnikovou aplikaci). Výchozí cesty využívající důvěryhodné ID a uloženou konverzaci tento souhlas nevyžadují. Nejde o vypršelý tajný klíč Living Security.

Otevřete Nastavení → Komunikace → Kanály → Microsoft Teams. Můžete také použít Open Microsoft Teams setup z chyby v protokolu komunikace.
Ověřte, že je připojeno správné ID tenanta Microsoft Entra.
Pokud je záložní vyhledávání podle e-mailu/UPN vyžadováno, požádejte správce Microsoft Entra, aby klikl na Grant optional User.Read.All consent a schválil User.Read.All pro zobrazené Bot app ID. Jinak zajistěte, aby příjemce otevřel osobní aplikaci a aby Living Security měla jeho důvěryhodné ID objektu Entra.
Jakmile Microsoft souhlas zpracuje, odešlete z nastavení Microsoft Teams pokročilý cílený test podle e-mailu/UPN. Protokol komunikace zobrazuje historii doručení a diagnostiku; neodesílá neúspěšnou zprávu znovu.

Překonfigurování Microsoft Entra ID (Client Credentials) tuto chybu neodstraní, protože tato integrace se pro doručování oznámení v Teams nepoužívá.

Aplikace je nainstalována, ale oznámení selhávají

Zkontrolujte, zda bot nebyl zablokován, odebrán nebo odinstalován
Pokud byla aplikace nainstalována před připojením tenanta v Living Security, uložte tenanta a vyberte Validate install, aby mohla Living Security existující instalaci přiřadit
Přeinstalujte pouze v případě, že ověření existující instalaci nezjistí
Ověřte, že cílový uživatel nebo kanál obdržel nejnovější událost instalace aplikace
Po přeinstalaci aplikace odešlete nové testovací oznámení

Příklad polí události instalace používaných při řešení potíží:

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

Zabezpečení

Living Security používá Microsoft Graph User.Read.All pouze pro volitelné záložní vyhledávání příjemců podle e-mailu/UPN. Ve výchozím nastavení používá směrování osobních oznámení důvěryhodné ID objektu Entra z dat entit Living Security a referenci konverzace bota získanou z Microsoft Teams. ID objektů a reference konverzací dodané volajícím nejsou důvěryhodnými směrovacími daty. Zprávy v Microsoft Teams jsou doručovány prostřednictvím bota Living Security pro Teams určeného pouze pro oznámení pomocí proaktivních zpráv Microsoft Teams. Living Security nevyžaduje, aby zákazníci pro standardní nastavení aplikace pro Teams vytvářeli vlastní registraci aplikace Microsoft Entra nebo sdíleli tajný klíč klienta ve vlastnictví zákazníka. Balíčky Teams specifické pro region udržují ID aplikace, ID bota a koncový bod zpráv v souladu s regionem Living Security, ve kterém je vaše organizace hostována.

Související

Integrace e-mailu

Nakonfigurujte e-mail jako kanál doručování.

Integrace Slack

Nakonfigurujte Slack jako kanál doručování.

Protokol komunikace

Sledujte stav a historii doručování v Teams.

Ověřování

Konfigurace Microsoft Entra ID a SSO.

Integrace

Nastavení integrace

Katalog

Odchozí kanály

Předpoklady

Kdo za co odpovídá

Nastavení

Vlastní branding regionálního balíčku

Vydavatel a kontrolní součet

Volitelné: Povolení záložního vyhledávání podle e-mailu/UPN

Typy oznámení

Přizpůsobení

Aktualizace nebo odebrání aplikace

Řešení potíží

Zabezpečení

Související

Integrace e-mailu

Integrace Slack

Protokol komunikace

Ověřování

Integrace

Nastavení integrace

Katalog

Odchozí kanály

​Předpoklady

​Kdo za co odpovídá

​Nastavení

​Vlastní branding regionálního balíčku

​Vydavatel a kontrolní součet

​Volitelné: Povolení záložního vyhledávání podle e-mailu/UPN

​Typy oznámení

​Přizpůsobení

​Aktualizace nebo odebrání aplikace

​Řešení potíží

​Zabezpečení

​Související

Integrace e-mailu

Integrace Slack

Protokol komunikace

Ověřování

Předpoklady

Kdo za co odpovídá

Nastavení

Vlastní branding regionálního balíčku

Vydavatel a kontrolní součet

Volitelné: Povolení záložního vyhledávání podle e-mailu/UPN

Typy oznámení

Přizpůsobení

Aktualizace nebo odebrání aplikace

Řešení potíží

Zabezpečení

Související