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

# BambooHR

> Verbinden Sie BambooHR per HTTP Basic Auth mit Ihrem API-Schlüssel als Benutzernamen mit Iru Compliance, um Nachweise zu Mitarbeiterverzeichnis, Status und Onboarding zu erfassen.

### Über BambooHR

Die REST API von BambooHR verwendet **HTTPS** und **HTTP Basic**: **Benutzername** = **API-Schlüssel**, **Passwort** = das Literal **`x`** (oder eine beliebige nicht leere Zeichenfolge, die BambooHR ignoriert). Anfragen richten sich an **`https://YOUR_SUBDOMAIN.bamboohr.com/api/...`**. Iru speichert zuerst die **`subdomain`** und dann die Anmeldedaten.

### So funktioniert es

Die REST API von BambooHR verwendet **HTTP Basic** über HTTPS: **Benutzername** = Ihr **API-Schlüssel**, **Passwort** = das Literal **`x`** (BambooHR ignoriert das Passwortfeld, abgesehen davon, dass es nicht leer sein darf). Anfragen richten sich an **`https://{subdomain}.bamboohr.com/api/gateway.php/{subdomain}/v1/`**. Der Assistent erfasst zuerst die **Subdomain** und dann den Schlüssel.

| Detail | Wert |
| - | - |
| **Kategorie** | HRIS |
| **Authentifizierung** | Basic (API-Schlüssel + `x`) |

Offizielle Referenzen: [Erste Schritte](https://documentation.bamboohr.com/docs/getting-started), [API-Referenz](https://documentation.bamboohr.com/reference).

### Voraussetzungen

* Ihre **Subdomain** (`acme` aus `https://acme.bamboohr.com`).
* Die Möglichkeit, unter Ihrem BambooHR-Profil einen **API-Schlüssel** zu erstellen.

### BambooHR mit Iru verbinden

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

    <Steps>
      <Step title="Bei BambooHR anmelden">
        Melden Sie sich unter der Subdomain Ihres Unternehmens an (zum Beispiel `https://yourcompany.bamboohr.com`), und zwar mit einem Konto, das API-Schlüssel verwalten darf.
      </Step>

      <Step title="Profilmenü öffnen">
        Wählen Sie oben rechts **Ihren Namen** aus (oder das Profilmenü, das BambooHR für Ihr Konto anzeigt).
      </Step>

      <Step title="API-Schlüssel öffnen">
        Wählen Sie **API-Schlüssel** aus (je nach BambooHR-Layout manchmal unter **Konto** oder **My settings**).
      </Step>

      <Step title="Neuen Schlüssel hinzufügen">
        Wählen Sie **Add a New Key** (oder **Generate new key**). Geben Sie eine Bezeichnung wie **Iru Compliance** ein, damit Betreiber wissen, wofür dieser Schlüssel verwendet wird.
      </Step>

      <Step title="Schlüssel generieren und kopieren">
        Generieren Sie den Schlüssel und kopieren Sie den Wert **sofort**. BambooHR verwendet diesen Wert in Iru als HTTP-Basic-**Benutzernamen**; das **Passwort** ist das Literal **`x`**, wie auf der Registerkarte [**Iru Compliance**](#iru-compliance) beschrieben.
      </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 [**BambooHR**](#bamboohr) ab.
    </Note>

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

        <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="BambooHR aktivieren">
        Suchen Sie **BambooHR** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich eine Browser-Registerkarte oder ein Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Subdomain eingeben">
        Geben Sie nur die **Subdomain** ein (zum Beispiel `acme`). Bestätigen Sie, falls der Assistent eine Vorschau-URL anzeigt.
      </Step>

      <Step title="Basic-Authentifizierung eingeben">
        Geben Sie als **Benutzername** den API-Schlüssel und als **Kennwort** **`x`** (Literal) ein.
      </Step>

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

      <Step title="Prüfen, ob 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 vergewissern Sie sich, dass die Karte **BambooHR** 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">
    Verwenden Sie den vollständigen API-Schlüssel; generieren Sie ihn im Zweifelsfall neu.
  </Accordion>

  <Accordion title="Falscher Mandant">
    Korrigieren Sie die **Subdomain** und stellen Sie die Verbindung erneut her.
  </Accordion>

  <Accordion title="Fehlende Mitarbeiter">
    Die API übernimmt die **Benutzerberechtigungen** – verbinden Sie sich bei Bedarf mit einem Konto mit HR-Berechtigungen.
  </Accordion>
</AccordionGroup>

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