Integration med Microsoft Teams

Integrationen med Microsoft Teams skickar aviseringar från Living Security till användare och kanaler via Living Security Teams-appen. Använd den för utbildningstilldelningar, varningar om mänsklig risk, utrullningsmeddelanden och meddelanden från säkerhetsteamet. Integrationen är enbart avsedd för aviseringar. Användare skickar inga kommandon till boten i Microsoft Teams. När appen har installerats lagrar boten Teams-konversationsreferensen för framtida proaktiva aviseringar. Installationsmeddelanden är enkelriktade och kan anpassas eller inaktiveras utifrån organisationens krav vid utrullning.

En Microsoft Teams-administratör måste fortfarande ladda upp, godkänna och distribuera Living Security Teams-appen. Administratörsmedgivande i Microsoft Entra User.Read.All är valfritt och aktiverar endast reservfunktionen för uppslagning via e-postadress eller användarens huvudnamn (UPN).

För att konfigurera leverans av knuffar och spelböcker, börja i Inställningar → kommunikation → Channels och klicka på kortet Microsoft Teams. Den här sidan beskriver den underliggande konfigurationen av Teams-appen.

Förutsättningar

Innan du konfigurerar Microsoft Teams bör du ha följande:

En Microsoft Teams-administratör som kan ladda upp och godkänna organisationsappar. Samma person kan ha båda administratörsrollerna.
En Microsoft Entra-administratör, endast om du vill aktivera den valfria reservfunktionen för uppslagning via e-postadress/UPN med organisationsomfattande User.Read.All-applikationsmedgivande
Administratörsbehörighet i Living Security
En aktiv organisation i Living Security
Namnen på de team och kanaler dit säkerhetsmeddelanden ska levereras, om kanalmeddelanden är aktiverade
Ditt klientorganisations-ID (tenant ID) för Microsoft Entra, som finns under Microsoft Entra admin center → Identitet → Översikt

Vem gör vad

Roll	Ansvar
Living Security-administratör	Ansluter Microsoft-klientorganisationen, laddar ned det regionala paketet, konfigurerar installationsmeddelanden, validerar konfigurationen och skickar tester
Microsoft Teams-administratör	Laddar upp och tillåter appen, distribuerar den till avsedda användare eller grupper och tilldelar appkonfigurationsprinciper
Microsoft Entra-administratör, valfri	Beviljar `User.Read.All`-applikationsmedgivande till den regionala bottens app-ID när reservfunktionen för uppslagning via e-postadress/UPN behövs
Teams-ägare, när kanalleverans används	Installerar eller godkänner appen för avsett team och avsedd kanal

Rollerna kan innehas av olika personer. Dela paketets kontrollsumma, Teams-app-ID, Bot app ID och den avsedda utrullningsgruppen med Microsoft Teams-administratören. Dela den genererade medgivande-URL:en med en Microsoft Entra-administratör endast när du aktiverar den valfria reservfunktionen för uppslagning via e-postadress/UPN. Dela inga orelaterade autentiseringsuppgifter för Living Security.

Konfiguration

Öppna konfigurationspanelen för Microsoft Teams

I Living Security går du till Inställningar → kommunikation → Channels och väljer Microsoft Teams.Panelen visar organisationens region, paketets filnamn, Teams-app-ID, bot-app-ID, SHA256-kontrollsumma, status för konfigurationen av Microsoft-klientorganisationen, installationsanvisningar, inställningar för installationsmeddelanden samt verktyg för validering och testaviseringar.

Regionen som visas i Living Security stämmer överens med den region där din organisation finns.

Anslut din Microsoft-klientorganisation

Under Connect your tenant anger du det klientorganisations-ID för Microsoft Entra som äger de användare och Teams-kanaler som ska ta emot aviseringar, och klickar sedan på Save Microsoft tenant. En Microsoft-klientorganisation kan tillhöra endast en Living Security-organisation.Om klientorganisationskontrollen inte är tillgänglig kontaktar du din implementationsansvarige eller supportkontakt hos Living Security för att ansluta eller ändra klientorganisationen innan du installerar appen.

