> ## 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. # Integrace Microsoft Teams > Propojte Living Security s Microsoft Teams a odesílejte oznámení o školení, bezpečnostní upozornění a oznámení v kanálech. 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í 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. 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. 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](#vlastn%C3%AD-branding-region%C3%A1ln%C3%ADho-bal%C3%AD%C4%8Dku). Kontrolní součet staženého souboru odpovídá kontrolnímu součtu SHA256 zobrazenému v Living Security. 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. 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. 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. 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**. 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](/cs/features/communications/log). ## 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 soubor ZIP. Obsahuje přesně tři soubory v kořenovém adresáři archivu: `manifest.json`, `color.png` a `outline.png`. 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ů | 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. 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. 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 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: ```text theme={null} 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](#vlastn%C3%AD-branding-region%C3%A1ln%C3%ADho-bal%C3%AD%C4%8Dku). ## 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](#vlastn%C3%AD-branding-region%C3%A1ln%C3%ADho-bal%C3%AD%C4%8Dku). 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íží * 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 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. 1. Otevřete **Nastavení → Komunikace → Kanály → Microsoft Teams**. Můžete také použít **Open Microsoft Teams setup** z chyby v protokolu komunikace. 2. Ověřte, že je připojeno správné ID tenanta Microsoft Entra. 3. 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. 4. 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á. * 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íží: ```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" } } ``` ## 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í Nakonfigurujte e-mail jako kanál doručování. Nakonfigurujte Slack jako kanál doručování. Sledujte stav a historii doručování v Teams. Konfigurace Microsoft Entra ID a SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.