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

# Jenkins

> Verbinden Sie Jenkins über HTTP Basic Auth mit Benutzername und API-Token mit Iru Compliance, um Nachweise zu Job-Konfiguration, Build-Verlauf und Plugins zu erfassen.

### Über Jenkins

Iru ruft die Remote-API von Jenkins mit **HTTP Basic**-Authentifizierung auf: **Benutzername** plus ein **API-Token** als **Passwort** (gegenüber einem echten Passwort bevorzugt). Der Assistent speichert zuerst **`jenkins_host`** (nur Hostname und optionaler Kontextpfad) und fragt dann die Anmeldeinformationen ab.

### So funktioniert es

```http theme={null}
Authorization: Basic base64(username:api_token)
```

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | Basic (Benutzer + API-Token) |

Offizielle Referenzen: [Skriptbasierte Clients](https://www.jenkins.io/doc/book/system-administration/authenticating-scripted-clients/), [API-Tokens](https://www.jenkins.io/blog/2018/07/02/new-api-token-system/), [Remote-API](https://www.jenkins.io/doc/book/using/remote-access-api/).

### Voraussetzungen

* Jenkins ist aus dem **Netzwerk von Iru** erreichbar (Firewall / VPN / Zulassungsliste nach Bedarf).
* Ein Benutzer mit **Overall/Read** und **Lese**zugriff auf Job-Ebene für den zu prüfenden Umfang.
* **HTTPS** wird für den Controller dringend empfohlen.

### Jenkins mit Iru verbinden

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

    <Steps>
      <Step title="Bei Jenkins anmelden">
        Öffnen Sie die URL Ihres Jenkins-Controllers und melden Sie sich mit einem Benutzer an, der mindestens **Overall/Read** und den für Ihren Compliance-Umfang erforderlichen Lesezugriff auf Jobs hat.
      </Step>

      <Step title="Benutzerprofil öffnen">
        Wählen Sie oben rechts Ihren **Benutzernamen** (oder je nach Jenkins-Theme den Link **People** und dann Ihren Benutzer).
      </Step>

      <Step title="Konfigurieren öffnen">
        Wählen Sie **Konfigurieren** für Ihr Benutzerkonto, um persönliche Einstellungen zu bearbeiten.
      </Step>

      <Step title="Abschnitt API Token öffnen">
        Scrollen Sie zum Abschnitt **API Token** (oder **API Token** / **Add new Token**, je nach Jenkins-Version). Wenn Sie ihn nicht sehen, schränkt Ihr Administrator möglicherweise das Erstellen von Tokens ein.
      </Step>

      <Step title="Neues Token erstellen">
        Wählen Sie **Add new Token**, geben Sie einen Namen wie **Iru Compliance** ein und wählen Sie dann **Generieren** (oder **Erstellen**). Kopieren Sie das Token **einmalig**, wenn Jenkins es anzeigt.

        Optional kann ein **Ablaufdatum** gelten; Jenkins zeigt alternde Tokens außerdem in der Oberfläche an, damit Sie sie vor dem Ablauf rotieren können.
      </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 [**Jenkins**](#jenkins) 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="Jenkins aktivieren">
        Suchen Sie **Jenkins** (setzen Sie **Kategorie** auf **Developer tools** oder verwenden Sie **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="Jenkins-Host eingeben">
        Geben Sie **`jenkins_host`** als **`jenkins.example.com`** oder **`jenkins.example.com/jenkins`** ein (**ohne** `https://`). Bestätigen Sie die Servervariablen.
      </Step>

      <Step title="Jenkins-Anmeldeinformationen eingeben">
        Geben Sie den **Benutzernamen** ein und fügen Sie das **API-Token** in das Passwortfeld 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 **Jenkins** 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="Servervariablen fehlgeschlagen">
    Deaktivieren und aktivieren Sie die Quelle, um eine neue Assistentensitzung zu starten.
  </Accordion>

  <Accordion title="401 / 403">
    Korrigieren Sie Benutzer/Token; der Benutzer benötigt **Lese**berechtigungen für die Ziel-Jobs.
  </Accordion>

  <Accordion title="Nicht erreichbar">
    Prüfen Sie Routing, TLS, VPN oder die Zulassungsliste für ausgehenden Datenverkehr von Iru.
  </Accordion>

  <Accordion title="Falsche Host-Zeichenfolge">
    Geben Sie den Kontextpfad an, wenn sich Jenkins nicht im Stammverzeichnis der Domain befindet.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Verwenden Sie einen schreibgeschützten Dienstbenutzer, beschränkt auf die Ordner…" icon="circle-info">
    Verwenden Sie einen **schreibgeschützten** Dienstbenutzer, der auf die benötigten Ordner oder Ansichten beschränkt ist.
  </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>