Automatisez l’horodatage Bitcoin de chaque commit Git
L’horodatage manuel souffre du même défaut que les sauvegardes manuelles : il fonctionne parfaitement jusqu’à la semaine où vous êtes débordé. Et la semaine où vous êtes débordé est précisément celle où vous livrez la fonctionnalité dont vous devrez plus tard prouver la livraison.
Cet article explique comment retirer l’humain de cette boucle. Pas de « pensez à horodater avant de merger », pas de case à cocher dans votre runbook de release — mais une installation unique qui transforme chaque commit d’un dépôt surveillé en une preuve ancrée dans Bitcoin via un lot Merkle, automatiquement, chaque nuit, que quelqu’un dans l’équipe pense ou non à la protection de la PI.
Si vous êtes encore en train de décider si la preuve d’antériorité cryptographique compte pour votre situation, consultez Prouvez l’antériorité avant de déposer : le guide du fondateur. Cet article part du principe que vous avez tranché et que vous voulez désormais que tout tourne en pilote automatique.
Le piège de l’horodatage manuel (et pourquoi l’automatisation l’emporte)
Faire cela à la main paraît trompeusement simple. En pratique, un flux manuel signifie que quelqu’un dans l’équipe doit :
- Penser à horodater après chaque commit significatif — avant que la branche ne soit réécrite, squasheé ou force-pushée.
- Gérer le matériel cryptographique et les fichiers de preuve localement, à un endroit qui survit aux réinitialisations d’ordinateur portable et au turnover du personnel.
- Stocker les reçus obtenus dans un endroit durable, versionné et retrouvable deux ans plus tard lors d’une due diligence.
- Répéter pour chaque commit, dans chaque dépôt, pour toujours.
C’est la dernière puce qui tue les processus manuels. La couverture est incohérente, et une couverture incohérente est pire qu’elle n’en a l’air : en cas de litige, une lacune dans votre chaîne de preuves invite l’argument selon lequel ce commit — celui qui compte — était l’exception. Un push oublié un vendredi après-midi peut transformer une chronologie propre en point d’interrogation.
Le protocole OpenTimestamps sous-jacent est réellement bien conçu, et vous pouvez le piloter vous-même avec des outils en ligne de commande bruts et un ancrage Bitcoin manuel — la manière difficile, à vos frais et sur votre temps. Pour une équipe qui livre tous les jours et n’a personne dédié à la crypto, c’est un projet de maintenance déguisé en contrôle de sécurité.
L’automatisation l’emporte parce qu’elle convertit une décision récurrente en une configuration unique. Installez une GitHub App une fois, et à partir de ce moment chaque commit du dépôt surveillé est capturé, mis en file, regroupé en lot, ancré et archivé dans votre dépôt sans qu’un développeur ne touche à quoi que ce soit.
Installation unique : installez la GitHub App et oubliez-la
L’installation est la partie la plus courte de cet article, et c’est bien le but.
- Installez la GitHub App Timestamp GIT. Choisissez un seul dépôt ou accordez-la à toute votre organisation — chaque dépôt surveillé obtient ses propres preuves indépendantes.
- Choisissez la source et la cible. L’App lit les hachages de commit depuis votre dépôt source et écrit les preuves dans un dépôt cible, soit une branche
timestampsdédiée dans le même dépôt, soit un dépôt fantôme séparé. - Confirmez les permissions. Le mode standard nécessite un accès en lecture seule au dépôt source, car le modèle de permissions de GitHub n’a pas de portée « hachages de commit uniquement ». Un accès en écriture est nécessaire sur le dépôt cible pour que les preuves puissent y être commitées. C’est toute la surface de permissions.
Rien ne s’installe sur les machines des développeurs. Pas d’outils CLI, pas de hooks pre-commit, pas de fichiers de clés à distribuer, pas d’étape d’intégration pour les nouvelles recrues. Les développeurs continuent d’exécuter git commit et git push exactement comme avant.
Pour les organisations qui ne veulent pas que le service hébergé ait le moindre accès en lecture au code source, il existe le mode Enterprise ZK : une courte GitHub Action (12 lignes) s’exécute dans votre propre infrastructure et n’envoie que le hachage de commit à l’API, de sorte que le code source ne quitte jamais votre environnement. Dans ce mode, l’App n’a besoin d’aucun accès en lecture au dépôt source — il suffit d’installer l’Action. La plupart des équipes commencent par le mode managé standard et considèrent le mode ZK comme une option pour leurs dépôts les plus sensibles. Le parcours complet des permissions se trouve dans Configurez la protection de la PI avec une seule installation de GitHub App.
Au cœur du pipeline automatisé : du commit à l’ancrage Bitcoin
Une fois installé, le pipeline tourne selon son propre calendrier. Voici ce qui se passe entre votre git push et une preuve vérifiable :
- Détection des commits. La GitHub App récupère les nouveaux commits via des webhooks. En mode Enterprise ZK, c’est votre GitHub Action qui pousse les hachages de commit vers l’API.
- File de hachages. Les hachages de commit arrivent dans un magasin clé-valeur en mémoire, en attente du lot nocturne. Notez ce qui arrive ici : des hachages, pas du code.
- Worker cron de minuit. Un worker se réveille, regroupe tous les hachages en attente et écrit un fichier manifeste
.txtpar dépôt. - Construction de l’arbre de Merkle. Le worker construit nativement un arbre de Merkle sur le lot du jour, puis génère des preuves OpenTimestamps auprès des calendriers OTS publics.
- Ancrage Bitcoin. La racine de Merkle est ancrée dans un bloc Bitcoin. La confirmation prend généralement environ trois heures, la livraison des preuves intervient donc quelques heures après l’exécution du lot.
- Livraison des preuves. Le manifeste et les fichiers de reçu
.otssont commités automatiquement dans votre dépôt cible.
Deux propriétés de cette conception comptent plus que la mécanique :
- Zéro connaissance par construction. Le service ne voit, ne copie ni ne stocke jamais votre code source. Il manipule des hachages de commit et une racine de Merkle. L’état de votre dépôt n’entre jamais dans le pipeline.
- Indépendance vis-à-vis du fournisseur. Les preuves reposent uniquement sur SHA-256 et les données de blocs Bitcoin. Si Timestamp GIT disparaissait demain, les reçus dans votre dépôt resteraient vérifiables contre la blockchain Bitcoin à l’aide des outils OpenTimestamps standards. Pour le travail quotidien, vous utiliserez plutôt la page de vérification ou l’API — voir Comment vérifier une preuve d’horodatage Bitcoin pour votre code.
Surveillance et gestion des échecs : garantir que chaque commit est ancré
Une automatisation que vous ne surveillez pas n’est qu’une tâche cron pleine d’espoir. Timestamp GIT expose suffisamment de surface pour rendre la couverture observable.
Tableau de bord de statut. Chaque dépôt surveillé dispose d’une page de statut publique à l’adresse https://timestampgit.dev/status/{user}/{repo} affichant la longévité des preuves, la date du premier ancrage, la régularité quotidienne, les données de bloc et de transaction Bitcoin, une carte de chaleur calendaire des jours ancrés et des exports d’audit téléchargeables.
Badges intégrables. Les badges Shields.io peuvent être placés directement dans votre README, avec des extraits markdown générés juste après la connexion du dépôt. N’importe qui peut cliquer pour vérifier l’horodatage publiquement.
API pour des alertes personnalisées. Interrogez le statut et réconciliez les comptes depuis vos propres outils :
# Latest anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total committed / stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Combined summary (what the badge uses)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api | jq
Une vérification nocturne minimale qui signale une lacune avant qu’elle ne devienne un problème de preuve :
import datetime, requests
REPO = "https://timestampgit.dev/api"
USER, SLUG = "acme", "payments-api"
summary = requests.get(f"{REPO}/statusSummary/{USER}/{SLUG}", timeout=30).json()
last = requests.get(f"{REPO}/statusLast/{USER}/{SLUG}", timeout=30).json()
# Alert if nothing has been anchored in the last 48 hours
print("summary:", summary)
print("last anchor:", last)
Branchez cela sur votre canal d’alerte et vous avez bouclé la boucle — un jour manqué devient une notification au lieu d’une découverte lors d’une due diligence.
Scénarios d’échec. Les webhooks se perdent, les calendriers tombent parfois en panne et les réseaux hoquettent. Comme les hachages attendent dans une file plutôt que d’être horodatés en ligne, un hachage non ancré glisse simplement dans le lot nocturne suivant. Rien n’est perdu ; c’est reporté. Le symptôme visible est un jour manquant sur la carte de chaleur ou une valeur statusLast figée, ce que les vérifications ci-dessus détectent précisément.
Exports de conformité. Pour les audits, récupérez le registre complet en CSV ou un certificat PDF par jour :
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-11-22
Les dépôts privés ajoutent un HMAC chiffré à leurs URL de statut, de sorte que seuls les utilisateurs autorisés peuvent lire leur statut — le HMAC est propre à l’instance serveur.
Bonnes pratiques pour l’horodatage automatisé
- Surveillez la branche timestamps, pas seulement le tableau de bord. L’apparition de nouveaux manifestes et fichiers
.otsest votre source de vérité pour confirmer que la livraison a fonctionné de bout en bout. - Utilisez un dépôt cible dédié pour les preuves quand c’est possible. Cela garde l’historique de votre source propre et rend les preuves faciles à transmettre à un conseil juridique sans exporter votre base de code.
- Vérifiez périodiquement, pas une seule fois. Planifiez une vérification trimestrielle via la page de vérification publique ou
/api/verify/{user}/{repo}/{date}. Tous les calculs de vérification se font localement dans le navigateur — personne ne voit ce que vous vérifiez. - Ancrez la couverture dans votre processus, pas dans votre mémoire. Si un dépôt est critique pour l’entreprise, installez l’App à l’échelle de l’organisation plutôt que dépôt par dépôt ; le mode d’échec de l’installation sélective est un dépôt dont plus personne ne se souvient qu’il faut l’intégrer.
- Adaptez le déploiement à votre modèle de menace. Pour les environnements isolés ou à sécurité maximale, Timestamp GIT s’exécute sous forme d’image Docker auto-hébergée. Une configuration Docker Compose de démarrage rapide ressemble à ceci :
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
L’instance est disponible à l’adresse http://localhost:8080, et un assistant de premier lancement vous guide pour connecter votre GitHub App. Une licence de démonstration à durée limitée est disponible via le formulaire de demande sur la page Docker License (nom, entreprise, e-mail, téléphone facultatif).
FAQ
Dois-je installer un logiciel sur les machines de mes développeurs ? Non. Timestamp GIT fonctionne entièrement via une GitHub App ou une GitHub Action. Les développeurs commitent simplement comme d’habitude ; l’automatisation fait le reste.
Que se passe-t-il si un commit est effectué après l’heure limite nocturne ? Il sera inclus dans le lot de la nuit suivante. Le système met en file tous les hachages en attente et les ancre ensemble.
Puis-je automatiser l’horodatage pour plusieurs dépôts ? Oui. Vous pouvez installer la GitHub App sur plusieurs dépôts ou sur une organisation entière, et chaque dépôt obtient ses propres preuves.
Comment vérifier qu’un commit a été horodaté ? Vous pouvez utiliser la page de vérification publique ou l’API pour vérifier la preuve de Merkle contre la blockchain Bitcoin. Les badges affichent aussi le statut.
Que se passe-t-il si je pousse plusieurs commits dans la journée ? Ils sont tous collectés dans le lot du jour, repliés dans un seul arbre de Merkle et ancrés ensemble sous une seule transaction Bitcoin. Vous obtenez toujours des manifestes par dépôt, de sorte que les hachages de commit individuels restent traçables au sein du lot.
Puis-je horodater les commits de dépôts privés ? Oui — les dépôts privés sont pris en charge avec le plan Pro Agency (49 $/mois) et avec Enterprise ZK (199 $/mois, GitHub Actions). Les dépôts publics sont gratuits avec l’offre Open Source.
Combien de temps faut-il pour qu’un commit soit ancré ? Généralement quelques heures après l’exécution du lot nocturne. La confirmation Bitcoin elle-même prend normalement environ trois heures, les preuves arrivent donc dans votre dépôt quelques heures après minuit.
La preuve est-elle vérifiable sans Timestamp GIT ? Oui. Les preuves reposent uniquement sur SHA-256 et les données de blocs Bitcoin, elles peuvent donc être vérifiées indépendamment contre la blockchain — aucune technologie propriétaire et aucun verrouillage.
Conclusion
La valeur d’une preuve d’antériorité vient de la couverture, et la couverture vient de l’automatisation. Un processus d’horodatage qui dépend d’une personne qui doit penser à lancer quelque chose aura des trous, et ce sont les trous que cherche la partie adverse.
Timestamp GIT gère le protocole OpenTimestamps pour vous : installez la GitHub App une fois, laissez le cron nocturne ancrer chaque commit dans Bitcoin, surveillez les badges et les endpoints de statut, et conservez les reçus .ots dans un dépôt que vous contrôlez. L’installation prend quelques minutes ; ensuite, la seule tâche continue est de jeter un œil à une alerte qui ne devrait jamais se déclencher.
Commencez avec l’offre Open Source gratuite sur un dépôt public, ou connectez un dépôt privé sur Pro Agency et laissez le premier lot tourner cette nuit. Pour un aperçu plus large de ce que cela coûte par rapport à une solution maison, lisez Coûts d’horodatage de code comparés : managé vs DIY.
Articles connexes
- Coûts d’horodatage de code comparés : managé vs DIY
- Configurez la protection de la PI avec une seule installation de GitHub App
- Comment vérifier une preuve d’horodatage Bitcoin pour votre code