# GitHub

## Was es ist

GitHub ist ein Hostingdienst von Microsoft, der Git-Repositorys auf eigenen
Servern speichert und einen Arbeitsplatz darum aufbaut: eine Webansicht des
Codes und seiner Historie, Pull Requests zum Vorschlagen und Prüfen von
Änderungen, Issues zum Verfolgen von Aufgaben und GitHub Actions zum
automatischen Ausführen von Jobs, sobald etwas in einem Repository geschieht.

Darunter liegt gewöhnliches Git. Ein von GitHub geklontes Repository ist ein
normales Git-Repository mit vollständiger Historie. Zwischen Laptop und
GitHub bewegt sich die Arbeit mit den üblichen Push- und Fetch-Vorgängen.
Was GitHub hinzufügt, liegt auf seiner Seite der Verbindung:
Review-Diskussionen, Issues, Branch-Regeln, Automatisierungseinstellungen und
die Liste, wer was tun darf, bleiben in GitHubs eigenen Systemen, außerhalb
des geklonten Repositorys.

Ein Pull Request ist GitHubs Bezeichnung für den Vorschlag, die Änderungen
eines Branches in einen anderen zusammenzuführen. Er zeigt die Unterschiede
Zeile für Zeile, sammelt Kommentare und Freigaben und zeigt das Ergebnis
jeder automatischen Prüfung des vorgeschlagenen Codes. Ein als Entwurf
eröffneter Pull Request ist als unfertig markiert. Er kann erst
zusammengeführt werden, nachdem ihn jemand als prüfbereit markiert hat.

GitHub Actions ist die eingebaute Automatisierung des Dienstes. Ein Workflow
ist eine YAML-Datei im Verzeichnis `.github/workflows` des Repositorys.
Er benennt seine auslösenden Ereignisse, etwa einen Push, einen neuen Pull
Request oder einen Zeitplan, und listet Jobs aus einzelnen Schritten auf.
Jeder Schritt führt einen Shell-Befehl oder eine Action aus, einen als Paket
bereitgestellten Automatisierungsbaustein, der sich zwischen Repositorys
teilen lässt. Jobs laufen auf Runnern: virtuellen Maschinen mit Ubuntu Linux,
Windows oder macOS, die GitHub für jeden Lauf neu startet, oder eigenen
Rechnern, die als selbst gehostete Runner registriert sind.

Zwei weitere Dienste überwachen, was in ein Repository gelangt. Dependabot
liest eine Datei namens `dependabot.yml` und eröffnet Pull Requests, die
Abhängigkeiten aktualisieren. Unabhängig davon eröffnet es Pull Requests
für Abhängigkeiten mit bekannten Sicherheitslücken. Push Protection prüft
eingehende Pushes auf Geheimnisse wie Zugriffstoken und blockiert einen Push,
der eines enthält, bevor er das Repository erreicht.

## Warum es wichtig ist

Für viele Teams wird die Arbeit auf GitHub erledigt, nicht nur gespeichert.
Der Code, die Diskussion jeder Änderung, die Aufzeichnung, wer sie
freigegeben hat, und das Ergebnis jeder Prüfung stehen nebeneinander.
Warum eine Zeile existiert, lässt sich daher meist auf einer Seite
beantworten.

Die Automatisierung ist genauso wichtig wie das Hosting. Mit Actions neben
dem Code kann ein Pull Request seine eigenen Belege mitbringen: Die Tests
liefen und bestanden, der Build funktionierte, die Scanner meldeten ihre
Funde. Geschützte Branches machen aus diesen Belegen eine Regel. Ein Branch
lässt sich so einstellen, dass er Änderungen nur über einen Pull Request,
nur nach einer festgelegten Anzahl zustimmender Reviews und erst nach
bestandenen, namentlich festgelegten Statusprüfungen annimmt. Die Hauptlinie
nimmt damit ausschließlich geprüfte und freigegebene Änderungen auf.

