← All posts
GitHub-App für automatische Code-Zeitstempel installieren

GitHub-App für automatische Code-Zeitstempel installieren

timestamp git blockchain proof

Installation einer GitHub-App für automatische Code-Zeitstempelung

Sie möchten eine GitHub-App für Code-Zeitstempelung installieren, damit jeder Commit, den Sie machen, automatisch in der Bitcoin-Blockchain verankert wird – ohne Skripte zu pflegen, Cron-Jobs auszuführen oder OpenTimestamps selbst anzufassen. Genau das macht Timestamp GIT: Installieren Sie die GitHub-App einmal, wählen Sie aus, welche Repositories geschützt werden sollen, und jeder Commit wird gehasht, gebündelt und nächtlich in Bitcoin verankert. Keine manuellen Schritte nach der Einrichtung.

Dieser Leitfaden ist handlungsorientiert. Sie sind bereit zur Umsetzung, nicht nur zur Bewertung. Am Ende haben Sie die Timestamp-GIT-GitHub-App installiert, Ihr erstes Repository verbunden und einen Verifizierungs-Badge oder Audit-Trail eingerichtet.

Sie könnten OpenTimestamps manuell ausführen, Bitcoin-Transaktionen von Hand erstellen und Cron-Jobs überwachen – der schwierige Weg. Oder Sie installieren eine verwaltete GitHub-App und lassen Timestamp GIT das gesamte Protokoll hinter einem Zero-Setup-Workflow verbergen. Dieser Artikel beschreibt den ersten Weg.

Voraussetzungen für die Installation der Timestamp-GIT-GitHub-App

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

Schritt für Schritt: Installation und Konfiguration der GitHub-App

Schritt 1: Bei Timestamp GIT anmelden und die Installationsseite der GitHub-App öffnen

Melden Sie sich unter timestampgit.dev an. Navigieren Sie nach der Anmeldung zur Repository-Einrichtungsseite – normalerweise Ihre Repositories im Dashboard. Klicken Sie auf die Option, die GitHub-App zu installieren.

Schritt 2: Timestamp GIT für Ihr GitHub-Konto oder Ihre Organisation autorisieren

Klicken Sie auf GitHub-App installieren. GitHub fordert Sie auf, zwischen Ihrem persönlichen Konto und allen Organisationen zu wählen, die Sie verwalten. Wählen Sie das Konto aus, dem die Repositories gehören, die Sie schützen möchten.

Schritt 3: Repositories auswählen und Quellberechtigungen festlegen

Wählen Sie aus, welche Repositories Timestamp GIT überwachen soll.

Schritt 4: Wählen Sie, wo die Zeitstempel-Nachweise gespeichert werden

Wählen Sie das Ziel-Repository aus. Dies kann dasselbe Repository wie Ihr Quellcode sein oder ein separates Schatten-Repository. Timestamp GIT überträgt Manifestdateien und .ots-Belege in einen dedizierten Timestamps-Branch im Ziel-Repository.

Im Standardmodus benötigt das Ziel-Repository Lese-/Schreibzugriff. Im Enterprise-ZK-Modus benötigen Sie nur Lese-/Schreibzugriff auf das Ziel-Repository.

Schritt 5: Für den Enterprise-ZK-Modus den GitHub-Action-Workflow hinzufügen

Wenn Sie den Enterprise-ZK-Modus gewählt haben, generiert das Timestamp-GIT-Dashboard einen 12-zeiligen YAML-Ausschnitt für Sie. Kopieren Sie ihn in eine Workflow-Datei in Ihrem Quell-Repository, zum Beispiel .github/workflows/timestampgit.yml.

Ein generierter Workflow sieht ähnlich aus wie dieser (verwenden Sie den exakten Ausschnitt aus Ihrem Dashboard):

# Enterprise ZK Mode workflow generated by Timestamp GIT.
# This runs on your infrastructure and sends only commit hashes.
name: timestamp-git-zk
on:
  push:
    branches: [main]
jobs:
  send-hash:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Send commit hash to Timestamp GIT
        env:
          TIMESTAMPGIT_HMAC: ${{ secrets.TIMESTAMPGIT_HMAC }}
        run: |
          # The exact command is generated by Timestamp GIT.
          # It pushes the HEAD commit hash to the API endpoint.

Die Action überträgt nur den Commit-Hash. Ihr Quellcode verlässt niemals Ihre Umgebung.

Schritt 6: Einrichtung im Timestamp-GIT-Dashboard bestätigen

