Pourquoi votre journal Git ne constitue pas une preuve — et comment le rendre infalsifiable
Posez-vous une question concrète : si un avocat, un auditeur ou le conseil d’un patent troll vous demandait de prouver qu’un commit précis existait à une date précise, que lui remettriez-vous réellement ?
Une capture d’écran de git log ? Un export de votre activité GitHub ? Les deux sont trivialement écartés. Si vous voulez une véritable preuve d’infalsifiabilité de l’historique Git avec Bitcoin, la réponse n’est pas un meilleur export — c’est un horodatage que personne, vous y compris, ne peut antidater ni modifier. Ce guide détaille les mécanismes qui expliquent pourquoi votre journal échoue comme preuve, puis les étapes exactes pour le rendre infalsifiable, la GitHub App faisant le travail pendant la nuit.
Pourquoi votre journal Git n’est pas infalsifiable (et ce que cela implique pour la conformité)
Git est adressé par contenu, ce qui laisse croire que l’historique est immuable. Il ne l’est pas. Chaque hash de commit est un hash de l’arbre, du parent, du message et des métadonnées — mais la chaîne de ces hashes réside dans un dépôt sur un serveur que vous ne contrôlez pas. Trois éléments détruisent la valeur probante :
- L’historique est réécrivable par conception.
git rebase,git commit --amendet un force-push remplacent les commits par de nouveaux hashes. Les anciens objets subsistent jusqu’au garbage collection, puis disparaissent. Un mainteneur disposant des droits de push peut réécrire des mois d’historique en une minute. - Les dates sont auto-déclarées. Les horodatages d’auteur et de committer ne sont que des métadonnées que vous pouvez définir. Tout journal interne qui enregistre le temps n’est fiable que dans la mesure de la machine qui l’a écrit.
- Le journal vit sur l’infrastructure de quelqu’un d’autre. Votre organisation GitHub, votre base de données CI, votre wiki interne — tout est modifiable, tout est sous votre contrôle. Lors d’un audit juridique, cela en fait des preuves « à décharge » faciles à contester.
Ce dernier point compte plus que ne l’imaginent les développeurs. Un enregistrement que vous auriez pu modifier est un enregistrement que la partie adverse soutiendra que vous avez modifié. La solution n’est pas plus de journalisation — c’est d’externaliser la preuve vers un système dont l’historique aucune partie seule ne peut réécrire.
C’est l’idée derrière l’art antérieur cryptographique : vous prenez les empreintes que Git produit déjà (les hashes de commit), vous les regroupez, vous hashez à nouveau le lot dans un arbre de Merkle, et vous ancrez la racine dans la blockchain Bitcoin via le protocole OpenTimestamps. Quelqu’un peut réécrire votre dépôt, mais il ne peut pas réécrire un bloc Bitcoin.
Timestamp GIT automatise toute cette chaîne — aucun outil CLI, aucune commande OpenTimestamps, aucun changement dans le workflow des développeurs. Pour un contexte plus approfondi, consultez comment prouver l’art antérieur d’une idée logicielle sans brevet et si un horodatage blockchain est une preuve juridiquement valable.
Prérequis : ce qu’il vous faut avant d’ancrer votre premier commit
- Un dépôt GitHub (public ou privé) sur lequel vous avez les droits d’administration, afin de pouvoir installer la GitHub App Timestamp GIT.
- Un compte Timestamp GIT — gratuit pour l’open source / les dépôts publics, Pro Agency (49 $/mois) pour les dépôts privés, Enterprise ZK (199 $/mois) pour le mode GitHub Actions.
- Un dépôt cible pour les preuves. Soit une branche du même dépôt, soit un dépôt shadow séparé. Le modèle de permissions GitHub exige au moins un accès en lecture seule au dépôt source (il n’existe pas de portée « hash de commit uniquement »), plus un accès lecture-écriture sur la cible.
- Pour le mode Enterprise ZK : un workflow GitHub Actions et une clé API. Ici, seul un accès lecture-écriture au dépôt cible est requis — le dépôt source n’a besoin d’aucun accès en lecture.
- Pour l’auto-hébergement : Docker et Docker Compose, plus une licence de démonstration à durée limitée depuis la page Docker License.
Rien ne s’installe sur les machines des développeurs.
Étape par étape : rendre votre historique Git infalsifiable avec Timestamp GIT
Étape 1 — Installer la GitHub App et connecter le dépôt
Installez la GitHub App Timestamp GIT sur votre organisation et sélectionnez les dépôts à surveiller. Accordez un accès en lecture seule aux dépôts sources et en lecture-écriture à la cible (branche ou dépôt shadow). L’app enregistre des webhooks et détecte automatiquement les nouveaux commits — aucune action par commit de la part de votre équipe.
En mode Standard, l’app ne lit que le hash du commit HEAD de chaque dépôt surveillé. Elle ne lit jamais l’arbre de travail, les diffs ni le contenu des fichiers.
Étape 2 — (Facultatif) Passer en mode Enterprise ZK
Si même un hash de commit quittant votre réseau est trop, le mode Enterprise ZK remplace le chemin webhook par une courte GitHub Action qui s’exécute sur vos propres runners. Elle ne pousse que le hash — le service n’obtient jamais d’accès en lecture au dépôt source.
name: Timestamp commit hash
on:
push:
jobs:
anchor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Push HEAD hash to Timestamp GIT
env:
TSGIT_API_KEY: ${{ secrets.TSGIT_API_KEY }}
run: |
HASH=$(git rev-parse HEAD)
# POST $HASH + repo metadata to the Timestamp GIT API.
# The workflow is generated for you by the Enterprise setup wizard
# at https://timestampgit.dev/enterprise/{phase}.
C’est toute la surface d’exposition : un hash, une requête authentifiée.
Étape 3 — Laisser le worker cron nocturne faire l’ancrage
Vous n’avez rien à faire ici. Chaque nuit, un worker :
- Regroupe tous les hashes de commit en attente depuis la file en mémoire.
- Construit un manifeste
.txtpar dépôt. - Construit un arbre de Merkle nativement sur le lot.
- Crée des preuves OpenTimestamps à l’aide des calendriers OTS publics.
- Ancre la racine de Merkle dans la blockchain Bitcoin.
Le regroupement est tout l’intérêt — mille commits répartis sur cent dépôts coûtent un seul ancrage.
Étape 4 — Récupérer les reçus .ots et les manifestes
Après confirmation Bitcoin, les fichiers de manifeste et de reçu .ots sont poussés vers votre branche timestamps dédiée ou votre dépôt shadow. La confirmation Bitcoin prend généralement environ 3 heures, donc les preuves arrivent quelques heures après l’exécution nocturne — pas instantanément. Planifiez vos attentes en conséquence, surtout si vous faites une démonstration à l’équipe conformité.
Étape 5 — Intégrer un badge de vérification
Récupérez l’extrait depuis la page de votre dépôt connecté (/connected/{user}/{repo}), qui affiche un aperçu Shields.io en direct :
[](https://timestampgit.dev/status/acme/payments-service)
Toute personne qui clique arrive sur le tableau de bord de statut public. Les dépôts privés ajoutent un HMAC chiffré à l’URL — propre à l’instance — afin que seuls les spectateurs autorisés voient les données.
Étape 6 — (Alternative) Auto-héberger avec Docker Compose
Pour les environnements isolés ou à contrôle maximal, le même pipeline s’exécute 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’app est disponible à l’adresse http://localhost:8080. Au premier lancement, un assistant de configuration vous guide pour connecter votre GitHub App et configurer l’instance. Déposez votre licence de démonstration depuis la page Docker License à l’emplacement indiqué lorsque cela vous est demandé.
Comment confirmer que cela a fonctionné : vérification et pistes d’audit
Quatre contrôles, par ordre croissant de rigueur :
1. Le tableau de bord de statut. Consultez /status/{user}/{repo} pour la pérennité des preuves, la date du premier ancrage, la régularité quotidienne, ainsi que le bloc Bitcoin et les données de transaction derrière chaque lot. Une carte de chaleur calendaire rend les lacunes évidentes — utile quand un auditeur demande « était-ce continu ? »
2. La page de vérification. /verification/{user}/{repo}/{date} vous guide pas à pas dans la chaîne de Merkle à plusieurs niveaux. Tout le calcul se fait localement dans votre navigateur : zéro connaissance, et personne ne voit ce que vous vérifiez. C’est la page à ouvrir en réunion quand quelqu’un conteste l’horodatage.
3. Les exports d’audit. Récupérez des enregistrements structurés pour la conformité :
# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/acme/payments-service
# PDF certificate for a specific anchored date
curl -OJ https://timestampgit.dev/api/report/acme/payments-service/2026-10-30
# Raw Merkle chain data for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-30
4. La vérification indépendante. Comme la preuve repose uniquement sur SHA-256 et les données de blocs Bitcoin, n’importe qui peut vérifier un reçu .ots par rapport à la blockchain avec les outils de vérification OpenTimestamps standards — hors ligne, sans Timestamp GIT. C’est la garantie d’indépendance vis-à-vis du fournisseur : si l’entreprise disparaît demain, vos preuves restent vérifiables.
Dépannage des problèmes courants
- App installée mais rien n’est surveillé. Revérifiez les permissions : lecture seule sur la source, lecture-écriture sur la cible. Le mode Enterprise ZK fait exception — il ne nécessite que la lecture-écriture sur la cible et aucun accès en lecture à la source.
- Preuves « manquantes » après un push. Elles ne le sont pas. La confirmation Bitcoin prend plusieurs heures et les fichiers de preuve sont écrits ensuite. Consultez la page de statut pour les ancrages en attente avant de signaler un bug.
- Le badge renvoie 404 sur un dépôt privé. L’URL contient un HMAC chiffré propre à votre instance serveur. Copiez le lien depuis
/api/badgeLink/{user}/{repo}plutôt que de le construire à la main. - Le conteneur auto-hébergé démarre mais l’assistant échoue. Vérifiez que
./dataest correctement monté et accessible en écriture, puis consultezdocker compose logs -f timestampgit. La plupart des échecs au premier lancement sont un problème de permissions ou de volume, pas de l’app.
FAQ
Puis-je encore réécrire l’historique Git après avoir utilisé Timestamp GIT ? Oui — vous pouvez faire un rebase, un amend ou un force-push en local. Mais les hashes de commit ancrés dans Bitcoin restent immuables. Toute altération des commits d’origine devient évidente, car les hashes ancrés dans Bitcoin ne correspondront plus à l’historique modifié.
Timestamp GIT a-t-il accès à mon code source ? Non. En mode Standard, la GitHub App ne lit que le hash du commit HEAD. En mode Enterprise ZK, une GitHub Action ne pousse que le hash du commit vers l’API. Votre code source ne quitte jamais votre environnement.
Que se passe-t-il si Timestamp GIT cesse son activité ?
Vos preuves sont indépendantes du fournisseur. Les fichiers de reçu .ots et les données de la blockchain Bitcoin permettent à quiconque de vérifier l’horodatage hors ligne à l’aide des outils OpenTimestamps standards, sans dépendre de Timestamp GIT.
Combien de temps faut-il pour qu’un commit soit ancré ?
Les commits sont regroupés chaque nuit. Une fois le lot ancré, la confirmation Bitcoin prend généralement environ 3 heures, et les fichiers de preuve sont écrits quelques heures plus tard. Vous trouverez les reçus .ots dans la branche timestamps de votre dépôt.
Conclusion
Votre journal Git est un enregistrement opérationnel, pas une preuve. Il réside sur une infrastructure que vous contrôlez, contient des dates que vous pouvez définir, et peut être réécrit par quiconque dispose des droits de push — c’est précisément pourquoi les auditeurs le dévaluent. Ancrer les hashes de commit dans Bitcoin transforme cet enregistrement en quelque chose hors de votre contrôle et hors de votre capacité à le modifier.
Timestamp GIT le fait sans demander à vos développeurs d’apprendre un protocole : installez la GitHub App une fois, laissez le worker nocturne ancrer, intégrez le badge, et conservez les reçus .ots et les exports d’audit pour le jour où vous en aurez réellement besoin.
Prochaine étape : installez l’app sur votre dépôt le plus critique pour l’activité dès aujourd’hui. L’ancrage le plus ancien que vous aurez jamais est celui que vous créez ce soir.
Articles similaires
- Automatiser la protection de la PI pour le code d’une startup : le guide du fondateur
- Un horodatage blockchain est-il une preuve juridiquement valable ?
- Timestamp GIT vs OpenTimestamps CLI : lequel convient à votre équipe ?