Living Security visar Microsoft tenant connected innan du fortsätter.

Anslut klientorganisationen innan du installerar Teams-appen om möjligt. Om appen redan är installerad sparar du klientorganisationen och väljer först Validate install. Living Security försöker automatiskt koppla den befintliga installationen; installera om endast om valideringen inte kan identifiera den.

Ladda ned det regionala Teams-paketet

Klicka på Download Teams package. Living Security tillhandahåller ett regionspecifikt ZIP-paket för din organisation.Verifiera den nedladdade filen mot SHA256-kontrollsumman som visas i Living Security innan du ändrar något. Om du vill ge appen ett eget namn och egna ikoner följer du Anpassa varumärket för det regionala paketet efter den här kontrollen och innan du laddar upp paketet.

Kontrollsumman för den nedladdade filen stämmer överens med SHA256-kontrollsumman som visas i Living Security.

Ladda upp och installera paketet i Teams admin center

I Microsoft Teams admin center går du till Teams apps → Manage apps → Åtgärder → Upload new app och laddar sedan upp den ZIP-fil som du laddade ned från Living Security.Bekräfta följande:

Teams-app-ID och bot-app-ID stämmer överens med värdena som visas i Living Security
Appnamnet är det regionala Living Security-namnet, eller det namn du angav om du anpassade varumärket för paketet
Utgivaren är Living Security. Att anpassa varumärket för paketet ändrar inte utgivaren
Appen är avblockerad
Appen är tillgänglig för de avsedda användarna eller grupperna
Appen är installerad via appkonfigurationsprinciper eller riktad installation för de användare och team/kanaler som ska ta emot aviseringar

Det kan ta tid för Microsoft att sprida ändringar av apptillgänglighet och konfigurationsprinciper.

Om valideringen eller ett test misslyckas direkt efter en ändring av apppolicyn bekräftar du principtilldelningen i Microsoft Teams admin center och försöker igen när Microsoft har slutfört spridningen.

Installera eller öppna appen

Distribuera den personliga appen till de avsedda användarna. Innan Living Security kan skicka ett personligt test till en identifierad installation måste minst en användare installera eller öppna den personliga Living Security-appen i Microsoft Teams. Det gör att boten kan registrera användarens betrodda identitet och personliga konversationsreferens. Enbart en kanalinstallation kan inte användas för ett personligt test av en identifierad installation.För kanalleverans installerar du appen i avsett team och avsedd kanal så att boten kan registrera kanalens konversationsreferens.

En målanvändare har installerat eller öppnat den personliga appen, eller så är appen installerad i den avsedda kanalen.

Konfigurera installationsmeddelanden

I avsnittet Install message controls väljer du om Teams-installationsmeddelanden ska skickas och anpassar den enkelriktade texten för din organisation.Tillgängliga inställningar:

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

Meddelandefälten stöder {{installerName}}, som ersätts med visningsnamnet för den användare som installerade appen. Lämna ett personligt meddelande eller kanalmeddelande tomt om du vill använda det konfigurerade standardmeddelandet. Om standardmeddelandet också är tomt använder Living Security det inbyggda meddelandet för den aktuella typen.

Validera konfigurationen

Klicka på Validate install i Living Security. Valideringen kontrollerar att det regionala paketet är tillgängligt, att konfigurationen av Microsoft-klientorganisationen finns och är unik för den här Living Security-organisationen, att regionala botuppgifter är konfigurerade och att en aktiv appinstallation har identifierats för den anslutna klientorganisationen.

Valideringen visar Validation passed innan du skickar skarpa aviseringar.

Skicka testaviseringar

