Timestamp GIT

← Alle Beiträge

2026-10-31

Warum Ihr Git-Log kein Beweis ist – und wie Sie ihn manipulationssicher machen

Warum Ihr Git-Log kein Beweis ist – und wie Sie ihn manipulationssicher machen
timestamp git blockchain proof

Warum Ihr Git-Log kein Beweis ist – und wie Sie es manipulationssicher machen

Stellen Sie sich eine konkrete Frage: Wenn ein Anwalt, ein Auditor oder der Rechtsbeistand eines Patent-Trolls Sie auffordern würde zu beweisen, dass ein bestimmter Commit an einem bestimmten Datum existierte – was würden Sie ihm tatsächlich vorlegen?

Einen Screenshot von git log? Einen Export Ihrer GitHub-Aktivität? Beides wird mühelos entkräftet. Wenn Sie einen echten Nachweis gegen Manipulation der Git-Historie mit Bitcoin wollen, ist die Antwort kein besserer Export – sondern ein Zeitstempel, den niemand, auch Sie selbst nicht, rückdatieren oder verändern kann. Dieser Leitfaden erklärt die Mechanismen, warum Ihr Log als Beweismittel versagt, und dann die genauen Schritte, um es manipulationssicher zu machen – wobei die GitHub App die Arbeit über Nacht erledigt.

Warum Ihr Git-Log nicht manipulationssicher ist (und was das für die Compliance bedeutet)

Git ist inhaltsadressiert, was viele zu der Annahme verleitet, die Historie sei unveränderlich. Das ist sie nicht. Jeder Commit-Hash ist ein Hash aus Tree, Parent, Nachricht und Metadaten – aber die Kette dieser Hashes liegt in einem Repository auf einem Server, den Sie nicht kontrollieren. Drei Dinge zerstören den Beweiswert:

  • Die Historie ist konstruktionsbedingt umschreibbar. git rebase, git commit --amend und ein Force-Push ersetzen Commits durch neue Hashes. Alte Objekte bleiben bis zur Garbage Collection erhalten, und dann sind sie weg. Ein Maintainer mit Push-Rechten kann Monate der Historie in einer Minute umschreiben.
  • Die Daten sind selbst angegeben. Autor- und Committer-Zeitstempel sind reine Metadaten, die Sie setzen können. Jedes interne Log, das Zeit erfasst, ist nur so vertrauenswürdig wie die Maschine, die es geschrieben hat.
  • Das Log liegt auf fremder Infrastruktur. Ihre GitHub-Organisation, Ihre CI-Datenbank, Ihr internes Wiki – alles editierbar, alles unter Ihrer Kontrolle. Bei einem rechtlichen Audit macht sie das zu „eigennützigen" Beweisen, die leicht angefochten werden können.

Der letzte Punkt ist wichtiger, als Entwickler erwarten. Ein Datensatz, den Sie hätten ändern können, ist ein Datensatz, bei dem die Gegenseite argumentieren wird, Sie hätten ihn tatsächlich geändert. Die Lösung ist nicht mehr Logging – sondern das Verlagern des Nachweises auf ein System, dessen Historie keine einzelne Partei umschreiben kann.

Das ist die Idee hinter kryptografischem Prior Art: Sie nehmen die Fingerabdrücke, die Git ohnehin erzeugt (Commit-Hashes), bündeln sie, hashen den Stapel erneut zu einem Merkle-Baum und verankern die Wurzel über das OpenTimestamps-Protokoll in der Bitcoin-Blockchain. Jemand kann Ihr Repository umschreiben, aber er kann keinen Bitcoin-Block umschreiben.

Timestamp GIT automatisiert diese gesamte Kette – keine CLI-Tools, keine OpenTimestamps-Befehle, keine Änderungen am Entwickler-Workflow. Für tiefergehenden Hintergrund siehe wie man Prior Art für eine Software-Idee ohne Patent beweist und ob ein Blockchain-Zeitstempel rechtlich gültiges Beweismittel ist.

