> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Verbinden Sie Slack mit einem Bot-Token mit Iru Compliance, um Workspace-Metadaten, Kanalinventar, Benutzer- und Gruppenmitgliedschaften sowie Audit-Logs von Enterprise Grid zu erfassen.

### Über Slack

Der **Slack**-Connector liest Workspace-Mitgliedschaften, Kanalkonfiguration und Benutzergruppen. Unter **Enterprise Grid** liest er außerdem **Audit-Log**-Ereignisse. Diese Informationen werden in Iru Compliance als Artifacts bereitgestellt. Iru authentifiziert sich mit einem **Bot-OAuth-Token** (`xoxb-`), das Sie durch die Installation einer Slack-App in Ihrem Workspace erhalten. Der Zugriff ist für Compliance-Nachweise **lesend ausgerichtet**; über die hier beschriebenen Scopes werden weder Nachrichten gesendet noch Workspace-Einstellungen geändert.

### Funktionsweise

Slack-APIs erwarten das Bot-Token im Header **Authorization**:

```http theme={null}
Authorization: Bearer xoxb-XXXX-XXXX-XXXX
```

Sie erstellen eine App unter **api.slack.com**, erteilen **Bot token scopes**, installieren die App im Workspace und kopieren dann das **Bot User OAuth Token**. Das Erweitern von Scopes erfordert eine **Neuinstallation** der App, wodurch ein **neues** Token ausgestellt wird. Aktualisieren Sie Iru jedes Mal, wenn dies geschieht.

| Detail | Wert |
| - | - |
| **Kategorie** | Kommunikation |
| **Authentifizierung** | Bearer-Token (Bot-OAuth-Token `xoxb-`) |
| **Audit-Logs** | **`auditlogs:read`** gilt **nur für Enterprise Grid**. Ohne Grid sind Nachweise im Stil von Audit-Logs über diesen API-Pfad nicht verfügbar. |

Referenzen: [OAuth-Token](https://docs.slack.dev/authentication/tokens/), [Scopes](https://docs.slack.dev/scopes/), [Audit Logs API](https://docs.slack.dev/apis/audit-logs-api/).

### Voraussetzungen

* **Workspace Owner**- oder **Workspace Admin**-Rechte, damit Sie Apps installieren können.
* Möglichkeit, sich für Ihren Workspace bei **[api.slack.com/apps](https://api.slack.com/apps)** anzumelden.
* Optional: Enterprise Grid, wenn Sie **`auditlogs:read`** benötigen.

**Typische Bot-Scopes für Verzeichnis- und Kanalnachweise**

| Scope | Zweck |
| - | - |
| `users:read` | Mitgliederprofile lesen |
| `users:read.email` | E-Mail-Adressen der Mitglieder lesen |
| `channels:read` | Öffentliche Kanäle auflisten und lesen |
| `groups:read` | Private Kanäle auflisten und lesen (sofern zulässig) |
| `usergroups:read` | Konfiguration von Benutzergruppen lesen |
| `auditlogs:read` | Audit-Logs (nur **Enterprise Grid**) |

### Slack mit Iru verbinden

<Tabs>
  <Tab title="Slack">
    <Note>
      Schließen Sie diesen Tab ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Slack-API-Apps öffnen">
        Rufen Sie in einem Browser **[api.slack.com/apps](https://api.slack.com/apps)** auf und melden Sie sich mit einem Slack-Konto an, das für den Ziel-**Workspace** **Apps erstellen** kann (häufig ein Workspace-Administrator).
      </Step>

      <Step title="Neue App erstellen">
        Wählen Sie **Create New App** und dann **From scratch** (es sei denn, Ihre Organisation verwendet standardmäßig ein Manifest; dieser Artikel geht von **From scratch** aus).
      </Step>

      <Step title="App benennen und Workspace auswählen">
        Geben Sie einen App-Namen wie **Iru Compliance** ein und wählen Sie den **Slack-Workspace**, in dem Iru installiert werden soll.
      </Step>

      <Step title="OAuth & Permissions öffnen">
        Öffnen Sie in der linken Seitenleiste der App **OAuth & Permissions**.
      </Step>

      <Step title="Bot-Token-Scopes hinzufügen">
        Fügen Sie unter **Bot Token Scopes** jeden Scope aus den **Voraussetzungen** hinzu, den Ihre Kontrollen erfordern. Fügen Sie **`auditlogs:read`** nur hinzu, wenn Sie **Enterprise Grid** verwenden und Audit-Nachweise benötigen.
      </Step>

      <Step title="App im Workspace installieren">
        Wählen Sie unter **OAuth & Permissions** **Install to Workspace** (oder **Reinstall** nach Änderungen an Scopes). Prüfen Sie die Berechtigungen und genehmigen Sie sie.
      </Step>

      <Step title="Bot User OAuth Token kopieren">
        Kopieren Sie das **Bot User OAuth Token** (beginnt mit **`xoxb-`**). Wenn Sie später Scopes ändern, installieren Sie die App neu, um ein **neues** Token zu erhalten. Fügen Sie das aktuelle Token in den Iru-Connector-Assistenten ein, wenn **Iru Compliance** Sie dazu auffordert.
      </Step>
    </Steps>

    <Note>
      Fahren Sie im Tab [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst den Tab [**Slack**](#slack) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Slack aktivieren">
        Suchen Sie **Slack** (setzen Sie **Kategorie** auf **Communications** oder verwenden Sie **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Für den Connector-Assistenten kann sich ein Browser-Tab oder -Fenster öffnen.
      </Step>

      <Step title="Bot-Token im Assistenten einfügen">
        Wenn der Assistent nach einem Bearer-Token fragt, fügen Sie das **`xoxb-`**-**Bot User OAuth Token** ein und senden Sie es ab.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Bearer-Token senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Prüfen, ob die Quelle aktiv ist">
        Schließen Sie den Browser-Tab **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und vergewissern Sie sich, dass die Karte **Slack** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Überprüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="not_authed / 401">
    Vergewissern Sie sich, dass das Token aktuell ist, mit **`xoxb-`** beginnt und die App noch installiert ist.
  </Accordion>

  <Accordion title="missing_scope">
    Fügen Sie den Scope unter **OAuth & Permissions** hinzu, **installieren** Sie die App neu, kopieren Sie das **neue** Token und aktualisieren Sie Iru.
  </Accordion>

  <Accordion title="token_revoked">
    Installieren Sie die App neu oder rotieren Sie die Anmeldedaten; aktualisieren Sie Iru mit dem neuen Bot-Token.
  </Accordion>

  <Accordion title="Keine Audit-Daten">
    **`auditlogs:read`** erfordert **Enterprise Grid**. Ohne Grid sind Nachweise aus der Audit-Log-API nicht verfügbar.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Bot-Token laufen in der Regel nicht ab, es sei denn…" icon="circle-info">
    Bot-Token **laufen** in der Regel **nicht ab**, es sei denn, Ihr Workspace erzwingt eine Rotation. Folgen Sie den Vorgaben von Slack, wenn die Rotation aktiviert ist.
  </Card>

  <Card title="Das Deinstallieren der App widerruft das Token sofort." icon="shield">
    Das Deinstallieren der App **widerruft** das Token sofort.
  </Card>

  <Card title="Erweiterte Scopes erfordern immer eine Neuinstallation und ein neues…" icon="server">
    Erweiterte Scopes erfordern immer eine **Neuinstallation** und ein neues Token. Planen Sie Änderungen in einem Wartungsfenster.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Verwaltung von Quellen" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Überblick" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Verwaltung von Artifacts" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>