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

# HiBob

> Verbinden Sie HiBob über HTTP Basic Auth mit einer Service-User-ID und einem Token mit Iru Compliance, um Nachweise zu Mitarbeiterliste, Lebenszyklusereignissen und Organisationsstruktur zu erfassen.

### Über HiBob

Iru liest die **Mitarbeiterliste** (einschließlich Status, Eintritts- und Austrittsdatum), **Lebenszyklusereignisse**, **Abteilungen und Berichtslinien** sowie **Metadatenfelder** aus der öffentlichen API von HiBob. Die Authentifizierung erfolgt über einen **API-Service-User**, der unter **Einstellungen** → **Integrationen** → **Service Users** erstellt wird. Ein Service-User ist kein Mitarbeiter und kann sich nicht bei Bob anmelden. Er dient ausschließlich der Authentifizierung von API-Anfragen.

### So funktioniert es

```http theme={null}
Authorization: Basic BASE64("SERVICE-USER-ID:TOKEN")
```

HiBob verwendet **HTTP Basic** über HTTPS, wobei der **Benutzername** die **ID** des Service-Users und das **Passwort** sein **Token** ist. Iru übernimmt die Codierung. Sie fügen die beiden Werte separat ein. Anfragen richten sich an `https://api.hibob.com/v1`; es muss keine Subdomain konfiguriert werden.

Die Berechtigungen von Service-Usern sind **granular und additiv**: Jede Datenkategorie wird separat über eine Berechtigungsgruppe erteilt, und ein Endpunkt gibt nichts zurück, bis seine Kategorie erteilt wurde. HiBob hat **API Access Tokens am 31. Oktober 2024 eingestellt**. Service-User sind die einzige unterstützte Methode für vom Kunden erstellte Integrationen.

| Detail | Wert |
| - | - |
| **Kategorie** | HRIS |
| **Authentifizierung** | Basic (Service-User-ID + Token) |

Offizielle Referenzen: [API-Service-User](https://apidocs.hibob.com/docs/api-service-users), [Erstellen des Autorisierungs-Headers](https://apidocs.hibob.com/reference/authorization), [Berechtigungen](https://apidocs.hibob.com/reference/permissions).

### Voraussetzungen

* Ein **Bob-Administratorkonto** oder ein Administrator, der die Anmeldeinformationen für Sie generieren kann. Nur Administratoren können Service-User erstellen.
* Die Möglichkeit, eine **Berechtigungsgruppe** zu erstellen und ihr den Service-User zuzuweisen. Das Erstellen des Service-Users allein reicht nicht aus. Ohne Berechtigungsgruppe ist die Authentifizierung erfolgreich, es werden jedoch keine Daten zurückgegeben.

### HiBob mit Iru verbinden

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

    <Steps>
      <Step title="Bei Bob anmelden">
        Melden Sie sich als **Administrator** bei Bob an.
      </Step>

      <Step title="Service Users öffnen">
        Gehen Sie zu **Einstellungen** → **Integrationen** → **Service Users**.
      </Step>

      <Step title="Service-User erstellen">
        Erstellen Sie einen **neuen Service-User** und geben Sie ihm einen Namen wie **Iru Compliance**, damit Sie ihn später wiedererkennen.
      </Step>

      <Step title="ID und Token kopieren">
        Kopieren Sie die **Service-User-ID** und das **Token** sofort. Das Token wird **nur einmal** angezeigt. Wenn Sie es verlieren, aktualisieren Sie das Token des Service-Users und stellen Sie die Verbindung erneut her.
      </Step>

      <Step title="Berechtigungsgruppe zuweisen">
        Erstellen Sie eine **Berechtigungsgruppe** (oder bearbeiten Sie eine vorhandene) und fügen Sie ihr den neuen Service-User hinzu.
      </Step>

      <Step title="Leseberechtigungen erteilen">
        Erteilen Sie der Gruppe **Lese**berechtigungen für die Kategorien, die Ihr Compliance-Programm benötigt. **People - Read** ist das Minimum für Nachweise zur Mitarbeiterliste und zum Offboarding. Erteilen Sie keine Schreib- oder Löschberechtigungen. Erteilen Sie **Payroll - Read** nur, wenn eine Kontrolle Vergütungsdaten erfordert.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**HiBob**](#hibob) 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="HiBob aktivieren">
        Suchen Sie **HiBob** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Basic-Authentifizierung eingeben">
        Geben Sie unter **Benutzername** die **Service-User-ID** und unter **Kennwort** das **Service-User-Token** ein.
      </Step>

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

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **HiBob** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

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

  <Accordion title="Authentifizierung schlägt mit tokenNotMatch fehl">
    ID und Token passen nicht zusammen, oder das Token wurde aktualisiert. Generieren Sie in HiBob ein neues Token und stellen Sie die Verbindung erneut her. Vergewissern Sie sich, dass Sie die beiden Felder nicht vertauscht haben. Die **ID** ist der Benutzername.
  </Accordion>

  <Accordion title="Verbindung erfolgreich, aber es werden keine Mitarbeiter zurückgegeben">
    Der Service-User ist keiner **Berechtigungsgruppe** zugeordnet, oder der Gruppe fehlt **People - Read**. Dies ist das häufigste Einrichtungsproblem bei HiBob, da die Authentifizierung in beiden Fällen problemlos erfolgreich ist.
  </Accordion>

  <Accordion title="Sie verwenden ein altes API Access Token">
    Diese funktionieren seit dem **31. Oktober 2024** nicht mehr. Migrieren Sie zu einem Service-User.
  </Accordion>

  <Accordion title="Ausgeschiedene Mitarbeiter fehlen">
    Bestätigen Sie, dass die Erfassung inaktive Datensätze einschließt; HiBob schließt diese bei einigen Endpunkten standardmäßig aus.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Berechtigungsgruppen sind erforderlich" icon="circle-info">
    Das Erstellen des Service-Users allein reicht nicht aus. Ohne eine **Berechtigungsgruppe**, die **People - Read** enthält, ist die Authentifizierung erfolgreich, es werden jedoch keine Mitarbeiter zurückgegeben.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" 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-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

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