För det personliga standardtestet klickar du på Send test to detected installation. Living Security väljer en identifierad aktiv personlig installation och använder dess lagrade betrodda identitet och konversationsreferens. Testet anropar inte Microsoft Graph och kräver inget User.Read.All-medgivande.Om ingen personlig installation har identifierats ber du en användare att installera eller öppna den personliga Living Security-appen, väljer Validate install igen och skickar sedan testet på nytt. Använd det avancerade riktade testet via e-postadress/UPN endast när den valfria reservfunktionen för uppslagning är aktiverad.

Den enkelriktade testaviseringen visas i Microsoft Teams.

Granska motsvarande försök i kommunikationsloggen när du behöver leveransdiagnostik.

Anpassa varumärket för det regionala paketet

Det regionala paketet är ett ZIP-arkiv med tre filer: manifest.json, color.png och outline.png. Du kan ange ett eget appnamn och egna ikoner i paketet innan du laddar upp det. Living Security stöder detta tillvägagångssätt för regionala paket som en Teams-administratör laddar upp direkt. Gör detta efter att du har laddat ned och verifierat paketet, och innan du laddar upp det i Teams admin center.

Packa upp paketet

Extrahera ZIP-filen. Den innehåller exakt tre filer i arkivets rot: manifest.json, color.png och outline.png.

Ersätt ikonerna

Ersätt color.png och outline.png med dina egna ikoner. Behåll samma två filnamn.

Fil	Krav
`color.png`	Helfärgs-PNG, 192 × 192 pixlar, utan transparens
`outline.png`	Transparent PNG, 32 × 32 pixlar

Ange appens namn

Redigera dessa två fält i manifest.json:

name.short – namnet som visas i Teams apphuvud och andra utrymmesbegränsade områden. Högst 30 tecken.
name.full – namnet som visas i appkatalogen och i appinformationen. Högst 100 tecken.
Om en Living Security-app redan har laddats upp i Teams admin center anger du version högre än den version som är installerad där. Microsoft Teams avvisar en uppdatering som inte ökar versionsnumret, och en ny nedladdning kan ha samma version som, eller en lägre version än, det paket du redan har installerat.Läs av den installerade versionen i Teams admin center under Teams apps → Manage apps, på appens informationssida. Jämför den med värdet version i manifest.json som du precis laddade ned, och ange sedan ett värde som är högre än båda. Behåll formatet MAJOR.MINOR.PATCH med tre tal.Om den installerade appen till exempel är 1.1.1 och din nya nedladdning är 1.1.0, anger du 1.1.2. Om du höjde den nedladdade 1.1.0 till 1.1.1 skulle det upprepa den installerade versionen, och Teams skulle avvisa uppladdningen.

Lämna identitetsfälten oförändrade

Ändra inte dessa fält. Vart och ett av dem bär appens, botens eller enkel inloggningens (SSO) identitet:

id
botId i bots
webApplicationInfo
validDomains
contentUrl och websiteUrl i staticTabs
En ändring av ett identitetsfält kan göra att appen går att installera men inte kan leverera aviseringar eller slutföra enkel inloggning. Validate install kontrollerar klientorganisationen, botens autentiseringsuppgifter och den identifierade installationen. Den jämför inte ditt manifest med det paket som Living Security har byggt.

Packa ihop de tre filerna igen

Skapa ett nytt ZIP-arkiv av de tre filerna. Placera dem i arkivets rot, utan omslutande mapp. Microsoft Teams avvisar ett paket där manifest.json ligger i en mapp.

Ladda upp och verifiera

Ladda upp den ZIP-fil där varumärket har anpassats i Teams admin center, gå sedan tillbaka till Living Security och klicka på Validate install. Skicka en testavisering.

Valideringen visar Validation passed, och testaviseringen kommer fram i Microsoft Teams med ditt appnamn och dina ikoner.

Utgivare och kontrollsumma

Anpassningen av varumärket ändrar appens namn och ikoner. Två saker ändras inte:

