Horodater des commits Git sans ligne de commande
Vous voulez la propriété, pas la procédure. La propriété, c’est : ce hash de commit existait à cette date, et voici un reçu que n’importe qui peut vérifier contre la blockchain Bitcoin. La procédure que vous voulez éviter, c’est d’installer des outils sur chaque ordinateur portable de développeur, de courir après les fichiers de preuve dans les fils de discussion, et d’espérer que quelqu’un se souvienne encore comment fonctionne le côté vérification deux ans plus tard, quand un avocat le demande.
Ce guide montre comment horodater des commits Git sans outils en ligne de commande. Tout ce qui suit se passe dans un navigateur et dans GitHub. Vous installez une GitHub App une seule fois, vous la pointez vers un dépôt, puis vous continuez à committer exactement comme aujourd’hui. Timestamp GIT regroupe les hash de commits chaque nuit, les ancre dans Bitcoin via le protocole OpenTimestamps, et repousse les reçus de preuve dans votre dépôt.
Pas de CLI. Pas de nœud Bitcoin local. Aucune connaissance du protocole requise.
Pourquoi éviter la ligne de commande pour l’horodatage Git ?
La méthode difficile existe, et vous en devinez probablement la forme : installer le client OpenTimestamps sur votre machine, exécuter une commande sur un fichier que vous avez construit, conserver le reçu obtenu quelque part, et répéter l’opération quand vous y pensez. Trois modes de défaillance en découlent immédiatement :
- C’est par machine. Intégrer un nouveau développeur signifie réexpliquer le rituel. Votre runner CI en a besoin aussi. Votre nouvel ordinateur portable en a besoin à nouveau.
- C’est par instant. Les horodatages ne couvrent que ce que vous avez pensé à estampiller. Les commits que vous avez oubliés — généralement les plus intéressants, faits dans la précipitation — sont ceux dont vous aurez besoin en cas de litige.
- C’est une preuve fragile. Un reçu qui traîne dans le répertoire personnel de quelqu’un, sans chaîne de traçabilité, n’est pas une piste d’audit.
La méthode gérée déplace tout cela côté serveur. Timestamp GIT est une GitHub App qui surveille vos dépôts et ancre automatiquement les hash de commits chaque nuit. Vous ne touchez jamais au protocole sous-jacent. La preuve est réécrite dans votre propre dépôt, dans une branche dédiée ou un dépôt fantôme, afin qu’elle vive avec le code qu’elle décrit.
Pour comprendre pourquoi un simple git log n’est pas une preuve en soi, voir Why Your Git Log Isn’t Proof. Cet article est le mode d’emploi.
Prérequis
Avant de commencer, vérifiez que vous disposez de :
- Un compte GitHub et un dépôt — public ou privé — que vous souhaitez horodater.
- Des permissions d’administrateur sur ce dépôt ou sur l’organisation qui le possède, pour pouvoir installer une GitHub App.
- Pour les dépôts privés, un forfait payant : Pro Agency (49 $/mois) ou Enterprise ZK (199 $/mois). Les dépôts publics sont gratuits avec le forfait Open Source.
- Rien d’autre. Aucun logiciel local, aucune installation d’OpenTimestamps, aucun nœud Bitcoin, aucun portefeuille. Un navigateur suffit comme chaîne d’outils complète.
Une remarque sur les permissions, car c’est la première question que l’on nous pose. Le modèle de permissions GitHub n’a pas de portée « hash de commit uniquement », donc le mode Standard exige un accès en lecture seule au dépôt source et un accès en lecture-écriture au dépôt cible où les preuves sont écrites. Si même un accès en lecture seule au dépôt source vous est inacceptable, le mode Enterprise ZK utilise une GitHub Action à la place et ne nécessite aucun accès en lecture au dépôt source. Plus de détails à l’étape 6.
Étape par étape : horodater des commits sans ligne de commande
Étape 1 : installer la GitHub App Timestamp GIT
Installez l’application depuis le GitHub Marketplace ou depuis timestampgit.dev. Pendant l’installation, il vous sera demandé quels dépôts l’application peut voir, et vous accorderez les deux ensembles de permissions décrits ci-dessus : lecture seule sur votre dépôt source, lecture-écriture sur le dépôt qui recevra les fichiers de preuve.
Si vous horodatez toute une organisation, installez au niveau de l’organisation une seule fois plutôt que dépôt par dépôt.
Étape 2 : sélectionner les dépôts à surveiller
Ouvrez le tableau de bord à l’adresse https://timestampgit.dev/repos et choisissez les dépôts à surveiller. Une fois un dépôt connecté, l’application détecte les nouveaux commits via les webhooks GitHub — rien à configurer par commit, et rien à mémoriser.
Vous pouvez vérifier la connexion immédiatement. Les endpoints de statut publics renvoient du JSON, sans CLI :
# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo
# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo
Un dépôt tout neuf renverra légitimement des compteurs à zéro jusqu’à ce que la première exécution nocturne soit terminée.
Étape 3 : committer comme d’habitude
C’est toute l’étape « changement de workflow », et elle est vide. Vous écrivez du code, vous faites git commit, vous poussez. Timestamp GIT capture le hash de commit transmis par le webhook — pas le diff, pas les fichiers, pas la source. Le service ne voit, ne copie et ne stocke jamais votre code réel ; uniquement le SHA qui identifie l’état du dépôt.
Concrètement, cela signifie que vos développeurs n’ont pas besoin de formation, et que votre revue de sécurité a une réponse courte : la seule donnée qui quitte le dépôt est un hash, et un hash est une empreinte à sens unique.
Étape 4 : laisser le cron nocturne faire l’ancrage
À minuit, un worker collecte tous les hash de commits en attente, les regroupe par dépôt et écrit un fichier manifeste texte par dépôt. Il construit un arbre de Merkle sur le lot, crée des preuves OpenTimestamps contre les calendriers OTS publics, et ancre la racine de Merkle dans une transaction Bitcoin.
Deux conséquences découlent de cette conception :
- Le traitement par lots est économique et privé. Ancrer individuellement des milliers de commits serait absurde. Une racine de Merkle par dépôt et par jour signifie qu’un ancrage couvre tout ce qui a été commité ce jour-là, et les hash individuels restent cachés à l’intérieur de l’arbre.
- La livraison des preuves n’est pas instantanée. Le manifeste et les fichiers de reçu
.otssont repoussés vers une branche d’horodatage dédiée ou un dépôt fantôme après la confirmation Bitcoin, qui prend normalement environ trois heures. Une exécution qui démarre à minuit se termine généralement au petit matin.
Les hash de commits attendent dans un stockage clé-valeur en mémoire jusqu’à l’exécution, donc un dépôt qui reste silencieux pendant une journée ne produit simplement aucun nouveau fichier de preuve — pas d’erreur.
Étape 5 : intégrer un badge de vérification (facultatif)
Ouvrez la page Repository Connected de votre dépôt — https://timestampgit.dev/connected/{user}/{repo} — et utilisez le widget de badge. Il affiche un aperçu en direct et vous fournit un extrait Markdown à coller dans votre README, afin que l’affirmation de provenance soit publique et cliquable plutôt qu’un paragraphe d’affirmation.
<!-- Paste the exact snippet generated by the badge widget -->
[](https://timestampgit.dev/status/your-user/your-repo)
Quiconque clique sur le badge arrive sur la page de statut publique, qui est aussi l’endroit où les auditeurs voudront aller.
Étape 6 : auto-héberger ou passer en zéro connaissance (facultatif)
Deux déploiements alternatifs existent pour les équipes aux exigences plus strictes.
Le mode Enterprise ZK inverse le flux de données : une GitHub Action de 12 lignes s’exécute sur votre propre infrastructure et ne pousse que le hash de commit vers l’API Timestamp GIT. Votre source ne quitte jamais votre environnement, et aucun accès en lecture au dépôt source n’est nécessaire — seulement un accès en lecture-écriture sur le dépôt cible pour la livraison des preuves.
Le Docker auto-hébergé est destiné aux environnements isolés et à tous ceux qui veulent l’instance à l’intérieur de leur propre périmètre. 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. Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer l’instance. L’auto-hébergement nécessite une licence : vous pouvez demander une licence de démonstration à durée limitée depuis la page Docker License avec votre nom, votre entreprise, votre e-mail et, facultativement, votre numéro de téléphone, puis télécharger le fichier de licence pour évaluation.
Comment confirmer que cela a fonctionné
Ne prenez pas le badge pour une preuve. Confirmez à trois niveaux, par ordre croissant de rigueur.
1. La page de statut du dépôt. Rendez-vous sur https://timestampgit.dev/status/{user}/{repo}. Vous y verrez la longévité des preuves, la date d’ancrage la plus ancienne, la régularité quotidienne, les données de bloc et de transaction Bitcoin derrière chaque ancrage, et une carte de chaleur calendaire montrant quels jours ont produit des preuves. La carte de chaleur est le moyen le plus rapide de repérer les lacunes.
2. Les artefacts d’audit. Depuis la page de statut ou l’API, récupérez le registre d’audit ou un certificat par date :
# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo
# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03
Ce sont les documents que vous remettez à un avocat ou à un auditeur, et le CSV est ce qu’une équipe de conformité comparera réellement aux enregistrements internes.
3. Vérification cryptographique locale. La page de vérification à https://timestampgit.dev/verification/{user}/{repo}/{date} parcourt la chaîne de Merkle étape par étape, et tous les calculs se font localement dans votre navigateur. Rien de ce que vous vérifiez n’est transmis. Le fichier de reçu .ots du jour se trouve dans votre branche d’horodatage, et n’importe qui peut le vérifier indépendamment contre la blockchain Bitcoin avec les outils OpenTimestamps standards — sans compte, sans clé API, sans dépendance à l’existence de Timestamp GIT.
Ce dernier point mérite d’être répété au service juridique : la preuve est du SHA-256 plus des données de bloc Bitcoin. Aucun format propriétaire n’intervient dans la chaîne de confiance.
Dépannage des problèmes courants
Les preuves ne sont pas encore apparues. Vérifiez l’heure avant toute autre chose. L’ancrage nécessite une confirmation Bitcoin, qui prend normalement environ trois heures après le lot de minuit. S’il est 2 h du matin, rien ne cloche. S’il est l’après-midi suivant et que la branche est toujours vide, vérifiez si le dépôt figure bien dans la liste surveillée.
Des commits manquent dans le manifeste. C’est presque toujours un problème de permissions ou de webhook. Vérifiez que l’installation de la GitHub App inclut bien ce dépôt précis (les installations au niveau de l’organisation accordent souvent « selected repositories » et en oublient un), et que l’application a toujours une connexion active. Revérifiez /api/statusCount/{user}/{repo} après l’exécution nocturne suivante.
La page de statut d’un dépôt privé ne se charge pas. Les dépôts privés ajoutent un HMAC chiffré à l’URL, et ce HMAC est propre à l’instance serveur. Copiez le lien de badge authentifié depuis la page Repository Connected au lieu de construire une URL à la main — un HMAC tronqué ou ne correspondant pas à l’instance échouera.
Le déploiement Docker ne démarre pas. Vérifiez que le fichier Compose nomme exactement rue1401/timestampgit:prod et valkey/valkey:8, que le port 8080 n’est pas déjà occupé, et que ./data existe et est accessible en écriture par le conteneur. docker compose logs -f timestampgit nomme normalement la dépendance défaillante. Si l’application démarre mais que l’assistant de configuration ne peut pas joindre GitHub, c’est du côté de la configuration OAuth qu’il faut chercher.
FAQ
Dois-je installer quelque chose sur les machines des développeurs ? Non. Timestamp GIT est une GitHub App gérée qui s’exécute sur l’infrastructure de GitHub et sur nos serveurs. Les développeurs committent simplement comme d’habitude ; aucun outil CLI ni logiciel local n’est requis.
Puis-je horodater des commits dans des dépôts privés ? Oui. Les dépôts privés sont pris en charge avec les forfaits payants (Pro Agency ou Enterprise ZK). L’application ne lit que les hash de commits, jamais votre code source, et les preuves sont stockées dans une branche dédiée ou un dépôt fantôme.
Combien de temps faut-il pour qu’un horodatage devienne immuable ? Après le lot nocturne, la racine de Merkle est ancrée dans une transaction Bitcoin. La confirmation prend généralement environ 3 heures, après quoi l’horodatage est immuable et vérifiable.
La preuve est-elle indépendante du fournisseur ? Oui. La preuve n’utilise que du SHA-256 et des données de bloc Bitcoin via le protocole OpenTimestamps. Vous pouvez la vérifier hors ligne avec les outils OpenTimestamps standards, même si Timestamp GIT cesse d’exister.
Que reçoit concrètement l’équipe de conformité ?
Une page de statut publique, un CSV d’audit téléchargeable couvrant l’historique du dépôt, un certificat PDF par date, et des reçus .ots dans le dépôt. Pour la valeur juridique de ces preuves, voir Is a Blockchain Timestamp Legally Valid Evidence?.
Conclusion : installer une fois, prouver pour toujours
Horodater des commits Git sans ligne de commande se résume à une décision : cessez de traiter l’horodatage comme un rituel par développeur et faites-en une propriété du dépôt. Installez la GitHub App, sélectionnez les dépôts, continuez à committer. Le cron nocturne transforme ces commits en preuves enracinées dans un arbre de Merkle et ancrées dans Bitcoin, et les reçus reviennent dans votre propre dépôt, là où ils ont leur place.
Commencez avec le forfait Open Source gratuit sur un dépôt public — cela ne coûte rien et prend environ cinq minutes. Quand vous serez prêt à couvrir du code privé, passez à Pro Agency à 49 $/mois, ou optez pour Enterprise ZK à 199 $/mois si le modèle GitHub Action correspond mieux à votre posture de sécurité. Dans tous les cas : timestampgit.dev est la seule étape d’installation.
Articles similaires
- Timestamp GIT Alternatives: What to Compare First
- Git Commit Timestamps Aren’t Tamper-Proof — What Is
- Best Code Timestamping Tools in 2026