Git-Commit-Zeitstempel mit einer GitHub App automatisieren
Sie haben entschieden, dass Ihre Commits einen kryptografischen Existenznachweis verdienen. Gut. Jetzt stellt sich operativ nur noch eine Frage: Erfolgt dieser Nachweis, wenn jemand daran denkt, oder erfolgt er jede Nacht, ob jemand daran denkt oder nicht?
Die erste Version jedes Zeitstempel-Prozesses ist manuell. Jemand im Team schreibt ein Skript, führt es vor einem Release aus, speichert eine Datei irgendwo und fühlt sich einigermaßen abgesichert. Sechs Wochen später ist diese Person im Urlaub, das Skript liegt auf einem Laptop, der neu aufgesetzt wurde, und der Release-Branch wurde überhaupt nie gestempelt. Schlimmer noch: Niemand bemerkt es – denn ein Repository mit teilweiser Zeitstempel-Abdeckung sieht genau aus wie ein vollständig abgedecktes, bis ein Prüfer nach einem bestimmten Datum fragt.
In diesem Artikel geht es um den Automatisierungsweg: eine Installation, kein Ritual pro Commit, keine Tools auf den Entwickler-Rechnern. Wir behandeln die einmalige Einrichtung, was tatsächlich zwischen einem git push und einem Bitcoin-Block passiert, wie man diese Pipeline überwacht und wo Automatisierung unbemerkt schiefgehen kann.
Die manuelle Zeitstempel-Falle (und warum Automatisierung gewinnt)
Manuelles Zeitstempeln hat einen vorhersehbaren Fehlermodus: Es skaliert mit Disziplin, und Disziplin skaliert nicht über Teams, Repos und Zeitzonen hinweg.
Konkret bedeutet der manuelle Ansatz, für jeden Commit, der Ihnen wichtig ist, einen CLI-Schritt oder ein maßgeschneidertes Skript auszuführen – oder, schlimmer noch, die zugrunde liegenden Bitcoin-Transaktionsdaten von Hand zusammenzustellen. Das ist der beschwerliche Weg, und er bricht an drei Stellen:
- Es ist pro Commit. Hundert Commits pro Woche werden zu hundert Gelegenheiten, den Schritt zu vergessen.
- Es ist umgebungsabhängig. Das Skript lebt auf dem Rechner von irgendjemandem, nicht in der Geschichte des Repos. Neue Mitarbeiter haben es nicht; CI hat es standardmäßig nicht.
- Es ist als Richtlinie nicht überprüfbar. Die Compliance-Abteilung kann nicht feststellen, ob ein Zeitstempel fehlt, weil an diesem Tag nichts passiert ist oder weil jemand es vergessen hat.
Für Entwickler ist die Anforderung einfach: In meinem Workflow ändert sich nichts. Für die Compliance ist die Anforderung ebenso einfach: Jeder Commit in jedem überwachten Repo ist abgedeckt, und ich kann es beweisen.
Das ist das Argument für eine GitHub App als Automatisierungsoberfläche statt einer CLI. Die GitHub App von Timestamp GIT wird einmal auf Organisationsebene installiert und beobachtet dann jeden Commit in den von Ihnen ausgewählten Repositories und verankert sie nächtlich in Bitcoin – lange nachdem alle nach Hause gegangen sind.
Einmalige Einrichtung: GitHub App installieren und vergessen
Die Einrichtung erfolgt in einem einzigen Durchgang, durch einen Administrator statt durch jeden Entwickler.
- Installieren Sie die App in Ihrer GitHub-Organisation oder Ihrem persönlichen Konto.
- Wählen Sie die Repositories aus, die überwacht werden sollen. Es gibt keine Konfigurationsdatei pro Repo, keine CI-Änderung und keine Installation auf Entwickler-Rechnern.
- Erteilen Sie Berechtigungen. Das GitHub-Berechtigungssystem bietet keinen Scope „nur Commit-Hash“, daher benötigt die App Lesezugriff auf Ihre Quell-Repositories und Lese-/Schreibzugriff auf das Ziel-Repository, in das die Nachweise geschrieben werden. Dieses Lese-/Schreibziel ist entweder ein dedizierter
timestamps-Branch im selben Repo oder ein separates Shadow-Repository – Ihre Entscheidung. - Fertig. Von hier an läuft die Erkennung über GitHub-Webhooks, und von Ihrem Team ist nichts weiter erforderlich.
Wenn Sie das strengere Isolationsmodell wünschen, ersetzt der Enterprise-ZK-Modus die Webhook-Erkennung durch eine 12-zeilige GitHub Action, die auf Ihrer eigenen Infrastruktur ausgeführt wird. Diese Action überträgt nur den Commit-Hash an die Timestamp GIT API. In diesem Modus benötigt der Dienst überhaupt keinen Lesezugriff auf Ihre Quell-Repositories – nur Lese-/Schreibzugriff auf das Ziel-Repository, das die Nachweise erhält. Sie müssen natürlich die Action selbst installieren.
Self-Hosting in einer air-gapped oder hochsicheren Umgebung
Für maximale Kontrolle wird Timestamp GIT als Docker-Image unter einer Self-Hosted-Lizenz ausgeliefert. 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
Starten Sie es und verfolgen Sie die Logs:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Die Anwendung ist unter http://localhost:8080 verfügbar, sobald sie startet. Beim ersten Start führt Sie ein Einrichtungsassistent durch die Verbindung Ihrer GitHub App und die Konfiguration der Instanz. Die Evaluierung läuft mit einer zeitlich begrenzten Demo-Lizenz, die über die Docker-Lizenzseite mit Ihrem Namen, Unternehmen, E-Mail und optional einer Telefonnummer angefordert wird.
In der automatisierten Pipeline: Vom Commit zum Bitcoin-Anker
Nach der Installation ist die Pipeline von Natur aus unspektakulär. Das ist der Punkt – sie sollte langweilig sein.
1. Commit-Erkennung. Die GitHub App fängt neue Commits über Webhooks ab. Im Enterprise-ZK-Modus überträgt stattdessen Ihre GitHub Action die Hashes an die API. So oder so werden nur Commit-Hashes übertragen.
2. Hash-Warteschlange. Die Hashes landen in einem In-Memory-Key-Value-Store und warten auf den nächsten Batch. Das ist Absicht: Hunderte Commits in einem Bitcoin-Anker zu bündeln, macht das Ganze günstig genug, um es für jedes Repository zu betreiben, das Sie besitzen.
3. Nächtlicher Cron-Worker. Jede Nacht gruppiert ein Worker alle ausstehenden Hashes, schreibt eine Manifest-Datei pro Repo (.txt), baut nativ einen Merkle-Baum, erstellt OpenTimestamps-Nachweise gegen öffentliche OTS-Kalender und verankert die Merkle-Wurzel in der Bitcoin-Blockchain.
4. Nachweiszustellung. Das Manifest und die .ots-Belegdateien werden zurück in Ihr Repository gepusht – in einen dedizierten timestamps-Branch oder ein Shadow-Repo. Die Bitcoin-Bestätigung dauert typischerweise etwa 3 Stunden, sodass das Schreiben der Nachweise normalerweise einige Stunden nach dem Start des Batches abgeschlossen ist.
Der API-Aufruf, den der ZK-Modus ausführt, sieht so aus (das Segment {hash} ist der HMAC-Wert aus der signierten URL, kein Commit-Hash):
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/proofs/<hmac>/<commit-sha>/<commit-id>"
Beachten Sie, was nicht in dieser Nutzlast enthalten ist: kein Diff, keine Dateiinhalte, kein Branch-Name, keine Autorenidentität über das hinaus, was eine Commit-ID impliziert. Zero-Knowledge-Sicherheit ist hier kein Marketingbegriff – der Dienst sieht, kopiert oder speichert Ihren Quellcode nie, nur den Git-Hash.
Und beachten Sie, was von Ihren Entwicklern nicht verlangt wird: kein Befehl, kein Hook, kein Flag. Sie pushen wie gewohnt. Der Nachweis erscheint am nächsten Morgen.
Monitoring und Fehlerbehandlung: Ihre Nachweise zuverlässig halten
Automatisierung, die man nicht beobachten kann, ist nur Hoffnung mit zusätzlichen Schritten. Es gibt drei Ebenen der Sichtbarkeit, und Sie sollten alle nutzen.
Öffentliche Status-Dashboards
Jedes überwachte Repository erhält eine Statusseite unter https://timestampgit.dev/status/{user}/{repo}, die die Nachweis-Lebensdauer (wie weit die Abdeckung zurückreicht), das früheste Ankerdatum, die tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten sowie eine Kalender-Heatmap zeigt. Die Heatmap ist der schnellste Weg, eine Lücke zu erkennen: Ein einzelner fehlender Tag fällt sofort auf.
README-Badges
Holen Sie sich das Embed-Widget von https://timestampgit.dev/connected/{user}/{repo}, das Ihnen eine Live-Shields.io-Vorschau plus Copy-and-Paste-Markdown liefert. Das Badge verlinkt auf eine öffentliche Verifizierungsseite, die jeder prüfen kann – nützlich, wenn Sie möchten, dass ein Kunde oder Prüfer die Abdeckung bestätigt, ohne ein Konto zu erstellen.
# Returns badge URLs and ready-to-paste markdown snippets
curl https://timestampgit.dev/api/badgeLink/acme/payments-api
Private Repositories werden ebenfalls abgedeckt: Ihre URLs enthalten einen verschlüsselten HMAC, spezifisch für die Serverinstanz, sodass nur autorisierte Benutzer den Status lesen können.
Programmatisches Monitoring und Audit-Exporte
Die öffentlichen Status-Endpunkte sind dafür ausgelegt, von Ihren eigenen Tools abgefragt zu werden:
# Last anchored Bitcoin block info (JSON)
curl https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed / stamped commit count (JSON)
curl https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary used by Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-api
Für die Compliance-Berichterstattung rufen Sie das vollständige Audit-Ledger als CSV mit GET /api/audit/{user}/{repo} und PDF-Zertifikate pro Tag mit GET /api/report/{user}/{repo}/{date} ab.
Wenn ein Lauf fehlschlägt
Wenn ein nächtlicher Lauf verzögert wird oder fehlschlägt, bleiben ausstehende Hashes in der Warteschlange und rutschen in den nächsten Batch – Commits gehen nicht verloren. In der Praxis zeigt sich ein Problem als flache Strecke auf der Status-Heatmap statt als Datenverlust. Beobachten Sie es an zwei Stellen: docker compose logs -f timestampgit für selbst gehostete Instanzen und das Dashboard für die SaaS-Variante.
Best Practices für automatisiertes Commit-Zeitstempeln
Automatisierung beseitigt die Kosten pro Commit, also ändert sich der richtige Standard: Die Abdeckung sollte breit sein, nicht kuratiert.
- Überwachen Sie jedes Repository, das geistiges Eigentum enthält. Das Herauspicken „wichtiger“ Repos ist eine manuelle Entscheidung, die sich als Automatisierung tarnt – und das Repo, das Sie auslassen, ist immer das, das sich als wichtig erweist. Die Grenzkosten eines weiteren Repos sind ein nächtlicher Hash in einem bestehenden Batch.
- Nutzen Sie den Enterprise-ZK-Modus für sensible Codebasen. Wenn Ihre Richtlinie besagt, dass nicht einmal Commit-Hashes an Dritte übertragen werden dürfen, hält der Weg über die GitHub Action alles außer dem Hash innerhalb Ihres Perimeters. Für vollständig isolierte Umgebungen deckt die Docker-Self-Hosted-Lizenz dasselbe ab.
- Exportieren Sie Audit-Ledger nach einem Zeitplan. Eine CSV im selben Ordner wie Ihre Rechtsdokumente ist besser als ein Dashboard-Login, den Sie während eines Rechtsstreits vergessen.
- Committen Sie früh und häufig auf überwachten Branches. Viele kleine Commits ergeben eine dichtere Nachweisspur mit besser verteidigbaren Daten als ein großer Squash zum Release-Zeitpunkt.
- Vermeiden Sie das Umschreiben der Historie auf Branches, auf die Sie sich als Prior Art verlassen. Ein Force-Push erzeugt neue Hashes; die alten bleiben verankert, aber die Zuordnung zwischen „diesem Code“ und „diesem Nachweis“ wird einem Anwalt gegenüber schwerer zu erklären. Wenn Sie umschreiben müssen, taggen Sie zuerst den Zustand vor dem Umschreiben.
- Halten Sie den Nachweis-Branch von Ihren Quell-Branches getrennt. Der
timestamps-Branch oder das Shadow-Repo ist generierte Ausgabe – ihn als schreibgeschützt zu behandeln, vermeidet versehentliche Merges inmain.
Eine Grenze sollten Sie im Hinterkopf behalten: Batching plus etwa 3 Stunden Bitcoin-Bestätigung bedeuten, dass ein um 17 Uhr erstellter Commit nicht um 17:05 Uhr nachweisbar ist. Wenn Sie den Nachweis heute brauchen, planen Sie um das nächtliche Fenster herum, statt eine sofortige Abwicklung zu erwarten.
FAQ
Müssen Entwickler Befehle ausführen oder Tools installieren, um Commits mit Zeitstempeln zu versehen?
Nein. Sobald die GitHub App installiert ist, wird jeder Commit in einem überwachten Repository automatisch erkannt und nächtlich in Bitcoin verankert. Entwickler verwenden Git wie gewohnt weiter – keine CLI, keine manuellen Schritte.
Wie lange nach einem Commit ist der Zeitstempel-Nachweis verfügbar?
Commits werden gebündelt und einmal pro Nacht verankert. Nachdem der Batch übermittelt wurde, dauert die Bitcoin-Bestätigung typischerweise etwa 3 Stunden, sodass die Nachweise normalerweise am nächsten Morgen verfügbar sind.
Kann ich den Zeitstempel verifizieren, ohne mich auf Timestamp GIT zu verlassen?
Ja. Die .ots-Belegdateien und Merkle-Nachweise sind anbieterunabhängig – SHA-256 plus Bitcoin-Blockdaten, kein proprietäres Format. Sie können sie herunterladen und mit Standard-OpenTimestamps-Tooling gegen die Bitcoin-Blockchain prüfen oder die In-Browser-Verifizierungsseite nutzen, die alle Berechnungen lokal in Ihrem Browser durchführt. Diese lokale Verifizierung lohnt sich, separat nachzulesen: siehe How to Verify a Bitcoin Timestamp Proof in Your Browser.
Was ist, wenn mein Repository privat ist oder sensiblen Code enthält?
Timestamp GIT liest oder speichert Ihren Quellcode nie – nur Commit-Hashes werden verarbeitet. Für strengere Isolation überträgt im Enterprise-ZK-Modus eine GitHub Action nur Hashes von Ihrer eigenen Infrastruktur, oder Sie hosten selbst mit Docker. Wenn Sie die Kompromisse gegenüber anderen Ansätzen abwägen, behandelt Timestamp GIT Alternatives: What to Compare First die Vergleichsdimensionen.
Was ist, wenn ich mehrere GitHub-Organisationen verwende?
Installieren Sie die App in jeder Organisation und überwachen Sie die Repositories, die Sie benötigen. Ihr Dashboard aggregiert alle überwachten Repositories an einem Ort.
Fazit
Der Wert eines Zeitstempels ist umgekehrt proportional zu der Aufmerksamkeit, die er erfordert. Ein Nachweis, den Sie manuell erzeugen, ist ein Nachweis, der für die Commits existiert, an die Sie sich erinnert haben – was bei einem Audit als inkonsistenter Prozess statt als geschützter Prozess gelesen wird.
Die Installation der GitHub App erfordert eine Admin-Sitzung. Danach wird jeder Commit in einem überwachten Repository gehasht, gebündelt, mit einer Merkle-Wurzel versehen und in Bitcoin verankert, während Sie schlafen – mit Badges für öffentliche Glaubwürdigkeit, CSV-Ledgern für die Compliance und .ots-Belegen, die jeden Anbieter überdauern. Für Entwickler ändert sich nichts.
Bereit, es nicht mehr von Hand zu tun? Installieren Sie die GitHub App für Ihre Organisation – kostenlos für öffentliche Repositories, mit den Tarifen Pro Agency und Enterprise ZK für private Repos und Hash-only-Workflows.
Verwandte Beiträge
- OpenTimestamps Without the CLI: Managed Bitcoin Timestamping
- How to Verify a Bitcoin Timestamp Proof in Your Browser
- How to Timestamp Git Commits Without the Command Line