Integration med Microsoft Teams

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

Åbn opsætningspanelet for Microsoft Teams

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.

Forbind din Microsoft-tenant

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.

Download den regionale Teams-pakke

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 efter denne kontrol og før du uploader pakken.

Kontrolsummen for den downloadede fil svarer til den SHA256-kontrolsum, der vises i Living Security.

Upload og installér pakken i Teams admin center

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.

Installér eller åbn appen

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.

Konfigurer installationsmeddelelser

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.

Validér opsætningen

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.

Send testnotifikationer

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, 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 pakken

Udpak ZIP-filen. Den indeholder nøjagtigt tre filer i arkivets rod: manifest.json, color.png og outline.png.

Udskift ikonerne

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

Angiv dit appnavn

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.

Lad identitetsfelterne være uændrede

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.

Pak de tre filer i en ny ZIP-fil

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 og kontrollér

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:

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.

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, 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

En bruger modtager ikke en personlig notifikation

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

En kanalmeddelelse vises ikke

Bekræft, at Living Security Teams-appen er installeret i det pågældende team eller den pågældende kanal.
Bekræft, at kanalmappingen i Living Security bruger det korrekte team og den korrekte kanal.
Kontrollér, om kanalen er blevet fjernet, omdøbt, arkiveret eller begrænset.
Geninstaller appen i det pågældende team eller den pågældende kanal, og send endnu en testnotifikation.

Valgfrit opslag via e-mail/UPN eller samtykke mislykkes

Bekræft, at en Microsoft Entra-administrator har givet samtykke for hele tenanten til Microsoft Graph User.Read.All til det viste Bot app ID.
Bekræft, at det konfigurerede tenant-id er den tenant, hvor brugerne og Teams er placeret.
Kontrollér, at brugeren findes i Microsoft Entra ID og ikke er en gæst fra en anden tenant.

Kommunikationsloggen viser, at Microsoft-administratorsamtykke er påkrævet

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.

Åbn Indstillinger → kommunikation → kanaler → Microsoft Teams. Du kan også bruge Open Microsoft Teams setup fra fejlen i kommunikationsloggen.
Bekræft, at det korrekte Microsoft Entra-tenant-id er forbundet.
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.
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.

Appen er installeret, men notifikationer mislykkes

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:

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

Integration med e-mail

Konfigurer e-mail som leveringskanal.

Integration med Slack

Konfigurer Slack som leveringskanal.

Kommunikationslog

Følg status og historik for levering via Teams.

Godkendelse

Konfiguration af Microsoft Entra ID og SSO.

Integrationer

Opsætning af integration

Katalog

Udgående kanaler

Forudsætninger

Hvem gør hvad

Opsætning

Tilpas den regionale pakke med eget brand

Udgiver og kontrolsum

Valgfrit: Aktivér reservemetode til opslag via e-mail/UPN

Notifikationstyper

Tilpasning

Opdatering eller fjernelse af appen

Fejlfinding

Sikkerhed

Relateret

Integration med e-mail

Integration med Slack

Kommunikationslog

Godkendelse

Integrationer

Opsætning af integration

Katalog

Udgående kanaler

​Forudsætninger

​Hvem gør hvad

​Opsætning

​Tilpas den regionale pakke med eget brand

​Udgiver og kontrolsum

​Valgfrit: Aktivér reservemetode til opslag via e-mail/UPN

​Notifikationstyper

​Tilpasning

​Opdatering eller fjernelse af appen

​Fejlfinding

​Sikkerhed

​Relateret

Integration med e-mail

Integration med Slack

Kommunikationslog

Godkendelse

Forudsætninger

Hvem gør hvad

Opsætning

Tilpas den regionale pakke med eget brand

Udgiver og kontrolsum

Valgfrit: Aktivér reservemetode til opslag via e-mail/UPN

Notifikationstyper

Tilpasning

Opdatering eller fjernelse af appen

Fejlfinding

Sikkerhed

Relateret