Integrasjon med Microsoft Teams

Integrasjonen med Microsoft Teams sender varsler fra Living Security til brukere og kanaler via Teams-appen for Living Security. Bruk den til opplæringstildelinger, varsler om menneskelig risiko, utrullingsmeldinger og kunngjøringer fra sikkerhetsteamet. Denne integrasjonen gjelder kun varsler. Brukere sender ikke kommandoer til boten i Microsoft Teams. Når appen er installert, lagrer boten samtalereferansen i Teams for fremtidige proaktive varsler. Installasjonsmeldinger er enveis og kan tilpasses eller deaktiveres i henhold til kravene til utrulling i virksomheten.

En Microsoft Teams-administrator må fortsatt laste opp, godkjenne og distribuere Teams-appen for Living Security. Administratorsamtykke for Microsoft Entra User.Read.All er valgfritt og aktiverer kun reserveløsningen for oppslag via e-postadresse eller brukerens hovednavn (UPN).

For oppsett av levering av Nudge og Playbook starter du under Innstillinger → kommunikasjon → Channels og klikker på kortet Microsoft Teams. Denne siden beskriver den underliggende konfigurasjonen av Teams-appen.

Forutsetninger

Før du konfigurerer Microsoft Teams, må du sørge for at du har:

En Microsoft Teams-administrator som kan laste opp og godkjenne organisasjonsapper. Den samme personen kan ha begge administratorrollene.
En Microsoft Entra-administrator, bare hvis du vil aktivere den valgfrie reserveløsningen for oppslag via e-postadresse/UPN med samtykke for User.Read.All-applikasjonen for hele tenanten
Administratorrettigheter i Living Security
En aktiv organisasjon i Living Security
Navnene på teamet og kanalen der sikkerhetskunngjøringer skal leveres, hvis kanalkunngjøringer er aktivert
Din Microsoft Entra-tenant-ID, som du finner under Microsoft Entra admin center → Identitet → Oversikt

Hvem gjør hva

Rolle	Ansvar
Administrator i Living Security	Kobler til Microsoft-tenanten, laster ned den regionale pakken, konfigurerer installasjonsmeldinger, validerer oppsettet og sender tester
Microsoft Teams-administrator	Laster opp og tillater appen, distribuerer den til de tiltenkte brukerne eller gruppene og tildeler policyer for appoppsett
Microsoft Entra-administrator, valgfri	Gir `User.Read.All`-applikasjonssamtykke til den regionale bot-app-ID-en når reserveløsningen for oppslag via e-postadresse/UPN er nødvendig
Teams-eier, når kanallevering brukes	Installerer eller godkjenner appen for det tiltenkte teamet og den tiltenkte kanalen

Dette kan være ulike personer. Del pakkens sjekksum, Teams-app-ID-en, Bot app ID og den tiltenkte brukergruppen for utrullingen med Microsoft Teams-administratoren. Del den genererte samtykke-URL-en med en Microsoft Entra-administrator bare når du aktiverer den valgfrie reserveløsningen for oppslag via e-postadresse/UPN. Ikke del andre legitimasjoner for Living Security som ikke er relevante.

Oppsett

Åpne oppsettpanelet for Microsoft Teams

Gå til Innstillinger → kommunikasjon → Channels i Living Security og velg Microsoft Teams.Panelet viser organisasjonens region, pakkens filnavn, Teams-app-ID, bot-app-ID, SHA256-sjekksum, status for konfigurasjonen av Microsoft-tenanten, installasjonsinstruksjoner, kontroller for installasjonsmeldinger samt verktøy for validering og testvarsler.

Regionen som vises i Living Security, samsvarer med regionen der organisasjonen din er driftet.

Koble til Microsoft-tenanten

Under Connect your tenant oppgir du Microsoft Entra-tenant-ID-en som eier brukerne og Teams-kanalene som skal motta varsler, og klikker deretter på Save Microsoft tenant. Én Microsoft-tenant kan bare tilhøre én organisasjon i Living Security.Hvis tenantkontrollen ikke er tilgjengelig, kontakter du den som har ansvaret for implementeringen hos Living Security, eller supportkontakten din, for å koble til eller endre tenanten før du installerer appen.

