> ## 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. # Integration med Microsoft Teams > Forbind Living Security med Microsoft Teams for at sende træningsnotifikationer, sikkerhedsadvarsler og kanalmeddelelser. Integrationen med Microsoft Teams sender notifikationer fra Living Security til brugere og kanaler via Living Security Teams-appen. Brug den til træningstildelinger, advarsler om menneskelig risiko, udrulningsmeddelelser og meddelelser fra sikkerhedsteamet. Denne integration er kun til notifikationer. Brugere sender ikke kommandoer til botten i Microsoft Teams. Når appen er installeret, gemmer botten Teams-samtalereferencen til fremtidige proaktive notifikationer. Installationsmeddelelser er envejs og kan tilpasses eller deaktiveres i overensstemmelse med virksomhedens krav til udrulning. En Microsoft Teams-administrator skal stadig uploade, godkende og distribuere Living Security Teams-appen. Administratorsamtykke i Microsoft Entra `User.Read.All` er valgfrit og aktiverer udelukkende en reservemetode til opslag via e-mail eller brugerhovednavn (UPN). Ved opsætning af levering af nudges og playbooks skal du starte under **Indstillinger → kommunikation → kanaler** og klikke på kortet **Microsoft Teams**. Denne side beskriver den underliggende konfiguration af Teams-appen. ## Forudsætninger Før du konfigurerer Microsoft Teams, skal du sikre, at du har følgende: * En Microsoft Teams-administrator, der kan uploade og godkende organisationens apps. Samme person kan have begge administratorroller. * En Microsoft Entra-administrator, kun hvis du vil aktivere den valgfrie reservemetode til opslag via e-mail/UPN med applikationssamtykke for hele tenanten til `User.Read.All` * Administratorrettigheder i Living Security * En aktiv Living Security-organisation * Navnene på de teams og kanaler, hvor sikkerhedsmeddelelser skal leveres, hvis kanalmeddelelser er aktiveret * Dit Microsoft Entra-tenant-id, som findes under **Microsoft Entra admin center → Identitet → Oversigt** ## Hvem gør hvad | Rolle | Ansvar | | - | - | | **Living Security-administrator** | Forbinder Microsoft-tenanten, downloader den regionale pakke, konfigurerer installationsmeddelelser, validerer opsætningen og sender tests | | **Microsoft Teams-administrator** | Uploader og tillader appen, distribuerer den til de tiltænkte brugere eller grupper og tildeler politikker for appopsætning | | **Microsoft Entra-administrator**, valgfri | Giver `User.Read.All`-applikationssamtykke til den regionale Bot-app-id, når reservemetoden til opslag via e-mail/UPN er påkrævet | | **Teams-ejer**, når kanallevering anvendes | Installerer eller godkender appen for det tiltænkte team og den tiltænkte kanal | Rollerne kan varetages af forskellige personer. Del pakkens kontrolsum, Teams-app-id'et, **Bot-app-id'et** og den tiltænkte udrulningsgruppe med Microsoft Teams-administratoren. Del den genererede samtykke-URL med en Microsoft Entra-administrator, kun når du aktiverer den valgfrie reservemetode til opslag via e-mail/UPN. Del ikke andre Living Security-legitimationsoplysninger. ## Opsætning Gå til **Indstillinger → kommunikation → kanaler** i Living Security, og vælg **Microsoft Teams**. Panelet viser din organisations region, pakkens filnavn, Teams-app-id, bot-app-id, SHA256-kontrolsum, status for Microsoft-tenantkonfigurationen, installationsvejledning, indstillinger for installationsmeddelelser samt værktøjer til validering og testnotifikationer. Den region, der vises i Living Security, svarer til den region, hvor din organisation er hostet. Under **Connect your tenant** skal du angive det Microsoft Entra-tenant-id, der ejer de brugere og Teams-kanaler, som modtager notifikationer, og derefter klikke på **Save Microsoft tenant**. Én Microsoft-tenant kan kun tilhøre én Living Security-organisation. Hvis tenantindstillingen ikke er tilgængelig, skal du kontakte din Living Security-implementeringsansvarlige eller support for at forbinde eller ændre tenanten, før appen installeres. Living Security viser **Microsoft tenant connected**, før du fortsætter. Forbind om muligt tenanten, før du installerer Teams-appen. Hvis appen allerede er installeret, skal du først gemme tenanten og vælge **Validate install**. Living Security forsøger automatisk at knytte den eksisterende installation til tenanten; geninstaller kun, hvis valideringen ikke kan registrere den. Klik på **Download Teams package**. Living Security leverer en regionsspecifik ZIP-pakke til din organisation. Kontrollér den downloadede fil mod den SHA256-kontrolsum, der vises i Living Security, før du ændrer noget. Hvis du vil give appen dit eget navn og egne ikoner, skal du følge [Tilpas den regionale pakke med eget brand](#tilpas-den-regionale-pakke-med-eget-brand) efter denne kontrol og før du uploader pakken. Kontrolsummen for den downloadede fil svarer til den SHA256-kontrolsum, der vises i Living Security. I Microsoft Teams admin center skal du gå til **Teams apps → Manage apps → Actions → Upload new app** og derefter uploade den ZIP-fil, du downloadede fra Living Security. Bekræft følgende: * Teams-app-id'et og bot-app-id'et svarer til de værdier, der vises i Living Security * Appens navn er det regionale Living Security-navn, eller det navn du har angivet, hvis du har tilpasset pakken med eget brand * Udgiveren er **Living Security**. Tilpasning af pakken med eget brand ændrer ikke udgiveren * Appen er ikke blokeret * Appen er tilgængelig for de tiltænkte brugere eller grupper * Appen er installeret via politikker for appopsætning eller målrettet installation for de brugere og teams/kanaler, der skal modtage notifikationer Det kan tage tid, før Microsoft har udbredt ændringer i appens tilgængelighed og i politikker for appopsætning. Hvis validering eller en test mislykkes umiddelbart efter en ændring af apppolitikken, skal du kontrollere politiktildelingen i Microsoft Teams admin center og prøve igen, når Microsoft er færdig med at udbrede den. Distribuer den personlige app til de tiltænkte brugere. Før Living Security kan sende en personlig test til en registreret installation, skal mindst én bruger installere eller åbne den personlige Living Security-app i Microsoft Teams. Det gør det muligt for botten at registrere brugerens betroede identitet og personlige samtalereference. En kanalinstallation alene kan ikke bruges til en personlig test af en registreret installation. Ved kanallevering skal du installere appen i det tiltænkte team og den tiltænkte kanal, så botten kan registrere kanalens samtalereference. En målbruger har installeret eller åbnet den personlige app, eller appen er installeret i den tiltænkte kanal. Under afsnittet **Install message controls** kan du vælge, om der sendes installationsmeddelelser i Teams, og tilpasse den envejs tekst til din organisation. Tilgængelige indstillinger: * Send install messages * Send personal install messages * Send channel install messages * Default message * Personal message * Channel message Meddelelsesfelterne understøtter `{{installerName}}`, som erstattes af visningsnavnet på den bruger, der installerede appen. Lad en personlig meddelelse eller kanalmeddelelse stå tom for at bruge din konfigurerede standardmeddelelse. Hvis standardmeddelelsen også er tom, bruger Living Security den indbyggede meddelelse for det pågældende område. Klik på **Validate install** i Living Security. Valideringen kontrollerer, at den regionale pakke er tilgængelig, at Microsoft-tenantkonfigurationen findes og er unik for denne Living Security-organisation, at regionale bot-legitimationsoplysninger er konfigureret, og at der er registreret en aktiv appinstallation for den forbundne tenant. Valideringen viser **Validation passed**, før du sender live-notifikationer. Til den personlige standardtest skal du klikke på **Send test to detected installation**. Living Security vælger en registreret aktiv personlig installation og bruger dens gemte betroede identitet og samtalereference. Denne test kalder ikke Microsoft Graph og kræver ikke `User.Read.All`-samtykke. Hvis der ikke registreres nogen personlig installation, skal du bede en bruger om at installere eller åbne den personlige Living Security-app, vælge **Validate install** igen og derefter sende testen igen. Brug kun den avancerede målrettede e-mail/UPN-test, når den valgfrie reservemetode til opslag er aktiveret. Envejs-testnotifikationen vises i Microsoft Teams. Gennemgå det tilsvarende forsøg i [kommunikationsloggen](/da/features/communications/log), når der er behov for leveringsdiagnostik. ## Tilpas den regionale pakke med eget brand Den regionale pakke er et ZIP-arkiv med tre filer: `manifest.json`, `color.png` og `outline.png`. Du kan angive dit eget appnavn og egne ikoner i pakken, før du uploader den. Living Security understøtter denne fremgangsmåde for regionale pakker, som en Teams-administrator uploader direkte. Gør dette, efter du har downloadet og kontrolleret pakken, og før du uploader den i Teams admin center. Udpak ZIP-filen. Den indeholder nøjagtigt tre filer i arkivets rod: `manifest.json`, `color.png` og `outline.png`. Udskift `color.png` og `outline.png` med dine egne ikoner. Behold de samme to filnavne. | Fil | Krav | | - | - | | `color.png` | PNG i fuld farve, 192 × 192 pixel, uden gennemsigtighed | | `outline.png` | Gennemsigtig PNG, 32 × 32 pixel | Rediger disse to felter i `manifest.json`: * `name.short` — navnet, der vises i Teams' appheader og andre steder med begrænset plads. Maksimalt 30 tegn. * `name.full` — navnet, der vises i appkataloget og appoplysningerne. Maksimalt 100 tegn. Hvis en Living Security-app allerede er uploadet i Teams admin center, skal du angive `version` højere end den version, der er installeret dér. Microsoft Teams afviser en opdatering, der ikke øger versionen, og en ny download kan have samme version som eller en lavere version end den pakke, du allerede har installeret. Du kan se den installerede version i Teams admin center under **Teams apps → Manage apps** på appens detaljeside. Sammenlign den med værdien `version` i den `manifest.json`, du netop har downloadet, og angiv derefter en værdi, der er højere end begge. Behold formatet `MAJOR.MINOR.PATCH` med tre tal. Hvis den installerede app for eksempel er `1.1.1`, og din nye download er `1.1.0`, skal du angive `1.1.2`. Hvis du hæver den downloadede `1.1.0` til `1.1.1`, ville det gentage den installerede version, og Teams ville afvise uploaden. Du må ikke ændre disse felter. Hvert af dem bærer app-, bot- eller single sign-on- identiteten: * `id` * `botId` i `bots` * `webApplicationInfo` * `validDomains` * `contentUrl` og `websiteUrl` i `staticTabs` En ændring af et identitetsfelt kan medføre, at appen stadig kan installeres, men ikke kan levere notifikationer eller gennemføre single sign-on. **Validate install** kontrollerer tenanten, bot-legitimationsoplysningerne og den registrerede installation. Den sammenligner ikke dit manifest med den pakke, som Living Security har bygget. Opret et nyt ZIP-arkiv af de tre filer. Placér dem i arkivets rod uden en omsluttende mappe. Microsoft Teams afviser en pakke, hvor `manifest.json` ligger i en mappe. Upload den ZIP-fil, du har tilpasset med eget brand, i Teams admin center, og vend derefter tilbage til Living Security og klik på **Validate install**. Send en testnotifikation. Valideringen viser **Validation passed**, og testnotifikationen vises i Microsoft Teams under dit appnavn og dine ikoner. ### Udgiver og kontrolsum Tilpasning med eget brand ændrer appnavn og ikoner. Det ændrer ikke to ting: * **Udgiveren forbliver Living Security.** Manifestfelterne `developer` angiver Living Security og linker til Living Securitys websted, privatlivspolitik og servicevilkår. Sammen identificerer de den virksomhed, der driver tjenesten, så Teams fortsat viser **Living Security** som udgiver på appens detaljeside, i dialogbokse til samtykke til tilladelser og i rapporter om appbrug. Dit navn og dine ikoner er det, brugerne ser i appheaderen, appkataloget og notifikationerne. * **SHA256-kontrolsummen svarer ikke længere til pakken.** Den kontrolsum, der vises i Living Security, beskriver pakken, som den blev downloadet. Kontrollér den, før du redigerer filerne, og notér derefter kontrolsummen for din egen pakke med eget brand til dine udrulningsoptegnelser. ## Valgfrit: Aktivér reservemetode til opslag via e-mail/UPN Normal personlig levering bruger et betroet Microsoft Entra-objekt-id, som Living Security allerede kender, sammen med den botsamtalereference, der registreres, når brugeren installerer eller åbner appen. Kanallevering bruger den gemte samtalereference for kanalen. Ingen af metoderne kræver Microsoft Graph. Hvis en modtager ikke har et betroet Entra-objekt-id, kan Living Security valgfrit bruge Microsoft Graph til at finde modtageren via e-mailadresse eller UPN. For at aktivere denne reservemetode skal en Microsoft Entra-administrator klikke på **Grant optional User.Read.All consent** i Teams-opsætningspanelet og godkende Microsoft Graph-applikationstilladelsen `User.Read.All` for den regionale Living Security Teams-applikation. Flowet for administratorsamtykke følger dette Microsoft Entra-mønster: ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security genererer denne URL ud fra det forbundne tenant-id og det **Bot app ID**, der vises i opsætningspanelet. Id'erne tjener forskellige formål: * **Teams app ID** identificerer den installerbare apppakke i Microsoft Teams admin center. * **Bot app ID** identificerer den regionale bots Microsoft Entra-applikation og er det klient-id, der bruges i det valgfrie flow for administratorsamtykke. Erstat ikke samtykke-URL'en med Teams-app-id'et. Integrationen **Microsoft Entra ID (Client Credentials)** under Connected Integrations er en separat, generisk integration. Dens legitimationsoplysninger eller samtykke kan ikke genbruges af den regionale Teams-bot, og samtykke givet til en urelateret Entra-applikation aktiverer ikke denne reservemetode. Når samtykke gøres valgfrit, fjernes `User.Read.All` ikke fra eksisterende regionale Living Security-applikationsregistreringer. Kunder, der allerede har givet samtykke, kan fortsætte med at bruge reservemetoden via e-mail/UPN uden omkonfigurering. ## Notifikationstyper Afhængigt af din organisations rettigheder og konfigurerede playbooks kan Living Security sende: | Notifikation | Beskrivelse | | - | - | | Træningstildelinger | Underretter brugere, når træning er tildelt, forfalder eller er klar til gennemførelse | | Træningspåmindelser | Minder brugere om forestående frister | | Advarsler om menneskelig risiko | Sender personlige opdateringer af Indeks for menneskelig risiko og anbefalede næste skridt | | Udrulningsmeddelelser | Sender envejs-notifikationer om onboarding eller udrulning under implementeringen | | Kanalmeddelelser | Opslår kommunikation fra sikkerhedsprogrammet i konfigurerede Teams-kanaler | ## Tilpasning Teams-notifikationer bruger konfigurationen af din Living Security-organisation. Understøttede felter omfatter kundens visningsnavn, understøttede logo- og brandfelter, meddelelsestekst, opfordringer til handling, destinationslinks, udrulningstekst samt tekst om support og kontakt. Installationsmeddelelser kan konfigureres under **Indstillinger → kommunikation → kanaler → Microsoft Teams → Install message controls**. Du kan deaktivere installationsmeddelelser helt, deaktivere kun personlige installationsmeddelelser eller kanalinstallationsmeddelelser og konfigurere standardtekst, personlig tekst eller kanalspecifik tekst. Teams-appens navn og ikoner stammer fra den regionale pakke. Du kan angive dine egne ved at følge [Tilpas den regionale pakke med eget brand](#tilpas-den-regionale-pakke-med-eget-brand). ## Opdatering eller fjernelse af appen * Når Living Security leverer en opdateret regional pakke, skal du downloade den fra panelet for Microsoft Teams-kanalen og uploade pakken via Teams admin center. Kontrollér det viste app-id, bot-id og den viste kontrolsum før udrulning. * Ændringer af branding bevares ikke ved en pakkeopdatering. Hver ny regional pakke har igen Living Security-appens navn og ikoner. Gentag dine ændringer ved at følge [Tilpas den regionale pakke med eget brand](#tilpas-den-regionale-pakke-med-eget-brand), før du uploader den nye pakke. Opbevar dine ikoner, dine to navneværdier og den version, du senest uploadede, et sted, hvor du kan finde dem, så hver opgradering blot er en kort gentagelse af de samme trin. En ny pakke har ikke altid en højere version end den, du har installeret, så angiv versionen ud fra det, som Teams viser som installeret. * Kør **Validate install** igen, og send endnu en test efter en app- eller politikopdatering. * Hvis appen fjernes eller blokeres, forhindres proaktive notifikationer til den pågældende bruger eller kanal. Geninstaller appen, og send en ny test, så Living Security modtager en aktuel installationshændelse fra Teams. * Hvis du ophører med levering via Teams, skal du fjerne Teams fra de relevante playbooks, før du fjerner appen fra Microsoft Teams. ## Fejlfinding * Bekræft, at den personlige Living Security Teams-app er installeret, og at brugeren har åbnet den, så Living Security har en aktuel samtalereference * Bekræft, at det konfigurerede Microsoft-tenant-id er den tenant, hvor brugeren er placeret * Hvis diagnostikken viser, at reservemetoden via e-mail/UPN blev forsøgt, skal du bekræfte, at `User.Read.All`-administratorsamtykke blev givet til det viste Bot app ID for den korrekte tenant * Når reservemetoden via e-mail/UPN anvendes, skal du kontrollere, at brugerens e-mail eller UPN i Living Security svarer til Microsoft Entra ID * Bed brugeren om at fjerne blokeringen af appen eller geninstallere den, hvis vedkommende tidligere har fjernet eller blokeret den Fejlkategorien `TEAMS_ADMIN_CONSENT_REQUIRED` eller Microsoft-fejlen `AADSTS7000229` betyder, at et opslag af modtager via e-mail/UPN forsøgte den valgfrie Microsoft Graph-reservemetode, men at den regionale Living Security Teams-app ikke har nogen tjenesteprincipal (virksomhedsapplikation) i den forbundne Microsoft Entra-tenant. Standardmetoderne med betroet id og gemt samtale kræver ikke dette samtykke. Dette er ikke en udløbet Living Security-hemmelighed. 1. Åbn **Indstillinger → kommunikation → kanaler → Microsoft Teams**. Du kan også bruge **Open Microsoft Teams setup** fra fejlen i kommunikationsloggen. 2. Bekræft, at det korrekte Microsoft Entra-tenant-id er forbundet. 3. Hvis reservemetoden via e-mail/UPN er påkrævet, skal du bede en Microsoft Entra-administrator om at klikke på **Grant optional User.Read.All consent** og godkende `User.Read.All` for det viste **Bot app ID**. Ellers skal du sikre, at modtageren har åbnet den personlige app, og at Living Security har modtagerens betroede Entra-objekt-id. 4. Når Microsoft er færdig med at behandle samtykket, skal du sende en avanceret målrettet e-mail/UPN-test fra Microsoft Teams-opsætningen. Kommunikationsloggen viser leveringshistorik og diagnostik; den leverer ikke den mislykkede meddelelse igen. Omkonfigurering af **Microsoft Entra ID (Client Credentials)** løser ikke denne fejl, fordi den integration ikke bruges til levering af Teams-notifikationer. * Kontrollér, om botten er blevet blokeret, fjernet eller afinstalleret * Hvis appen blev installeret, før tenanten blev forbundet i Living Security, skal du gemme tenanten og vælge **Validate install**, så Living Security kan knytte den eksisterende installation til tenanten * Geninstaller kun, hvis valideringen ikke kan registrere den eksisterende installation * Bekræft, at målbrugeren eller målkanalen har modtaget den seneste installationshændelse for appen * Send en ny testnotifikation efter geninstallation af appen Eksempel på felter i installationshændelser, der bruges til fejlfinding: ```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" } } ``` ## Sikkerhed Living Security bruger Microsoft Graph `User.Read.All` udelukkende til den valgfrie reservemetode til opslag af modtagere via e-mail/UPN. Som standard bruger routing af personlige notifikationer et betroet Entra-objekt-id fra Living Securitys enhedsdata og den botsamtalereference, der er registreret fra Microsoft Teams. Objekt-id'er og samtalereferencer, som en kalder angiver, betragtes ikke som betroede routingdata. Microsoft Teams-meddelelser leveres via Living Securitys Teams-bot, der kun er til notifikationer, ved hjælp af proaktiv meddelelsesformidling i Microsoft Teams. Living Security kræver ikke, at kunder opretter deres egen Microsoft Entra-appregistrering eller deler en kundeejet klienthemmelighed ved den almindelige opsætning af Teams-appen. Regionsspecifikke Teams-pakker holder app-id, bot-id og meddelelsesendepunkt afstemt med den Living Security-region, hvor din organisation er hostet. ## Relateret Konfigurer e-mail som leveringskanal. Konfigurer Slack som leveringskanal. Følg status og historik for levering via Teams. Konfiguration af Microsoft Entra ID og SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.