Timestamp GIT

← Tous les articles

2026-11-15

Horodatage automatique des commits Git sans CLI

Horodatage automatique des commits Git sans CLI
timestamp git blockchain proof

Horodatage automatique des commits Git sans aucune CLI

La plupart des équipes qui souhaitent disposer d’un état de la technique cryptographique ne l’obtiennent jamais, et la raison n’est presque jamais technique. Elle est opérationnelle. Une habitude d’horodatage ne fonctionne que si un humain pense à exécuter l’outil sur le bon commit, au bon moment, et à stocker le reçu quelque part où l’auditeur le trouvera dix-huit mois plus tard. Sous la pression des délais, cette habitude est la première à disparaître.

Cet article porte sur la suppression totale de l’habitude. Non pas « comment exécuter une commande d’horodatage plus souvent », mais comment faire en sorte que chaque commit d’un dépôt surveillé soit ancré automatiquement à la blockchain Bitcoin, chaque nuit, sans qu’aucune commande ne soit tapée par quiconque dans votre équipe. Si vous évaluez s’il vaut la peine d’apprendre le protocole brut plutôt que d’utiliser une GitHub App managée, nous traitons ce compromis séparément dans OpenTimestamps vs Timestamp GIT : preuves manuelles ou GitHub App ?. Ici, nous partons du principe que vous avez décidé de vouloir l’automatisation.

Le piège de l’horodatage manuel (et pourquoi vous voulez en sortir)

Imaginez comment l’horodatage manuel se déroule réellement :

  1. Quelqu’un termine une branche de fonctionnalité et se souvient — généralement après coup — que ce commit devrait être horodaté.
  2. Il exécute un outil, attend, et récupère un fichier de reçu.
  3. Le reçu est renommé, déposé dans un dossier proofs/, commité, ou pire, envoyé par e-mail à un manager.
  4. Personne ne fait cela pour les quarante commits suivants parce que le sprint est devenu chargé.

La CLI OpenTimestamps brute existe et c’est la manière difficile de procéder : c’est un parcours orienté expert où vous gérez le traitement par lots, les fichiers de preuve, l’interaction avec le calendrier et le système de classement. Cela fonctionne. Cela dépend aussi d’une personne qui reste disciplinée pour toujours, et cela ne laisse aucune piste d’audit expliquant pourquoi le commit 4f9c1ab a une preuve et le commit 8d2e0f3 n’en a pas.

Le mode de défaillance en matière de conformité est pire que la gêne. Un dossier d’état de la technique comportant des trous est un dossier qu’un avocat peut démonter. Si une contrepartie demande « prouvez à quoi ressemblait votre base de code le 14 mars », et que votre réponse est un tableur plus la mémoire d’un développeur, vous avez déjà perdu le cadre. Les processus manuels sont aussi difficiles à auditer : aucun artefact cohérent, aucune cadence régulière, et aucun moyen pour un réviseur de conformité de confirmer la couverture sans demander aux ingénieurs de reconstituer leur propre historique.

La promesse de l’automatisation est différente en nature, pas en degré : installez une fois, et à partir de ce moment chaque commit d’un dépôt surveillé est empreinté et ancré chaque nuit. Aucune CLI à apprendre, aucun reçu à classer à la main, rien d’installé sur les machines des développeurs. Le dossier de preuve devient une propriété du dépôt plutôt qu’une propriété de la diligence de quelqu’un.

Configuration unique : installez la GitHub App et oubliez-la

Le parcours principal est la GitHub App. Vous l’installez sur un dépôt ou sur toute l’organisation, et la configuration est véritablement unique — aucun script par dépôt, aucune étape d’intégration pour les développeurs.

Mode standard (GitHub App). L’App lit automatiquement le hash du commit HEAD de chaque dépôt surveillé. Le modèle de permissions de GitHub n’offre pas de portée « hash de commit uniquement », donc l’App nécessite au minimum un accès en lecture seule au dépôt source. Elle a aussi besoin d’un accès en lecture-écriture au dépôt cible, car c’est là que les preuves sont écrites : une branche timestamps dédiée, soit dans le même dépôt que la source, soit dans un dépôt fantôme séparé.

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. Dans ce mode, le service n’a besoin d’aucun accès en lecture au dépôt source — seulement d’un accès en lecture-écriture au dépôt cible pour la livraison des preuves — et vous installez l’Action dans votre workflow. Choisissez ce mode lorsque l’accès en lecture au code source est exclu pour des raisons de politique, ou lorsque votre revue de sécurité exige que les hashes proviennent de l’intérieur de votre périmètre. Choisissez le mode standard lorsque vous voulez le strict minimum d’éléments mobiles.

Standard (GitHub App) Enterprise ZK (GitHub Action)
Accès au dépôt source Lecture seule Aucun
Accès au dépôt cible Lecture-écriture Lecture-écriture
Origine des hashes L’App Votre runner CI
Effort de configuration Installer l’App Installer l’App + ajouter l’Action

