> ## 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. # Integrasjon med Microsoft Teams > Koble Living Security til Microsoft Teams for å sende opplæringsvarsler, sikkerhetsvarsler og kanalkunngjøringer. 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 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. 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. 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](#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. 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. 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. 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. 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. 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](/no/features/communications/log) 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 ZIP-filen. Den inneholder nøyaktig tre filer i roten av arkivet: `manifest.json`, `color.png` og `outline.png`. 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 | 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. 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. 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 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: ```text theme={null} 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](#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](#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 * 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 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. 1. Åpne **Innstillinger → kommunikasjon → Channels → Microsoft Teams**. Du kan også bruke **Open Microsoft Teams setup** fra feilen i kommunikasjonsloggen. 2. Bekreft at riktig Microsoft Entra-tenant-ID er tilkoblet. 3. 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. 4. 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. * 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: ```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" } } ``` ## 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 Konfigurer e-post som leveringskanal. Konfigurer Slack som leveringskanal. Følg leveringsstatus og historikk for Teams. Konfigurasjon av Microsoft Entra ID og SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.