Living Security viser Microsoft tenant connected før du fortsetter.

Koble til tenanten før du installerer Teams-appen når det er mulig. Hvis appen allerede er installert, lagrer du tenanten og velger først Validate install. Living Security forsøker å knytte den eksisterende installasjonen til automatisk. Installer på nytt bare hvis valideringen ikke finner den.

Last ned den regionale Teams-pakken

Klikk på Download Teams package. Living Security tilbyr en regionsspesifikk ZIP-pakke for organisasjonen din.Kontroller den nedlastede filen mot SHA256-sjekksummen som vises i Living Security, før du endrer noe. Hvis du vil gi appen ditt eget navn og egne ikoner, følger du Endre merkevaren for den regionale pakken etter denne kontrollen og før du laster opp pakken.

Sjekksummen for den nedlastede filen samsvarer med SHA256-sjekksummen som vises i Living Security.

Last opp og installer pakken i Teams admin center

Gå til Teams apps → Manage apps → Actions → Upload new app i Microsoft Teams admin center, og last opp ZIP-filen du lastet ned fra Living Security.Bekreft følgende:

Teams-app-ID-en og bot-app-ID-en samsvarer med verdiene som vises i Living Security
Appnavnet er det regionale navnet for Living Security, eller navnet du har angitt hvis du har endret merkevaren for pakken
Utgiveren er Living Security. Endring av merkevaren for pakken endrer ikke utgiveren
Appen er ikke blokkert
Appen er tilgjengelig for de tiltenkte brukerne eller gruppene
Appen er installert via policyer for appoppsett eller målrettet installasjon for brukerne og teamene/kanalene som skal motta varsler

Det kan ta tid før Microsoft har propagert endringer i apptilgjengelighet og policyer for appoppsett.

Hvis validering eller en test mislykkes rett etter en endring i apppolicyen, bekrefter du policytildelingen i Microsoft Teams admin center og prøver på nytt når Microsoft er ferdig med å propagere den.

Installer eller åpne appen

Distribuer den personlige appen til de tiltenkte brukerne. Før Living Security kan sende en personlig test til en oppdaget installasjon, må minst én bruker installere eller åpne den personlige appen for Living Security i Microsoft Teams. Dette gjør at boten kan registrere brukerens pålitelige identitet og personlige samtalereferanse. En kanalinstallasjon alene kan ikke brukes til en personlig test av oppdaget installasjon.For kanallevering installerer du appen i det tiltenkte teamet og den tiltenkte kanalen, slik at boten kan registrere samtalereferansen for kanalen.

En målbruker har installert eller åpnet den personlige appen, eller appen er installert i den tiltenkte kanalen.

Konfigurer installasjonsmeldinger

Under Install message controls velger du om installasjonsmeldinger i Teams skal sendes, og tilpasser den enveis teksten for organisasjonen din.Tilgjengelige kontroller:

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

Meldingsfeltene støtter {{installerName}}, som erstattes med visningsnavnet til brukeren som installerte appen. La en personlig melding eller kanalmelding stå tom for å bruke den konfigurerte standardmeldingen. Hvis standardmeldingen også er tom, bruker Living Security den innebygde meldingen for det aktuelle omfanget.

Valider oppsettet

Klikk på Validate install i Living Security. Valideringen kontrollerer at den regionale pakken er tilgjengelig, at konfigurasjonen av Microsoft-tenanten finnes og er unik for denne organisasjonen i Living Security, at regionale bot-legitimasjoner er konfigurert, og at en aktiv appinstallasjon er oppdaget for den tilkoblede tenanten.

Valideringen viser Validation passed før du sender live-varsler.

Send testvarsler

For den personlige standardtesten klikker du på Send test to detected installation. Living Security velger en oppdaget aktiv personlig installasjon og bruker dens lagrede pålitelige identitet og samtalereferanse. Denne testen kaller ikke Microsoft Graph og krever ikke samtykke for User.Read.All.Hvis ingen personlig installasjon er oppdaget, ber du en bruker installere eller åpne den personlige appen for Living Security, velger Validate install på nytt og sender testen om igjen. Bruk den avanserte målrettede e-postadresse/UPN-testen bare når den valgfrie reserveløsningen for oppslag er aktivert.