Utgivaren förblir Living Security. Manifestfälten developer anger Living Security och länkar till Living Securitys webbplats, integritetspolicy och användarvillkor. Tillsammans identifierar de företaget som driver tjänsten, så Teams fortsätter att visa Living Security som utgivare på appens informationssida, i dialogrutor för behörighetsmedgivande och i apprapporter över användning. Ditt namn och dina ikoner är det som användarna ser i apphuvudet, i appkatalogen och i aviseringar.
SHA256-kontrollsumman stämmer inte längre. Kontrollsumman som visas i Living Security beskriver paketet som det laddades ned. Verifiera den innan du redigerar filerna och anteckna sedan kontrollsumman för ditt eget paket med anpassat varumärke i dina utrullningsanteckningar.

Valfritt: Aktivera reservfunktionen för uppslagning via e-postadress/UPN

Normal personlig leverans använder ett betrott objekt-ID i Microsoft Entra som redan är känt för Living Security, tillsammans med den konversationsreferens för boten som registreras när användaren installerar eller öppnar appen. Kanalleverans använder den lagrade konversationsreferensen för kanalen. Ingen av vägarna kräver Microsoft Graph. Om en mottagare saknar ett betrott objekt-ID i Entra kan Living Security valfritt använda Microsoft Graph för att identifiera mottagaren via e-postadress eller UPN. För att aktivera den reservfunktionen ber du en Microsoft Entra-administratör att klicka på Grant optional User.Read.All consent i Teams-konfigurationspanelen och godkänna Microsoft Graph-applikationsbehörigheten User.Read.All för den regionala Living Security Teams-applikationen. Flödet för administratörsmedgivande följer detta mönster i Microsoft Entra:

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

Living Security genererar den här URL:en utifrån det anslutna klientorganisations-ID:t och Bot app ID som visas i konfigurationspanelen. ID:na har olika syften:

Teams app ID identifierar det installerbara apppaketet i Microsoft Teams admin center.
Bot app ID identifierar den regionala botens Microsoft Entra-applikation och är det klient-ID som används i det valfria flödet för administratörsmedgivande.

Ersätt inte Teams-app-ID:t i medgivande-URL:en. Integrationen Microsoft Entra ID (Client Credentials) under Connected Integrations är en separat, generisk integration. Dess autentiseringsuppgifter eller medgivande kan inte återanvändas av den regionala Teams-boten, och medgivande som beviljats till en orelaterad Entra-applikation aktiverar inte den här reservfunktionen.

Att göra medgivandet valfritt tar inte bort User.Read.All från befintliga regionala applikationsregistreringar för Living Security. Kunder som redan har beviljat medgivande kan fortsätta använda reservfunktionen för e-postadress/UPN utan ny konfiguration.

Aviseringstyper

Beroende på organisationens rättigheter och konfigurerade spelböcker kan Living Security skicka:

Avisering	Beskrivning
Utbildningstilldelningar	Meddelar användare när utbildning har tilldelats, förfaller eller är redo att slutföras
Utbildningspåminnelser	Påminner användare om kommande tidsfrister
Varningar om mänsklig risk	Skickar personliga uppdateringar av Index för mänsklig risk och rekommenderade nästa steg
Utrullningsmeddelanden	Skickar enkelriktade introduktions- eller utrullningsaviseringar under driftsättningen
Kanalmeddelanden	Publicerar kommunikation från säkerhetsprogrammet i konfigurerade Teams-kanaler

Anpassning

Teams-aviseringar använder konfigurationen för din Living Security-organisation. Fält som stöds är bland annat kundens visningsnamn, logotyp- och varumärkesfält som stöds, meddelandetext, uppmaningar till handling, mållänkar, utrullningstext samt support- och kontakttext. Installationsmeddelanden kan konfigureras under Inställningar → kommunikation → Channels → Microsoft Teams → Install message controls. Du kan inaktivera installationsmeddelanden helt, inaktivera endast personliga installationsmeddelanden eller kanalinstallationsmeddelanden samt konfigurera standardtext, personlig text eller kanalspecifik text. Teams-appens namn och ikoner kommer från det regionala paketet. Om du vill ange egna, se Anpassa varumärket för det regionala paketet.