Kehren Sie zu Timestamp GIT zurück und bestätigen Sie die Installation. Im Standardmodus beginnt die GitHub-App automatisch damit, Commits über GitHub-Webhooks zu erkennen. Im Enterprise-ZK-Modus überträgt die Action bei jedem Push Commit-Hashes an die API.

An diesem Punkt sollten Sie Ihr Repository unter Ihre Repositories mit einem Status sehen, der anzeigt, dass es verbunden ist.

Schritt 7: Einen Verifizierungs-Badge zu Ihrer README hinzufügen

Kopieren Sie von der Seite des verbundenen Repositories (https://timestampgit.dev/connected/{user}/{repo}) den Markdown-Ausschnitt für einen Shields.io-Badge. Er sieht so aus, mit Ihren tatsächlichen Benutzer- und Repo-Namen:

[![Timestamp GIT](https://timestampgit.dev/api/badgeLink/your-user/your-repo)](https://timestampgit.dev/status/your-user/your-repo)

Fügen Sie ihn in Ihre README.md ein. Öffentliche Besucher können auf den Badge klicken, um den öffentlichen Verifizierungsstatus für Ihr Repository anzusehen.

So bestätigen Sie, dass die Zeitstempelung funktioniert

Warten Sie nach der Installation auf die nächtliche Bündelung und die Bitcoin-Bestätigung. So überprüfen Sie, dass Ihre ersten Commits korrekt verankert wurden.

  1. Repository-Statusseite prüfen. Öffnen Sie https://timestampgit.dev/status/{user}/{repo}. Sie zeigt das früheste Ankerdatum, die tägliche Regelmäßigkeit, Bitcoin-Block- und Transaktionsdaten sowie eine Kalender-Heatmap der gestempelten Commits.

  2. Nach dem Timestamps-Branch suchen. Finden Sie in Ihrem Ziel-Repository den dedizierten Timestamps-Branch (oder das Schatten-Repository). Er enthält Manifestdateien und .ots-Belegdateien für jede tägliche Bündelung.

  3. Lokale Verifizierung im Browser ausführen. Besuchen Sie https://timestampgit.dev/verification/{user}/{repo}/{date}. Die Seite führt eine schrittweise Merkle-Chain-Verifizierung lokal in Ihrem Browser durch – Zero-Knowledge, niemand sieht, was Sie verifizieren. Sie müssen nichts installieren.

  4. Compliance-Aufzeichnungen herunterladen. Verwenden Sie die Audit-CSV- und PDF-Zertifikats-Endpunkte. Zum Beispiel:

    • https://timestampgit.dev/api/audit/{user}/{repo} lädt das vollständige Audit-Ledger als CSV herunter.
    • https://timestampgit.dev/api/report/{user}/{repo}/{date} lädt ein PDF-Zertifikat für einen bestimmten Tag herunter.

  5. Den Zeitplan beachten. Commits werden jede Nacht von einem Cron-Worker gebündelt. Die Merkle-Wurzel wird dann in eine Bitcoin-Transaktion verankert. Die Bitcoin-Bestätigung dauert normalerweise etwa 3 Stunden, daher sind Nachweise in der Regel am nächsten Tag verfügbar. Wenn Sie nicht sofort nach einem Commit einen Nachweis sehen, ist das erwartungsgemäß.

Fehlerbehebung bei häufigen Installationsproblemen

Problem: Es werden keine Commits zeitgestempelt.
Überprüfen Sie, dass die GitHub-App die korrekten Berechtigungen hat und dass das Repository im Timestamp-GIT-Dashboard ausgewählt ist. Im Standardmodus benötigt die App Lesezugriff auf das Quell-Repository und Lese-/Schreibzugriff auf das Ziel-Repository. Im Enterprise-ZK-Modus muss die GitHub Action im Quell-Repository installiert und so konfiguriert sein, dass sie an die API überträgt.

Problem: Nachweise erscheinen nach einem Tag nicht.
Bestätigen Sie, dass der nächtliche Cron-Worker ausgeführt wurde und dass die Bitcoin-Transaktion bestätigt wurde. Die Bitcoin-Bestätigung dauert in der Regel etwa 3 Stunden nach der Verarbeitung der Bündelung. Überprüfen Sie die Repository-Statusseite auf die Informationen zum zuletzt verankerten Block. Wenn mehr als 24 Stunden vergangen sind, überprüfen Sie, dass das Ziel-Repository einen Timestamps-Branch hat und dass die GitHub-App weiterhin Schreibzugriff besitzt.

Problem: Der Status eines privaten Repositories ist nicht sichtbar.
Statusseiten und Badges privater Repositories sind mit einem verschlüsselten HMAC-Token geschützt. Stellen Sie sicher, dass Sie die authentifizierte URL verwenden, die den HMAC-Wert enthält. Bestätigen Sie außerdem, dass Sie einen kostenpflichtigen Plan haben (Pro Agency oder Enterprise ZK). Der kostenlose Open-Source-Plan deckt keine privaten Repositories ab.

Problem: Der Enterprise-ZK-Modus überträgt keine Hashes.
Überprüfen Sie, dass die GitHub-Action-Workflow-Datei in .github/workflows/ vorhanden ist und dass das Geheimnis TIMESTAMPGIT_HMAC in Ihren Repository-Einstellungen korrekt gesetzt ist. Prüfen Sie die Workflow-Ausführungsprotokolle in GitHub Actions, um zu bestätigen, dass der API-Endpunkt erreichbar ist und die Action erfolgreich abgeschlossen wurde.

Problem: Die Verifizierung schlägt lokal auf der öffentlichen Verifizierungsseite oder mit einer heruntergeladenen .ots-Datei fehl.
Stellen Sie sicher, dass Sie die korrekte .ots-Datei für das jeweilige Datum verwenden. Bestätigen Sie außerdem, dass Ihre lokalen OpenTimestamps-Tools aktuell sind, wenn Sie außerhalb des Browsers verifizieren. Die Verifizierungsseite selbst führt alle Berechnungen lokal aus und sollte mit jedem modernen Browser funktionieren.

FAQ

Hat die Timestamp-GIT-GitHub-App Zugriff auf meinen Quellcode?

Im Standardmodus benötigt die GitHub-App Lesezugriff auf das Quell-Repository, da GitHub keine Berechtigung nur für Commit-Hashes bereitstellt. Timestamp GIT extrahiert jedoch nur den Commit-Hash und liest oder speichert niemals Ihren Quellcode. Im Enterprise-ZK-Modus läuft die GitHub Action auf Ihrer Infrastruktur und überträgt nur den Commit-Hash an die API, sodass die App überhaupt keinen Zugriff auf Ihr Quell-Repository hat.

Wie lange dauert es, bis ein Commit in der Bitcoin-Blockchain zeitgestempelt ist?

Commits werden nächtlich gebündelt. Nach der Verarbeitung der Bündelung wird die Merkle-Wurzel in eine Bitcoin-Transaktion verankert. Die Bitcoin-Bestätigung dauert in der Regel etwa 3 Stunden, daher ist der Nachweis normalerweise am nächsten Tag verfügbar. Sie können den Status in Ihrem Repository-Dashboard überwachen.

Kann ich Timestamp GIT für private Repositories verwenden?

Ja, private Repositories werden in den Plänen Pro Agency ($49/Monat) und Enterprise ZK ($199/Monat) unterstützt. Der kostenlose Open-Source-Plan ist auf öffentliche Repositories beschränkt. Statusseiten und Badges privater Repos sind mit einem verschlüsselten HMAC-Token geschützt.

Was passiert, wenn Timestamp GIT das Geschäft aufgibt? Kann ich meine Zeitstempel trotzdem verifizieren?

Ihre Nachweise werden als .ots-Dateien in Ihrem Repository gespeichert und in der Bitcoin-Blockchain verankert. Sie können sie unabhängig mit Standard-OpenTimestamps-Tools und Bitcoin-Blockdaten verifizieren. Es ist keine proprietäre Technologie erforderlich, daher bleiben Ihre Beweise auch ohne Timestamp GIT gültig.

Fazit: Schützen Sie Ihren Code noch heute

Die Installation der Timestamp-GIT-GitHub-App dauert nur wenige Minuten. Danach wird jeder Commit in einem überwachten Repository automatisch fingerabdruckt, gebündelt und in der Bitcoin-Blockchain verankert. Sie erhalten gerichtsfeste Beweise, anbieterunabhängige Nachweise und null laufenden Aufwand.

Wenn Sie maximale Sicherheit in einer luftdichten oder selbst gehosteten Umgebung benötigen, ist Timestamp GIT auch als Docker-Image mit einer zeitlich begrenzten Demo-Lizenz verfügbar. Für die meisten Teams ist die verwaltete GitHub-App jedoch der schnellste Weg zu kryptografischem Stand der Technik.

Beginnen Sie bei Timestamp GIT, melden Sie sich an, installieren Sie die GitHub-App und verbinden Sie noch heute Ihr erstes Repository.

Published on Timestamp GIT · Timestamp GIT
EU label: AI-generated content