Enveis-testvarselet vises i Microsoft Teams.

Se det tilsvarende forsøket i Kommunikasjonslogg når du trenger leveringsdiagnostikk.

Endre merkevaren for den regionale pakken

Den regionale pakken er et ZIP-arkiv med tre filer: manifest.json, color.png og outline.png. Du kan angi ditt eget appnavn og egne ikoner i denne pakken før du laster den opp. Living Security støtter denne fremgangsmåten for regionale pakker som en Teams-administrator laster opp direkte. Gjør dette etter at du har lastet ned og kontrollert pakken, og før du laster den opp i Teams admin center.

Pakk ut pakken

Pakk ut ZIP-filen. Den inneholder nøyaktig tre filer i roten av arkivet: manifest.json, color.png og outline.png.

Bytt ut ikonene

Bytt ut color.png og outline.png med dine egne ikoner. Behold de samme to filnavnene.

Fil	Krav
`color.png`	Fargeikon i PNG, 192 × 192 piksler, uten gjennomsiktighet
`outline.png`	PNG med gjennomsiktig bakgrunn, 32 × 32 piksler

Angi appnavnet

Rediger disse to feltene i manifest.json:

name.short – navnet som vises i Teams-appens topptekst og i andre områder med begrenset plass. Maksimalt 30 tegn.
name.full – navnet som vises i appkatalogen og i appdetaljene. Maksimalt 100 tegn.
Hvis en app for Living Security allerede er lastet opp i Teams admin center, må du sette version høyere enn versjonen som er installert der. Microsoft Teams avviser en oppdatering som ikke øker versjonen, og en ny nedlasting kan ha samme versjon som, eller en lavere versjon enn, pakken du allerede har installert.Du finner den installerte versjonen i Teams admin center under Teams apps → Manage apps, på appens detaljside. Sammenlign den med verdien for version i manifest.json du nettopp lastet ned, og angi deretter en verdi som er høyere enn begge. Behold formatet med tre tall for MAJOR.MINOR.PATCH.Hvis for eksempel den installerte appen er 1.1.1 og den nye nedlastingen er 1.1.0, setter du 1.1.2. Hvis du hever den nedlastede 1.1.0 til 1.1.1, ville det gjentatt den installerte versjonen, og Teams ville avvist opplastingen.

La identitetsfeltene være uendret

Ikke endre disse feltene. Hvert av dem bærer identiteten til appen, boten eller single sign-on:

id
botId i bots
webApplicationInfo
validDomains
contentUrl og websiteUrl i staticTabs
En endring i et identitetsfelt kan gjøre at appen fortsatt kan installeres, men ikke kan levere varsler eller fullføre single sign-on. Validate install kontrollerer tenanten, bot-legitimasjonen og den oppdagede installasjonen. Den sammenligner ikke manifestet ditt med pakken som Living Security har bygget.

Pakk de tre filene i en ny ZIP-fil

Opprett et nytt ZIP-arkiv av de tre filene. Plasser dem i roten av arkivet, uten en omsluttende mappe. Microsoft Teams avviser en pakke der manifest.json ligger inne i en mappe.

Last opp og verifiser

Last opp ZIP-filen med ny merkevare i Teams admin center, gå deretter tilbake til Living Security og klikk på Validate install. Send et testvarsel.

Valideringen viser Validation passed, og testvarselet kommer frem i Microsoft Teams under appnavnet og ikonene dine.

Utgiver og sjekksum

Endring av merkevaren setter appnavnet og ikonene. Den endrer ikke to ting:

