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

# Microsoft-Teams-Integration

> Verbinden Sie Living Security mit Microsoft Teams, um Schulungsbenachrichtigungen, Sicherheitswarnungen und Kanalankündigungen zu versenden.

Die Microsoft-Teams-Integration sendet Living-Security-Benachrichtigungen über die Living Security Teams-App an Benutzer und Kanäle. Nutzen Sie sie für Schulungszuweisungen, Warnungen zum Human Risk, Rollout-Nachrichten und Ankündigungen des Sicherheitsteams.

Diese Integration dient ausschließlich dem Versand von Benachrichtigungen. Benutzer senden in Microsoft Teams keine Befehle an den Bot. Wenn die App installiert ist, speichert der Bot die Teams-Konversationsreferenz für künftige proaktive Benachrichtigungen. Installationsnachrichten sind unidirektional und können an die Anforderungen des Unternehmens-Rollouts angepasst oder deaktiviert werden.

<Warning>
  Ein Microsoft-Teams-Administrator muss die Living Security Teams-App weiterhin hochladen, genehmigen und verteilen. Die Administratoreinwilligung für Microsoft Entra `User.Read.All` ist
  optional und aktiviert lediglich den Fallback für die Suche per E-Mail-Adresse oder User Principal Name (UPN).
</Warning>

<Note>
  Für die Einrichtung der Zustellung von Schubsen und Playbooks beginnen Sie unter **Einstellungen → Communications →
  Channels** und klicken Sie auf die Karte **Microsoft Teams**. Diese Seite behandelt die
  zugrunde liegende Konfiguration der Teams-App.
</Note>

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

| Rolle | Verantwortlichkeit |
| - | - |
| **Living-Security-Administrator** | Verbindet den Microsoft-Mandanten, lädt das regionale Paket herunter, konfiguriert Installationsnachrichten, validiert die Einrichtung und sendet Tests |
| **Microsoft-Teams-Administrator** | Lädt die App hoch und erlaubt sie, verteilt sie an die vorgesehenen Benutzer oder Gruppen und weist App-Setup-Richtlinien zu |
| **Microsoft-Entra-Administrator**, optional | Erteilt die `User.Read.All`-Anwendungseinwilligung für die regionale Bot-App-ID, wenn der Fallback für die Suche per E-Mail/UPN erforderlich ist |
| **Teams-Besitzer**, wenn die Kanalzustellung genutzt wird | Installiert die App für das vorgesehene Team und den vorgesehenen Kanal oder genehmigt sie dort |

Diese Rollen können von verschiedenen Personen wahrgenommen werden. Teilen Sie die Prüfsumme des Pakets, die Teams-App-ID, die **Bot-App-ID** und die vorgesehene Rollout-Zielgruppe mit dem Microsoft-Teams-Administrator. Teilen Sie die generierte Einwilligungs-URL nur dann mit einem Microsoft-Entra-Administrator, wenn Sie den optionalen Fallback für die Suche per E-Mail/UPN aktivieren. Geben Sie keine nicht zugehörigen Living-Security-Zugangsdaten weiter.

## Einrichtung