Voraussetzungen: Was Sie brauchen, bevor Sie Ihren ersten Commit verankern

  • Ein GitHub-Repository (öffentlich oder privat), in dem Sie Admin-Rechte haben, damit Sie die Timestamp GIT GitHub App installieren können.
  • Ein Timestamp GIT-Konto – kostenlos für Open-Source-/öffentliche Repos, Pro Agency (49 $/Monat) für private Repos, Enterprise ZK (199 $/Monat) für den GitHub-Actions-Modus.
  • Ein Ziel-Repository für Nachweise. Entweder ein Branch im selben Repo oder ein separates Shadow-Repo. Das GitHub-Berechtigungsmodell erfordert mindestens Lesezugriff auf das Quell-Repo (es gibt keinen „nur Commit-Hash"-Scope) sowie Lese-/Schreibzugriff auf das Ziel.
  • Für den Enterprise-ZK-Modus: einen GitHub-Actions-Workflow und einen API-Schlüssel. Hier ist nur Lese-/Schreibzugriff auf das Ziel-Repo erforderlich – das Quell-Repo braucht überhaupt keinen Lesezugriff.
  • Für Self-Hosting: Docker und Docker Compose sowie eine zeitlich begrenzte Demo-Lizenz von der Docker-Lizenzseite.

Auf den Rechnern der Entwickler wird nichts installiert.

Schritt für Schritt: Machen Sie Ihre Git-Historie mit Timestamp GIT manipulationssicher

Schritt 1 – GitHub App installieren und Repository verbinden

Installieren Sie die Timestamp GIT GitHub App in Ihrer Organisation und wählen Sie die zu überwachenden Repositories aus. Gewähren Sie Lesezugriff auf Quell-Repos und Lese-/Schreibzugriff auf das Ziel (Branch oder Shadow-Repo). Die App registriert Webhooks und erkennt neue Commits automatisch – es gibt keine Aktion pro Commit seitens Ihres Teams.

Im Standardmodus liest die App nur den HEAD-Commit-Hash jedes überwachten Repositories. Sie liest niemals den Working Tree, die Diffs oder die Dateiinhalte.

Schritt 2 – (Optional) Zum Enterprise-ZK-Modus wechseln

Wenn selbst ein Commit-Hash, der Ihr Netzwerk verlässt, zu viel ist, ersetzt der Enterprise-ZK-Modus den Webhook-Pfad durch eine kurze GitHub Action, die auf Ihren eigenen Runnern läuft. Sie überträgt nur den Hash – der Dienst erhält niemals Lesezugriff auf das Quell-Repo.

name: Timestamp commit hash
on:
  push:
jobs:
  anchor:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Push HEAD hash to Timestamp GIT
        env:
          TSGIT_API_KEY: ${{ secrets.TSGIT_API_KEY }}
        run: |
          HASH=$(git rev-parse HEAD)
          # POST $HASH + repo metadata to the Timestamp GIT API.
          # The workflow is generated for you by the Enterprise setup wizard
          # at https://timestampgit.dev/enterprise/{phase}.

Das ist die gesamte Angriffsfläche: ein Hash, eine authentifizierte Anfrage.

Schritt 3 – Den nächtlichen Cron-Worker die Verankerung erledigen lassen

Hier tun Sie nichts. Jede Nacht erledigt ein Worker Folgendes:

  1. Er gruppiert alle ausstehenden Commit-Hashes aus der In-Memory-Queue.
  2. Er erstellt ein Manifest .txt pro Repository.
  3. Er konstruiert nativ einen Merkle-Baum über den Stapel.
  4. Er erstellt OpenTimestamps-Nachweise mithilfe öffentlicher OTS-Kalender.
  5. Er verankert die Merkle-Wurzel in der Bitcoin-Blockchain.

Das Batching ist der Punkt – tausend Commits über hundert Repos kosten eine Verankerung.

Schritt 4 – Die .ots-Belege und Manifeste abholen

Nach der Bitcoin-Bestätigung werden das Manifest und die .ots-Belegdateien in Ihren dedizierten Timestamps-Branch oder das Shadow-Repo zurückgeschrieben. Die Bitcoin-Bestätigung dauert typischerweise etwa 3 Stunden, sodass die Nachweise einige Stunden nach dem nächtlichen Lauf eintreffen – nicht sofort. Planen Sie Ihre Erwartungen entsprechend, insbesondere wenn Sie dies der Compliance-Abteilung demonstrieren.

Schritt 5 – Ein Verifizierungs-Badge einbetten

Holen Sie sich das Snippet von Ihrer Seite für verbundene Repositories (/connected/{user}/{repo}), die eine Live-Vorschau von Shields.io rendert:

[![Bitcoin timestamped](https://img.shields.io/endpoint?url=https://timestampgit.dev/api/statusSummary/acme/payments-service)](https://timestampgit.dev/status/acme/payments-service)

Wer darauf klickt, landet auf dem öffentlichen Status-Dashboard. Bei privaten Repos wird der URL ein verschlüsselter HMAC angehängt – instanzspezifisch –, sodass nur autorisierte Betrachter die Daten sehen.

Schritt 6 – (Alternative) Self-Hosting mit Docker Compose

Für air-gapped Umgebungen oder maximale Kontrolle läuft dieselbe Pipeline als Docker-Image. Ein Quick-Start-Docker-Compose-Setup sieht so aus:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Die App ist unter http://localhost:8080 verfügbar. Beim ersten Start führt Sie ein Einrichtungsassistent durch die Verbindung Ihrer GitHub App und die Konfiguration der Instanz. Legen Sie Ihre Demo-Lizenz von der Docker-Lizenzseite an der entsprechenden Stelle ab, wenn Sie dazu aufgefordert werden.

So bestätigen Sie, dass es funktioniert hat: Verifizierung und Audit-Trails

Vier Prüfungen, in aufsteigender Reihenfolge der Strenge:

1. Das Status-Dashboard. Besuchen Sie /status/{user}/{repo} für die Beständigkeit der Nachweise, das früheste Verankerungsdatum, die tägliche Regelmäßigkeit sowie die Bitcoin-Block- und Transaktionsdaten hinter jedem Stapel. Eine Kalender-Heatmap macht Lücken offensichtlich – nützlich, wenn ein Auditor fragt: „War das kontinuierlich?"

2. Die Verifizierungsseite. /verification/{user}/{repo}/{date} führt Sie Schritt für Schritt durch die mehrstufige Merkle-Kette. Die gesamte Berechnung erfolgt lokal in Ihrem Browser: Zero-Knowledge, und niemand sieht, was Sie verifizieren. Dies ist die Seite, die Sie in einem Meeting öffnen, wenn jemand den Zeitstempel anzweifelt.

3. Audit-Exporte. Rufen Sie strukturierte Datensätze für die Compliance ab:

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/acme/payments-service

# PDF certificate for a specific anchored date
curl -OJ https://timestampgit.dev/api/report/acme/payments-service/2026-10-30

# Raw Merkle chain data for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-30

4. Unabhängige Verifizierung. Da der Nachweis nur auf SHA-256 und Bitcoin-Blockdaten beruht, kann jeder einen .ots-Beleg mit Standard-OpenTimestamps-Verifizierungstools gegen die Blockchain prüfen – offline, ohne Timestamp GIT. Das ist die Garantie der Anbieterunabhängigkeit: Wenn das Unternehmen morgen verschwindet, lassen sich Ihre Nachweise weiterhin verifizieren.

Fehlerbehebung bei häufigen Problemen

  • App installiert, aber nichts wird überwacht. Prüfen Sie die Berechtigungen erneut: Lesezugriff auf die Quelle, Lese-/Schreibzugriff auf das Ziel. Der Enterprise-ZK-Modus ist die Ausnahme – er benötigt nur Lese-/Schreibzugriff auf das Ziel und keinen Lesezugriff auf die Quelle.
  • Nachweise „fehlen" nach einem Push. Das tun sie nicht. Die Bitcoin-Bestätigung dauert mehrere Stunden, und die Nachweisdateien werden danach geschrieben. Prüfen Sie die Statusseite auf ausstehende Verankerungen, bevor Sie einen Bug melden.
  • Badge liefert 404 bei einem privaten Repo. Die URL enthält einen verschlüsselten HMAC, der für Ihre Serverinstanz spezifisch ist. Kopieren Sie den Link von /api/badgeLink/{user}/{repo}, statt ihn von Hand zu konstruieren.
  • Self-Hosted-Container startet, aber der Assistent schlägt fehl. Vergewissern Sie sich, dass ./data korrekt eingebunden und beschreibbar ist, und prüfen Sie dann docker compose logs -f timestampgit. Die meisten Fehler beim ersten Start sind ein Berechtigungs- oder Volume-Problem, nicht die App.

FAQ

Kann ich die Git-Historie nach der Verwendung von Timestamp GIT noch umschreiben? Ja – Sie können lokal rebasen, amendieren oder force-pushen. Aber die in Bitcoin verankerten Commit-Hashes bleiben unveränderlich. Jede Manipulation an den ursprünglichen Commits wird offensichtlich, weil die in Bitcoin verankerten Hashes nicht mit der veränderten Historie übereinstimmen.

Hat Timestamp GIT Zugriff auf meinen Quellcode? Nein. Im Standardmodus liest die GitHub App nur den HEAD-Commit-Hash. Im Enterprise-ZK-Modus überträgt eine GitHub Action nur den Commit-Hash an die API. Ihr Quellcode verlässt niemals Ihre Umgebung.

Was passiert, wenn Timestamp GIT den Betrieb einstellt? Ihre Nachweise sind anbieterunabhängig. Die .ots-Belegdateien plus die Bitcoin-Blockchain-Daten ermöglichen es jedem, den Zeitstempel offline mit Standard-OpenTimestamps-Tools zu verifizieren, ohne auf Timestamp GIT angewiesen zu sein.

Wie lange dauert es, bis ein Commit verankert ist? Commits werden nächtlich gebündelt. Nach der Verankerung des Stapels dauert die Bitcoin-Bestätigung typischerweise etwa 3 Stunden, und die Nachweisdateien werden einige Stunden später geschrieben. Die .ots-Belege finden Sie im Timestamps-Branch Ihres Repositories.

Fazit

Ihr Git-Log ist ein operativer Datensatz, kein Beweismittel. Er liegt auf Infrastruktur, die Sie kontrollieren, enthält Daten, die Sie setzen können, und kann von jedem mit Push-Rechten umgeschrieben werden – genau deshalb tun ihn Auditoren ab. Die Verankerung von Commit-Hashes in Bitcoin verwandelt diesen Datensatz in etwas außerhalb Ihrer Kontrolle und außerhalb Ihrer Möglichkeit, ihn zu verändern.

Timestamp GIT erledigt das, ohne dass Ihre Entwickler ein Protokoll lernen müssen: Installieren Sie die GitHub App einmal, lassen Sie den nächtlichen Worker verankern, betten Sie das Badge ein und bewahren Sie die .ots-Belege und Audit-Exporte für den Tag auf, an dem Sie sie tatsächlich brauchen.

Nächster Schritt: Installieren Sie die App noch heute in Ihrem geschäftskritischsten Repository. Die älteste Verankerung, die Sie je haben werden, ist die, die Sie heute Nacht erstellen.

Verwandte Beiträge

EU label: AI-generated content