> ## 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. # Integratie met Microsoft Teams > Koppel Living Security aan Microsoft Teams om trainingsmeldingen, beveiligingswaarschuwingen en kanaalaankondigingen te verzenden. De Microsoft Teams-integratie verzendt meldingen van Living Security via de Living Security Teams-app naar gebruikers en kanalen. Gebruik de integratie voor Training-toewijzingen, waarschuwingen over menselijk risico, uitrolberichten en aankondigingen van het beveiligingsteam. Deze integratie is uitsluitend bedoeld voor meldingen. Gebruikers sturen geen opdrachten naar de bot in Microsoft Teams. Wanneer de app is geïnstalleerd, slaat de bot de Teams-gespreksreferentie op voor toekomstige proactieve meldingen. Installatieberichten zijn eenrichtingsberichten en kunnen worden aangepast of uitgeschakeld om aan de eisen van een bedrijfsbrede uitrol te voldoen. Een Microsoft Teams-beheerder moet de Living Security Teams-app nog steeds uploaden, goedkeuren en distribueren. Beheerderstoestemming voor Microsoft Entra `User.Read.All` is optioneel en schakelt uitsluitend de terugvaloptie voor opzoeken op e-mailadres of user principal name (UPN) in. Voor het instellen van de bezorging van Nudges en Playbooks begint u bij **instellingen → Communicatie → Kanalen** en klikt u op de kaart **Microsoft Teams**. Deze pagina behandelt de onderliggende configuratie van de Teams-app. ## Vereisten Zorg voordat u Microsoft Teams configureert voor het volgende: * Een Microsoft Teams-beheerder die organisatie-apps kan uploaden en goedkeuren. Dezelfde persoon kan beide beheerdersrollen hebben. * Een Microsoft Entra-beheerder, alleen als u de optionele terugvaloptie voor opzoeken op e-mailadres/UPN wilt inschakelen met tenantbrede toestemming voor de `User.Read.All`-toepassing * Beheerdersrechten voor Living Security * Een actieve Living Security-organisatie * De namen van het team en het kanaal waarin beveiligingsaankondigingen moeten worden bezorgd, als kanaalaankondigingen zijn ingeschakeld * Uw Microsoft Entra-tenant-ID, beschikbaar onder **Microsoft Entra admin center → Identiteit → Overview** ## Wie doet wat | Rol | Verantwoordelijkheid | | - | - | | **Living Security-beheerder** | Koppelt de Microsoft-tenant, downloadt het regionale pakket, configureert installatieberichten, valideert de installatie en verzendt tests | | **Microsoft Teams-beheerder** | Uploadt de app en staat deze toe, distribueert de app naar de beoogde gebruikers of groepen en wijst beleid voor app-installatie toe | | **Microsoft Entra-beheerder**, optioneel | Verleent `User.Read.All`-toepassingstoestemming aan de regionale Bot-app-ID wanneer de terugvaloptie voor opzoeken op e-mailadres/UPN vereist is | | **Teams-eigenaar**, wanneer kanaalbezorging wordt gebruikt | Installeert de app voor het beoogde team en kanaal of keurt de app hiervoor goed | Dit kunnen verschillende personen zijn. Deel de checksum van het pakket, de Teams-app-ID, de **Bot-app-ID** en de beoogde uitrolpopulatie met de Microsoft Teams-beheerder. Deel de gegenereerde toestemmings-URL alleen met een Microsoft Entra-beheerder wanneer u de optionele terugvaloptie voor opzoeken op e-mailadres/UPN inschakelt. Deel geen andere Living Security-referenties die hier niet mee te maken hebben. ## Installatie Ga in Living Security naar **instellingen → Communicatie → Kanalen** en selecteer **Microsoft Teams**. Het paneel toont de regio van uw organisatie, de bestandsnaam van het pakket, de Teams-app-ID, de bot-app-ID, de SHA256-checksum, de configuratiestatus van de Microsoft-tenant, installatie-instructies, besturingselementen voor installatieberichten, validatie en hulpmiddelen voor testmeldingen. De regio die in Living Security wordt weergegeven, komt overeen met de regio waar uw organisatie wordt gehost. Voer bij **Uw tenant koppelen** de Microsoft Entra-tenant-ID in van de tenant waartoe de gebruikers en Teams-kanalen behoren die de meldingen ontvangen, en klik vervolgens op **Microsoft-tenant opslaan**. Eén Microsoft-tenant kan slechts bij één Living Security-organisatie horen. Als het besturingselement voor de tenant niet beschikbaar is, neemt u contact op met uw Living Security-implementatieverantwoordelijke of uw supportcontact om de tenant te koppelen of te wijzigen voordat u de app installeert. Living Security toont **Microsoft-tenant gekoppeld** voordat u verdergaat. Koppel de tenant indien mogelijk voordat u de Teams-app installeert. Als de app al is geïnstalleerd, slaat u eerst de tenant op en selecteert u **Installatie valideren**. Living Security probeert de bestaande installatie automatisch te koppelen; installeer de app alleen opnieuw als de validatie deze niet kan detecteren. Klik op **Teams-pakket downloaden**. Living Security levert een regiospecifiek ZIP-pakket voor uw organisatie. Controleer het gedownloade bestand aan de hand van de SHA256-checksum die in Living Security wordt weergegeven voordat u iets wijzigt. Als u de app uw eigen naam en pictogrammen wilt geven, volgt u na deze controle en vóór het uploaden van het pakket [Het regionale pakket van een eigen huisstijl voorzien](#het-regionale-pakket-van-een-eigen-huisstijl-voorzien). De checksum van het gedownloade bestand komt overeen met de SHA256-checksum die in Living Security wordt weergegeven. Ga in het Microsoft Teams admin center naar **Teams apps → Manage apps → Acties → Upload new app** en upload vervolgens het ZIP-bestand dat u van Living Security hebt gedownload. Controleer het volgende: * De Teams-app-ID en de bot-app-ID komen overeen met de waarden die in Living Security worden weergegeven * De app-naam is de regionale naam van Living Security, of de naam die u hebt ingesteld als u het pakket van een eigen huisstijl hebt voorzien * De uitgever is **Living Security**. Het aanpassen van de huisstijl van het pakket wijzigt de uitgever niet * De app is niet geblokkeerd * De app is beschikbaar voor de beoogde gebruikers of groepen * De app is geïnstalleerd via beleid voor app-installatie of gerichte installatie voor de gebruikers en teams/kanalen die meldingen moeten ontvangen Het kan even duren voordat Microsoft wijzigingen in de beschikbaarheid van de app en in het beleid voor app-installatie heeft doorgevoerd. Als validatie of een test direct na een wijziging in het app-beleid mislukt, controleert u de beleidstoewijzing in het Microsoft Teams admin center en probeert u het opnieuw nadat Microsoft de wijziging heeft doorgevoerd. Distribueer de persoonlijke app naar de beoogde gebruikers. Voordat Living Security een persoonlijke test naar een gedetecteerde installatie kan verzenden, moet ten minste één gebruiker de persoonlijke Living Security-app in Microsoft Teams installeren of openen. Hierdoor kan de bot de vertrouwde identiteit en de persoonlijke gespreksreferentie van de gebruiker vastleggen. Een installatie in een kanaal alleen kan niet worden gebruikt voor een persoonlijke test van een gedetecteerde installatie. Installeer voor kanaalbezorging de app in het beoogde team en kanaal, zodat de bot de gespreksreferentie van dat kanaal kan vastleggen. Een doelgebruiker heeft de persoonlijke app geïnstalleerd of geopend, of de app is geïnstalleerd in het beoogde kanaal. Kies in de sectie **Besturingselementen voor installatieberichten** of Teams-installatieberichten worden verzonden en pas de eenrichtingstekst voor uw organisatie aan. Beschikbare besturingselementen: * Installatieberichten verzenden * Persoonlijke installatieberichten verzenden * Kanaalinstallatieberichten verzenden * Standaardbericht * Persoonlijk bericht * Kanaalbericht Berichtvelden ondersteunen `{{installerName}}`, dat wordt vervangen door de weergavenaam van de gebruiker die de app heeft geïnstalleerd. Laat een persoonlijk bericht of kanaalbericht leeg om uw geconfigureerde standaardbericht te gebruiken. Als het standaardbericht ook leeg is, gebruikt Living Security het ingebouwde bericht voor die context. Klik in Living Security op **Installatie valideren**. De validatie controleert of het regionale pakket beschikbaar is, of de configuratie van de Microsoft-tenant aanwezig en uniek is voor deze Living Security-organisatie, of de regionale botreferenties zijn geconfigureerd en of voor de gekoppelde tenant een actieve app-installatie is gedetecteerd. De validatie toont **Validatie geslaagd** voordat u live meldingen verzendt. Klik voor de standaard persoonlijke test op **Test naar gedetecteerde installatie verzenden**. Living Security selecteert een gedetecteerde actieve persoonlijke installatie en gebruikt de opgeslagen vertrouwde identiteit en gespreksreferentie daarvan. Deze test roept Microsoft Graph niet aan en vereist geen `User.Read.All`-toestemming. Als er geen persoonlijke installatie is gedetecteerd, vraagt u een gebruiker om de persoonlijke Living Security-app te installeren of te openen, selecteert u opnieuw **Installatie valideren** en verzendt u de test opnieuw. Gebruik de geavanceerde gerichte test op e-mailadres/UPN alleen wanneer de optionele terugvaloptie voor opzoeken is ingeschakeld. De eenrichtingstestmelding verschijnt in Microsoft Teams. Raadpleeg de bijbehorende poging in het [Communicatielogboek](/nl/features/communications/log) wanneer diagnostische gegevens over de bezorging nodig zijn. ## Het regionale pakket van een eigen huisstijl voorzien Het regionale pakket is een ZIP-archief met drie bestanden: `manifest.json`, `color.png` en `outline.png`. U kunt in dat pakket uw eigen app-naam en pictogrammen instellen voordat u het uploadt. Living Security ondersteunt deze werkwijze voor regionale pakketten die een Teams-beheerder rechtstreeks uploadt. Doe dit nadat u het pakket hebt gedownload en gecontroleerd, en voordat u het uploadt in het Teams admin center. Pak het ZIP-bestand uit. Het bevat precies drie bestanden in de hoofdmap van het archief: `manifest.json`, `color.png` en `outline.png`. Vervang `color.png` en `outline.png` door uw eigen pictogrammen. Behoud dezelfde twee bestandsnamen. | Bestand | Vereiste | | - | - | | `color.png` | Volledig gekleurde PNG, 192 × 192 pixels, zonder transparantie | | `outline.png` | Transparante PNG, 32 × 32 pixels | Bewerk in `manifest.json` deze twee velden: * `name.short` — de naam die wordt weergegeven in de koptekst van de Teams-app en op andere plekken met beperkte ruimte. Maximaal 30 tekens. * `name.full` — de naam die wordt weergegeven in de app-catalogus en de app-details. Maximaal 100 tekens. Als er al een Living Security-app is geüpload in het Teams admin center, stelt u `version` hoger in dan de versie die daar is geïnstalleerd. Microsoft Teams weigert een update waarbij de versie niet hoger is, en een nieuwe download kan dezelfde versie hebben als het pakket dat u al hebt geïnstalleerd, of een lagere. U vindt de geïnstalleerde versie in het Teams admin center onder **Teams apps → Manage apps**, op de detailpagina van de app. Vergelijk deze met de waarde van `version` in het `manifest.json` dat u zojuist hebt gedownload en stel vervolgens een waarde in die hoger is dan beide. Behoud de notatie `MAJOR.MINOR.PATCH` met drie getallen. Als de geïnstalleerde app bijvoorbeeld `1.1.1` is en uw nieuwe download `1.1.0`, stelt u `1.1.2` in. Als u de gedownloade `1.1.0` verhoogt naar `1.1.1`, zou dit de geïnstalleerde versie herhalen en zou Teams de upload weigeren. Wijzig deze velden niet. Elk veld bevat de identiteit van de app, de bot of de single sign-on: * `id` * `botId` in `bots` * `webApplicationInfo` * `validDomains` * `contentUrl` en `websiteUrl` in `staticTabs` Een wijziging in een identiteitsveld kan ertoe leiden dat de app wel kan worden geïnstalleerd, maar geen meldingen kan bezorgen of single sign-on niet kan voltooien. **Installatie valideren** controleert de tenant, de botreferenties en de gedetecteerde installatie. Het vergelijkt uw manifest niet met het pakket dat Living Security heeft samengesteld. Maak een nieuw ZIP-archief van de drie bestanden. Plaats ze in de hoofdmap van het archief, zonder omsluitende map. Microsoft Teams weigert een pakket waarvan de `manifest.json` zich in een map bevindt. Upload het ZIP-bestand met uw eigen huisstijl in het Teams admin center, keer vervolgens terug naar Living Security en klik op **Installatie valideren**. Verzend een testmelding. De validatie toont **Validatie geslaagd** en de testmelding komt aan in Microsoft Teams onder uw app-naam en pictogrammen. ### Uitgever en checksum Door de huisstijl aan te passen stelt u de app-naam en pictogrammen in. Twee zaken wijzigen hierdoor niet: * **De uitgever blijft Living Security.** De velden `developer` in het manifest noemen Living Security en verwijzen naar de website, het privacybeleid en de servicevoorwaarden van Living Security. Samen identificeren zij het bedrijf dat de dienst exploiteert, zodat Teams **Living Security** blijft tonen als uitgever op de detailpagina van de app, in dialoogvensters voor toestemming voor machtigingen en in rapporten over app-gebruik. Uw naam en pictogrammen zijn wat gebruikers zien in de koptekst van de app, de app-catalogus en meldingen. * **De SHA256-checksum komt niet meer overeen.** De checksum die in Living Security wordt weergegeven, beschrijft het pakket zoals het is gedownload. Controleer deze voordat u de bestanden bewerkt en leg vervolgens de checksum van uw eigen pakket met aangepaste huisstijl vast in uw uitrolgegevens. ## Optioneel: de terugvaloptie voor opzoeken op e-mailadres/UPN inschakelen Normale persoonlijke bezorging maakt gebruik van een vertrouwde Microsoft Entra-object-ID die al bekend is bij Living Security, samen met de gespreksreferentie van de bot die wordt vastgelegd wanneer de gebruiker de app installeert of opent. Kanaalbezorging gebruikt de opgeslagen gespreksreferentie van het kanaal. Geen van beide routes vereist Microsoft Graph. Als een ontvanger geen vertrouwde Entra-object-ID heeft, kan Living Security optioneel Microsoft Graph gebruiken om de ontvanger te achterhalen via e-mailadres of UPN. Om deze terugvaloptie in te schakelen, vraagt u een Microsoft Entra-beheerder om in het Teams-installatiepaneel op **Optionele User.Read.All-toestemming verlenen** te klikken en de Microsoft Graph-toepassingsmachtiging `User.Read.All` goed te keuren voor de regionale Living Security Teams-toepassing. De flow voor beheerderstoestemming volgt dit Microsoft Entra-patroon: ```text theme={null} https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id} ``` Living Security genereert deze URL op basis van de ID van de gekoppelde tenant en de **Bot-app-ID** die in het installatiepaneel wordt weergegeven. De ID's hebben verschillende doelen: * De **Teams-app-ID** identificeert het installeerbare app-pakket in het Microsoft Teams admin center. * De **Bot-app-ID** identificeert de Microsoft Entra-toepassing van de regionale bot en is de client-ID die wordt gebruikt voor de optionele flow voor beheerderstoestemming. Vervang de Teams-app-ID niet in de toestemmings-URL. De integratie **Microsoft Entra ID (Client Credentials)** onder Gekoppelde Integraties is een afzonderlijke, algemene integratie. De referenties of toestemming hiervan kunnen niet worden hergebruikt door de regionale Teams-bot, en toestemming die aan een niet-gerelateerde Entra-toepassing is verleend, schakelt deze terugvaloptie niet in. Door toestemming optioneel te maken wordt `User.Read.All` niet verwijderd uit bestaande regionale Living Security-toepassingsregistraties. Klanten die al toestemming hebben verleend kunnen de terugvaloptie voor e-mailadres/UPN zonder herconfiguratie blijven gebruiken. ## Soorten meldingen Afhankelijk van de rechten van uw organisatie en de geconfigureerde Playbooks kan Living Security de volgende meldingen verzenden: | Melding | Beschrijving | | - | - | | Training-toewijzingen | Informeer gebruikers wanneer een Training is toegewezen, bijna moet worden afgerond of klaarstaat om te voltooien | | Training-herinneringen | Herinner gebruikers aan naderende deadlines | | Waarschuwingen over menselijk risico | Verzend gepersonaliseerde updates over de Menselijke risico-index en aanbevolen vervolgstappen | | Uitrolberichten | Verzend eenrichtingsmeldingen voor onboarding of uitrol tijdens de implementatie | | Kanaalaankondigingen | Plaats communicatie over het beveiligingsprogramma in geconfigureerde Teams-kanalen | ## Aanpassing Teams-meldingen gebruiken de configuratie van uw Living Security-organisatie. Ondersteunde velden zijn onder andere de weergavenaam van de klant, ondersteunde logo- en huisstijlvelden, berichttekst, oproepen tot actie, bestemmingslinks, uitroltekst en support-/contacttekst. Installatieberichten zijn configureerbaar via **instellingen → Communicatie → Kanalen → Microsoft Teams → Besturingselementen voor installatieberichten**. U kunt installatieberichten volledig uitschakelen, alleen persoonlijke of kanaalinstallatieberichten uitschakelen, en standaardtekst, persoonlijke tekst of kanaalspecifieke tekst configureren. De naam en pictogrammen van de Teams-app komen uit het regionale pakket. Zie [Het regionale pakket van een eigen huisstijl voorzien](#het-regionale-pakket-van-een-eigen-huisstijl-voorzien) als u uw eigen naam en pictogrammen wilt instellen. ## De app bijwerken of verwijderen * Wanneer Living Security een bijgewerkt regionaal pakket levert, downloadt u dit vanuit het Microsoft Teams-kanaalpaneel en uploadt u dat pakket via het Teams admin center. Controleer de weergegeven app-ID, bot-ID en checksum vóór de uitrol. * Aanpassingen aan de huisstijl blijven niet behouden bij een pakketupdate. Elk nieuw regionaal pakket bevat opnieuw de app-naam en pictogrammen van Living Security. Pas uw aanpassingen opnieuw toe met [Het regionale pakket van een eigen huisstijl voorzien](#het-regionale-pakket-van-een-eigen-huisstijl-voorzien) voordat u het nieuwe pakket uploadt. Bewaar uw pictogrammen, uw twee naamwaarden en de versie die u het laatst hebt geüpload op een vindbare plek, zodat elke upgrade een korte herhaling van dezelfde stappen is. Een nieuw pakket heeft niet altijd een hogere versie dan de versie die u hebt geïnstalleerd, dus stel de versie in op basis van wat Teams als geïnstalleerd toont. * Voer **Installatie valideren** opnieuw uit en verzend nog een test na een update van de app of het beleid. * Als u de app verwijdert of blokkeert, worden geen proactieve meldingen meer verzonden naar die gebruiker of dat kanaal. Installeer de app opnieuw en verzend een nieuwe test, zodat Living Security een actuele Teams-installatiegebeurtenis ontvangt. * Als u de bezorging via Teams stopzet, verwijdert u Teams uit de relevante Playbooks voordat u de app uit Microsoft Teams verwijdert. ## Probleemoplossing * Controleer of de persoonlijke Living Security Teams-app is geïnstalleerd en of de gebruiker deze heeft geopend, zodat Living Security over een actuele gespreksreferentie beschikt * Controleer of de geconfigureerde Microsoft-tenant-ID de tenant is waarin de gebruiker zich bevindt * Als de diagnostische gegevens laten zien dat de terugvaloptie voor e-mailadres/UPN is geprobeerd, controleert u of `User.Read.All`-beheerderstoestemming is verleend aan de weergegeven Bot-app-ID voor de juiste tenant * Wanneer de terugvaloptie voor e-mailadres/UPN wordt gebruikt, controleert u of het e-mailadres of de UPN van de gebruiker in Living Security overeenkomt met Microsoft Entra ID * Vraag de gebruiker de app te deblokkeren of opnieuw te installeren als die eerder is verwijderd of geblokkeerd De foutcategorie `TEAMS_ADMIN_CONSENT_REQUIRED`, of de Microsoft-fout `AADSTS7000229`, betekent dat bij het opzoeken van een ontvanger op e-mailadres/UPN de optionele terugvaloptie van Microsoft Graph is geprobeerd, maar dat de regionale Living Security Teams-app geen service principal (bedrijfstoepassing) heeft in de gekoppelde Microsoft Entra-tenant. De standaardroutes met vertrouwde ID en opgeslagen gesprek vereisen deze toestemming niet. Dit is geen verlopen Living Security-geheim. 1. Open **instellingen → Communicatie → Kanalen → Microsoft Teams**. U kunt ook **Microsoft Teams-installatie openen** gebruiken vanuit de fout in het Communicatielogboek. 2. Controleer of de juiste Microsoft Entra-tenant-ID is gekoppeld. 3. Als de terugvaloptie voor e-mailadres/UPN vereist is, vraagt u een Microsoft Entra-beheerder om te klikken op **Optionele User.Read.All-toestemming verlenen** en `User.Read.All` goed te keuren voor de weergegeven **Bot-app-ID**. Zorg anders dat de ontvanger de persoonlijke app heeft geopend en dat Living Security over de vertrouwde Entra-object-ID beschikt. 4. Nadat Microsoft de toestemming heeft verwerkt, verzendt u vanuit de Microsoft Teams-installatie een geavanceerde gerichte test op e-mailadres/UPN. Het Communicatielogboek toont de bezorggeschiedenis en diagnostische gegevens; het bezorgt het mislukte bericht niet opnieuw. Het opnieuw configureren van **Microsoft Entra ID (Client Credentials)** lost deze fout niet op, omdat die integratie niet wordt gebruikt voor de bezorging van Teams-meldingen. * Controleer of de bot is geblokkeerd, verwijderd of gedeïnstalleerd * Als de app is geïnstalleerd voordat de tenant in Living Security werd gekoppeld, slaat u de tenant op en selecteert u **Installatie valideren**, zodat Living Security de bestaande installatie kan koppelen * Installeer de app alleen opnieuw als de validatie de bestaande installatie niet kan detecteren * Controleer of de doelgebruiker of het doelkanaal de meest recente app-installatiegebeurtenis heeft ontvangen * Verzend een nieuwe testmelding nadat u de app opnieuw hebt geïnstalleerd Voorbeeld van velden van een installatiegebeurtenis die worden gebruikt bij probleemoplossing: ```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" } } ``` ## Beveiliging Living Security gebruikt Microsoft Graph `User.Read.All` uitsluitend voor de optionele terugvaloptie voor het opzoeken van ontvangers op e-mailadres/UPN. Standaard gebruikt de routering van persoonlijke meldingen een vertrouwde Entra-object-ID uit de entiteitsgegevens van Living Security en de gespreksreferentie van de bot die uit Microsoft Teams is vastgelegd. Door de aanroeper opgegeven object-ID's en gespreksreferenties worden niet vertrouwd als routeringsgegevens. Microsoft Teams-berichten worden bezorgd via de Living Security Teams-bot, die uitsluitend voor meldingen is bedoeld, met behulp van proactieve berichten van Microsoft Teams. Living Security vereist niet dat klanten voor de standaardinstallatie van de Teams-app een eigen Microsoft Entra-appregistratie aanmaken of een eigen clientgeheim delen. Regiospecifieke Teams-pakketten houden de app-ID, de bot-ID en het berichteneindpunt afgestemd op de Living Security-regio waar uw organisatie wordt gehost. ## Gerelateerd Configureer e-mail als bezorgkanaal. Configureer Slack als bezorgkanaal. Volg de bezorgstatus en geschiedenis van Teams. Configuratie van Microsoft Entra ID en SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.