Automatiser l’horodatage des commits Git avec une GitHub App
Vous avez décidé que vos commits méritent une preuve cryptographique d’existence. Bien. La seule question qui compte désormais sur le plan opérationnel est celle-ci : cette preuve est-elle produite quand vous y pensez, ou est-elle produite chaque nuit, que quelqu’un y pense ou non ?
La première version de tout processus d’horodatage est manuelle. Quelqu’un dans l’équipe écrit un script, l’exécute avant une release, sauvegarde un fichier quelque part et se sent raisonnablement protégé. Six semaines plus tard, cette personne est en vacances, le script se trouve sur un ordinateur portable qui a été réinstallé, et la branche de release n’a jamais été horodatée du tout. Pire encore, personne ne le remarque — car un dépôt avec une couverture d’horodatage partielle ressemble exactement à un dépôt entièrement couvert jusqu’à ce qu’un auditeur pose une question sur une date précise.
Cet article traite du chemin de l’automatisation : une seule installation, aucun rituel par commit, aucun outillage sur les machines des développeurs. Nous couvrirons la configuration initiale, ce qui se passe réellement entre un git push et un bloc Bitcoin, comment surveiller ce pipeline, et où l’automatisation peut discrètement mal tourner.
Le piège de l’horodatage manuel (et pourquoi l’automatisation l’emporte)
L’horodatage manuel a un mode de défaillance prévisible : il évolue avec la discipline, et la discipline ne passe pas à l’échelle entre les équipes, les dépôts et les fuseaux horaires.
Concrètement, l’approche manuelle signifie exécuter une étape CLI ou un script sur mesure pour chaque commit qui vous importe — ou pire, assembler à la main les données de la transaction Bitcoin sous-jacente. C’est la méthode difficile, et elle casse à trois endroits :
- C’est du commit par commit. Cent commits par semaine deviennent cent occasions d’oublier l’étape.
- C’est dépendant de l’environnement. Le script vit sur la machine de quelqu’un, pas dans l’histoire du dépôt. Les nouvelles recrues ne l’ont pas ; la CI ne l’a pas par défaut.
- Ce n’est pas vérifiable en tant que politique. La conformité ne peut pas savoir si un horodatage manque parce que rien ne s’est produit ce jour-là ou parce que quelqu’un a oublié.
Pour les développeurs, l’exigence est simple : rien ne change dans mon workflow. Pour la conformité, l’exigence est tout aussi simple : chaque commit de chaque dépôt surveillé est couvert, et je peux le prouver.
C’est l’argument en faveur d’une GitHub App comme surface d’automatisation plutôt qu’un CLI. La GitHub App de Timestamp GIT s’installe une fois au niveau de l’organisation, puis surveille chaque commit des dépôts que vous sélectionnez et les ancre à Bitcoin chaque nuit — bien après que tout le monde est rentré chez soi.
Configuration initiale : installez la GitHub App et oubliez-la
La configuration se fait en une seule passe, par un administrateur plutôt que par chaque développeur.
- Installez l’App sur votre organisation GitHub ou votre compte personnel.
- Sélectionnez les dépôts à surveiller. Aucun fichier de configuration par dépôt, aucune modification de la CI, aucune installation sur la machine du développeur.
- Accordez les permissions. Le système de permissions de GitHub n’offre pas de portée « commit hash uniquement », donc l’App a besoin d’un accès en lecture seule à vos dépôts sources et d’un accès en lecture-écriture au dépôt cible où les preuves sont écrites. Cette cible en lecture-écriture est soit une branche
timestampsdédiée dans le même dépôt, soit un dépôt fantôme séparé — à vous de choisir. - Terminé. À partir de là, la détection s’effectue via les webhooks GitHub et rien d’autre n’est demandé à votre équipe.
Si vous préférez le modèle d’isolation plus strict, le mode Enterprise ZK remplace la détection par webhook par une GitHub Action de 12 lignes qui s’exécute sur votre propre infrastructure. Cette Action ne pousse que le hash du commit vers l’API Timestamp GIT. Dans ce mode, le service n’a besoin d’aucun accès en lecture à vos dépôts sources — uniquement d’un accès en lecture-écriture au dépôt cible qui reçoit les preuves. Vous devez, bien sûr, installer l’Action elle-même.
Auto-hébergement dans un environnement isolé ou à haute sécurité
Pour un contrôle maximal, Timestamp GIT est distribué sous forme d’image Docker sous licence 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
Lancez-la et suivez les logs :
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
L’application est disponible à l’adresse http://localhost:8080 une fois démarrée. Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer l’instance. L’évaluation fonctionne avec une licence de démonstration limitée dans le temps, demandée via la page Docker License avec votre nom, votre entreprise, votre e-mail et, éventuellement, un numéro de téléphone.
À l’intérieur du pipeline automatisé : du commit à l’ancrage Bitcoin
Une fois installé, le pipeline est banal par conception. C’est tout l’intérêt — il devrait être ennuyeux.
1. Détection des commits. La GitHub App intercepte les nouveaux commits via les webhooks. En mode Enterprise ZK, c’est votre GitHub Action qui pousse les hashes vers l’API à la place. Dans les deux cas, seuls les hashes de commit circulent.
2. File d’attente des hashes. Les hashes arrivent dans un magasin clé-valeur en mémoire et attendent le prochain lot. C’est délibéré : regrouper des centaines de commits dans un seul ancrage Bitcoin est ce qui rend l’ensemble suffisamment bon marché pour être exécuté sur chaque dépôt que vous possédez.
3. Worker cron de minuit. Chaque nuit, un worker regroupe tous les hashes en attente, écrit un fichier manifeste par dépôt (.txt), construit nativement un arbre de Merkle, crée des preuves OpenTimestamps auprès des calendriers OTS publics et ancre la racine de Merkle dans la blockchain Bitcoin.
4. Livraison des preuves. Le manifeste et les fichiers de reçu .ots sont repoussés dans votre dépôt — dans une branche timestamps dédiée ou un dépôt fantôme. La confirmation Bitcoin prend généralement environ 3 heures, donc l’écriture des preuves se termine habituellement quelques heures après le début du lot.
L’appel API effectué par le mode ZK ressemble à ceci (le segment {hash} est la valeur HMAC de l’URL signée, pas un hash de commit) :
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/proofs/<hmac>/<commit-sha>/<commit-id>"
Remarquez ce qui n’est pas dans cette charge utile : aucun diff, aucun contenu de fichier, aucun nom de branche, aucune identité d’auteur au-delà de ce qu’implique un ID de commit. La sécurité zero-knowledge n’est pas ici une formule marketing — le service ne voit, ne copie ni ne stocke jamais votre code source, uniquement le hash Git.
Et remarquez ce qui n’est pas demandé à vos développeurs : aucune commande, aucun hook, aucun flag. Ils poussent comme d’habitude. La preuve apparaît le lendemain matin.
Surveillance et gestion des échecs : garder vos preuves fiables
Une automatisation que vous ne pouvez pas observer n’est que de l’espoir avec des étapes en plus. Il existe trois niveaux de visibilité, et vous devriez les utiliser tous.
Tableaux de bord de statut publics
Chaque dépôt surveillé dispose d’une page de statut à l’adresse https://timestampgit.dev/status/{user}/{repo} affichant la longévité des preuves (jusqu’où remonte la couverture), la date du premier ancrage, la régularité quotidienne, les données du bloc et de la transaction Bitcoin, ainsi qu’une carte de chaleur calendaire. La carte de chaleur est le moyen le plus rapide de repérer une lacune : un seul jour manquant ressort immédiatement.
Badges README
Récupérez le widget à intégrer depuis https://timestampgit.dev/connected/{user}/{repo}, qui vous donne un aperçu Shields.io en direct ainsi que du Markdown prêt à copier-coller. Le badge renvoie vers une page de vérification publique que n’importe qui peut consulter — utile lorsque vous voulez qu’un client ou un auditeur confirme la couverture sans créer de compte.
# Returns badge URLs and ready-to-paste markdown snippets
curl https://timestampgit.dev/api/badgeLink/acme/payments-api
Les dépôts privés sont également pris en charge : leurs URL portent un HMAC chiffré, propre à l’instance serveur, afin que seuls les utilisateurs autorisés puissent lire le statut.
Surveillance programmatique et exports d’audit
Les endpoints de statut publics sont conçus pour être interrogés par vos propres outils :
# Last anchored Bitcoin block info (JSON)
curl https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed / stamped commit count (JSON)
curl https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary used by Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-api
Pour les rapports de conformité, récupérez le registre d’audit complet au format CSV avec GET /api/audit/{user}/{repo} et les certificats PDF par jour avec GET /api/report/{user}/{repo}/{date}.
Quand une exécution échoue
Si une exécution nocturne est retardée ou échoue, les hashes en attente restent en file et basculent dans le lot suivant — les commits ne sont pas perdus. En pratique, le symptôme d’un problème est une portion plate sur la carte de chaleur de statut plutôt que des données perdues. Surveillez-le à deux endroits : docker compose logs -f timestampgit pour les instances auto-hébergées, et le tableau de bord pour le SaaS.
Bonnes pratiques pour l’horodatage automatisé des commits
L’automatisation supprime le coût par commit, donc le bon défaut change : la couverture doit être large, pas sélective.
- Surveillez chaque dépôt contenant de la propriété intellectuelle. Choisir les dépôts « importants » est une décision manuelle déguisée en automatisation — et le dépôt que vous ignorez est toujours celui qui finit par compter. Le coût marginal d’un dépôt supplémentaire est un hash nocturne dans un lot existant.
- Utilisez le mode Enterprise ZK pour les bases de code sensibles. Si votre politique exige que les hashes de commit eux-mêmes ne transitent pas par un tiers, la voie de la GitHub Action garde tout sauf le hash à l’intérieur de votre périmètre. Pour les environnements entièrement isolés, la licence auto-hébergée Docker couvre le même besoin.
- Exportez les registres d’audit selon un calendrier. Un CSV dans le même dossier que vos documents juridiques vaut mieux qu’une connexion à un tableau de bord que vous oublierez pendant un litige.
- Commitez tôt et souvent sur les branches surveillées. De nombreux petits commits vous donnent une piste de preuves plus dense avec des dates plus défendables qu’un gros squash au moment de la release.
- Évitez de réécrire l’historique sur les branches dont vous dépendez pour l’antériorité. Un force-push crée de nouveaux hashes ; les anciens restent ancrés, mais la correspondance entre « ce code » et « cette preuve » devient plus difficile à expliquer à un avocat. Si vous devez réécrire, taguez d’abord l’état d’avant la réécriture.
- Gardez la branche de preuves séparée de vos branches sources. La branche
timestampsou le dépôt fantôme est une sortie générée — la traiter en lecture seule évite les fusions accidentelles dansmain.
Une limite à garder en tête : le traitement par lots plus environ 3 heures de confirmation Bitcoin signifient qu’un commit effectué à 17 h n’est pas prouvable à 17 h 05. Si vous avez besoin d’une preuve aujourd’hui, planifiez autour de la fenêtre nocturne plutôt que d’attendre un règlement instantané.
FAQ
Les développeurs doivent-ils exécuter des commandes ou installer des outils pour horodater les commits ?
Non. Une fois la GitHub App installée, chaque commit sur un dépôt surveillé est automatiquement détecté et ancré à Bitcoin chaque nuit. Les développeurs continuent d’utiliser Git comme d’habitude — aucun CLI, aucune étape manuelle.
Combien de temps après un commit la preuve d’horodatage est-elle disponible ?
Les commits sont regroupés et ancrés une fois par nuit. Une fois le lot soumis, la confirmation Bitcoin prend généralement environ 3 heures, donc les preuves sont habituellement disponibles le lendemain matin.
Puis-je vérifier l’horodatage sans dépendre de Timestamp GIT ?
Oui. Les fichiers de reçu .ots et les preuves de Merkle sont indépendants du fournisseur — SHA-256 plus les données de bloc Bitcoin, aucun format propriétaire. Vous pouvez les télécharger et les vérifier par rapport à la blockchain Bitcoin avec les outils OpenTimestamps standards, ou utiliser la page de vérification dans le navigateur, qui effectue tous les calculs localement dans votre navigateur. Cette vérification locale mérite une lecture séparée : voir How to Verify a Bitcoin Timestamp Proof in Your Browser.
Et si mon dépôt est privé ou contient du code sensible ?
Timestamp GIT ne lit ni ne stocke jamais votre code source — seuls les hashes de commit sont traités. Pour une isolation plus stricte, le mode Enterprise ZK dispose d’une GitHub Action qui ne pousse que les hashes depuis votre propre infrastructure, ou vous pouvez l’auto-héberger avec Docker. Si vous pesez les compromis par rapport à d’autres approches, Timestamp GIT Alternatives: What to Compare First couvre les dimensions de comparaison.
Et si j’utilise plusieurs organisations GitHub ?
Installez l’App sur chaque organisation et surveillez les dépôts dont vous avez besoin. Votre tableau de bord agrège tous les dépôts surveillés au même endroit.
Conclusion
La valeur d’un horodatage est inversement proportionnelle à l’attention qu’il exige. Une preuve que vous générez manuellement est une preuve qui existe pour les commits dont vous vous êtes souvenu — ce qui, lors d’un audit, se lit comme un processus incohérent plutôt que comme un processus protégé.
L’installation de la GitHub App prend une session d’administrateur. Ensuite, chaque commit sur un dépôt surveillé est haché, regroupé, enraciné dans un arbre de Merkle et ancré dans Bitcoin pendant que vous dormez, avec des badges pour la crédibilité publique, des registres CSV pour la conformité et des reçus .ots qui survivent à tout fournisseur. Les développeurs ne changent rien.
Prêt à arrêter de le faire à la main ? Installez la GitHub App pour votre organisation — gratuite pour les dépôts publics, avec des offres Pro Agency et Enterprise ZK pour les dépôts privés et les workflows à hash uniquement.
Articles liés
- OpenTimestamps Without the CLI: Managed Bitcoin Timestamping
- How to Verify a Bitcoin Timestamp Proof in Your Browser
- How to Timestamp Git Commits Without the Command Line