Weil GitHub dort sitzt, wo Code in ein Projekt gelangt, liegen dort auch die
Kontrollen der Softwarelieferkette: welche Actions Dritter ein Workflow in
welcher genauen Version ausführen darf, wie Abhängigkeiten aktuell bleiben
und ob ein Geheimnis beim Push gestoppt wird. Diese Kontrollen werden meist
je Repository oder Organisation eingeschaltet und abgestimmt. Ein großer
Teil der tatsächlichen Sicherheit eines GitHub-Projekts liegt deshalb in
Einstellungen, die niemand bei einem Code-Review sieht.

Darin liegt der Kompromiss bei einem Hostingdienst. Sie erhalten eine
vollständige, gepflegte Umgebung, ohne Server zu betreiben. Dafür werden die Regeln zum
Schutz Ihres Codes in der Oberfläche eines anderen konfiguriert, mit
Vorgaben für den allgemeinen Fall statt für Ihren eigenen.

## Wie es in der Praxis aussieht

Drei Seiten aus der Arbeit des Unternehmens zeigen die unterschiedlichen
Aufgaben, die GitHub übernimmt.

[Eine auf GitHub Actions aufgebaute Auslieferungspipeline](/de/portfolio/built-github-actions-ci-cd-pipelines/)
teilt die Arbeit in getrennte Workflows: einen für die verbindliche
Codequalitätsprüfung, einen für die Tests und einen je Umgebung für
Bereitstellungen. Daneben laufen CodeQL, die Prüfung von Abhängigkeiten und
ein Schritt für eine Softwarestückliste. Der Weg führt vom Commit zu einem
in Azure laufenden Dienst. Die Promotion führt einen Build auf einem
festgelegten Weg durch die Umgebungen, statt ihn von Hand weiterzureichen.
Das Frontend wird in einem Distroless-Image ohne Shell und Paketverwaltung
ausgeliefert, die Go-API auf einer schlanken Alpine-Basis.

[Ein kontinuierliches Programm für Sicherheitsprüfungen](/de/portfolio/ran-a-continuous-security-scanning-programme/)
nutzt die Kontrollen um den Code auf GitHub. Jede GitHub Action eines
Drittanbieters ist an einen Commit-Hash statt an ein Tag gebunden. Niemand
kann daher ein Tag verschieben und damit ändern, was ein Workflow ausführt.
Dependabot überwacht 6 Ökosysteme, Gitleaks durchsucht die Historie nach
Zugangsdaten, und jeder Build erzeugt mit Anchore und Syft eine
Softwarestückliste. Die Seite nennt auch die tatsächlichen Kosten: die Menge
der Funde. Ein Scanner, der alles meldet, gewöhnt Menschen daran, ihn zu
ignorieren. Damit das Signal nutzbar bleibt, müssen die Funde fortlaufend
bewertet und priorisiert werden.

[Die Bereitstellung einer GIS-Software-as-a-Service-Anwendung](/de/portfolio/automated-gis-saas-deployment-with-github-actions/)
verlagerte ihren Test-, Build- und Bereitstellungszyklus in Workflows von
GitHub Actions. Ein Release hing damit nicht mehr davon ab, dass jemand an
die Schritte dachte. Wiederkehrende Datenverarbeitung und Berichte wanderten
in zeitgesteuerte Python-, Bash- und SQL-Jobs. Konfiguration und Geheimnisse
wurden vereinheitlicht, damit sich jede Umgebung gleich verhielt.

So sieht die Bindung an einen Commit in einem Workflow aus. Die lange
Hexadezimalzeichenfolge ist der vollständige Commit-Bezeichner des geprüften
Releases. Der Kommentar hält daneben die für Menschen lesbare Version fest:

```yaml
steps:
    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
```

## Wo es schiefgeht