Utgiveren forblir Living Security. Feltene developer i manifestet oppgir Living Security og lenker til nettstedet, personvernerklæringen og vilkårene for bruk for Living Security. Sammen identifiserer de selskapet som driver tjenesten, slik at Teams fortsetter å vise Living Security som utgiver på appens detaljside, i dialogbokser for samtykke til tillatelser og i rapporter om appbruk. Navnet og ikonene dine er det brukerne ser i apptoppteksten, i appkatalogen og i varslene.
SHA256-sjekksummen samsvarer ikke lenger. Sjekksummen som vises i Living Security, beskriver pakken slik den ble lastet ned. Kontroller den før du redigerer filene, og noter deretter sjekksummen for din egen pakke med ny merkevare i dokumentasjonen for utrullingen.

Valgfritt: Aktiver reserveløsning for oppslag via e-postadresse/UPN

Vanlig personlig levering bruker en pålitelig Microsoft Entra-objekt-ID som allerede er kjent for Living Security, sammen med bot-samtalereferansen som registreres når brukeren installerer eller åpner appen. Kanallevering bruker den lagrede samtalereferansen for kanalen. Ingen av disse rutene krever Microsoft Graph. Hvis en mottaker ikke har en pålitelig Entra-objekt-ID, kan Living Security eventuelt bruke Microsoft Graph til å finne mottakeren via e-postadresse eller UPN. For å aktivere denne reserveløsningen ber du en Microsoft Entra-administrator klikke på Grant optional User.Read.All consent i Teams-oppsettpanelet og godkjenne applikasjonstillatelsen User.Read.All i Microsoft Graph for den regionale Teams-applikasjonen for Living Security. Flyten for administratorsamtykke følger dette mønsteret i Microsoft Entra:

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

Living Security genererer denne URL-en fra den tilkoblede tenant-ID-en og Bot app ID som vises i oppsettpanelet. ID-ene har ulike formål:

Teams app ID identifiserer den installerbare apppakken i Microsoft Teams admin center.
Bot app ID identifiserer Microsoft Entra-applikasjonen til den regionale boten og er klient-ID-en som brukes i den valgfrie flyten for administratorsamtykke.

Ikke bruk Teams-app-ID-en i stedet i samtykke-URL-en. Integrasjonen Microsoft Entra ID (Client Credentials) under Connected Integrations er en separat, generisk integrasjon. Legitimasjonen eller samtykket for den kan ikke gjenbrukes av den regionale Teams-boten, og samtykke gitt til en urelatert Entra-applikasjon aktiverer ikke denne reserveløsningen.

At samtykket er valgfritt, fjerner ikke User.Read.All fra eksisterende regionale applikasjonsregistreringer for Living Security. Kunder som allerede har gitt samtykke, kan fortsette å bruke reserveløsningen for e-postadresse/UPN uten ny konfigurasjon.

Varseltyper

Avhengig av organisasjonens rettigheter og konfigurerte Playbooks kan Living Security sende:

Varsel	Beskrivelse
Opplæringstildelinger	Varsler brukere når opplæring er tildelt, forfaller eller er klar til å fullføres
Påminnelser om opplæring	Minner brukere om kommende frister
Varsler om menneskelig risiko	Sender personlige oppdateringer om Menneskelig risikoindeks og anbefalte neste steg
Utrullingsmeldinger	Sender enveis varsler om onboarding eller utrulling under implementeringen
Kanalkunngjøringer	Publiserer kommunikasjon fra sikkerhetsprogrammet i konfigurerte Teams-kanaler

Tilpasning

Teams-varsler bruker konfigurasjonen av organisasjonen din i Living Security. Støttede felt omfatter kundens visningsnavn, støttede felt for logo og merkevare, meldingstekst, handlingsoppfordringer, destinasjonslenker, utrullingstekst og tekst for support og kontakt. Installasjonsmeldinger kan konfigureres under Innstillinger → kommunikasjon → Channels → Microsoft Teams → Install message controls. Du kan deaktivere installasjonsmeldinger helt, deaktivere bare personlige eller kanalbaserte installasjonsmeldinger, og konfigurere standardtekst, personlig tekst eller kanalspesifikk tekst. Teams-appens navn og ikoner kommer fra den regionale pakken. Se Endre merkevaren for den regionale pakken for å angi dine egne.