Uppdatera eller ta bort appen

När Living Security tillhandahåller ett uppdaterat regionalt paket laddar du ned det från panelen för Microsoft Teams-kanalen och laddar upp paketet via Teams admin center. Verifiera det visade app-ID:t, bot-ID:t och kontrollsumman före utrullning.
Ändringar av varumärket finns inte kvar efter en paketuppdatering. Varje nytt regionalt paket har åter Living Security-appens namn och ikoner. Tillämpa dina ändringar igen med Anpassa varumärket för det regionala paketet innan du laddar upp det nya paketet. Spara dina ikoner, dina två namnvärden och den version du senast laddade upp på en plats där du hittar dem, så att varje uppgradering blir en kort upprepning av samma steg. Ett nytt paket har inte alltid ett högre versionsnummer än det du har installerat, så ange versionen utifrån vad Teams visar som installerat.
Kör Validate install igen och skicka ytterligare ett test efter en app- eller principuppdatering.
Om appen tas bort eller blockeras förhindras proaktiva aviseringar till den användaren eller kanalen. Installera om appen och skicka ett nytt test så att Living Security får en aktuell installationshändelse från Teams.
Om du avvecklar leverans via Teams tar du bort Teams från relevanta spelböcker innan du tar bort appen från Microsoft Teams.

Felsökning

En användare får ingen personlig avisering

Bekräfta att den personliga Living Security Teams-appen är installerad och att användaren har öppnat den så att Living Security har en aktuell konversationsreferens
Bekräfta att det konfigurerade klientorganisations-ID:t för Microsoft är den klientorganisation där användaren finns
Om diagnostiken visar att reservfunktionen för e-postadress/UPN har använts bekräftar du att administratörsmedgivande för User.Read.All har beviljats till det visade Bot app ID för rätt klientorganisation
När reservfunktionen för e-postadress/UPN används kontrollerar du att användarens e-postadress eller UPN i Living Security stämmer överens med Microsoft Entra ID
Be användaren att avblockera eller installera om appen om användaren tidigare har tagit bort eller blockerat den

Ett kanalmeddelande visas inte

Bekräfta att Living Security Teams-appen är installerad i målteamet eller målkanalen.
Bekräfta att kanalmappningen i Living Security använder rätt team och rätt kanal.
Kontrollera om kanalen har tagits bort, bytt namn, arkiverats eller begränsats.
Installera om appen i målteamet eller målkanalen och skicka ytterligare en testavisering.

Valfri uppslagning via e-postadress/UPN eller medgivande misslyckas

Bekräfta att en Microsoft Entra-administratör har beviljat organisationsomfattande medgivande för Microsoft Graph User.Read.All till det visade Bot app ID.
Bekräfta att det konfigurerade klientorganisations-ID:t är den klientorganisation där användarna och Teams finns.
Kontrollera att användaren finns i Microsoft Entra ID och inte är en gäst från en annan klientorganisation.

Kommunikationsloggen visar att administratörsmedgivande från Microsoft krävs

Felkategorin TEAMS_ADMIN_CONSENT_REQUIRED, eller Microsoft-felet AADSTS7000229, innebär att en uppslagning av mottagare via e-postadress/UPN försökte använda den valfria reservfunktionen i Microsoft Graph, men den regionala Living Security Teams-appen saknar tjänstens huvudnamn (enterprise application) i den anslutna Microsoft Entra-klientorganisationen. Standardvägarna med betrott ID och lagrad konversation kräver inte detta medgivande. Det handlar inte om en utgången hemlighet i Living Security.