- **Eine an ein Tag gebundene Action ändert sich ohne Warnung.** Ein Tag wie
  `v4` kann von der Person, die das Repository der Action kontrolliert,
  verschoben oder gelöscht werden. Der morgen ausgeführte Code kann deshalb
  vom heute geprüften abweichen. GitHub selbst empfiehlt die Bindung an einen
  vollständigen Commit-SHA. Ein Angreifer könnte ihn nur nachahmen, indem er
  „eine SHA-1-Kollision für die Nutzdaten eines gültigen Git-Objekts“ erzeugt.
- **Ein Workflow-Token hat mehr Rechte, als sein Job braucht.** Jeder Lauf
  erhält ein `GITHUB_TOKEN`. Seine Berechtigungen bestimmen, was ein
  kompromittierter Schritt ändern könnte. GitHub empfiehlt, standardmäßig
  nur Lesezugriff auf Repository-Inhalte zu gewähren und Schreibzugriff nur
  den Jobs zu geben, die ihn brauchen.
- **Nicht vertrauenswürdiger Text wird zum Befehl.** Schreibt ein Workflow
  den Titel eines Pull Requests direkt in ein eingebettetes Skript, darf
  dessen Verfasser damit einen Teil des Skripts bestimmen. Eine
  zwischengeschaltete Umgebungsvariable hält den Wert als Daten fest.
  Die Trigger `pull_request_target` und `workflow_run` starten privilegierte
  Workflows. GitHub warnt, dass das Auschecken eines nicht vertrauenswürdigen
  Pull Requests darin das Repository einer Kompromittierung aussetzt.
- **Administratoren gehen geradewegs an den Branch-Regeln vorbei.**
  Standardmäßig nimmt eine Branch-Schutzregel Personen mit
  Administratorrechten am Repository von ihren Beschränkungen aus.
  Die Einstellung „Do not allow bypassing the above settings“
  (Umgehen der obigen Einstellungen nicht zulassen) bindet auch sie an die
  Regeln.
- **Ein Geheimnis rutscht durch Push Protection.** Die standardmäßig aktive
  Variante schützt die eigenen Pushes jedes Nutzers zu öffentlichen
  Repositorys. Die Variante, die ein Repository gegen alle Mitwirkenden
  schützt, braucht GitHub Secret Protection und bleibt bis zur Aktivierung
  abgeschaltet. Selbst dann kann jeder mit Schreibzugriff eine Blockierung
  mit einer Begründung umgehen. Das löst einen Alarm aus und wird im
  Audit-Log erfasst. Einmal gepushte Zugangsdaten leben in jedem Klon.
  Tauschen Sie sie deshalb aus, statt auf ein Umschreiben der Historie zu
  vertrauen.

## Weiterführende Lektüre

- [GitHub-Dokumentation](https://docs.github.com/) — die gesamte Dokumentation
  zu Repositorys, Pull Requests, Actions und Sicherheitsfunktionen.
- [GitHub Actions verstehen](https://docs.github.com/en/actions/get-started/understand-github-actions)
  — Workflows, Ereignisse, Jobs, Schritte und Runner und ihr Zusammenspiel.
- [Referenz zur sicheren Verwendung](https://docs.github.com/en/actions/reference/security/secure-use)
  — Bindung von Actions an Commits, Token-Berechtigungen und Skript-Injection,
  von GitHub selbst erläutert.
- [Geschützte Branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)
  — erforderliche Reviews und Statusprüfungen sowie die Personen, die sie
  umgehen dürfen.
- [Dependabot-Versionsaktualisierungen](https://docs.github.com/en/code-security/concepts/supply-chain-security/dependabot-version-updates)
  — wie eine Datei `dependabot.yml` die Aktualisierungs-Pull-Requests steuert.
- [Push Protection](https://docs.github.com/en/code-security/concepts/secret-security/push-protection)
  — die beiden Varianten, was jede blockiert und wie eine Umgehung erfasst
  wird.

<https://engineer.company/de/glossary/github/>