Oppdatere eller fjerne appen

Når Living Security tilbyr en oppdatert regional pakke, laster du den ned fra kanalpanelet for Microsoft Teams og laster den opp via Teams admin center. Kontroller den viste app-ID-en, bot-ID-en og sjekksummen før utrulling.
Endringer i merkevaren overlever ikke en pakkeoppdatering. Hver nye regionale pakke har igjen appnavnet og ikonene fra Living Security. Bruk endringene dine på nytt med Endre merkevaren for den regionale pakken før du laster opp den nye pakken. Oppbevar ikonene dine, de to navneverdiene og versjonen du sist lastet opp, på et sted der du finner dem, slik at hver oppgradering blir en kort gjentakelse av de samme trinnene. En ny pakke har ikke alltid en høyere versjon enn den du har installert, så angi versjonen ut fra det Teams viser som installert.
Kjør Validate install på nytt og send et nytt testvarsel etter en app- eller policyoppdatering.
Hvis appen fjernes eller blokkeres, hindrer det proaktive varsler til den aktuelle brukeren eller kanalen. Installer appen på nytt og send en ny test, slik at Living Security mottar en oppdatert installasjonshendelse fra Teams.
Hvis du avvikler levering via Teams, fjerner du Teams fra de aktuelle Playbooks før du fjerner appen fra Microsoft Teams.

Feilsøking

En bruker mottar ikke et personlig varsel

Bekreft at den personlige Teams-appen for Living Security er installert og at brukeren har åpnet den, slik at Living Security har en gjeldende samtalereferanse
Bekreft at den konfigurerte Microsoft-tenant-ID-en er tenanten der brukeren befinner seg
Hvis diagnostikken viser at reserveløsningen for e-postadresse/UPN ble forsøkt, bekrefter du at administratorsamtykke for User.Read.All ble gitt til den viste Bot app ID for riktig tenant
Når reserveløsningen for e-postadresse/UPN brukes, kontrollerer du at brukerens e-postadresse eller UPN i Living Security samsvarer med Microsoft Entra ID
Be brukeren oppheve blokkeringen av appen eller installere den på nytt hvis vedkommende tidligere har fjernet eller blokkert den

En kanalkunngjøring vises ikke

Bekreft at Teams-appen for Living Security er installert i det aktuelle teamet eller den aktuelle kanalen.
Bekreft at kanaltilordningen i Living Security bruker riktig team og kanal.
Kontroller om kanalen er fjernet, omdøpt, arkivert eller begrenset.
Installer appen på nytt i det aktuelle teamet eller den aktuelle kanalen, og send et nytt testvarsel.

Valgfritt oppslag via e-postadresse/UPN eller samtykke mislykkes

Bekreft at en Microsoft Entra-administrator har gitt samtykke for hele tenanten for Microsoft Graph User.Read.All til den viste Bot app ID.
Bekreft at den konfigurerte tenant-ID-en er tenanten der brukerne og Teams befinner seg.
Kontroller at brukeren finnes i Microsoft Entra ID og ikke er en gjest fra en annen tenant.

Kommunikasjonsloggen viser at Microsoft-administratorsamtykke kreves

Feilkategorien TEAMS_ADMIN_CONSENT_REQUIRED, eller Microsoft-feilen AADSTS7000229, betyr at et oppslag av mottaker via e-postadresse/UPN forsøkte den valgfrie reserveløsningen med Microsoft Graph, men at den regionale Teams-appen for Living Security ikke har noen tjenesteprinsipal (enterprise-applikasjon) i den tilkoblede Microsoft Entra-tenanten. Standardrutene med pålitelig ID og lagret samtale krever ikke dette samtykket. Dette er ikke en utløpt hemmelighet i Living Security.

