Horodatage Git automatisé : ancrez vos commits dans Bitcoin
Si votre protection d’antériorité dépend de quelqu’un qui doit penser à lancer un outil après chaque commit, vous n’avez pas de protection d’antériorité — vous avez une habitude. Et les habitudes s’effondrent la semaine précédant un audit, pendant un rush de release, ou juste après que la personne qui « faisait toujours ça » a changé d’équipe.
L’horodatage manuel suit une boucle d’échec prévisible. Vous committez, puis vous pensez à horodater. Vous copiez le reçu quelque part où il ne se perdra pas. Vous recommencez demain, et après-demain, pour chaque dépôt qui compte — et dès que vous êtes sur un sprint chargé en branches, la boucle s’arrête silencieusement. Un dépôt passe à l’échelle. Cinq dépôts avec trois contributeurs chacun, non.
Cet article porte sur l’élimination totale de cette boucle : l’horodatage Git automatisé sur Bitcoin, où la seule action récurrente est un commit que vous alliez de toute façon faire.
Vous pouvez faire les choses à la dure en exécutant vous-même l’outillage OpenTimestamps et en surveillant les fichiers de reçus. Timestamp GIT existe pour que vous n’ayez pas à le faire. C’est un service managé qui masque entièrement le protocole : installez la GitHub App une fois, et chaque commit sur un dépôt surveillé est ancré dans Bitcoin automatiquement chaque nuit. Pas d’outils CLI, pas de commandes de protocole, pas de checklist quotidienne. Pour le tutoriel d’installation lui-même, voir GitHub App Blockchain Timestamp Setup: Install Once, Timestamp Forever — cet article se concentre sur ce qui se passe après l’installation.
La tâche manuelle répétitive que vous pouvez éliminer
Avant de vous décider pour l’automatisation, il vaut la peine de nommer précisément ce qui disparaît de votre semaine :
- Un rituel par commit. Quelque chose doit s’exécuter après chaque commit qui mérite une preuve. C’est un humain dans la boucle, à chaque commit, pour toujours.
- La dispersion des reçus. Les fichiers de preuve finissent dans un dossier personnel, un lecteur partagé ou un fil Slack. Six mois plus tard, personne ne peut relier un reçu à une date ou à un dépôt.
- L’érosion de la couverture. Vous protégez le dépôt phare. Le dépôt d’outillage interne, la bibliothèque client, le service au secret industriel — personne ne les horodate, et ce sont souvent ceux qui comptent dans un litige.
- Les trous silencieux. Manquer un seul jour est invisible jusqu’à ce que vous ayez besoin de la preuve, c’est-à-dire le pire moment possible pour découvrir un trou dans votre chronologie.
Ce que « automatisé » signifie ici est étroit et précis. Vous installez la GitHub App une fois sur les dépôts que vous voulez surveiller. À partir de là, chaque commit est détecté, mis en lot et ancré dans la blockchain Bitcoin chaque nuit avec aucune action de la part du développeur. Les développeurs continuent de committer exactement comme aujourd’hui. Il n’y a rien à installer sur leurs machines, pas de hook pre-commit, pas de nouveau workflow à apprendre.
C’est la différence entre un processus et une propriété d’arrière-plan de vos dépôts.
Configuration unique : installez la GitHub App et oubliez-la
Timestamp GIT vous offre deux façons de connecter un dépôt, toutes deux étant une configuration unique.
Mode Standard (GitHub App). Installez la GitHub App sur les dépôts que vous voulez surveiller. Elle lit automatiquement uniquement le hash du commit HEAD de chaque dépôt surveillé. Les preuves sont écrites dans une branche Git dédiée — soit dans le même dépôt que la source, soit dans un dépôt séparé.
Le modèle de permissions mérite d’être compris clairement, car il est plus restreint que ce que les gens imaginent :
- Accès en lecture seule au dépôt source. Le système de permissions GitHub n’a pas de portée « commit-hash-only », donc la lecture seule est le minimum que l’App peut demander pour voir le hash HEAD.
- Accès en lecture-écriture au dépôt cible, qui est l’endroit où le manifeste et les fichiers de reçus sont poussés.
Mode Enterprise ZK. Une GitHub Action de 12 lignes s’exécute sur votre propre infrastructure et ne pousse que le hash du commit vers l’API Timestamp GIT. Cette configuration ne nécessite qu’un accès en lecture-écriture au dépôt cible — aucun accès en lecture au dépôt source n’est nécessaire, et votre source ne quitte jamais votre environnement.
Quel que soit le mode choisi, l’expérience développeur est identique pour votre équipe : rien à installer sur les machines des développeurs, aucun changement dans la façon dont chacun crée des branches, committe ou fusionne.
Si vous devez auto-héberger. Pour une sécurité maximale ou des environnements isolés, Timestamp GIT est également disponible sous forme d’image Docker. 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’application est disponible à l’adresse http://localhost:8080 après le démarrage, et un assistant de configuration vous guide pour connecter votre GitHub App et configurer votre instance au premier lancement. La licence, le formulaire de demande de licence de démonstration et le tutoriel complet d’auto-hébergement se trouvent dans Self-Hosted Git Timestamps: Docker Setup & License Guide.
Le pipeline automatisé : du commit à l’ancrage Bitcoin
Une fois connecté, le pipeline tourne sans vous. Voici la séquence réelle.
1. Détection des commits. Soit la GitHub App détecte les nouveaux commits via des webhooks, soit — en mode Enterprise ZK — votre GitHub Action pousse les hashs de commits vers l’API.
2. File d’attente des hashs. Les hashs de commits arrivent dans un magasin clé-valeur en mémoire pour la mise en lot. Rien d’autre n’est stocké, car rien d’autre n’a été envoyé.
3. Le worker cron de minuit. Chaque nuit, un worker :
- Regroupe tous les hashs en attente
- Crée des fichiers manifestes par dépôt (
.txt) - Construit un arbre de Merkle nativement
- Crée des preuves OpenTimestamps à l’aide des calendriers OTS publics
- Ancre la racine de Merkle dans la blockchain Bitcoin
4. Livraison des preuves. Le manifeste et les fichiers de reçus .ots sont poussés vers votre dépôt dans une branche timestamps dédiée ou un dépôt fantôme.
L’ensemble du flux ressemble à ceci :
commit ──▶ hash queue ──▶ midnight cron ──▶ Merkle root ──▶ Bitcoin block
│
└──▶ manifest.txt + .ots receipt
│
▼
timestamps branch / shadow repo
En mode Enterprise ZK, votre GitHub Action communique avec l’API ZK Commit, authentifiée par un HMAC issu de l’URL signée que l’API renvoie pour votre dépôt :
# The signed URL (and its HMAC) is returned by the API for your repo.
# {target} is the destination repo, {hash} is the HMAC from that URL.
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/timestamps/<hmac>/<commitHash>/<commitId>"
Attente de timing. La confirmation Bitcoin prend plusieurs heures — normalement environ 3 — donc l’écriture des preuves se termine quelques heures après l’exécution nocturne, pas à minuit pile. Si vous consultez votre branche timestamps à 00h05 et ne voyez rien, c’est un comportement attendu, pas un échec.
Surveillance et gestion des échecs
Une automatisation que vous ne pouvez pas observer est indiscernable d’une automatisation qui a cessé de fonctionner. Timestamp GIT expose des endpoints de statut publics pour que vous puissiez surveiller le pipeline sans vous connecter :
# Last anchored Bitcoin block
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 (Shields.io friendly)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
Badges. Des badges de vérification intégrables sont disponibles pour votre README, afin que le statut d’ancrage soit visible par quiconque parcourt le dépôt. N’importe qui peut suivre le lien du badge pour vérifier l’horodatage — il existe une visionneuse dédiée et un rapport PDF. Les dépôts privés sont également pris en charge : leurs URL de statut ajoutent un HMAC chiffré propre à l’instance du serveur, de sorte que seuls les utilisateurs autorisés peuvent voir le statut.
Tableau de bord Repository Status. À l’adresse /status/{user}/{repo}, vous obtenez la longévité des preuves, la date d’ancrage la plus ancienne, la régularité quotidienne, les données de blocs et de transactions Bitcoin, et une carte de chaleur calendaire — le moyen le plus rapide de repérer visuellement un trou dans la couverture.
Endpoints d’audit et de reporting. Quand vous avez besoin de preuves plutôt que d’un tableau de bord :
# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api
# PDF certificate for one specific date
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-21
Quand une nuit semble manquante, procédez dans cet ordre :
- Vérifiez
statusLastetstatusCount. Si le dernier ancrage date de plusieurs heures de plus que prévu, la confirmation est peut-être simplement encore en cours. - Confirmez que la GitHub App a toujours accès au dépôt. Une App désinstallée, une permission révoquée ou un dépôt renommé arrêtera silencieusement la détection.
- En mode Enterprise ZK, vérifiez l’historique d’exécution de l’Action de votre côté — le push vers l’API est le seul lien qui peut se rompre localement.
- Revérifiez après la fin de la confirmation Bitcoin avant de supposer que quoi que ce soit est perdu.
Bonnes pratiques pour l’horodatage automatisé
- Surveillez chaque dépôt qui compte, pas seulement le phare. La couverture est toute la valeur de l’automatisation ; un seul dépôt protégé laisse encore le reste de votre travail exposé.
- Gardez des commits significatifs. L’automatisation horodate ce que vous committez, donc l’hygiène des commits façonne encore l’histoire que raconte votre historique ancré. Cent commits « wip » prouvent moins qu’un historique propre et descriptif.
- Placez le badge dans le README et conservez le CSV d’audit et les rapports PDF par date avec vos dossiers de PI. Ces artefacts sont ce que vous remettez à un auditeur ou à un avocat adverse.
- Vérifiez indépendamment quand cela compte. Téléchargez le fichier
.otset vérifiez-le avec les outils OpenTimestamps standards par rapport à Bitcoin. La preuve est indépendante du fournisseur par conception — elle n’utilise que SHA-256 et les données de blocs Bitcoin. Le tutoriel pas à pas se trouve dans How to Verify a Bitcoin Timestamp Proof Locally. - Rappelez-vous la garantie zero-knowledge. Seuls les hashs de commits sont horodatés, jamais le code source, donc automatiser sur chaque dépôt n’élargit pas du tout votre exposition — c’est le même hash que vous ayez un dépôt ou cinquante.
FAQ
L’horodatage Git automatisé lit-il ou stocke-t-il un jour mon code source ?
Non. Timestamp GIT ne traite que les hashs de commits. En mode Standard, la GitHub App lit le hash du commit HEAD, et en mode Enterprise ZK, une GitHub Action sur votre infrastructure ne pousse que le hash vers l’API. Votre code source ne quitte jamais votre environnement en mode ZK et n’est jamais copié ni stocké par le service.
Combien de temps après mon commit l’ancrage Bitcoin est-il confirmé ?
Les commits sont mis en lot et ancrés par un worker cron nocturne. La confirmation Bitcoin prend plusieurs heures, normalement environ 3 heures, donc le reçu .ots et les fichiers manifestes apparaissent dans votre branche timestamps ou votre dépôt fantôme quelques heures après l’exécution nocturne.
Qu’advient-il de mes preuves si Timestamp GIT ferme ?
Les preuves restent valides. Elles reposent uniquement sur SHA-256 et les données de blocs Bitcoin via le protocole OpenTimestamps, donc n’importe qui peut télécharger le fichier .ots et le vérifier indépendamment par rapport à la blockchain Bitcoin à l’aide des outils OpenTimestamps standards — aucune technologie propriétaire, aucun verrouillage.
Puis-je utiliser l’horodatage automatisé avec des dépôts privés ?
Oui. Les dépôts privés sont pris en charge, et les URL de statut ajoutent un HMAC chiffré propre à l’instance du serveur, de sorte que seuls les utilisateurs autorisés peuvent consulter le statut. Les badges de vérification publics et le tableau de bord de statut fonctionnent de la même manière une fois l’accès accordé.
Conclusion : configurez une fois, prouvez pour toujours
Le changement ici est modeste en effort et considérable en conséquences. Vous cessez d’entretenir une corvée quotidienne et commencez à posséder une propriété de vos dépôts : chaque commit, ancré dans Bitcoin, automatiquement, chaque nuit, avec un reçu que vous pouvez remettre à un avocat, un auditeur ou un tribunal. La preuve est intégrée dans Bitcoin, prête pour le tribunal, et vérifiable par n’importe qui sans outils propriétaires — et tout est piloté par Timestamp GIT côté backend, pas par vos développeurs.
Si votre équipe ne peut pas du tout utiliser un service managé, l’option Docker auto-hébergée couvre les environnements à sécurité maximale et isolés avec la configuration Compose montrée ci-dessus.
Installez la GitHub App sur votre premier dépôt dès aujourd’hui et laissez le pipeline tourner cette nuit. Demain, vérifiez statusLast — vous aurez un ancrage que vous auriez autrement passé un an à essayer de penser à créer.
Articles similaires
- How to Prove Code Ownership in a Client Payment Dispute
- OpenTimestamps Alternative: Managed GitHub App for Every Commit
- Self-Hosted Git Timestamps: Docker Setup & License Guide