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
Installatie
Open het Microsoft Teams-installatiepaneel
Koppel uw Microsoft-tenant
Download het regionale Teams-pakket
Upload en installeer het pakket in het Teams admin center
- 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
Installeer of open de app
Configureer installatieberichten
- Installatieberichten verzenden
- Persoonlijke installatieberichten verzenden
- Kanaalinstallatieberichten verzenden
- Standaardbericht
- Persoonlijk bericht
- Kanaalbericht
{{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.Valideer de installatie
Verzend testmeldingen
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.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 pakket uit
manifest.json, color.png en outline.png.Vervang de pictogrammen
color.png en outline.png door uw eigen pictogrammen. Behoud dezelfde twee
bestandsnamen.Stel uw app-naam 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 uversionhoger 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 vanversionin hetmanifest.jsondat u zojuist hebt gedownload en stel vervolgens een waarde in die hoger is dan beide. Behoud de notatieMAJOR.MINOR.PATCHmet drie getallen.Als de geïnstalleerde app bijvoorbeeld1.1.1is en uw nieuwe download1.1.0, stelt u1.1.2in. Als u de gedownloade1.1.0verhoogt naar1.1.1, zou dit de geïnstalleerde versie herhalen en zou Teams de upload weigeren.
Laat de identiteitsvelden ongewijzigd
-
id -
botIdinbots -
webApplicationInfo -
validDomains -
contentUrlenwebsiteUrlinstaticTabs
Zip de drie bestanden opnieuw
manifest.json zich in een map bevindt.Upload en controleer
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
developerin 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-toepassingsmachtigingUser.Read.All goed te keuren voor de regionale Living
Security Teams-toepassing.
De flow voor beheerderstoestemming volgt dit Microsoft Entra-patroon:
- 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.
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
Een gebruiker ontvangt geen persoonlijke melding
Een gebruiker ontvangt geen persoonlijke melding
- 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
Een kanaalaankondiging verschijnt niet
Een kanaalaankondiging verschijnt niet
- 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.
Optioneel opzoeken op e-mailadres/UPN of toestemming mislukt
Optioneel opzoeken op e-mailadres/UPN of toestemming mislukt
- Controleer of een Microsoft Entra-beheerder tenantbrede toestemming heeft verleend voor
Microsoft Graph
User.Read.Allaan 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.
Communicatielogboek toont dat Microsoft-beheerderstoestemming vereist is
Communicatielogboek toont dat Microsoft-beheerderstoestemming vereist is
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.- Open instellingen → Communicatie → Kanalen → Microsoft Teams. U kunt ook Microsoft Teams-installatie openen gebruiken vanuit de fout in het Communicatielogboek.
- Controleer of de juiste Microsoft Entra-tenant-ID is gekoppeld.
- 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.Allgoed 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. - 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.
De app is geïnstalleerd, maar meldingen mislukken
De app is geïnstalleerd, maar meldingen mislukken
- 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
Beveiliging
Living Security gebruikt Microsoft GraphUser.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.

