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

# Slack-Integration

> Verbinden Sie Living Security mit Slack, um Schulungsbenachrichtigungen, Sicherheitswarnungen und Playbook-Updates an Ihren Workspace zu senden.

Die Slack-Integration ermöglicht es Living Security, Benachrichtigungen direkt an Ihren Slack-Workspace zu senden. Informieren Sie Benutzer über zugewiesene Schulungen, warnen Sie Sicherheitsteams vor Risikoereignissen und halten Sie Führungskräfte über den Fortschritt ihrer Teams auf dem Laufenden.

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

## Voraussetzungen

Stellen Sie vor der Konfiguration der Slack-Integration sicher, dass Sie über Folgendes verfügen:

* Administratorberechtigungen für den Slack-Workspace oder Berechtigungen zur Installation von Apps
* Zugriff auf das Slack-API-Portal unter [api.slack.com](https://api.slack.com)
* Administratorrechte für Living Security

## Slack-App erstellen

<Steps>
  <Step title="Neue Slack-App erstellen">
    1. Rufen Sie [api.slack.com/apps](https://api.slack.com/apps) auf
    2. Klicken Sie auf **Create New App**
    3. Wählen Sie **From scratch**
    4. Geben Sie einen App-Namen ein (z. B. „Living Security“)
    5. Wählen Sie Ihren Workspace aus
    6. Klicken Sie auf **Create App**

    <Check>
      Ihre App wird im Slack-API-Dashboard angezeigt.
    </Check>
  </Step>

  <Step title="OAuth-Scopes konfigurieren">
    1. Klicken Sie in der linken Seitenleiste auf **OAuth & Permissions**
    2. Scrollen Sie zu **Bot Token Scopes**
    3. Fügen Sie die folgenden Scopes hinzu:

    | Scope | Zweck |
    | - | - |
    | `chat:write` | Nachrichten an Kanäle senden |
    | `chat:write.public` | Nachrichten an Kanäle senden, ohne beizutreten |
    | `users:read` | Benutzerinformationen abrufen |
    | `users:read.email` | Benutzer anhand der E-Mail-Adresse zuordnen |

    <Tip>
      Fügen Sie nur die Scopes hinzu, die Ihre Organisation benötigt. Weniger Scopes bedeuten mehr Sicherheit.
    </Tip>
  </Step>

  <Step title="App in Ihrem Workspace installieren">
    1. Scrollen Sie zum Anfang von **OAuth & Permissions**
    2. Klicken Sie auf **Install to Workspace**
    3. Prüfen Sie die Berechtigungen und klicken Sie auf **Allow**

    <Check>
      Es wird ein **Bot User OAuth Token** angezeigt, der mit `xoxb-` beginnt.
    </Check>
  </Step>

  <Step title="Signing Secret abrufen">
    1. Klicken Sie in der linken Seitenleiste auf **Basic Information**
    2. Scrollen Sie zu **App Credentials**
    3. Kopieren Sie das **Signing Secret**

    <Warning>
      Halten Sie Ihr Signing Secret geheim. Geben Sie es niemals in öffentlichen Repositories oder Logs preis.
    </Warning>
  </Step>
</Steps>

## Anmeldedaten in Living Security hinzufügen

<Steps>
  <Step title="Zu „Ausgehend“ unter „Integrationen“ navigieren">
    Rufen Sie **Einstellungen → Integrationen → Ausgehend** auf und klicken Sie auf die Karte **Slack**.
  </Step>

  <Step title="Anmeldedaten hinzufügen">
    Klicken Sie auf **Add Credential** und geben Sie Folgendes ein:

    <ParamField body="botToken" type="string" required>
      Ihr Bot User OAuth Token, der mit `xoxb-` beginnt. Zu finden unter **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Das Signing Secret Ihrer App. Zu finden unter **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Optional. Nur für Socket-Mode-Verbindungen erforderlich. Beginnt mit `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Optional. Ein aussagekräftiger Name für diese Anmeldedaten (z. B. „Production Slack“).
    </ParamField>
  </Step>

  <Step title="Speichern und überprüfen">
    Klicken Sie auf **Speichern**. Die Anmeldedaten erscheinen in Ihrer Liste mit dem Status **aktiv**.

    <Check>
      Ihre Slack-Integration ist nun verbunden und bereit, Benachrichtigungen zu senden.
    </Check>
  </Step>
</Steps>

## Benachrichtigungstypen

Nach der Verbindung kann Living Security die folgenden Benachrichtigungstypen an Slack senden:

| Benachrichtigung | Beschreibung |
| - | - |
| Schulungszuweisungen | Benutzer benachrichtigen, wenn ihnen eine neue Schulung zugewiesen wird |
| Schulungserinnerungen | Benutzer an bevorstehende Fristen erinnern |
| Abschlussbestätigungen | Bestätigen, wenn eine Schulung abgeschlossen wurde |
| Sicherheitswarnungen | Sicherheitsteams über Risikoereignisse informieren |
| Playbook-Zusammenfassungen | Regelmäßige Updates zur Playbook-Leistung senden |

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Nachrichten erscheinen nicht in Kanälen">
    * Stellen Sie sicher, dass der Bot in den Kanal eingeladen wurde (`/invite @YourBotName`)
    * Prüfen Sie, ob der Scope `chat:write.public` für das Senden an öffentliche Kanäle ohne Beitritt hinzugefügt wurde
    * Vergewissern Sie sich, dass die Kanal-ID korrekt ist (verwenden Sie die Kanal-ID, nicht den Namen)
  </Accordion>

  <Accordion title="Fehler „Ungültiger Token“">
    * Stellen Sie sicher, dass Sie den vollständigen Token kopiert haben, der mit `xoxb-` beginnt
    * Prüfen Sie, ob die App weiterhin in Ihrem Workspace installiert ist
    * Prüfen Sie, ob der Token neu generiert wurde (in diesem Fall ist eine Aktualisierung in Living Security erforderlich)
  </Accordion>

  <Accordion title="Ratenbegrenzung">
    Slack begrenzt API-Anfragen. Wenn Fehler aufgrund der Ratenbegrenzung angezeigt werden:

    * Reduzieren Sie die Häufigkeit der Benachrichtigungen
    * Fassen Sie mehrere Benachrichtigungen in Sammelnachrichten zusammen
    * Wenden Sie sich bei Anwendungsfällen mit hohem Volumen an den Support
  </Accordion>
</AccordionGroup>

## Bewährte Vorgehensweisen

<Tip>
  Erstellen Sie einen eigenen Slack-Kanal für Living Security-Benachrichtigungen (z. B. `#security-training`), um Warnungen zu organisieren und das Rauschen in allgemeinen Kanälen zu reduzieren.
</Tip>

* Verwenden Sie aussagekräftige Bezeichnungen für Anmeldedaten, wenn Sie mehrere Workspaces verwalten
* Prüfen Sie regelmäßig, welche Kanäle Benachrichtigungen erhalten
* Richten Sie bei Warnungen mit hohem Volumen Benachrichtigungs-Digests anstelle von Einzelnachrichten ein
* Überprüfen Sie die Berechtigungen der Slack-App vierteljährlich und entfernen Sie nicht verwendete Scopes

## Weiterführende Informationen

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

  <Card title="Teams-Integration" icon="microsoft" href="/de/integrations/outbound/teams">
    Microsoft Teams als Zustellkanal konfigurieren.
  </Card>

  <Card title="Kommunikationsprotokoll" icon="clock-rotate-left" href="/de/features/communications/log">
    Zustellstatus und Verlauf von Slack-Nachrichten nachverfolgen.
  </Card>

  <Card title="So richten Sie eine neue Integration ein" icon="plug" href="/de/integrations/managing/setup">
    Allgemeine Anleitung zur Einrichtung von Integrationen.
  </Card>
</CardGroup>


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