Öppna Inställningar → kommunikation → Channels → Microsoft Teams. Du kan också använda Open Microsoft Teams setup från felet i kommunikationsloggen.
Bekräfta att rätt klientorganisations-ID för Microsoft Entra är anslutet.
Om reservfunktionen för e-postadress/UPN behövs ber du en Microsoft Entra-administratör att klicka på Grant optional User.Read.All consent och godkänna User.Read.All för det visade Bot app ID. Annars ser du till att mottagaren har öppnat den personliga appen och att Living Security har mottagarens betrodda objekt-ID i Entra.
När Microsoft har slutfört behandlingen av medgivandet skickar du ett avancerat riktat test via e-postadress/UPN från Microsoft Teams-konfigurationen. Kommunikationsloggen visar leveranshistorik och diagnostik; den levererar inte det misslyckade meddelandet på nytt.

Att konfigurera om Microsoft Entra ID (Client Credentials) löser inte det här felet eftersom den integrationen inte används för leverans av Teams-aviseringar.

Appen är installerad men aviseringar misslyckas

Kontrollera om boten har blockerats, tagits bort eller avinstallerats
Om appen installerades innan klientorganisationen anslöts i Living Security sparar du klientorganisationen och väljer Validate install så att Living Security kan koppla den befintliga installationen
Installera om endast om valideringen inte kan identifiera den befintliga installationen
Bekräfta att målanvändaren eller målkanalen har tagit emot den senaste installationshändelsen för appen
Skicka en ny testavisering efter att du har installerat om appen

Exempel på fält i installationshändelsen som används vid felsökning:

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

Säkerhet

Living Security använder Microsoft Graph User.Read.All endast för den valfria reservfunktionen för uppslagning av mottagare via e-postadress/UPN. Som standard använder routningen av personliga aviseringar ett betrott objekt-ID i Entra från Living Securitys entitetsdata och den konversationsreferens för boten som registrerats från Microsoft Teams. Objekt-ID:n och konversationsreferenser som tillhandahålls av anroparen betraktas inte som betrodda routningsdata. Meddelanden i Microsoft Teams levereras via Living Securitys Teams-bot som enbart är avsedd för aviseringar, med hjälp av proaktiva meddelanden i Microsoft Teams. Living Security kräver inte att kunder skapar en egen appregistrering i Microsoft Entra eller delar en kundägd klienthemlighet för den standardmässiga konfigurationen av Teams-appen. Regionspecifika Teams-paket håller app-ID, bot-ID och meddelandeslutpunkt i linje med den Living Security-region där din organisation finns.

Relaterat

E-postintegration

Konfigurera e-post som leveranskanal.

Slack-integration

Konfigurera Slack som leveranskanal.

Kommunikationslogg

Följ leveransstatus och historik för Teams.

Autentisering

Konfiguration av Microsoft Entra ID och SSO.

Integrationer

Konfigurering av integration

Katalog

Utgående kanaler

Förutsättningar

Vem gör vad

Konfiguration

Anpassa varumärket för det regionala paketet

Utgivare och kontrollsumma

Valfritt: Aktivera reservfunktionen för uppslagning via e-postadress/UPN

Aviseringstyper

Anpassning

Uppdatera eller ta bort appen

Felsökning

Säkerhet

Relaterat

E-postintegration

Slack-integration

Kommunikationslogg

Autentisering

Integrationer

Konfigurering av integration

Katalog

Utgående kanaler

​Förutsättningar

​Vem gör vad

​Konfiguration

​Anpassa varumärket för det regionala paketet

​Utgivare och kontrollsumma

​Valfritt: Aktivera reservfunktionen för uppslagning via e-postadress/UPN

​Aviseringstyper

​Anpassning

​Uppdatera eller ta bort appen

​Felsökning

​Säkerhet

​Relaterat

E-postintegration

Slack-integration

Kommunikationslogg

Autentisering

Förutsättningar

Vem gör vad

Konfiguration

Anpassa varumärket för det regionala paketet

Utgivare och kontrollsumma

Valfritt: Aktivera reservfunktionen för uppslagning via e-postadress/UPN

Aviseringstyper

Anpassning

Uppdatera eller ta bort appen

Felsökning

Säkerhet

Relaterat