Skip to main content
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

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

1

Open het Microsoft Teams-installatiepaneel

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.
2

Koppel uw Microsoft-tenant

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.
3

Download het regionale Teams-pakket

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.
De checksum van het gedownloade bestand komt overeen met de SHA256-checksum die in Living Security wordt weergegeven.
4

Upload en installeer het pakket in het Teams admin center

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.
5

Installeer of open de app

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.
6

Configureer installatieberichten

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.
7

Valideer de installatie

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.
8

Verzend testmeldingen

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 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.
1

Pak het pakket uit

Pak het ZIP-bestand uit. Het bevat precies drie bestanden in de hoofdmap van het archief: manifest.json, color.png en outline.png.
2

Vervang de pictogrammen

Vervang color.png en outline.png door uw eigen pictogrammen. Behoud dezelfde twee bestandsnamen.
3

Stel uw app-naam in

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.
4

Laat de identiteitsvelden ongewijzigd

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.
5

Zip de drie bestanden opnieuw

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.
6

Upload en controleer

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:
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:

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 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 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
  • Controleer of de Living Security Teams-app is geïnstalleerd in het doelteam of -kanaal.
  • Controleer of de kanaaltoewijzing in Living Security het juiste team en kanaal gebruikt.
  • Controleer of het kanaal is verwijderd, hernoemd, gearchiveerd of beperkt.
  • Installeer de app opnieuw in het doelteam of -kanaal en verzend nog een testmelding.
  • Controleer of een Microsoft Entra-beheerder tenantbrede toestemming heeft verleend voor Microsoft Graph User.Read.All aan de weergegeven Bot-app-ID.
  • Controleer of de geconfigureerde tenant-ID de tenant is waarin de gebruikers en Teams zich bevinden.
  • Controleer of de gebruiker bestaat in Microsoft Entra ID en geen gast is van een andere tenant.
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:

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

E-mailintegratie

Configureer e-mail als bezorgkanaal.

Slack-integratie

Configureer Slack als bezorgkanaal.

Communicatielogboek

Volg de bezorgstatus en geschiedenis van Teams.

Authenticatie

Configuratie van Microsoft Entra ID en SSO.