> ## 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 > Anslut Living Security till Microsoft Teams för att skicka utbildningsaviseringar, säkerhetsvarningar och kanalmeddelanden. 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 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. 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. 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](#anpassa-varum%C3%A4rket-f%C3%B6r-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. 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. 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. 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. 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. 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](/sv/features/communications/log) 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. Extrahera ZIP-filen. Den innehåller exakt tre filer i arkivets rot: `manifest.json`, `color.png` och `outline.png`. 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 | 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. Ä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. 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 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: ```text theme={null} 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](#anpassa-varum%C3%A4rket-f%C3%B6r-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](#anpassa-varum%C3%A4rket-f%C3%B6r-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 * 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 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. 1. Öppna **Inställningar → kommunikation → Channels → Microsoft Teams**. Du kan också använda **Open Microsoft Teams setup** från felet i kommunikationsloggen. 2. Bekräfta att rätt klientorganisations-ID för Microsoft Entra är anslutet. 3. 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. 4. 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. * 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: ```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" } } ``` ## 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 Konfigurera e-post som leveranskanal. Konfigurera Slack som leveranskanal. Följ leveransstatus och historik för Teams. Konfiguration av Microsoft Entra ID och SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.