Dans les deux modes, rien n’est installé sur les machines des développeurs. Les ingénieurs continuent de commiter exactement comme aujourd’hui, et tout le pipeline s’exécute côté serveur. Le service ne voit, ne copie et ne stocke jamais votre code source — il ne manipule que des hashes de commit.

Si vous devez exécuter l’ensemble au sein de votre propre réseau, Timestamp GIT est également disponible 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’application est disponible à l’adresse http://localhost:8080 après le démarrage, et un assistant de configuration au premier lancement vous guide pour connecter votre GitHub App et configurer l’instance. Une licence de démonstration à durée limitée pour l’évaluation peut être demandée depuis la page Docker License. Nous approfondissons le déploiement dans Auto-héberger l’horodatage Git avec Docker Compose.

Le pipeline automatisé : du commit à l’ancrage Bitcoin

Une fois l’App installée, voici ce qui se passe sans vous :

  1. Détection des commits. Soit la GitHub App récupère les nouveaux commits via des webhooks, soit votre GitHub Action pousse les hashes de commit vers l’API. Seuls les hashes circulent.
  2. File de hashes. Les hashes de commit arrivent dans un magasin clé-valeur en mémoire, en attente du lot nocturne.
  3. Worker cron de minuit. Chaque nuit, un worker regroupe tous les hashes en attente, écrit un fichier manifeste texte par dépôt, construit un arbre de Merkle nativement, crée des preuves OpenTimestamps à l’aide 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 — une branche timestamps dédiée ou un dépôt fantôme — afin que les preuves vivent à côté du code qu’elles décrivent.

Une note pratique sur le timing : la confirmation Bitcoin prend plusieurs heures, normalement environ trois. Ainsi, un commit effectué le mardi obtient une preuve finalisée le mercredi matin, pas le mardi soir. C’est le coût de l’ancrage dans un registre public et immuable, et c’est un coût qui vaut la peine d’être payé.

Vous n’avez pas à accepter tout cela sur parole. Chaque dépôt surveillé dispose d’un tableau de bord de statut public affichant 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 que vous pouvez scruter d’un coup d’œil pour repérer les trous. La même page propose des certificats d’audit CSV et PDF téléchargeables. La vérification elle-même se fait à l’adresse /verification/{user}/{repo}/{date}, qui parcourt la chaîne de Merkle multi-niveaux étape par étape — et tout ce calcul se fait localement dans le navigateur, donc personne ne voit ce que vous vérifiez.

Pour les README, des badges intégrables affichent publiquement le statut de vérification, et quiconque peut suivre le lien du badge pour vérifier l’horodatage sur le site ou télécharger le rapport PDF.

Pour intégrer le statut dans vos propres tableaux de bord, l’API publique est délibérément ennuyeuse :

# Last anchored Bitcoin block info
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 (what the Shields.io badge consumes)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

Et lorsque la conformité demande des artefacts, ne cliquez pas dans une interface à 17 h un vendredi :

# Full audit ledger as CSV
curl -sL -o audit-acme-payments-api.csv \
  https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for a specific day
curl -sL -o certificate-2026-11-14.pdf \
  https://timestampgit.dev/api/report/acme/payments-api/2026-11-14

Les URL de badges et le markdown prêt à coller proviennent de /api/badgeLink/{user}/{repo} (authentifié). Pour les dépôts privés, les URL de statut portent un HMAC chiffré propre à votre instance serveur, afin que seuls les utilisateurs autorisés puissent les lire.

Surveillance et gestion des défaillances : garder l’automatisation honnête

Une automatisation que vous ne surveillez pas est une automatisation dont vous ne savez pas qu’elle fonctionne. Trois choses méritent de devenir une habitude.

Surveillez les trous, pas les erreurs. Si une exécution nocturne échoue, le système réessaie, et les hashes en attente restent dans la file en mémoire plutôt que d’être perdus. Mais la profondeur de la file et les tentatives sont internes ; la carte de chaleur calendaire sur la page de statut est ce que vous pouvez réellement lire. Un jour manquant est immédiatement visible comme un trou dans la grille.

Interrogez et alertez. Une petite tâche planifiée qui compare la dernière charge utile de statut à l’instantané de la veille détectera un pipeline bloqué avant qu’un auditeur ne le fasse :

import json, pathlib, requests

REPO = "acme/payments-api"
URL = f"https://timestampgit.dev/api/statusSummary/{REPO}"
snapshot = pathlib.Path("last-status.json")

r = requests.get(URL, timeout=30)
r.raise_for_status()
current = r.json()

previous = json.loads(snapshot.read_text()) if snapshot.exists() else None

if previous == current:
    print("WARNING: status unchanged since last poll - check the repo status page")