<Steps>
  <Step title="Das Microsoft-Teams-Einrichtungsfenster öffnen">
    Gehen Sie in Living Security zu **Einstellungen → Communications → Channels** und wählen Sie **Microsoft Teams**.

    Das Fenster zeigt die Region Ihrer Organisation, den Paketdateinamen, die Teams-App-ID, die Bot-App-ID, die SHA256-Prüfsumme, den Konfigurationsstatus des Microsoft-Mandanten, Installationsanweisungen, Steuerelemente für Installationsnachrichten sowie Werkzeuge für Validierung und Testbenachrichtigungen.

    <Check>
      Die in Living Security angezeigte Region entspricht der Region, in der Ihre Organisation gehostet wird.
    </Check>
  </Step>

  <Step title="Microsoft-Mandanten verbinden">
    Geben Sie unter **Connect your tenant** die Microsoft-Entra-Mandanten-ID ein, zu der die Benutzer und Teams-Kanäle gehören, die Benachrichtigungen erhalten, und klicken Sie dann auf **Save Microsoft tenant**. Ein Microsoft-Mandant kann nur zu einer Living-Security-Organisation gehören.

    Wenn das Steuerelement für den Mandanten nicht verfügbar ist, wenden Sie sich an Ihren Living-Security-Implementierungsverantwortlichen oder Ihren Support-Kontakt, um den Mandanten vor der Installation der App zu verbinden oder zu ändern.

    <Check>
      Living Security zeigt **Microsoft tenant connected** an, bevor Sie fortfahren.
    </Check>

    <Note>
      Verbinden Sie den Mandanten nach Möglichkeit, bevor Sie die Teams-App installieren. Wenn die App bereits installiert ist, speichern Sie den Mandanten und wählen Sie zuerst **Validate install**. Living Security versucht, die vorhandene Installation automatisch zuzuordnen; installieren Sie die App nur dann neu, wenn die Validierung sie nicht erkennen kann.
    </Note>
  </Step>

  <Step title="Regionales Teams-Paket herunterladen">
    Klicken Sie auf **Download Teams package**. Living Security stellt für Ihre Organisation ein regionsspezifisches ZIP-Paket bereit.

    Prüfen Sie die heruntergeladene Datei anhand der in Living Security angezeigten SHA256-Prüfsumme, bevor Sie etwas ändern. Um der App einen eigenen Namen und eigene Symbole zu geben, folgen Sie nach dieser Prüfung und vor dem Hochladen des Pakets der Anleitung unter [Regionales Paket mit eigenem Branding versehen](#regionales-paket-mit-eigenem-branding-versehen).

    <Check>
      Die Prüfsumme der heruntergeladenen Datei stimmt mit der in Living Security angezeigten SHA256-Prüfsumme überein.
    </Check>
  </Step>

  <Step title="Paket im Teams admin center hochladen und installieren">
    Gehen Sie im Microsoft Teams admin center zu **Teams apps → Manage apps → Aktionen → Upload new app** und laden Sie die aus Living Security heruntergeladene ZIP-Datei hoch.

    Prüfen Sie Folgendes:

    * 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

    Es kann einige Zeit dauern, bis Microsoft Änderungen an der App-Verfügbarkeit und an Setup-Richtlinien übernommen hat.

    <Note>
      Wenn die Validierung oder ein Test unmittelbar nach einer Änderung der App-Richtlinie fehlschlägt, prüfen Sie die Richtlinienzuweisung im Microsoft Teams admin center und wiederholen Sie den Vorgang, nachdem Microsoft die Änderung übernommen hat.
    </Note>
  </Step>

  <Step title="App installieren oder öffnen">
    Verteilen Sie die persönliche App an die vorgesehenen Benutzer. Damit Living Security
    einen persönlichen Test an eine erkannte Installation senden kann, muss mindestens ein Benutzer die persönliche
    Living Security App in Microsoft Teams installieren oder öffnen. Dadurch
    kann der Bot die vertrauenswürdige Identität des Benutzers und die persönliche
    Konversationsreferenz erfassen. Eine Kanalinstallation allein kann für einen
    persönlichen Test an eine erkannte Installation nicht verwendet werden.

    Installieren Sie die App für die Kanalzustellung im vorgesehenen Team und Kanal, damit der
    Bot die Konversationsreferenz dieses Kanals erfassen kann.

    <Check>
      Ein Zielbenutzer hat die persönliche App installiert oder geöffnet, oder die App ist
      im vorgesehenen Kanal installiert.
    </Check>
  </Step>

  <Step title="Installationsnachrichten konfigurieren">
    Legen Sie im Abschnitt **Install message controls** fest, ob Teams-Installationsnachrichten gesendet werden, und passen Sie den unidirektionalen Text für Ihre Organisation an.

    Verfügbare Steuerelemente:

    * Send install messages
    * Send personal install messages
    * Send channel install messages
    * Default message
    * Personal message
    * Channel message

    Die Nachrichtenfelder unterstützen `{{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.
  </Step>

  <Step title="Einrichtung validieren">
    Klicken Sie in Living Security auf **Validate install**. Die Validierung prüft, ob das regionale Paket verfügbar ist, ob die Konfiguration des Microsoft-Mandanten vorhanden und ausschließlich dieser Living-Security-Organisation zugeordnet ist, ob die regionalen Bot-Zugangsdaten konfiguriert sind und ob für den verbundenen Mandanten eine aktive App-Installation erkannt wurde.

    <Check>
      Die Validierung zeigt **Validation passed** an, bevor Sie Live-Benachrichtigungen senden.
    </Check>
  </Step>

  <Step title="Testbenachrichtigungen senden">
    Klicken Sie für den persönlichen Standardtest auf **Send test to detected installation**.
    Living Security wählt eine erkannte aktive persönliche Installation aus und verwendet deren
    gespeicherte vertrauenswürdige Identität und Konversationsreferenz. Dieser Test ruft
    Microsoft Graph nicht auf und erfordert keine `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.

    <Check>Die unidirektionale Testbenachrichtigung erscheint in Microsoft Teams.</Check>

    Prüfen Sie den entsprechenden Versuch im [Communication Log](/de/features/communications/log), wenn Diagnosedaten zur Zustellung benötigt werden.
  </Step>
</Steps>

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

<Steps>
  <Step title="Paket entpacken">
    Extrahieren Sie die ZIP-Datei. Sie enthält genau drei Dateien im Stammverzeichnis des
    Archivs: `manifest.json`, `color.png` und `outline.png`.
  </Step>

  <Step title="Symbole ersetzen">
    Ersetzen Sie `color.png` und `outline.png` durch Ihre eigenen Symbole. Behalten Sie dieselben zwei
    Dateinamen bei.

    | Datei | Anforderung |
    | - | - |
    | `color.png` | Farbiges PNG, 192 × 192 Pixel, ohne Transparenz |
    | `outline.png` | Transparentes PNG, 32 × 32 Pixel |
  </Step>

  <Step title="App-Namen festlegen">
    Bearbeiten Sie in `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.

          <Note>
            Wenn im Teams admin center bereits eine Living-Security-App hochgeladen ist, setzen Sie
            `version` hö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 Wert `version` in der
            soeben heruntergeladenen Datei `manifest.json` und legen Sie dann einen Wert fest, der höher ist als beide. Behalten Sie
            das dreiteilige Zahlenformat `MAJOR.MINOR.PATCH` bei.

            Wenn beispielsweise die installierte App `1.1.1` ist und Ihr neuer Download `1.1.0`,
            setzen Sie `1.1.2`. Würden Sie das heruntergeladene `1.1.0` auf `1.1.1` erhöhen, würde dies die
            installierte Version wiederholen, und Teams würde den Upload ablehnen.
          </Note>
  </Step>

  <Step title="Identitätsfelder unverändert lassen">
    Ändern Sie diese Felder nicht. Jedes von ihnen enthält die Identität der App, des Bots oder
    des Single Sign-on:

    * `id`
    * `botId` in `bots`
    * `webApplicationInfo`
    * `validDomains`
    * `contentUrl` und `websiteUrl` in `staticTabs`

          <Warning>
            Eine Änderung an einem Identitätsfeld kann dazu führen, dass die App zwar installierbar ist, aber keine Benachrichtigungen
            zustellen oder Single Sign-on nicht abschließen kann. **Validate install** prüft
            den Mandanten, die Bot-Zugangsdaten und die erkannte Installation. Es vergleicht Ihr Manifest nicht
            mit dem von Living Security erstellten Paket.
          </Warning>
  </Step>

  <Step title="Die drei Dateien erneut zippen">
    Erstellen Sie aus den drei Dateien ein neues ZIP-Archiv. Legen Sie sie im Stammverzeichnis des
    Archivs ab, ohne umschließenden Ordner. Microsoft Teams lehnt ein Paket ab, dessen
    `manifest.json` sich in einem Ordner befindet.
  </Step>

  <Step title="Hochladen und überprüfen">
    Laden Sie die ZIP-Datei mit dem neuen Branding im Teams admin center hoch, kehren Sie dann zu Living
    Security zurück und klicken Sie auf **Validate install**. Senden Sie eine Testbenachrichtigung.

    <Check>
      Die Validierung zeigt **Validation passed** an, und die Testbenachrichtigung erscheint in
      Microsoft Teams unter Ihrem App-Namen und mit Ihren Symbolen.
    </Check>
  </Step>
</Steps>

### Herausgeber und Prüfsumme

Das Rebranding legt App-Namen und Symbole fest. Zwei Dinge ändert es nicht:

* **Der Herausgeber bleibt Living Security.** Die Manifestfelder `developer` nennen 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-Anwendungsberechtigung `User.Read.All` für die regionale Living
Security Teams-Anwendung zu genehmigen.

Der Ablauf der Administratoreinwilligung folgt diesem Microsoft-Entra-Muster:

```text theme={null}
https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}
```

Living Security generiert diese URL aus der verbundenen Mandanten-ID und der im Einrichtungsfenster angezeigten **Bot
app ID**. Die IDs dienen unterschiedlichen Zwecken:

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

Ersetzen Sie die Bot-App-ID in der Einwilligungs-URL nicht durch die Teams-App-ID. Die Integration **Microsoft Entra ID
(Client Credentials)** unter „Connected Integrations“ ist eine separate,
generische Integration. Ihre Zugangsdaten oder Einwilligung können vom regionalen
Teams-Bot nicht wiederverwendet werden, und eine für eine nicht zugehörige Entra-Anwendung erteilte Einwilligung aktiviert
diesen Fallback nicht.

<Note>
  Dass die Einwilligung optional ist, entfernt `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.
