Voraussetzungen
Stellen Sie vor der Konfiguration von Microsoft Teams Folgendes sicher:- Ein Microsoft-Teams-Administrator, der Apps der Organisation hochladen und genehmigen kann. Dieselbe Person kann beide Administratorrollen innehaben.
- Ein Microsoft-Entra-Administrator, nur wenn Sie den optionalen Fallback für die Suche per E-Mail/UPN mit mandantenweiter
User.Read.All-Anwendungseinwilligung aktivieren möchten - Administratorrechte in Living Security
- Eine aktive Living-Security-Organisation
- Die Namen von Team und Kanal, in denen Sicherheitsankündigungen zugestellt werden sollen, sofern Kanalankündigungen aktiviert sind
- Ihre Microsoft-Entra-Mandanten-ID, verfügbar unter Microsoft Entra admin center → Identität → Übersicht
Wer macht was
Einrichtung
Das Microsoft-Teams-Einrichtungsfenster öffnen
Microsoft-Mandanten verbinden
Regionales Teams-Paket herunterladen
Paket im Teams admin center hochladen und installieren
- Die Teams-App-ID und die Bot-App-ID stimmen mit den in Living Security angezeigten Werten überein
- Der App-Name ist der regionale Living-Security-Name oder der Name, den Sie beim Rebranding des Pakets festgelegt haben
- Der Herausgeber ist Living Security. Das Rebranding des Pakets ändert den Herausgeber nicht
- Die App ist nicht blockiert
- Die App steht den vorgesehenen Benutzern oder Gruppen zur Verfügung
- Die App wird über App-Setup-Richtlinien oder gezielte Installation für die Benutzer und Teams/Kanäle installiert, die Benachrichtigungen erhalten sollen
App installieren oder öffnen
Installationsnachrichten konfigurieren
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{installerName}}, das durch den Anzeigenamen des Benutzers ersetzt wird, der die App installiert hat. Lassen Sie eine persönliche Nachricht oder eine Kanalnachricht leer, um Ihre konfigurierte Standardnachricht zu verwenden. Ist auch die Standardnachricht leer, verwendet Living Security die integrierte Nachricht für den jeweiligen Geltungsbereich.Einrichtung validieren
Testbenachrichtigungen senden
User.Read.All-Einwilligung.Wenn keine persönliche Installation erkannt wird, bitten Sie einen Benutzer, die
persönliche Living Security App zu installieren oder zu öffnen, wählen Sie erneut Validate install und senden Sie den Test
anschließend erneut. Verwenden Sie den erweiterten gezielten E-Mail/UPN-Test nur, wenn der
optionale Lookup-Fallback aktiviert ist.Regionales Paket mit eigenem Branding versehen
Das regionale Paket ist ein ZIP-Archiv mit drei Dateien:manifest.json, color.png und outline.png. Sie können in diesem Paket Ihren eigenen App-Namen und Ihre eigenen Symbole festlegen, bevor Sie es hochladen. Living Security unterstützt diesen Weg für regionale Pakete, die ein Teams-Administrator direkt hochlädt.
Führen Sie dies aus, nachdem Sie das Paket heruntergeladen und geprüft haben, und bevor Sie es im Teams admin center hochladen.
Paket entpacken
manifest.json, color.png und outline.png.Symbole ersetzen
color.png und outline.png durch Ihre eigenen Symbole. Behalten Sie dieselben zwei
Dateinamen bei.App-Namen festlegen
manifest.json diese beiden Felder:-
name.short– der Name, der in der Teams-App-Kopfzeile und in anderen platzbeschränkten Bereichen angezeigt wird. Maximal 30 Zeichen. -
name.full– der Name, der im App-Katalog und in den App-Details angezeigt wird. Maximal 100 Zeichen.Wenn im Teams admin center bereits eine Living-Security-App hochgeladen ist, setzen Sieversionhöher als die dort installierte Version. Microsoft Teams lehnt ein Update ab, das die Version nicht erhöht, und ein frischer Download kann dieselbe Version wie das bereits installierte Paket oder eine niedrigere Version tragen.Lesen Sie die installierte Version im Teams admin center unter Teams apps → Manage apps auf der Seite mit den App-Details ab. Vergleichen Sie sie mit dem Wertversionin der soeben heruntergeladenen Dateimanifest.jsonund legen Sie dann einen Wert fest, der höher ist als beide. Behalten Sie das dreiteilige ZahlenformatMAJOR.MINOR.PATCHbei.Wenn beispielsweise die installierte App1.1.1ist und Ihr neuer Download1.1.0, setzen Sie1.1.2. Würden Sie das heruntergeladene1.1.0auf1.1.1erhöhen, würde dies die installierte Version wiederholen, und Teams würde den Upload ablehnen.
Identitätsfelder unverändert lassen
-
id -
botIdinbots -
webApplicationInfo -
validDomains -
contentUrlundwebsiteUrlinstaticTabs
Die drei Dateien erneut zippen
manifest.json sich in einem Ordner befindet.Hochladen und überprüfen
Herausgeber und Prüfsumme
Das Rebranding legt App-Namen und Symbole fest. Zwei Dinge ändert es nicht:- Der Herausgeber bleibt Living Security. Die Manifestfelder
developernennen Living Security und verweisen auf die Website, die Datenschutzerklärung und die Nutzungsbedingungen von Living Security. Zusammen identifizieren sie das Unternehmen, das den Dienst betreibt, sodass Teams weiterhin Living Security als Herausgeber auf der Seite mit den App-Details, in Dialogen zur Berechtigungseinwilligung und in App-Nutzungsberichten anzeigt. Ihr Name und Ihre Symbole sind das, was Benutzer in der App-Kopfzeile, im App-Katalog und in Benachrichtigungen sehen. - Die SHA256-Prüfsumme stimmt nicht mehr überein. Die in Living Security angezeigte Prüfsumme beschreibt das Paket im heruntergeladenen Zustand. Prüfen Sie sie, bevor Sie die Dateien bearbeiten, und halten Sie dann die Prüfsumme Ihres eigenen Pakets mit neuem Branding für Ihre Rollout-Unterlagen fest.
Optional: Fallback für die Suche per E-Mail/UPN aktivieren
Die normale persönliche Zustellung verwendet eine vertrauenswürdige Microsoft-Entra-Objekt-ID, die Living Security bereits bekannt ist, zusammen mit der Bot-Konversationsreferenz, die erfasst wird, wenn der Benutzer die App installiert oder öffnet. Die Kanalzustellung verwendet die gespeicherte Konversationsreferenz des Kanals. Keine der beiden Routen erfordert Microsoft Graph. Wenn ein Empfänger keine vertrauenswürdige Entra-Objekt-ID hat, kann Living Security optional Microsoft Graph verwenden, um den Empfänger anhand der E-Mail-Adresse oder des UPN aufzulösen. Um diesen Fallback zu aktivieren, bitten Sie einen Microsoft-Entra-Administrator, im Teams-Einrichtungsfenster auf Grant optional User.Read.All consent zu klicken und die Microsoft-Graph-AnwendungsberechtigungUser.Read.All für die regionale Living
Security Teams-Anwendung zu genehmigen.
Der Ablauf der Administratoreinwilligung folgt diesem Microsoft-Entra-Muster:
- Die Teams-App-ID identifiziert das installierbare App-Paket im Microsoft Teams admin center.
- Die Bot-App-ID identifiziert die Microsoft-Entra-Anwendung des regionalen Bots und ist die Client-ID, die für den optionalen Ablauf der Administratoreinwilligung verwendet wird.
User.Read.All nicht aus bestehenden regionalen
Living-Security-Anwendungsregistrierungen. Kunden, die die Einwilligung bereits erteilt haben,
können den E-Mail/UPN-Fallback ohne Neukonfiguration weiter nutzen.Benachrichtigungstypen
Abhängig von den Berechtigungen Ihrer Organisation und den konfigurierten Playbooks kann Living Security Folgendes senden:Anpassung
Teams-Benachrichtigungen verwenden die Konfiguration Ihrer Living-Security-Organisation. Unterstützte Felder sind der Anzeigename des Kunden, unterstützte Logo- und Markenfelder, Nachrichtentext, Handlungsaufforderungen, Ziel-Links, Rollout-Text sowie Support-/Kontakttext. Installationsnachrichten lassen sich unter Einstellungen → Communications → Channels → Microsoft Teams → Install message controls konfigurieren. Sie können Installationsnachrichten vollständig deaktivieren, nur persönliche oder Kanal-Installationsnachrichten deaktivieren und Standardtexte, persönliche Texte oder kanalspezifische Texte konfigurieren. Der Name und die Symbole der Teams-App stammen aus dem regionalen Paket. Informationen dazu, wie Sie eigene festlegen, finden Sie unter Regionales Paket mit eigenem Branding versehen.App aktualisieren oder entfernen
- Wenn Living Security ein aktualisiertes regionales Paket bereitstellt, laden Sie es im Microsoft-Teams-Kanalfenster herunter und laden Sie dieses Paket über das Teams admin center hoch. Prüfen Sie vor dem Rollout die angezeigte App-ID, Bot-ID und Prüfsumme.
- Branding-Änderungen bleiben bei einem Paket-Update nicht erhalten. Jedes neue regionale Paket enthält wieder den Living-Security-App-Namen und die Living-Security-Symbole. Wenden Sie Ihre Änderungen erneut an, indem Sie Regionales Paket mit eigenem Branding versehen befolgen, bevor Sie das neue Paket hochladen. Bewahren Sie Ihre Symbole, Ihre beiden Namenswerte und die zuletzt hochgeladene Version an einem leicht auffindbaren Ort auf, sodass jedes Upgrade eine kurze Wiederholung derselben Schritte ist. Ein neues Paket trägt nicht immer eine höhere Version als die installierte; legen Sie die Version daher anhand dessen fest, was Teams als installiert anzeigt.
- Führen Sie nach einem App- oder Richtlinien-Update Validate install erneut aus und senden Sie eine weitere Testbenachrichtigung.
- Das Entfernen oder Blockieren der App verhindert proaktive Benachrichtigungen an den betreffenden Benutzer oder Kanal. Installieren Sie die App erneut und senden Sie einen neuen Test, damit Living Security ein aktuelles Teams-Installationsereignis erhält.
- Wenn Sie die Teams-Zustellung einstellen, entfernen Sie Teams aus den betreffenden Playbooks, bevor Sie die App aus Microsoft Teams entfernen.
Fehlerbehebung
Ein Benutzer erhält keine persönliche Benachrichtigung
Ein Benutzer erhält keine persönliche Benachrichtigung
- Vergewissern Sie sich, dass die persönliche Living Security Teams-App installiert ist und der Benutzer sie geöffnet hat, damit Living Security über eine aktuelle Konversationsreferenz verfügt
- Vergewissern Sie sich, dass die konfigurierte Microsoft-Mandanten-ID die des Mandanten ist, in dem sich der Benutzer befindet
- Wenn die Diagnose zeigt, dass der E-Mail/UPN-Fallback versucht wurde, vergewissern Sie sich, dass die
User.Read.All-Administratoreinwilligung für die angezeigte Bot-App-ID und den richtigen Mandanten erteilt wurde - Wenn der E-Mail/UPN-Fallback verwendet wird, prüfen Sie, ob die E-Mail-Adresse oder der UPN des Benutzers in Living Security mit Microsoft Entra ID übereinstimmt
- Bitten Sie den Benutzer, die App zu entsperren oder neu zu installieren, falls er sie zuvor entfernt oder blockiert hat
Eine Kanalankündigung erscheint nicht
Eine Kanalankündigung erscheint nicht
- Vergewissern Sie sich, dass die Living Security Teams-App im Zielteam oder Zielkanal installiert ist.
- Vergewissern Sie sich, dass die Kanalzuordnung in Living Security das richtige Team und den richtigen Kanal verwendet.
- Prüfen Sie, ob der Kanal entfernt, umbenannt, archiviert oder eingeschränkt wurde.
- Installieren Sie die App im Zielteam oder Zielkanal erneut und senden Sie eine weitere Testbenachrichtigung.
Die optionale Suche per E-Mail/UPN oder die Einwilligung schlägt fehl
Die optionale Suche per E-Mail/UPN oder die Einwilligung schlägt fehl
- Vergewissern Sie sich, dass ein Microsoft-Entra-Administrator die mandantenweite Einwilligung für
Microsoft Graph
User.Read.Allfür die angezeigte Bot-App-ID erteilt hat. - Vergewissern Sie sich, dass die konfigurierte Mandanten-ID die des Mandanten ist, in dem sich Benutzer und Teams befinden.
- Prüfen Sie, ob der Benutzer in Microsoft Entra ID existiert und kein Gast aus einem anderen Mandanten ist.
Communication Log zeigt an, dass eine Microsoft-Administratoreinwilligung erforderlich ist
Communication Log zeigt an, dass eine Microsoft-Administratoreinwilligung erforderlich ist
TEAMS_ADMIN_CONSENT_REQUIRED oder der Microsoft-Fehler AADSTS7000229 bedeutet, dass bei einer Empfängersuche per E-Mail/UPN der optionale Microsoft-Graph-Fallback versucht wurde, die regionale Living Security Teams-App im verbundenen Microsoft-Entra-Mandanten jedoch keinen Dienstprinzipal (Unternehmensanwendung) hat. Die Standardrouten über vertrauenswürdige ID und gespeicherte Konversation erfordern diese Einwilligung nicht. Es handelt sich nicht um ein abgelaufenes Living-Security-Secret.- Öffnen Sie Einstellungen → Communications → Channels → Microsoft Teams. Sie können auch Open Microsoft Teams setup im Fehler des Communication Log verwenden.
- Vergewissern Sie sich, dass die richtige Microsoft-Entra-Mandanten-ID verbunden ist.
- Wenn der E-Mail/UPN-Fallback erforderlich ist, bitten Sie einen Microsoft-Entra-Administrator, auf Grant optional User.Read.All consent zu klicken und
User.Read.Allfür die angezeigte Bot-App-ID zu genehmigen. Stellen Sie andernfalls sicher, dass der Empfänger die persönliche App geöffnet hat und Living Security über seine vertrauenswürdige Entra-Objekt-ID verfügt. - Senden Sie, nachdem Microsoft die Einwilligung verarbeitet hat, über die Microsoft-Teams-Einrichtung einen erweiterten gezielten E-Mail/UPN-Test. Das Communication Log zeigt Zustellverlauf und Diagnosedaten; es stellt die fehlgeschlagene Nachricht nicht erneut zu.
Die App ist installiert, aber Benachrichtigungen schlagen fehl
Die App ist installiert, aber Benachrichtigungen schlagen fehl
- Prüfen Sie, ob der Bot blockiert, entfernt oder deinstalliert wurde
- Wenn die App installiert wurde, bevor der Mandant in Living Security verbunden wurde, speichern Sie den Mandanten und wählen Sie Validate install, damit Living Security die vorhandene Installation zuordnen kann
- Installieren Sie die App nur dann neu, wenn die Validierung die vorhandene Installation nicht erkennen kann
- Vergewissern Sie sich, dass der Zielbenutzer oder Zielkanal das aktuelle App-Installationsereignis erhalten hat
- Senden Sie nach der Neuinstallation der App eine neue Testbenachrichtigung
Sicherheit
Living Security verwendet Microsoft GraphUser.Read.All ausschließlich für den optionalen Fallback der Empfängersuche per E-Mail/UPN. Standardmäßig verwendet das Routing persönlicher Benachrichtigungen eine vertrauenswürdige Entra-Objekt-ID aus den Entitätsdaten von Living Security sowie die aus Microsoft Teams erfasste Bot-Konversationsreferenz. Vom Aufrufer bereitgestellte Objekt-IDs und Konversationsreferenzen gelten nicht als vertrauenswürdige Routingdaten. Microsoft-Teams-Nachrichten werden über den ausschließlich für Benachrichtigungen vorgesehenen Living-Security-Teams-Bot mithilfe des proaktiven Nachrichtenversands von Microsoft Teams zugestellt.
Living Security verlangt von Kunden für die Standardeinrichtung der Teams-App weder eine eigene Microsoft-Entra-App-Registrierung noch die Weitergabe eines kundeneigenen Client-Secrets.
Regionsspezifische Teams-Pakete halten App-ID, Bot-ID und Messaging-Endpunkt auf die Living-Security-Region abgestimmt, in der Ihre Organisation gehostet wird.