else:
    print("new anchor data:", json.dumps(current))

snapshot.write_text(json.dumps(current, indent=2))

Exécutez-le toutes les heures en CI, ou quotidiennement juste après la fenêtre cron, et acheminez l’avertissement là où les humains regardent.

Planifiez les audits en fonction du délai de confirmation. Comme l’ancrage dans Bitcoin prend quelques heures après l’exécution du worker cron, « horodatez tout ce qui vient de la release d’hier soir, il me faut le certificat dans dix minutes » n’est pas une demande que quiconque peut satisfaire. Donnez à la conformité une règle simple : les preuves du jour N sont finalisées au jour N+1.

La partie rassurante de la gestion des défaillances est ce qui se passe si le service est totalement indisponible. La vérification ne dépend pas de nous. Le fichier de reçu .ots peut être vérifié hors ligne par rapport à la blockchain Bitcoin à l’aide des outils de vérification OpenTimestamps standard, car la preuve ne dépend que de SHA-256 et des données de bloc Bitcoin — aucune technologie propriétaire, aucun verrouillage. Même si le fournisseur disparaît, la preuve tient.

Bonnes pratiques pour un horodatage sans intervention

  • Commitez tôt et souvent. Chaque commit est automatiquement empreinté, donc un historique de commits dense produit un dossier d’état de la technique dense. Écraser un mois de travail en un seul commit la veille d’un dépôt de brevet vous donne un ancrage au lieu de deux cents.
  • Choisissez le mode adapté à votre posture de sécurité. Si l’accès en lecture au dépôt source est exclu, utilisez le mode Enterprise ZK : seuls les hashes de commit quittent votre infrastructure, poussés par la GitHub Action.
  • Exportez les registres d’audit et les certificats selon un calendrier. Les archives de conformité ne doivent pas dépendre de quelqu’un qui se souvient d’un lien de téléchargement. Appelez /api/audit/{user}/{repo} mensuellement et /api/report/{user}/{repo}/{date} pour les dates jalons, et stockez les résultats là où vivent vos artefacts juridiques.
  • Placez le badge dans votre README. Au-delà du signal qu’il envoie aux clients, un badge de vérification en direct est un moyen de dissuasion peu coûteux contre les revendications du type « nous avons développé cela indépendamment ».
  • Conservez les preuves dans leur propre branche ou dépôt fantôme. Les commits de preuve quotidiens atterrissant dans une branche timestamps dédiée gardent votre historique principal lisible tout en maintenant la preuve attachée au même dépôt.
  • Documentez le processus par écrit. Pour un auditeur, documentez qui a installé la GitHub App, quels dépôts sont surveillés et où se trouve la branche timestamps. Les mathématiques sont vérifiables ; la chaîne de possession a encore besoin d’un paragraphe.

FAQ

Dois-je installer un logiciel sur les machines des développeurs ?

Non. Timestamp GIT est un service managé qui s’exécute entièrement côté serveur via une GitHub App. Les développeurs commitent simplement comme d’habitude ; aucun outil CLI ni installation locale n’est requis.

Combien de temps faut-il pour qu’un commit soit horodaté ?

Les commits sont traités par lots chaque nuit et ancrés dans Bitcoin. La confirmation Bitcoin prend généralement environ 3 heures, donc les preuves sont habituellement disponibles quelques heures après l’exécution du cron nocturne.

Puis-je vérifier les preuves sans le service ?

Oui. Vous recevez un fichier de reçu .ots immuable qui peut être vérifié hors ligne à l’aide des outils OpenTimestamps standard par rapport à la blockchain Bitcoin. La preuve est indépendante du fournisseur et ne repose que sur SHA-256 et les données de bloc Bitcoin.

Et si j’utilise un dépôt privé ?

La GitHub App fonctionne avec les dépôts privés. Les URL de statut des dépôts privés incluent un HMAC chiffré propre à votre instance serveur, afin que seuls les utilisateurs autorisés puissent consulter le statut.

Conclusion

Toute la valeur d’un dossier d’état de la technique réside dans le fait qu’il existe quand vous en avez besoin, ce qui signifie qu’il ne peut pas dépendre d’un humain qui se souvient d’une commande. Installez la GitHub App une fois, et chaque commit des dépôts surveillés est mis en file, traité par lots à minuit, enraciné dans un arbre de Merkle et ancré dans Bitcoin — avec les preuves repoussées dans une branche que vous possédez, un tableau de bord de statut que vous pouvez consulter, et des exports CSV et PDF pour les auditeurs.

Si la raison pour laquelle vous n’avez pas horodaté votre code est que cela ressemblait toujours à une corvée, cette raison vient de disparaître. Commencez sur timestampgit.dev — connectez un dépôt, laissez le premier lot nocturne s’exécuter, et regardez la carte de chaleur calendaire le lendemain matin.

Articles connexes

EU label: AI-generated content