Åpne Innstillinger → kommunikasjon → Channels → Microsoft Teams. Du kan også bruke Open Microsoft Teams setup fra feilen i kommunikasjonsloggen.
Bekreft at riktig Microsoft Entra-tenant-ID er tilkoblet.
Hvis reserveløsningen for e-postadresse/UPN er nødvendig, ber du en Microsoft Entra-administrator klikke på Grant optional User.Read.All consent og godkjenne User.Read.All for den viste Bot app ID. Ellers må du sørge for at mottakeren har åpnet den personlige appen og at Living Security har mottakerens pålitelige Entra-objekt-ID.
Når Microsoft er ferdig med å behandle samtykket, sender du en avansert målrettet e-postadresse/UPN-test fra oppsettet av Microsoft Teams. Kommunikasjonsloggen viser leveringshistorikk og diagnostikk, men leverer ikke den mislykkede meldingen på nytt.

Å konfigurere Microsoft Entra ID (Client Credentials) på nytt løser ikke denne feilen, fordi den integrasjonen ikke brukes til levering av Teams-varsler.

Appen er installert, men varslene mislykkes

Kontroller om boten er blokkert, fjernet eller avinstallert
Hvis appen ble installert før tenanten ble koblet til i Living Security, lagrer du tenanten og velger Validate install, slik at Living Security kan knytte den eksisterende installasjonen til
Installer på nytt bare hvis valideringen ikke finner den eksisterende installasjonen
Bekreft at målbrukeren eller målkanalen har mottatt den siste installasjonshendelsen for appen
Send et nytt testvarsel etter at du har installert appen på nytt

Eksempel på felt i installasjonshendelser som brukes til feilsøking:

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

Sikkerhet

Living Security bruker Microsoft Graph User.Read.All bare for den valgfrie reserveløsningen for oppslag av mottakere via e-postadresse/UPN. Som standard bruker ruting av personlige varsler en pålitelig Entra-objekt-ID fra enhetsdataene i Living Security og bot-samtalereferansen som er registrert fra Microsoft Teams. Objekt-ID-er og samtalereferanser som oppgis av den som kaller, regnes ikke som pålitelige rutingdata. Meldinger i Microsoft Teams leveres via Teams-boten for Living Security, som kun sender varsler, ved hjelp av proaktiv meldingsutsendelse i Microsoft Teams. Living Security krever ikke at kunder oppretter sin egen appregistrering i Microsoft Entra eller deler en klienthemmelighet som eies av kunden, for standard oppsett av Teams-appen. Regionsspesifikke Teams-pakker holder app-ID-en, bot-ID-en og meldingsendepunktet i samsvar med regionen for Living Security der organisasjonen din er driftet.

Relatert

E-postintegrasjon

Konfigurer e-post som leveringskanal.

Slack-integrasjon

Konfigurer Slack som leveringskanal.

Kommunikasjonslogg

Følg leveringsstatus og historikk for Teams.

Autentisering

Konfigurasjon av Microsoft Entra ID og SSO.

Integrasjoner

Oppsett av integrasjon

Katalog

Utgående kanaler

Forutsetninger

Hvem gjør hva

Oppsett

Endre merkevaren for den regionale pakken

Utgiver og sjekksum

Valgfritt: Aktiver reserveløsning for oppslag via e-postadresse/UPN

Varseltyper

Tilpasning

Oppdatere eller fjerne appen

Feilsøking

Sikkerhet

Relatert

E-postintegrasjon

Slack-integrasjon

Kommunikasjonslogg

Autentisering

Integrasjoner

Oppsett av integrasjon

Katalog

Utgående kanaler

​Forutsetninger

​Hvem gjør hva

​Oppsett

​Endre merkevaren for den regionale pakken

​Utgiver og sjekksum

​Valgfritt: Aktiver reserveløsning for oppslag via e-postadresse/UPN

​Varseltyper

​Tilpasning

​Oppdatere eller fjerne appen

​Feilsøking

​Sikkerhet

​Relatert

E-postintegrasjon

Slack-integrasjon

Kommunikasjonslogg

Autentisering

Forutsetninger

Hvem gjør hva

Oppsett

Endre merkevaren for den regionale pakken

Utgiver og sjekksum

Valgfritt: Aktiver reserveløsning for oppslag via e-postadresse/UPN

Varseltyper

Tilpasning

Oppdatere eller fjerne appen

Feilsøking

Sikkerhet

Relatert