GitHub App Blockchain-Zeitstempel einrichten: Einmal installieren, für immer Zeitstempel setzen
Hier die Aufgabe in einem Satz: Installiere die Timestamp GIT GitHub App auf einem Repository, sodass jeder von dir gepushte Commit jede Nacht automatisch in der Bitcoin-Blockchain verankert wird — keine CLI-Tools, keine manuellen Schritte, keine Änderungen an der Arbeitsweise deines Teams.
Du kannst das natürlich auch auf die harte Tour machen: OpenTimestamps-Tooling selbst betreiben, Kalender verwalten, dein eigenes Merkle-Batching bauen und Bitcoin-Bestätigungen überwachen. Das ist ein Teilzeitjob. Timestamp GIT existiert, damit es gar nicht erst dein Job ist. Dieser Leitfaden beschreibt den von uns empfohlenen Einrichtungsweg: eine Installation, eine Repository-Auswahl, ein Konfigurationsbildschirm und danach eine nächtliche Pipeline, über die du nie wieder nachdenken musst.
Am Ende hast du täglich einen .ots-Beleg für deine Commits, ein Verifizierungs-Badge in deiner README und ein öffentliches Status-Dashboard, das jeder — ein Anwalt, ein Auditor, ein Kunde — ohne Konto einsehen kann.
Was du einrichtest (und warum es eine einmalige Sache ist)
Die genaue Aufgabe: Verbinde ein Repository mit der GitHub App, sodass Commit-Erkennung, Hash-Batching, Bitcoin-Verankerung und Proof-Zustellung alle ohne dich ablaufen.
Was du davon hast:
- Einen unveränderlichen
.ots-Beleg pro Tag — ein kryptografischer Beweis, dass eine bestimmte Menge von Commit-Hashes an einem bestimmten Datum existierte. - Ein Verifizierungs-Badge, das du in deine README einfügen kannst, damit der Proof-Status öffentlich ist.
- Ein Status-Dashboard mit Ankerdaten, Bitcoin-Block- und Transaktionsdaten, täglicher Regelmäßigkeit und herunterladbaren Audit-Exporten.
Die Arbeitsteilung ist es wert, verinnerlicht zu werden, denn sie erklärt, warum die Einrichtung eine einmalige Sache ist:
- Die GitHub App erkennt Commits über Webhooks.
- Timestamp GIT batcht die Commit-Hashes um Mitternacht, baut einen Merkle-Baum und verankert die Merkle-Wurzel mit dem OpenTimestamps-Protokoll in Bitcoin.
- Die Manifest- und
.ots-Belegdateien werden zurück in einen dediziertentimestamps-Branch oder ein Schatten-Repository gepusht, das du kontrollierst.
Es gibt zwei Deployment-Modi, und dieser Leitfaden folgt dem ersten:
- Standardmodus (GitHub App) — vollständig verwaltet, kein Code in deiner CI, liest nur den HEAD-Commit-Hash überwachter Repositories.
- Enterprise-ZK-Modus — eine kleine GitHub Action, die auf deiner eigenen Infrastruktur läuft, pusht nur Commit-Hashes an die Timestamp GIT API, und es ist nur Lese-Schreib-Zugriff auf das Ziel-Proof-Repository erforderlich.
Wenn du den konzeptionellen Hintergrund brauchst, warum das alles wichtig ist — Patent-Trolle, Mitarbeiterstreitigkeiten, „Clean-Room"-Behauptungen — lies zuerst Was ist kryptografischer Stand der Technik?. Dieser Artikel setzt voraus, dass du dich entschieden hast, es haben zu wollen, und es jetzt zum Laufen bringen willst.
Voraussetzungen vor der Installation
- Ein GitHub-Konto mit Admin-Rechten auf dem Ziel-Repository (öffentlich oder privat).
- Ein Timestamp GIT-Konto mit einem Plan, der zur Sichtbarkeit deines Repos passt: Open Source (kostenlos, öffentliche Repos), Pro Agency (49 $/Monat, private Repos) oder Enterprise ZK (199 $/Monat, GitHub Actions).
- Eine Entscheidung darüber, wo die Proofs liegen sollen: ein dedizierter
timestamps-Branch im selben Repository oder ein separates Schatten-Repository. - Klarheit über das Berechtigungsmodell: Der Standardmodus erfordert Lesezugriff auf das Quell-Repo und Lese-Schreib-Zugriff auf das Ziel-Repo. Der Enterprise-ZK-Modus erfordert nur Lese-Schreib-Zugriff auf das Ziel-Repo, plus eine im Quell-Repo installierte GitHub Action.
- Praktisch nichts weiter. Auf Entwicklerrechnern ist nichts zu installieren. Keine lokale Konfiguration, keine Hooks, keine Umgebungsvariablen pro Entwickler.
Schritt 1 — Die Timestamp GIT GitHub App installieren
- Navigiere zum Timestamp GIT GitHub App-Eintrag und klicke auf Install.
- Wähle das GitHub-Konto oder die Organisation, dem/der das Repository gehört.
- Wähle Only select repositories und wähle die Repo(s) aus, die überwacht werden sollen — oder gewähre Zugriff auf alle Repositories im Konto.
- Bestätige die angeforderten Berechtigungen. Im Standardmodus bedeutet das Lesezugriff auf das Quell-Repo (GitHubs Berechtigungssystem kennt keinen „nur Commit-Hash"-Scope) und Lese-Schreib-Zugriff auf das Ziel-Repo, in das Proofs geschrieben werden.
- Bestätige die Weiterleitung zurück zu Timestamp GIT und warte auf die Erfolgsmeldung.
Das ist die Installation. Es ist ein normaler GitHub App-Flow im OAuth-Stil, und er dauert etwa eine Minute.
Schritt 2 — Dein Repository verbinden und konfigurieren
Gehe zu Your Repositories (/repos) und bestätige, dass das neu zugängliche Repository in der Liste erscheint. Wenn es nicht auftaucht, hast du bei der Installation fast sicher das falsche Konto ausgewählt.
Öffne dann die Repository-Verbindungsseite und konfiguriere das Ziel für deine Proofs:
- Dasselbe Repository, dedizierter Branch — Proofs landen auf einem
timestamps-Branch neben deinem Code. Einfach, in sich geschlossen, leicht zu finden. - Separates Schatten-Repository — Proofs landen in einem Repo deiner Wahl. Nützlich, wenn das Quell-Repo einen eingeschränkten Empfängerkreis hat oder du ein zentrales Proof-Ledger über viele Projekte hinweg möchtest.
Wenn du ein Schatten-Repo verwendest, erstelle oder wähle es aus und bestätige, dass Timestamp GIT Lese-Schreib-Zugriff darauf hat. Eine fehlende oder entzogene Berechtigung ist hier die mit Abstand häufigste Ursache für „warum taucht nichts auf" später.
Aktiviere auf dieser Seite auch das README-Badge. Die Verbindungsseite rendert eine Live-Vorschau des Shields.io-Badges und liefert dir das exakte Markdown-Snippet — schreibe die URLs nicht von Hand, da private Repos eine instanzspezifische HMAC-Komponente erfordern.
Speichere die Konfiguration. Die App ist jetzt scharf gestellt: Ab diesem Punkt informieren sie Webhooks über jeden neuen Commit auf dem überwachten Branch.
Schritt 3 — Die nächtliche Verankerung laufen lassen (und wissen, was zu erwarten ist)
Von dir ist nichts weiter erforderlich. Folgendes passiert um Mitternacht:
- Commit-Erkennung — die GitHub App hat neue Commit-Hashes bereits über Webhooks erfasst.
- Hash-Warteschlange — die Hashes liegen in einem In-Memory-Key-Value-Store und warten auf das Batch-Fenster.
- Mitternachts-Cron-Worker — ausstehende Hashes werden gruppiert, eine Manifest-
.txt-Datei wird pro Repository generiert, ein Merkle-Baum wird nativ gebaut, OpenTimestamps-Proofs werden mit öffentlichen OTS-Kalendern erstellt und die Merkle-Wurzel wird in der Bitcoin-Blockchain verankert. - Proof-Zustellung — die Manifest- und
.ots-Belegdateien werden zurück in dentimestamps-Branch deines Repositories oder das Schatten-Repo gepusht.
Was im Ziel-Repository auftaucht, sieht ungefähr so aus:
timestamps/
manifests/
2026-10-18.txt # the commit hashes batched that day
proofs/
2026-10-18.txt.ots # the OpenTimestamps receipt for that manifest
Zeitliche Erwartungen. Der Batch läuft um Mitternacht, und die Bitcoin-Bestätigung dauert mehrere Stunden — normalerweise etwa drei. Wenn du also um 09:00 pushst, rechne damit, dass die Proofs am folgenden Tag am Vormittag eintreffen. Das ist eine Eigenschaft von Bitcoin, kein Fehler in der Pipeline.
Was dein Repository verlässt: nur Commit-Hashes. Timestamp GIT liest, kopiert oder speichert niemals deinen Quellcode. Der Quellcode bleibt in GitHub (oder im Enterprise-ZK-Modus vollständig in deiner eigenen Umgebung), und nur der Hash wird gestempelt.
Und dann wiederholt es sich. Jede Nacht, für immer, für jeden zukünftigen Commit. Du hast einmal installiert; die Pipeline erledigt den Rest.
Schritt 4 — Das Verifizierungs-Badge zu deiner README hinzufügen
Hole dir das Markdown-Snippet von der Repository-Verbindungsseite — dieselben Daten sind programmatisch über den authentifizierten GET /api/badgeLink/{user}/{repo}-Endpunkt verfügbar, der Badge-URLs und Markdown-Snippets zurückgibt.
Das Snippet hat diese Form (verwende die Kopierschaltfläche; die tatsächlichen URLs sind instanz- und repo-spezifisch, besonders bei privaten Repos):
[](<status-page-url>)
Füge es in deine README ein, committe und pushe. Wer auf das Badge klickt, landet auf der öffentlichen Verifizierungsansicht — kein Konto, kein Login, kein Spezialwissen erforderlich.
Ein Hinweis zu privaten Repos. Status-URLs für private Repositories hängen einen verschlüsselten HMAC an. Das bedeutet, dass nur autorisierte Nutzer den Proof-Status sehen können, während der zugrunde liegende Bitcoin-Anker für jeden, der die .ots-Datei besitzt, öffentlich verifizierbar bleibt. Der HMAC ist spezifisch für deine Serverinstanz, weshalb du die Badge-URL kopieren und nicht selbst konstruieren solltest.
Optional, aber schön: Bette dasselbe Badge in eine interne Doku-Seite oder ein Engineering-Dashboard ein. Es ist nur eine Bild-URL plus ein Link.
Schritt 5 — (Optional) Selbst hosten mit Docker für air-gapped Umgebungen
Wähle Self-Hosting, wenn du maximale Sicherheit, ein air-gapped Netzwerk oder strenge Datenresidenz-Garantien willst, die ein Managed Service nicht erfüllen kann.
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
Dann pullen und starten:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Nach dem Start ist die Anwendung unter http://localhost:8080 verfügbar. Beim ersten Start führt dich ein Einrichtungsassistent durch die Verbindung deiner GitHub App und die Konfiguration deiner Instanz.
Eine zeitlich begrenzte Demo-Lizenz zur Evaluierung ist verfügbar, indem du das Anfrageformular auf der Docker-License-Seite (/docker-license) mit deinem Namen, Unternehmen, E-Mail und einer optionalen Telefonnummer einreichst. Eine zeitlich begrenzte Demo-Lizenzdatei kann nach der Genehmigung heruntergeladen werden.
So bestätigst du, dass es funktioniert hat
Gib ihm einen vollständigen Zyklus (Mitternachts-Batch plus etwa drei Stunden) und verifiziere dann:
- Status-Dashboard — öffne
/status/{user}/{repo}. Du solltest Proof-Langlebigkeit, frühestes Ankerdatum, tägliche Regelmäßigkeit, Bitcoin-Block- und Transaktionsdaten und eine Kalender-Heatmap sehen. - Audit-CSV —
GET /api/audit/{user}/{repo}lädt das vollständige Audit-Ledger herunter. - PDF-Zertifikat —
GET /api/report/{user}/{repo}/{date}erzeugt ein Zertifikat für einen bestimmten Tag. - Merkle-Chain-Walk —
/verification/{user}/{repo}/{date}zeigt die mehrstufige Verifizierung Schritt für Schritt. Die gesamte Berechnung findet lokal in deinem Browser statt, sodass niemand — auch wir nicht — sieht, was du verifizierst. - Öffentliche Status-Endpunkte — schnelle Plausibilitätsprüfungen:
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}
statusLast gibt den letzten verankerten Bitcoin-Block zurück, statusCount gibt die Gesamtzahl der committeten und gestempelten Commits zurück, und statusSummary bündelt die Daten für Shields.io.
Wenn du die tiefere Offline-Anleitung willst, wie man eine .ots-Datei in eine verifizierte Bitcoin-Blockhöhe umwandelt, behandeln wir das separat in Wie man einen Bitcoin-Zeitstempel-Proof lokal verifiziert.
Fehlerbehebung bei häufigen Einrichtungsproblemen
Nach 24 Stunden erscheinen keine Proofs. Bestätige, dass die App tatsächlich Zugriff auf das richtige Repository hat (prüfe /repos), und bestätige, dass mindestens ein Commit nach der Installation gepusht wurde. Commits, die vor der Installation liegen, wurden nie an die Hash-Warteschlange gesendet.
Badge wird als „unknown" gerendert. Prüfe den Repository-Slug in der Badge-URL. Stelle bei privaten Repositories sicher, dass die verschlüsselte HMAC-Komponente vorhanden ist — eine abgespeckte URL schlägt bei der Autorisierung fehl und gibt keinen Status zurück.
Pushes ins Schatten-Repo schlagen fehl. Timestamp GIT benötigt Lese-Schreib-Zugriff auf das Ziel-Repository. Überprüfe die Installationsberechtigungen speziell für das Schatten-Repo erneut; Berechtigungen des Quell-Repos erstrecken sich nicht darauf.
Der Enterprise-ZK-Modus produziert nichts. In diesem Modus gibt es keine webhook-basierte Commit-Erkennung. Wenn die GitHub Action nicht im Quell-Repository installiert ist und aktiv Hashes an die API pusht, erreichen nie Hashes den Dienst.
Proofs sind ein paar Stunden verspätet. Erwartet. Der Batch läuft um Mitternacht, und die Bitcoin-Bestätigung dauert typischerweise etwa drei Stunden. Verzögerungen hier sind Blockchain-Timing, kein Fehler.
FAQ
Muss ich CLI-Tools installieren oder OpenTimestamps-Befehle ausführen?
Nein. Timestamp GIT ist eine verwaltete GitHub App: Du installierst sie einmal, und jeder Commit in einem überwachten Repository wird jede Nacht automatisch in Bitcoin verankert. Es gibt keine CLI-Tools, keine OpenTimestamps-Befehle und nichts, was auf Entwicklerrechnern installiert werden müsste.
Kann ich die GitHub App mit privaten Repositories verwenden?
Ja. Private Repositories werden im Pro-Agency-Plan unterstützt. Status-URLs für private Repos hängen einen verschlüsselten HMAC an, sodass nur autorisierte Nutzer den Proof-Status einsehen können.
Wie lange dauert es, bis mein erster Zeitstempel-Proof erscheint?
Commits werden von einem Mitternachts-Cron-Worker gebatcht und verankert. Die Bitcoin-Bestätigung dauert typischerweise etwa drei Stunden, sodass die Manifest- und .ots-Belegdateien ein paar Stunden nach dem Batch-Lauf zurück in dein Repository gepusht werden.
Was passiert mit meinen Proofs, wenn Timestamp GIT abgeschaltet wird?
Die Proofs sind anbieterunabhängig. Sie beruhen nur auf SHA-256 und Bitcoin-Blockdaten über das OpenTimestamps-Protokoll, sodass du sie mit Standardwerkzeugen offline verifizieren kannst, selbst wenn der Dienst nicht mehr existiert.
Fazit
Der ganze Sinn einer GitHub App-Blockchain-Zeitstempel-Einrichtung ist, dass sie langweilig sein sollte: einmal installieren, ein Repo auswählen, wählen, wohin die Proofs gehen, und einen nächtlichen Job den Rest erledigen lassen. Alles nach Schritt zwei ist Warten darauf, dass Bitcoin bestätigt.
Zu diesem Zeitpunkt hast du etwas, das die meisten Teams nicht haben — einen mathematisch unbestreitbaren Beweis dafür, wann dein Code existierte, offline verifizierbar, ohne dass dein Quellcode jemals dein Repository verlässt. Das ist Stand der Technik, den du einem Anwalt, einem Auditor oder einem Kunden übergeben kannst, ohne dass ein einziger Entwickler seinen Workflow ändert.
Installiere die GitHub App zuerst auf deinem wertvollsten Repository und erweitere dann von dort aus. Wenn du sie lieber innerhalb deines eigenen Perimeters betreiben möchtest, ist die selbst gehostete Docker-Lizenz dasselbe Produkt mit deiner Infrastruktur darunter.
Verwandte Beiträge
- Sind Git-Commit-Zeitstempel für rechtliche Beweise zuverlässig?
- Wie man einen Bitcoin-Zeitstempel-Proof lokal verifiziert
- GitHub App, die Commits automatisch mit Zeitstempeln versieht