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

# GitHub

> Verbinden Sie GitHub mit einem Personal Access Token mit Iru Compliance, um Repository-Inventar, Branch-Schutz, Organisationsmitgliedschaften und Audit-Logs zu erfassen.

### Über GitHub

Der **GitHub**-Connector liest Repository-Metadaten, Branch-Schutz, Teammitgliedschaften, Organisationseinstellungen, Audit-Logs und zugehörige Sicherheitskonfigurationen aus Ihrer **GitHub-Organisation**. Diese Daten erscheinen in Iru Compliance als Artefakte, die Sie Aktionen und Kontrollen zuordnen können. Die Integration ist **schreibgeschützt**. Iru öffnet keine Pull Requests, ändert keine Einstellungen und modifiziert keine Repositorys über das hinaus, was die GitHub-API für die von Ihnen erteilten Scopes zulässt.

### So funktioniert es

Iru ruft die GitHub REST API mit einem **Personal Access Token (PAT)** auf, das als **Bearer**-Token gesendet wird:

```http theme={null}
Authorization: Bearer github_pat_XXXX
```

Mit **Fine-grained PATs** (empfohlen) können Sie Repositorys und Berechtigungen eng eingrenzen. **Classic PATs** funktionieren ebenfalls, sind jedoch breiter gefasst und lassen sich schwerer nach dem Least-Privilege-Prinzip einschränken.

Wenn Ihre Organisation **SAML SSO** erzwingt, müssen Sie das PAT nach dem Erstellen für die Organisation **autorisieren**, da API-Aufrufe für Daten auf Organisationsebene sonst fehlschlagen.

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | Bearer-Token (Fine-grained oder Classic PAT) |
| **GitHub-Tarif** | Kompatibel mit GitHub Free, Team oder Enterprise (abhängig von der Verfügbarkeit der GitHub-API und der Audit-Logs) |

Offizielle Referenzen: [Verwalten von Personal Access Tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens), [REST-Authentifizierung](https://docs.github.com/en/rest/authentication/authenticating-to-the-rest-api) und [Ratenbegrenzungen](https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api).

### Voraussetzungen

* GitHub-Zugriff als Mitglied (oder Owner) der Organisation, die Iru lesen soll.
* **Besitzer**-Zugriff auf diese Organisation, wenn Sie Audit-Logs und organisationsweite Sicherheitseinstellungen benötigen (je nachdem, was Ihr Compliance-Programm erwartet).
* Ein PAT mit **Lese**berechtigungen gemäß den folgenden Tabellen (dargestellt für ein Fine-grained PAT).

**Minimale Berechtigungen für Fine-grained PATs (typisch)**

| Bereich | Berechtigungen |
| - | - |
| **Repository** | **Contents** (Lesen), **Metadata** (Lesen), **Administration** (Lesen) |
| **Organisation** | **Members** (Lesen), **Administration** (Lesen) |

Erweitern Sie die Berechtigungen nur, wenn Ihre Kontrollen zusätzliche Lese-Scopes erfordern.

### GitHub mit Iru verbinden

#### Fine-grained Personal Access Token erstellen

<Steps>
  <Step title="Developer settings öffnen">
    Melden Sie sich bei GitHub an. Wählen Sie Ihr Profilbild → **Einstellungen** → **Developer settings** → **Personal access tokens** → **Fine-grained tokens**.
  </Step>

  <Step title="Neues Token erstellen">
    Wählen Sie **Generate new token**.
  </Step>

  <Step title="Name, Ablaufdatum und Ressourcenumfang festlegen">
    Legen Sie einen eindeutigen **Namen** (zum Beispiel **Iru Compliance**) und ein **Ablaufdatum** fest (Fine-grained PATs können bis zu **366 Tage** gültig sein – richten Sie eine Erinnerung ein, um sie frühzeitig zu rotieren). Wählen Sie unter **Resource owner** Ihre **Organisation**, wenn Sie Daten auf Organisationsebene benötigen. Wählen Sie unter **Repository access** die Option **All repositories** oder nur die Repositorys, die Compliance abdeckt.
  </Step>

  <Step title="Repository- und Organisationsberechtigungen festlegen">
    Aktivieren Sie unter **Berechtigungen** mindestens die oben unter **Voraussetzungen** aufgeführten **Lese**berechtigungen für Repository und Organisation.
  </Step>

  <Step title="Token generieren und kopieren">
    Generieren Sie das Token und kopieren Sie es sofort. Es wird nur einmal angezeigt.
  </Step>

  <Step title="Für SAML SSO autorisieren (falls erforderlich)">
    Wenn Ihre Organisation **SAML SSO** verwendet, öffnen Sie **Einstellungen** → **Developer settings** → **Personal access tokens**, suchen Sie das Token, wählen Sie **Configure SSO** und **autorisieren** Sie es für Ihre Organisation.
  </Step>
</Steps>

#### Connector in Iru abschließen

<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="GitHub aktivieren">
    Suchen Sie **GitHub** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. In einer neuen Registerkarte wird der Connector-Assistent geöffnet.
  </Step>

  <Step title="Personal Access Token einfügen">
    Wenn der Schritt für das Bearer-Token angezeigt wird, fügen Sie Ihr PAT in das Feld **Token** ein und übermitteln Sie es.
  </Step>

  <Step title="Verbindung abschließen">
    Wählen Sie **Bearer-Token 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 **GitHub** den Status **Aktiv** hat.
  </Step>
</Steps>

### 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="401 Unauthorized">
    Bestätigen Sie, dass das PAT vollständig kopiert wurde, nicht abgelaufen ist und nicht widerrufen wurde.
  </Accordion>

  <Accordion title="Fehlende Organisationsdaten">
    Für organisationsweite Lesevorgänge muss der **Resource owner** des PAT die Organisation sein – nicht nur Ihr persönliches Konto. Erstellen Sie bei Bedarf ein neues PAT.
  </Accordion>

  <Accordion title="SSO erforderlich">
    Autorisieren Sie das PAT für SAML SSO (siehe **Fine-grained Personal Access Token erstellen**).
  </Accordion>

  <Accordion title="Ressource für PAT nicht zugänglich">
    Generieren Sie das PAT mit den Repository- und Organisationsberechtigungen neu, die Ihre Kontrollen erfordern.
  </Accordion>

  <Accordion title="Ratenbegrenzung">
    Authentifizierte REST-Anfragen unterliegen den Ratenbegrenzungen von GitHub (siehe GitHub-Dokumentation). Iru bündelt die Arbeit innerhalb dieser Grenzen; anhaltende Spitzen können die Synchronisierung verzögern.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Bevorzugen Sie Fine-grained PATs mit dem kleinstmöglichen…" icon="circle-info">
    Bevorzugen Sie **Fine-grained PATs** mit der kleinstmöglichen Repository-Auswahl und den Lese-Scopes, die Ihre Kontrollen dennoch erfüllen.
  </Card>

  <Card title="Rotieren Sie PATs vor dem Ablauf und aktualisieren Sie den Connector…" icon="shield">
    Rotieren Sie PATs vor dem Ablauf und aktualisieren Sie den Connector, damit die Nachweiserfassung nicht ins Stocken gerät.
  </Card>

  <Card title="Iru liest Metadaten und Konfigurationen, die von den…" icon="server">
    Iru liest Metadaten und Konfigurationen, die von den von Ihnen zugelassenen APIs bereitgestellt werden – GitHub-Berechtigungen, die Ihre Organisation durchsetzt, werden nicht umgangen.
  </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>