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

# Segment

> Verbinden Sie Segment mit einem Public-API-Zugriffstoken mit Iru Compliance, um Nachweise zu Workspaces, Quellen, Zielen und Tracking-Plänen zu erfassen.

### Über Segment

Dieser Connector basiert auf der **Segment Public API**. Iru liest Metadaten zu **Workspace-Einstellungen**, **Quellen und Zielen**, **Tracking-Plänen** und **Mitgliedschaften** – genug, um nachzuweisen, wie Kundendaten durch Segment fließen. Die Integration ist auf Seiten von Iru **schreibgeschützt**; sie sendet keine Events und ändert keine Workspace-Konfiguration.

Nur **Workspace Owners** können in Segment Public-API-Token erstellen.

### Funktionsweise

Iru authentifiziert sich mit einem **Bearer**-Token (Segment **Public API access token**):

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

| Detail | Wert |
| - | - |
| **Kategorie** | Analysen |
| **Authentifizierung** | Bearer-Token (Public-API-Zugriffstoken) |
| **Rolle zum Erstellen des Tokens** | Workspace Owner |

Offizielle Referenzen: [Segment Public API](https://segment.com/docs/api/public-api/), [API-Referenz](https://docs.segmentapis.com/) und [Access Management](https://segment.com/docs/segment-app/iam/).

### Voraussetzungen

* **Workspace Owner** des Segment-Workspaces, den Sie für Compliance benötigen.
* Einige Minuten Zeit, um das Token zu erstellen und in Iru einzufügen.

### Segment mit Iru verbinden

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

    <Steps>
      <Step title="Bei Segment anmelden">
        Öffnen Sie [Segment](https://segment.com) und melden Sie sich mit einem Benutzer an, der **Workspace**-Token verwalten kann.
      </Step>

      <Step title="Einstellungen öffnen">
        Wählen Sie in der Segment-App **Einstellungen** (Zahnradsymbol).
      </Step>

      <Step title="Workspace Settings öffnen">
        Wählen Sie **Workspace Settings** für den Workspace, den Iru lesen soll.
      </Step>

      <Step title="Access Management öffnen">
        Wählen Sie **Access Management** (oder **Members & access**) und öffnen Sie dann **Tokens**.
      </Step>

      <Step title="Token erstellen">
        Wählen Sie **Token erstellen** (oder **New token**). Geben Sie einen Namen wie **Iru Compliance** ein.
      </Step>

      <Step title="Token-Rolle auswählen">
        Wählen Sie eine Rolle nach dem Prinzip der geringsten Berechtigung:

        * **Workspace Owner**: Umfassender API-Zugriff; verwenden Sie diese Rolle, wenn Sie für Audits vollständige Sichtbarkeit des Workspaces benötigen.
        * **Workspace Member**: Eingeschränkter; lässt möglicherweise Ressourcen aus, die für Ihr Programm relevant sind.
      </Step>

      <Step title="Token kopieren und sicher aufbewahren">
        Erstellen Sie das Token und **kopieren Sie es sofort**. Segment zeigt es nur **einmal** an. Behandeln Sie es wie ein Passwort, bis Sie es in **Iru Compliance** einfügen.

        Segment kann Token, die in öffentlichen Repositorys entdeckt werden, **automatisch widerrufen**; die Owner werden benachrichtigt.
      </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 [**Segment**](#segment) 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="Segment aktivieren">
        Suchen Sie **Segment** (verwenden Sie **Kategorie** oder **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="Public-API-Token einfügen">
        Wenn der Assistent nach dem Token fragt, fügen Sie das **Public API access 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 **Segment** 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="401 Unauthorized">
    Kopieren Sie das Token exakt; vergewissern Sie sich, dass es nicht gelöscht oder automatisch widerrufen wurde.
  </Accordion>

  <Accordion title="Fehlende Quellen oder Ziele">
    Verwenden Sie bevorzugt ein **Workspace Owner**-Token statt eines eingeschränkten Member-Tokens.
  </Accordion>

  <Accordion title="Falscher Workspace">
    Token sind **Workspace-bezogen** – erstellen Sie das Token in dem Workspace, den Sie in Iru verbunden haben.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Token laufen standardmäßig nicht ab: regelmäßig…" icon="circle-info">
    Token laufen standardmäßig nicht ab – rotieren Sie sie nach einem festen Zeitplan und aktualisieren Sie Iru nach der Rotation.
  </Card>

  <Card title="Mehrere Workspaces benötigen separate Iru-Verbindungen…" icon="shield">
    Mehrere Workspaces benötigen **separate** Iru-Verbindungen und Token.
  </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>