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

# PagerDuty

> Verbinden Sie PagerDuty mit einem schreibgeschützten REST-API-Schlüssel mit Iru Compliance, um Nachweise zu Incidents, Services, Eskalationsrichtlinien und Bereitschaftsdiensten zu erfassen.

### Über PagerDuty

Iru liest **Incidents**, **Services**, **Eskalationsrichtlinien**, **Dienstpläne**, **Teams** und **Audit**-Daten über die PagerDuty REST API. Die Authentifizierung verwendet das Header-Format von PagerDuty (nicht einfaches Bearer):

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Verwenden Sie vorzugsweise einen REST-API-Schlüssel vom Typ **General Access** mit **schreibgeschütztem** Umfang, damit Iru keine Incidents oder Services ändern kann.

### Funktionsweise

PagerDuty-REST-API-Schlüssel werden im benutzerdefinierten Header-Format von PagerDuty gesendet: **`Authorization: Token token=<API_KEY>`** (dies ist **kein** generisches **`Bearer`**-Token).

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | REST-API-Schlüssel (`Authorization: Token token=…`) |

**General Access**-Schlüssel werden von Administratoren erstellt und können das gesamte Konto abdecken. **Benutzer**-Token übernehmen die Sichtbarkeit des jeweiligen Benutzers. Vermeiden Sie diese, sofern Sie den Umfang nicht bewusst einschränken möchten.

Offizielle Referenzen: [API-Zugriffsschlüssel](https://support.pagerduty.com/main/docs/api-access-keys), [REST-API-Referenz](https://developer.pagerduty.com/api-reference/) und [Ratenbegrenzung](https://developer.pagerduty.com/docs/rest-api-v2/rate-limiting/).

### Voraussetzungen

* **Administrator** oder **Kontoinhaber** (oder gleichwertig), um **General Access**-API-Schlüssel zu erstellen.

### PagerDuty mit Iru verbinden

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

    <Steps>
      <Step title="Bei PagerDuty anmelden">
        Öffnen Sie [PagerDuty](https://www.pagerduty.com) und melden Sie sich als **Administrator** oder **Kontoinhaber** (oder gleichwertig) an, der **API Access Keys** erstellen kann.
      </Step>

      <Step title="Integrationen öffnen">
        Öffnen Sie in der Produktnavigation **Integrationen** (je nach PagerDuty-Edition manchmal unter **Automation** oder **Developer**).
      </Step>

      <Step title="Developer Tools öffnen">
        Wählen Sie **Developer Tools** (oder **API Access**) und suchen Sie dann **API Access Keys**.
      </Step>

      <Step title="Neuen API-Schlüssel erstellen">
        Wählen Sie **Create new API key** (die Bezeichnung kann auch **New key** lauten). Verwenden Sie nach Möglichkeit einen **General Access**-Schlüssel, sofern die Organisationsrichtlinie dies zulässt, damit die Lesezugriffe von Iru nicht an die Sichtbarkeit eines einzelnen Benutzers gebunden sind.
      </Step>

      <Step title="Schlüssel benennen und auf Read-only setzen">
        Geben Sie einen Namen wie **Iru Compliance** ein. Setzen Sie den Schlüsseltyp auf **Read-only** (oder die Leseoption mit den geringsten Berechtigungen, die PagerDuty für die REST-Nachweiserfassung anbietet).
      </Step>

      <Step title="Schlüssel erstellen und kopieren">
        Schließen Sie die Erstellung ab und kopieren Sie den Schlüsselwert **einmalig**, wenn PagerDuty ihn anzeigt. Nach dem Schließen des Dialogs wird er nicht erneut angezeigt.
      </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 [**PagerDuty**](#pagerduty) 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="PagerDuty aktivieren">
        Suchen Sie **PagerDuty** (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="API-Schlüssel einfügen">
        Fügen Sie den **reinen API-Schlüssel** in das vom Assistenten bereitgestellte Feld ein. Das Produkt formatiert `Authorization: Token token=YOUR_API_KEY` für Sie. Stellen Sie `Token token=` **nicht** selbst voran.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **API-Schlüssel 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 **PagerDuty** 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">
    Vollständiger Schlüssel ohne Leerzeichen; der Schlüssel darf nicht deaktiviert sein.
  </Accordion>

  <Accordion title="403 Forbidden">
    Wechseln Sie von einem **Benutzer**-Token zu einem **General Access**-Schlüssel mit ausreichendem Umfang.
  </Accordion>

  <Accordion title="Fehlende Services oder Dienstpläne">
    Benutzerbezogene Token sehen nur die Teams dieses Benutzers. Verwenden Sie **General Access**.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="API-Schlüssel laufen nicht automatisch ab: regelmäßig rotieren." icon="circle-info">
    API-Schlüssel laufen nicht automatisch ab – rotieren Sie sie nach einem festen Zeitplan.
  </Card>

  <Card title="Große Nachfüllvorgänge bleiben innerhalb der PagerDuty-Ratenlimits;…" icon="shield">
    Große Nachfüllvorgänge (Backfills) bleiben innerhalb der **Ratenlimits** von PagerDuty; die Synchronisierung kann sich über einen längeren Zeitraum erstrecken.
  </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>