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

# Sage HR

> Verbinden Sie Sage HR mit einem API-Schlüssel im X-Auth-Token-Header und Ihrer Konto-Subdomain mit Iru Compliance, um Nachweise zu Mitarbeitenden, Abwesenheiten und dem Teamverzeichnis zu erfassen.

### Über Sage HR

Iru ruft **`https://YOUR_SUBDOMAIN.sage.hr/api`** auf mit:

```http theme={null}
X-Auth-Token: YOUR_API_KEY
```

Schlüssel gelten **pro Administrator** und übernehmen die Berechtigungen dieses Benutzers. Durch Deaktivieren und erneutes Aktivieren des API-Zugriffs wird der Schlüssel **rotiert**.

### Funktionsweise

Die REST API von Sage HR akzeptiert einen **API-Schlüssel** im Header **`X-Auth-Token`**. Der Connector-Assistent erfasst zuerst Ihre **Subdomain** (um **`https://{subdomain}.sage.hr/api`** zu bilden) und in einem weiteren Schritt den **API-Schlüssel**.

| Detail | Wert |
| - | - |
| **Kategorie** | HRIS |
| **Authentifizierung** | API-Schlüssel (`X-Auth-Token`) |

Offizielle Referenzen: [Funktionsweise der API](https://support.sage.hr/en/articles/3246469-how-does-sage-hr-api-work), [Sage Developer HR](https://developer.sage.com/hr/reference/).

### Voraussetzungen

* **Administrator**-Zugriff.
* **Subdomain** (`acme` aus `https://acme.sage.hr`).

### Sage HR mit Iru verbinden

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

    <Steps>
      <Step title="Bei Sage HR anmelden">
        Öffnen Sie Ihre Sage HR-Website (`https://YOUR_SUBDOMAIN.sage.hr`) und melden Sie sich als **Administrator** an, der die Einstellungen unter **Integrationen** ändern kann.
      </Step>

      <Step title="Profilmenü öffnen">
        Wählen Sie in der Kopfzeile von Sage HR **Name** (Ihr Profil), um das Kontomenü zu öffnen.
      </Step>

      <Step title="Einstellungen öffnen">
        Wählen Sie **Einstellungen** (oder je nach Sage HR-Edition **Company settings**).
      </Step>

      <Step title="Integrations und API öffnen">
        Navigieren Sie zu **Integrationen** und dann zu **API** (die Bezeichnungen können auch **Integrationen** → **API access** lauten).
      </Step>

      <Step title="API-Zugriff aktivieren">
        Aktivieren oder wählen Sie **Enable API Access** und bestätigen Sie alle Hinweise, die Sage HR zum Datenzugriff anzeigt.
      </Step>

      <Step title="API-Schlüssel kopieren">
        Kopieren Sie den von Sage HR angezeigten **API-Schlüssel** und bewahren Sie ihn sicher auf. Sie verwenden ihn in Iru als Wert für **`X-Auth-Token`**.
      </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 [**Sage HR**](#sage-hr) 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="Sage HR aktivieren">
        Suchen Sie **Sage HR** (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="Subdomain eingeben">
        Geben Sie die **Subdomain** ein, wenn der Assistent danach fragt.
      </Step>

      <Step title="Header-Wert des API-Schlüssels einfügen">
        Fügen Sie den Wert für **`X-Auth-Token`** ein, wenn Sie dazu aufgefordert werden.
      </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 **Sage HR** 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">
    Der Schlüssel wurde rotiert – kopieren Sie ihn nach dem erneuten Aktivieren noch einmal.
  </Accordion>

  <Accordion title="Falscher Mandant">
    Korrigieren Sie die **Subdomain**.
  </Accordion>
</AccordionGroup>

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