Automatische Git-Commit-Zeitstempel ohne jede CLI
Die meisten Teams, die kryptografischen Stand der Technik (Prior Art) wollen, bekommen ihn nie – und der Grund ist fast nie technisch. Er ist operativ. Eine Zeitstempel-Gewohnheit funktioniert nur, wenn ein Mensch daran denkt, das Tool zum richtigen Zeitpunkt auf den richtigen Commit anzuwenden und den Beleg dort abzulegen, wo der Auditor ihn achtzehn Monate später findet. Unter Termindruck stirbt diese Gewohnheit zuerst.
In diesem Artikel geht es darum, die Gewohnheit vollständig abzuschaffen. Nicht „wie man einen Zeitstempel-Befehl öfter ausführt“, sondern wie jeder Commit in einem überwachten Repository automatisch jede Nacht in der Bitcoin-Blockchain verankert wird – ohne dass jemand in deinem Team einen einzigen Befehl eintippt. Wenn du abwägst, ob es sich lohnt, das rohe Protokoll zu lernen, statt eine verwaltete GitHub App zu nutzen, behandeln wir diesen Trade-off separat in OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?. Hier gehen wir davon aus, dass du dich für die Automatisierung entschieden hast.
Die manuelle Zeitstempel-Falle (und warum du da raus willst)
Stell dir vor, wie manuelles Zeitstempeln in der Praxis abläuft:
- Jemand schließt einen Feature-Branch ab und erinnert sich – meist im Nachhinein –, dass dieser Commit einen Zeitstempel bekommen sollte.
- Er führt ein Tool aus, wartet und bekommt eine Belegdatei zurück.
- Der Beleg wird umbenannt, in einen
proofs/-Ordner gelegt, committet oder – schlimmer – per E-Mail an einen Manager geschickt. - Für die nächsten vierzig Commits macht das niemand, weil der Sprint hektisch wurde.
Die rohe OpenTimestamps-CLI existiert und ist der harte Weg: ein expertenorientierter Pfad, bei dem du das Batching, die Belegdateien, die Kalender-Interaktion und das Ablagesystem selbst verantwortest. Es funktioniert. Es hängt aber davon ab, dass eine Person für immer diszipliniert bleibt, und es hinterlässt keine Prüfspur, die erklärt, warum Commit 4f9c1ab einen Beleg hat und Commit 8d2e0f3 nicht.
Der Compliance-Fehlermodus ist schlimmer als die Unannehmlichkeit. Eine Prior-Art-Aufzeichnung mit Lücken ist eine Aufzeichnung, die ein Anwalt auseinandernehmen kann. Wenn eine Gegenpartei fragt „beweise, wie eure Codebasis am 14. März aussah“ und deine Antwort eine Tabelle plus das Gedächtnis eines Entwicklers ist, hast du die Rahmung bereits verloren. Manuelle Prozesse sind auch schwer zu auditieren: kein konsistentes Artefakt, keine regelmäßige Kadenz und keine Möglichkeit für einen Compliance-Prüfer, die Abdeckung zu bestätigen, ohne Ingenieure zu bitten, ihre eigene Historie zu rekonstruieren.
Das Versprechen der Automatisierung ist von anderer Art, nicht nur graduell besser: einmal installieren, und ab diesem Moment wird jeder Commit in einem überwachten Repository mit einem Fingerabdruck versehen und nächtlich verankert. Keine CLI zu lernen, keine Belege von Hand abzulegen, nichts auf Entwickler-Rechnern zu installieren. Die Belegaufzeichnung wird zu einer Eigenschaft des Repositories statt zu einer Eigenschaft der Sorgfalt von jemandem.
Einmalige Einrichtung: Installiere die GitHub App und vergiss sie
Der primäre Weg ist die GitHub App. Du installierst sie auf einem Repository oder auf der gesamten Organisation, und die Einrichtung ist wirklich einmalig – keine Skripte pro Repository, kein Onboarding-Schritt für Entwickler.
Standardmodus (GitHub App). Die App liest den HEAD-Commit-Hash jedes überwachten Repositories automatisch. GitHubs Berechtigungsmodell bietet keinen Scope „nur Commit-Hash“, daher benötigt die App mindestens Lesezugriff auf das Quell-Repository. Sie braucht außerdem Lese-/Schreibzugriff auf das Ziel-Repository, denn dort werden die Belege geschrieben: in einen dedizierten timestamps-Branch, entweder im selben Repository wie die Quelle oder in einem separaten Shadow-Repository.
Enterprise-ZK-Modus. Eine 12-zeilige GitHub Action läuft auf deiner eigenen Infrastruktur und pusht nur den Commit-Hash an die Timestamp GIT API. In diesem Modus braucht der Dienst überhaupt keinen Lesezugriff auf das Quell-Repository – nur Lese-/Schreibzugriff auf das Ziel-Repo für die Belegauslieferung – und du installierst die Action in deinem Workflow. Wähle diesen Modus, wenn Lesezugriff auf den Quellcode aus Richtlinien-Gründen nicht infrage kommt oder wenn dein Security-Review verlangt, dass Hashes innerhalb deines Perimeters entstehen. Wähle den Standardmodus, wenn du die absolut minimalen beweglichen Teile willst.
| Standard (GitHub App) | Enterprise ZK (GitHub Action) | |
|---|---|---|
| Zugriff auf Quell-Repo | Lesezugriff | Keiner |
| Zugriff auf Ziel-Repo | Lese-/Schreibzugriff | Lese-/Schreibzugriff |
| Woher die Hashes stammen | Die App | Dein CI-Runner |
| Einrichtungsaufwand | App installieren | App installieren + Action hinzufügen |
In beiden Modi wird nichts auf Entwickler-Rechnern installiert. Ingenieure committen genau wie heute, und die gesamte Pipeline läuft serverseitig. Der Dienst sieht, kopiert oder speichert deinen Quellcode nie – er verarbeitet ausschließlich Commit-Hashes.
Wenn du das Ganze in deinem eigenen Netzwerk betreiben musst, ist Timestamp GIT auch als selbst gehostetes Docker-Image verfügbar. 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 Anwendung ist nach dem Start unter http://localhost:8080 erreichbar, und ein Einrichtungsassistent beim ersten Start führt dich durch die Verbindung deiner GitHub App und die Konfiguration der Instanz. Eine zeitlich begrenzte Demo-Lizenz zur Evaluierung kann über die Docker-Lizenzseite angefordert werden. Tiefer ins Deployment gehen wir in Self-Host Git Timestamping With Docker Compose.
Die automatisierte Pipeline: Vom Commit zum Bitcoin-Anker
Sobald die App installiert ist, passiert Folgendes ohne dich:
- Commit-Erkennung. Entweder greift die GitHub App neue Commits über Webhooks auf, oder deine GitHub Action pusht Commit-Hashes an die API. Es bewegen sich nur Hashes.
- Hash-Warteschlange. Commit-Hashes landen in einem In-Memory-Key-Value-Store und warten auf den nächtlichen Batch.
- Mitternachts-Cron-Worker. Jede Nacht gruppiert ein Worker alle ausstehenden Hashes, schreibt pro Repository eine Manifest-Textdatei, baut nativ einen Merkle-Baum, erstellt OpenTimestamps-Belege über öffentliche OTS-Kalender und verankert die Merkle-Wurzel in der Bitcoin-Blockchain.
- Belegauslieferung. Das Manifest und die
.ots-Belegdateien werden zurück in dein Repository gepusht – in einen dedizierten timestamps-Branch oder ein Shadow-Repository –, sodass die Belege neben dem Code liegen, den sie beschreiben.
Ein praktischer Hinweis zum Timing: Die Bitcoin-Bestätigung dauert mehrere Stunden, normalerweise etwa drei. Ein am Dienstag erstellter Commit erhält also am Mittwochmorgen einen finalisierten Beleg, nicht am Dienstagabend. Das sind die Kosten der Verankerung in einem öffentlichen, unveränderlichen Ledger – und es sind Kosten, die es wert sind.
Du musst nichts davon einfach glauben. Jedes überwachte Repository bekommt ein öffentliches Status-Dashboard, das die Langlebigkeit der Belege, das früheste Ankerdatum, die tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten hinter jedem Anker sowie eine Kalender-Heatmap zeigt, die du auf Lücken hin überfliegen kannst. Dieselbe Seite bietet herunterladbare Audit-CSV- und PDF-Zertifikate. Die Verifikation selbst erfolgt unter /verification/{user}/{repo}/{date}, die die mehrstufige Merkle-Kette Schritt für Schritt durchläuft – und all diese Berechnung findet lokal im Browser statt, sodass niemand sieht, was du verifizierst.
Für READMEs zeigen einbettbare Badges öffentlich den Verifikationsstatus an, und jeder kann dem Badge-Link folgen, um den Zeitstempel auf der Website zu verifizieren oder den PDF-Bericht herunterzuladen.
Um den Status in deine eigenen Dashboards einzubinden, ist die öffentliche API bewusst langweilig:
# Last anchored Bitcoin block info
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed/stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary (what the Shields.io badge consumes)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
Und wenn Compliance nach Artefakten fragt, klickst du nicht am Freitag um 17 Uhr durch eine UI:
# Full audit ledger as CSV
curl -sL -o audit-acme-payments-api.csv \
https://timestampgit.dev/api/audit/acme/payments-api
# PDF certificate for a specific day
curl -sL -o certificate-2026-11-14.pdf \
https://timestampgit.dev/api/report/acme/payments-api/2026-11-14
Badge-URLs und fertig einzufügendes Markdown kommen von /api/badgeLink/{user}/{repo} (authentifiziert). Bei privaten Repositories tragen Status-URLs einen verschlüsselten HMAC, der spezifisch für deine Server-Instanz ist, sodass nur autorisierte Nutzer sie lesen können.
Monitoring und Fehlerbehandlung: Die Automatisierung ehrlich halten
Automatisierung, die du nicht beobachtest, ist Automatisierung, von der du nicht weißt, ob sie funktioniert. Drei Dinge lohnen es, eine Gewohnheit darum aufzubauen.
Achte auf Lücken, nicht auf Fehler. Wenn ein nächtlicher Lauf fehlschlägt, versucht das System es erneut, und ausstehende Hashes bleiben in der In-Memory-Warteschlange, statt verworfen zu werden. Aber Warteschlangentiefe und Wiederholungen sind intern; die Kalender-Heatmap auf der Statusseite ist das, was du tatsächlich lesen kannst. Ein fehlender Tag ist sofort als Loch im Raster sichtbar.
Abfragen und alarmieren. Ein kleiner geplanter Job, der die neueste Status-Payload mit dem Schnappschuss von gestern vergleicht, erkennt eine stockende Pipeline, bevor ein Auditor es tut:
import json, pathlib, requests
REPO = "acme/payments-api"
URL = f"https://timestampgit.dev/api/statusSummary/{REPO}"
snapshot = pathlib.Path("last-status.json")
r = requests.get(URL, timeout=30)
r.raise_for_status()
current = r.json()
previous = json.loads(snapshot.read_text()) if snapshot.exists() else None
if previous == current:
print("WARNING: status unchanged since last poll - check the repo status page")
else:
print("new anchor data:", json.dumps(current))
snapshot.write_text(json.dumps(current, indent=2))
Lass ihn stündlich in der CI laufen oder täglich direkt nach dem Cron-Fenster, und leite die Warnung dorthin, wo Menschen hinschauen.
Plane Audits um die Bestätigungsverzögerung herum. Weil die Verankerung in Bitcoin nach dem Lauf des Cron-Workers einige Stunden dauert, ist „timestamp alles aus dem gestrigen Release, ich brauche das Zertifikat in zehn Minuten“ keine Anfrage, die jemand erfüllen kann. Gib Compliance eine einfache Regel: Belege für Tag N sind bis Tag N+1 final.
Das Beruhigende an der Fehlerbehandlung ist, was passiert, wenn der Dienst vollständig nicht verfügbar ist. Die Verifikation braucht uns nicht. Die .ots-Belegdatei kann offline gegen die Bitcoin-Blockchain mit Standard-OpenTimestamps-Verifikationstools geprüft werden, denn der Beleg hängt nur von SHA-256 und Bitcoin-Blockdaten ab – keine proprietäre Technologie, kein Lock-in. Selbst wenn der Anbieter verschwindet, bleibt der Beleg bestehen.
Best Practices für Hands-off-Zeitstempel
- Früh und oft committen. Jeder Commit wird automatisch mit einem Fingerabdruck versehen, sodass eine dichte Commit-Historie eine dichte Prior-Art-Aufzeichnung erzeugt. Einen Monat Arbeit am Abend vor einer Patentanmeldung in einen Commit zu squashen, gibt dir einen Anker statt zweihundert.
- Wähle den Modus, der zu deiner Sicherheitshaltung passt. Wenn Lesezugriff auf das Quell-Repo nicht infrage kommt, nutze den Enterprise-ZK-Modus: Nur Commit-Hashes verlassen deine Infrastruktur, gepusht durch die GitHub Action.
- Exportiere Audit-Ledger und Zertifikate nach Zeitplan. Compliance-Archive sollten nicht davon abhängen, dass sich jemand an einen Download-Link erinnert. Rufe monatlich
/api/audit/{user}/{repo}und für Meilenstein-Daten/api/report/{user}/{repo}/{date}ab und speichere die Ergebnisse dort, wo deine rechtlichen Artefakte liegen. - Setze das Badge in dein README. Über das Signal an Kunden hinaus ist ein Live-Verifikations-Badge eine günstige Abschreckung gegen Behauptungen wie „wir haben das unabhängig entwickelt“.
- Halte Belege in einem eigenen Branch oder Shadow-Repo. Tägliche Beleg-Commits in einem dedizierten timestamps-Branch halten deine Haupt-Historie lesbar und die Beweise trotzdem am selben Repository befestigt.
- Schreibe den Prozess auf. Dokumentiere für einen Auditor, wer die GitHub App installiert hat, welche Repositories überwacht werden und wo der timestamps-Branch liegt. Die Mathematik ist verifizierbar; die Beweiskette braucht trotzdem einen Absatz.
FAQ
Muss ich Software auf Entwickler-Rechnern installieren?
Nein. Timestamp GIT ist ein verwalteter Dienst, der vollständig serverseitig über eine GitHub App läuft. Entwickler committen einfach wie gewohnt; es sind keine CLI-Tools oder lokalen Installationen erforderlich.
Wie lange dauert es, bis ein Commit einen Zeitstempel bekommt?
Commits werden nächtlich gebündelt und in Bitcoin verankert. Die Bitcoin-Bestätigung dauert typischerweise etwa 3 Stunden, daher sind Belege normalerweise einige Stunden nach dem nächtlichen Cron-Lauf verfügbar.
Kann ich Belege ohne den Dienst verifizieren?
Ja. Du erhältst eine unveränderliche .ots-Belegdatei, die offline mit Standard-OpenTimestamps-Tools gegen die Bitcoin-Blockchain verifiziert werden kann. Der Beleg ist anbieterunabhängig und beruht nur auf SHA-256 und Bitcoin-Blockdaten.
Was ist, wenn ich ein privates Repository verwende?
Die GitHub App funktioniert mit privaten Repositories. Status-URLs für private Repos enthalten einen verschlüsselten HMAC, der spezifisch für deine Server-Instanz ist, sodass nur autorisierte Nutzer den Status sehen können.
Fazit
Der ganze Wert einer Prior-Art-Aufzeichnung besteht darin, dass sie existiert, wenn du sie brauchst – was bedeutet, dass sie nicht davon abhängen darf, dass ein Mensch sich an einen Befehl erinnert. Installiere die GitHub App einmal, und jeder Commit in den überwachten Repositories wird eingereiht, um Mitternacht gebündelt, mit einer Merkle-Wurzel versehen und in Bitcoin verankert – mit Belegen, die in einen Branch gepusht werden, den du besitzt, einem Status-Dashboard, das du prüfen kannst, und CSV- und PDF-Exporten für die Auditoren.
Wenn der Grund, warum du deinen Code bisher nicht mit Zeitstempeln versehen hast, der war, dass es immer wie eine lästige Pflicht aussah, dann ist dieser Grund gerade weggefallen. Beginne bei timestampgit.dev – verbinde ein Repository, lass den ersten nächtlichen Batch laufen und schau am nächsten Morgen auf die Kalender-Heatmap.
Verwandte Beiträge
- OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?
- Self-Host Git Timestamping With Docker Compose
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls