Timestamp GIT

← Alle Beiträge

2026-11-20

IP-Schutz mit einer einzigen GitHub-App-Installation einrichten

IP-Schutz mit einer einzigen GitHub-App-Installation einrichten
timestamp git blockchain proof

IP-Schutz mit einer einzigen GitHub-App-Installation einrichten

Sie brauchen kein Rechtsbudget, keine CLI-Toolchain und keine Änderung daran, wie Ihr Team Code schreibt, um einen kryptografischen Nachweis zu erhalten, dass Ihr Repository zu einem bestimmten Zeitpunkt existiert hat. Sie brauchen eine Installation.

Diese Anleitung führt durch das gesamte Setup für einen github app for intellectual property protection: Installieren Sie die Timestamp GIT GitHub App, wählen Sie Ihre Repositories aus, lassen Sie die nächtliche Automatisierung Ihre Commit-Hashes bündeln und in Bitcoin verankern und bestätigen Sie dann, dass der Nachweis echt ist. Jeder Schritt unten ist ein Klick, eine Einstellung oder eine kurze Konfigurationsdatei. Kein Entwickler in Ihrem Team tippt einen neuen Befehl ein, und kein Quellcode verlässt jemals Ihre GitHub-Organisation.

Was Sie am Ende erhalten: einen unveränderlichen .ots-Beleg pro Tag, eine öffentliche Statusseite, die auf Bitcoin-Blockdaten basiert, ein Badge in Ihrer README und ein Audit-CSV oder PDF-Zertifikat, das Sie einem Anwalt oder einem Auditor vorlegen können.

Warum eine GitHub App der schnellste Weg zum IP-Schutz ist

Der harte Weg ist, Commits selbst manuell zu verankern — das OpenTimestamps-Tooling von Hand auszuführen und Bitcoin-Bestätigungen für jeden Batch zu verfolgen. Es funktioniert, aber es ist fehleranfällig, es hängt davon ab, dass eine Person daran denkt, es zu tun, und es bricht zusammen, sobald Sie fünf Entwickler und hundert Commits pro Tag haben.

Der verwaltete Weg ist eine einzige GitHub-App-Installation. Timestamp GIT setzt auf denselben kryptografischen Primitiven auf, verbirgt das Protokoll aber hinter Automatisierung:

  • Einmal installieren. Keine CLI, kein lokales Tooling, nichts, was auf Entwicklerrechnern installiert werden muss.
  • Automatische Erkennung. Jeder neue Commit in einem überwachten Repository wird über Webhooks erfasst.
  • Nächtliche Verankerung. Hashes werden um Mitternacht gebündelt, über einen Merkle-Baum zusammengefasst und über OpenTimestamps in Bitcoin verankert.
  • Rücklieferung an Sie. Manifeste und .ots-Belege landen in einem dedizierten Branch oder einem separaten Shadow-Repository.
  • Zero-Knowledge. Es werden nur Commit-Hashes verarbeitet. Ihr Quellcode wird nie gelesen, kopiert oder gespeichert.

Wenn Sie den strategischen Hintergrund dazu möchten, warum dies rechtlich relevant ist, bevor Sie mit dem Klicken beginnen, lesen Sie Prove Prior Art Before You File: A Founder’s Guide. Dieser Artikel konzentriert sich auf das Setup.

Voraussetzungen: Was Sie vor dem Start benötigen

  • Ein GitHub-Konto mit Admin-Rechten für das Repository — oder die Organisation —, das bzw. die Sie schützen möchten. Sie können eine GitHub App nicht auf einem Repo installieren, auf das Sie nur Schreibzugriff haben.
  • Ein Timestamp GIT-Konto. Die Open-Source-Stufe ist für öffentliche Repositories kostenlos; private Repositories erfordern einen kostenpflichtigen Plan.
  • Ein grundlegendes mentales Modell von Git. Sie sollten wissen, dass ein Commit einen SHA-1- oder SHA-256-Hash hat. Das ist der gesamte kryptografische Kenntnisstand, der erforderlich ist.
  • Eine Entscheidung darüber, wo die Nachweise liegen sollen. Dasselbe Repository in einem dedizierten Branch oder ein separates Shadow-Repository. Ein Shadow-Repo hält Ihr Haupt-Repository sauber, erfordert aber ein Ziel-Repo, dem Sie Schreibzugriff gewähren können.
  • Optional: Docker. Nur, wenn Sie später selbst hosten möchten — behandelt in einem späteren Abschnitt.

Schritt 1: Die Timestamp GIT GitHub App installieren

  1. Gehen Sie zu timestampgit.dev und melden Sie sich mit GitHub an.
  2. Klicken Sie auf Install GitHub App.
  3. Wählen Sie All repositories oder Only select repositories und wählen Sie dann die Repos aus, die überwacht werden sollen.
  4. Prüfen Sie die Berechtigungen, die GitHub Ihnen anzeigt. Im Standardmodus benötigt die App:
    • Lesezugriff auf Ihre Quell-Repositories — GitHub bietet keinen Zugriff nur auf Commit-Hashes an, daher ist Lesezugriff das Minimum.
    • Lese- und Schreibzugriff auf ein Ziel-Repository, in das Nachweise geschrieben werden.
  5. Bestätigen Sie. Sie landen im Dashboard mit Ihren verbundenen Repositories in der Liste.

Sie können die Repository-Auswahl jederzeit über die Einstellungsseite der GitHub App überprüfen und ändern; die App erfordert keine Neuinstallation, um neu hinzugefügte Repos zu erfassen.

Schritt 2: Ihre Repository-Einstellungen konfigurieren

Wählen Sie das Repository aus, das Sie gerade verbunden haben. Zwei Entscheidungen sind hier wichtig:

Wohin gehen die Nachweise? Entweder in einen dedizierten timestamps-Branch im selben Repository oder in ein separates Shadow-Repository. Wenn Sie ein Repository timestampen, das Sie später Open Source stellen möchten, hält ein Shadow-Repo die Nachweis-Historie aus dem öffentlichen Baum heraus, bis Sie sie sichtbar machen möchten.

Wann läuft die Verankerung? Nächtlich um Mitternacht ist die Standardeinstellung und die empfohlene Einstellung — viele Commits in einem Merkle-Root zu bündeln, ist das, was tägliche Nachweise günstig und konsistent macht. Den Zeitplan unverändert zu lassen, ist fast immer die richtige Wahl.

Kopieren Sie dann Ihren Badge-Einbettungscode. Öffnen Sie die Seite des verbundenen Repositories (/connected/{user}/{repo}) für eine Live-Vorschau des Shields.io-Verifizierungs-Badges und das exakte Markdown zum Einfügen.

Ein Hinweis zum Datenschutz: Status-URLs für private Repositories enthalten ein verschlüsseltes HMAC, das für Ihre Serverinstanz spezifisch ist, sodass nur autorisierte Benutzer den Status eines privaten Repos lesen können. Entfernen Sie diesen Parameter nicht, wenn Sie eine URL kopieren.

Speichern Sie die Einstellungen. Commit-Hashes beginnen sofort, in die Warteschlange zu fließen.

Schritt 3: Die Automatisierung laufen lassen

Hier gibt es nichts zu tun, außer Code zu pushen. Hinter den Kulissen:

  1. Commit-Erkennung — die GitHub App sieht neue Commits über Webhooks.
  2. Hash-Warteschlange — Commit-Hashes sammeln sich in einem In-Memory-Key-Value-Store für die Bündelung.
  3. Mitternachts-Cron-Worker — ein Worker gruppiert alle ausstehenden Hashes, schreibt eine Manifest-Textdatei pro Repository, baut nativ einen Merkle-Baum auf, erzeugt OpenTimestamps-Nachweise gegen öffentliche OTS-Kalender und verankert den Merkle-Root in Bitcoin.
  4. Nachweiszustellung — die Manifest- und .ots-Belegdateien werden zurück in Ihren timestamps-Branch oder Ihr Shadow-Repo gepusht.

Kalkulieren Sie das Bitcoin-Bestätigungsfenster ein. Der Batch wird um Mitternacht eingereicht, aber die Aufnahme in einen Block dauert normalerweise etwa drei Stunden. In der Praxis sind Nachweise für einen heute gepushten Commit morgen früh verfügbar.

Noch einmal zum Zero-Knowledge-Punkt, weil er das ist, wonach Auditoren fragen: Der Dienst verarbeitet ausschließlich Commit-Hashes. Ihr Diff, Ihre Dateien, Ihre Secrets — nichts davon wird übertragen.

Schritt 4: Das Verifizierungs-Badge zu Ihrer README hinzufügen

Fügen Sie den Snippet von der verbundenen Seite in Ihre README ein. Er sieht ungefähr so aus — verwenden Sie die exakte URL, die die App Ihnen gibt, nicht den Platzhalter:

<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[![Bitcoin-timestamped](BADGE_URL_FROM_TIMESTAMPGIT)](https://timestampgit.dev/status/your-user/your-repo)

Jeder, der durchklickt, erreicht die öffentliche Statusseite und kann den Zeitstempel selbst aus der .ots-Datei erneut verifizieren. Dieser öffentliche Verifizierungspfad per Klick ist es, der aus einem proprietären Anspruch einen Beweis macht, den ein Dritter akzeptiert.

So bestätigen Sie, dass es funktioniert hat

Warten Sie eine Nacht und prüfen Sie dann drei Dinge.

1. Die Repository-Statusseite. Öffnen Sie /status/{user}/{repo}. Sie sollten die Lebensdauer der Nachweise, das früheste Verankerungsdatum, die tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten für jede Verankerung sowie eine Kalender-Heatmap sehen. Eine Lücke in der Heatmap bedeutet einen Tag ohne Commits — kein Fehler.

2. Die API, falls Sie sie in einem Dashboard haben möchten.

# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo

# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo

3. Ein PDF-Zertifikat für ein bestimmtes Datum. Laden Sie es für jeden verankerten Tag herunter:

curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19

Die vollständige Schritt-für-Schritt-Durchführung, wie eine Merkle-Chain-Verifizierung tatsächlich aussieht — alles lokal in Ihrem Browser berechnet — finden Sie unter How to Verify a Bitcoin Timestamp Proof for Your Code. Die Kurzfassung: Die .ots-Datei und das Manifest sind Standard-OpenTimestamps-Nachweise, die von jedem kompatiblen Tool gegen Bitcoin-Blockdaten verifiziert werden können. Kein Lock-in, keine Abhängigkeit davon, dass wir im Geschäft bleiben.

Optional: Selbst hosten mit Docker für air-gapped Umgebungen

Für maximale Kontrolle — regulierte Umgebungen, air-gapped Netzwerke oder Teams, die den Dienst auf ihrer eigenen Infrastruktur betreiben möchten — 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Die Anwendung ist nach dem Start unter http://localhost:8080 verfügbar. Beim ersten Start führt Sie ein Setup-Assistent durch die Verbindung Ihrer GitHub App und die Konfiguration der Instanz.

Zur Evaluierung fordern Sie eine zeitlich begrenzte Demo-Lizenz über die Docker License page mit Ihrem Namen, Unternehmen, E-Mail und optionaler Telefonnummer an; Sie erhalten eine Lizenzdatei zum Herunterladen. Selbst-Hosting bedeutet, Ihre eigene GitHub App und Infrastruktur zu verwalten, aber die Zero-Knowledge-Garantien sind identisch.

Fehlerbehebung bei häufigen Setup-Problemen

  • Installation schlägt fehl oder Berechtigungen sehen falsch aus. Sie benötigen Admin-Rechte für das Repo oder die Organisation, und im Standardmodus muss der App auch Zugriff auf das Ziel-Repository gewährt werden, in das Nachweise geschrieben werden. Ein fehlendes Ziel-Repo ist die häufigste Ursache für „verbunden, aber es passiert nichts".
  • Keine Nachweise nach 24 Stunden. Bestätigen Sie, dass das Repository tatsächlich Commits empfängt und dass die App nicht von GitHub-Seite aus pausiert wurde. Prüfen Sie die Statusseite auf Fehler, bevor Sie etwas einreichen — ein inaktives Repo erzeugt kein Manifest, was erwartetes Verhalten ist.
  • Badge wird als defektes Bild angezeigt. Kopieren Sie die Badge-URL erneut von der verbundenen Seite. Bei privaten Repos muss die URL das verschlüsselte HMAC enthalten; eine gekürzte URL schlägt fehl.
  • Verankerung ist verspätet. Bitcoin-Blockzeiten variieren. Eine verzögerte Bestätigung wird trotzdem verankert — sobald der Block existiert, ist der Nachweis unveränderlich. Es muss nichts erneut ausgeführt werden.
  • Nachweise erscheinen an einer unerwarteten Stelle. Prüfen Sie, ob das Repo für einen Branch im selben Repo oder für ein Shadow-Repo konfiguriert ist; ein Moduswechsel schreibt historische Nachweise nicht um.

FAQ

Muss ich meinen Git-Workflow ändern, um Timestamp GIT zu nutzen? Nein. Sobald die GitHub App installiert ist, erkennt sie automatisch neue Commits und verankert sie nächtlich. Entwickler verwenden Git wie gewohnt weiter — keine neuen Befehle oder Tools zu lernen.

Welche GitHub-Berechtigungen benötigt Timestamp GIT? Im Standardmodus benötigt die App Lesezugriff auf Ihre Quell-Repositories (um Commit-Hashes zu lesen) und Lese- und Schreibzugriff auf ein Ziel-Repository, in dem Nachweise gespeichert werden. Der Enterprise-ZK-Modus tauscht dies gegen eine GitHub Action aus, die nur den Commit-Hash aus Ihrer eigenen Infrastruktur pusht, sodass der Dienst überhaupt keinen Lesezugriff auf das Quell-Repository benötigt.

Wie lange dauert es, bis ein Commit auf Bitcoin mit einem Zeitstempel versehen ist? Commit-Hashes werden einmal täglich um Mitternacht gebündelt und verankert. Nachdem der Batch über OpenTimestamps an die Bitcoin-Blockchain übermittelt wurde, dauert die Bestätigung typischerweise etwa 3 Stunden — Nachweise sind also normalerweise am nächsten Morgen verfügbar.

Kann ich den Zeitstempel-Nachweis unabhängig von Timestamp GIT verifizieren? Ja. Die .ots-Belegdatei und das Manifest sind Standard-OpenTimestamps-Nachweise. Sie können sie mit jedem OpenTimestamps-kompatiblen Tool gegen die Bitcoin-Blockchain verifizieren, was Anbieterunabhängigkeit gewährleistet.

Die Installation ist das ganze Projekt

Eine GitHub-App-Installation, eine Repository-Auswahl, eine Einstellungsseite. Danach wird IP-Schutz zu einer Hintergrundeigenschaft Ihres Repositories statt einer vierteljährlichen Pflichtaufgabe: jeder Commit-Hash nächtlich gebündelt, jeder Batch über einen Merkle-Root in einen Bitcoin-Block verankert, jeder Nachweis zurück in einen Branch geschrieben, den Sie kontrollieren, und von jedem mit der .ots-Datei verifizierbar.

Das sind die gesamten Einführungskosten. Wenn Sie den Schutz von Prior Art aufgeschoben haben, weil er wie ein Rechtsprozess mit angehängter Engineering-Steuer aussah, beginnen Sie heute mit der kostenlosen Open-Source-Stufe in einem öffentlichen Repo und sehen Sie zu, wie der erste Nachweis morgen früh eintrifft — get started here. Für Teams, die zuerst die Tooling-Landschaft bewerten, vergleicht Best Tools to Timestamp Source Code for Auditors die Optionen.

Verwandte Beiträge

EU label: AI-generated content