</Note>

## Benachrichtigungstypen

Abhängig von den Berechtigungen Ihrer Organisation und den konfigurierten Playbooks kann Living Security Folgendes senden:

| Benachrichtigung | Beschreibung |
| - | - |
| Schulungszuweisungen | Benachrichtigen Benutzer, wenn eine Schulung zugewiesen, fällig oder abschlussbereit ist |
| Schulungserinnerungen | Erinnern Benutzer an bevorstehende Fristen |
| Human-Risk-Warnungen | Senden personalisierte Aktualisierungen zum Human Risk Index und empfohlene nächste Schritte |
| Rollout-Nachrichten | Senden während der Bereitstellung unidirektionale Onboarding- oder Rollout-Benachrichtigungen |
| Kanalankündigungen | Veröffentlichen Kommunikation des Sicherheitsprogramms in konfigurierten Teams-Kanälen |

## 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](#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](#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

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="Eine Kanalankündigung erscheint nicht">
    <ul>
      <li>
        Vergewissern Sie sich, dass die Living Security Teams-App im Zielteam oder
        Zielkanal installiert ist.
      </li>

      <li>
        Vergewissern Sie sich, dass die Kanalzuordnung in Living Security das richtige Team und
        den richtigen Kanal verwendet.
      </li>

      <li>
        Prüfen Sie, ob der Kanal entfernt, umbenannt, archiviert oder eingeschränkt wurde.
      </li>

      <li>
        Installieren Sie die App im Zielteam oder Zielkanal erneut und senden Sie eine weitere Testbenachrichtigung.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Die optionale Suche per E-Mail/UPN oder die Einwilligung schlägt fehl">
    <ul>
      <li>
        Vergewissern Sie sich, dass ein Microsoft-Entra-Administrator die mandantenweite Einwilligung für
        Microsoft Graph `User.Read.All` für die angezeigte Bot-App-ID erteilt hat.
      </li>

      <li>
        Vergewissern Sie sich, dass die konfigurierte Mandanten-ID die des Mandanten ist, in dem sich Benutzer und Teams
        befinden.
      </li>

      <li>
        Prüfen Sie, ob der Benutzer in Microsoft Entra ID existiert und kein Gast aus
        einem anderen Mandanten ist.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Communication Log zeigt an, dass eine Microsoft-Administratoreinwilligung erforderlich ist">
    Die Fehlerkategorie `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.

    1. Öffnen Sie **Einstellungen → Communications → Channels → Microsoft Teams**. Sie können auch **Open Microsoft Teams setup** im Fehler des Communication Log verwenden.
    2. Vergewissern Sie sich, dass die richtige Microsoft-Entra-Mandanten-ID verbunden ist.
    3. 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.All` fü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.
    4. 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.

    Eine Neukonfiguration von **Microsoft Entra ID (Client Credentials)** behebt diesen Fehler nicht, da diese Integration nicht für die Zustellung von Teams-Benachrichtigungen verwendet wird.
  </Accordion>

  <Accordion title="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

    Beispielhafte Felder des Installationsereignisses zur Fehlerbehebung:

    ```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"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Sicherheit

Living Security verwendet Microsoft Graph `User.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.

## Weiterführende Informationen

<CardGroup cols={2}>
  <Card title="E-Mail-Integration" icon="envelope" href="/de/integrations/outbound/email">
    Konfigurieren Sie E-Mail als Zustellkanal.
  </Card>

  <Card title="Slack-Integration" icon="slack" href="/de/integrations/outbound/slack">
    Konfigurieren Sie Slack als Zustellkanal.
  </Card>

  <Card title="Communication Log" icon="clock-rotate-left" href="/de/features/communications/log">
    Verfolgen Sie Status und Verlauf der Teams-Zustellung.
  </Card>

  <Card title="Authentifizierung" icon="shield-halved" href="/de/features/settings/sso">
    Konfiguration von Microsoft Entra ID und SSO.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.