Timestamp GIT

← Tous les articles

2026-10-18

Configuration de l'horodatage blockchain via GitHub App : installez une fois, horodatez pour toujours

Configuration de l'horodatage blockchain via GitHub App : installez une fois, horodatez pour toujours
timestamp git blockchain proof

Configuration de l’horodatage blockchain via GitHub App : installez une fois, horodatez pour toujours

Voici la tâche en une phrase : installez la GitHub App Timestamp GIT sur un dépôt afin que chaque commit que vous poussez soit automatiquement ancré dans la blockchain Bitcoin chaque nuit — aucun outil CLI, aucune étape manuelle, aucun changement dans la façon de travailler de votre équipe.

Vous pouvez tout à fait faire les choses à la dure : exécuter vous-même les outils OpenTimestamps, gérer les calendriers, construire votre propre regroupement Merkle et surveiller les confirmations Bitcoin. C’est un travail à temps partiel. Timestamp GIT existe pour que ce ne soit pas votre travail du tout. Ce guide parcourt le chemin de configuration que nous recommandons : une installation, une sélection de dépôt, un écran de configuration, puis un pipeline nocturne auquel vous n’aurez plus jamais à penser.

À la fin, vous disposerez d’un reçu .ots quotidien pour vos commits, d’un badge de vérification dans votre README et d’un tableau de bord public que n’importe qui — un avocat, un auditeur, un client — peut consulter sans compte.

Ce que vous allez configurer (et pourquoi c’est un travail ponctuel)

La tâche exacte : connecter un dépôt à la GitHub App afin que la détection des commits, le regroupement des hachages, l’ancrage Bitcoin et la livraison des preuves se fassent tous sans vous.

Ce que vous en retirez :

  • Un reçu .ots immuable par jour — une preuve cryptographique qu’un ensemble précis de hachages de commits existait à une date précise.
  • Un badge de vérification que vous pouvez intégrer à votre README pour que le statut de la preuve soit public.
  • Un tableau de bord de statut avec les dates d’ancrage, les données de bloc et de transaction Bitcoin, la régularité quotidienne et des exports d’audit téléchargeables.

La répartition des tâches mérite d’être intériorisée, car elle explique pourquoi la configuration est un travail ponctuel :

  1. La GitHub App détecte les commits via des webhooks.
  2. Timestamp GIT regroupe les hachages de commits à minuit, construit un arbre de Merkle et ancre la racine de Merkle dans Bitcoin à l’aide du protocole OpenTimestamps.
  3. Les fichiers manifeste et de reçu .ots sont repoussés dans une branche timestamps dédiée ou dans un dépôt fantôme que vous contrôlez.

Il existe deux modes de déploiement, et ce guide suit le premier :

  • Mode standard (GitHub App) — entièrement géré, aucun code dans votre CI, ne lit que le hachage du commit HEAD des dépôts surveillés.
  • Mode Enterprise ZK — une petite GitHub Action exécutée sur votre propre infrastructure ne pousse que les hachages de commits vers l’API Timestamp GIT, et seul un accès en lecture-écriture au dépôt de preuves cible est requis.

Si vous avez besoin du contexte conceptuel expliquant pourquoi tout cela importe — les trolls de brevets, les litiges entre employés, les revendications de « clean room » — lisez d’abord Qu’est-ce que l’antériorité cryptographique ?. Cet article part du principe que vous avez décidé d’en vouloir et que vous voulez maintenant le faire tourner.

Prérequis avant l’installation

  • Un compte GitHub avec des droits d’administrateur sur le dépôt cible (public ou privé).
  • Un compte Timestamp GIT avec une offre correspondant à la visibilité de votre dépôt : Open Source (gratuit, dépôts publics), Pro Agency (49 $/mois, dépôts privés) ou Enterprise ZK (199 $/mois, GitHub Actions).
  • Une décision sur l’emplacement des preuves : une branche timestamps dédiée dans le même dépôt, ou un dépôt fantôme séparé.
  • Une idée claire du modèle de permissions : le mode standard nécessite un accès en lecture seule au dépôt source et un accès en lecture-écriture au dépôt cible. Le mode Enterprise ZK ne nécessite qu’un accès en lecture-écriture au dépôt cible, plus une GitHub Action installée dans votre dépôt source.
  • Pratiquement rien d’autre. Il n’y a rien à installer sur les machines des développeurs. Aucune configuration locale, aucun hook, aucune variable d’environnement par développeur.

Étape 1 — Installer la GitHub App Timestamp GIT

  1. Rendez-vous sur la fiche de la GitHub App Timestamp GIT et cliquez sur Install.
  2. Choisissez le compte GitHub ou l’organisation propriétaire du dépôt.
  3. Sélectionnez Only select repositories et choisissez le(s) dépôt(s) que vous souhaitez surveiller — ou accordez l’accès à tous les dépôts du compte.
  4. Approuvez les permissions demandées. En mode standard, cela signifie un accès en lecture seule au dépôt source (le système de permissions de GitHub n’a pas de portée « hachage de commit uniquement ») et un accès en lecture-écriture au dépôt cible où les preuves sont écrites.
  5. Confirmez la redirection vers Timestamp GIT et attendez le message de succès.

Voilà pour l’installation. C’est un flux classique de type OAuth pour GitHub App, et cela prend environ une minute.

Étape 2 — Connecter et configurer votre dépôt

Rendez-vous sur Your Repositories (/repos) et confirmez que le dépôt nouvellement accessible apparaît dans la liste. S’il n’apparaît pas, vous avez presque certainement sélectionné le mauvais compte lors de l’installation.

Ouvrez ensuite la page de connexion du dépôt et configurez la destination de vos preuves :

  • Même dépôt, branche dédiée — les preuves atterrissent sur une branche timestamps aux côtés de votre code. Simple, autonome, facile à trouver.
  • Dépôt fantôme séparé — les preuves atterrissent dans un dépôt de votre choix. Utile lorsque le dépôt source a un public restreint ou lorsque vous voulez un registre de preuves centralisé pour plusieurs projets.

Si vous utilisez un dépôt fantôme, créez-le ou sélectionnez-le et confirmez que Timestamp GIT dispose d’un accès en lecture-écriture. Une permission manquante ou révoquée ici est la cause la plus fréquente du fameux « pourquoi rien n’apparaît » plus tard.

Pendant que vous êtes sur cette page, activez le badge README. La page de connexion affiche un aperçu en direct du badge Shields.io et vous fournit l’extrait markdown exact — ne rédigez pas les URL à la main, car les dépôts privés nécessitent un composant HMAC propre à l’instance.

Enregistrez la configuration. L’application est désormais armée : à partir de ce moment, les webhooks l’informent de chaque nouveau commit sur la branche surveillée.

Étape 3 — Laisser l’ancrage nocturne s’exécuter (et savoir à quoi vous attendre)

Rien d’autre n’est requis de votre part. Voici ce qui se passe à minuit :

  1. Détection des commits — la GitHub App a déjà capturé les nouveaux hachages de commits via les webhooks.
  2. File de hachages — les hachages résident dans un magasin clé-valeur en mémoire, en attente de la fenêtre de regroupement.
  3. Worker cron de minuit — les hachages en attente sont regroupés, un fichier manifeste .txt est généré par dépôt, un arbre de Merkle est construit nativement, les preuves OpenTimestamps sont créées à l’aide des calendriers OTS publics, et la racine de Merkle est ancrée dans la blockchain Bitcoin.
  4. Livraison des preuves — les fichiers manifeste et de reçu .ots sont repoussés dans la branche timestamps de votre dépôt ou dans le dépôt fantôme.

Ce qui apparaît dans le dépôt cible ressemble à peu près à ceci :

timestamps/
  manifests/
    2026-10-18.txt        # the commit hashes batched that day
  proofs/
    2026-10-18.txt.ots    # the OpenTimestamps receipt for that manifest

Attentes en matière de délais. Le lot s’exécute à minuit, et la confirmation Bitcoin prend plusieurs heures — généralement environ trois. Donc si vous poussez à 09h00, attendez-vous à ce que les preuves arrivent en milieu de matinée le lendemain. C’est une propriété de Bitcoin, pas un bug du pipeline.

Ce qui quitte votre dépôt : uniquement les hachages de commits. Timestamp GIT ne lit, ne copie ni ne stocke jamais votre code source. La source reste dans GitHub (ou, en mode Enterprise ZK, entièrement dans votre propre environnement) et seul le hachage est horodaté.

Et puis cela se répète. Chaque nuit, pour toujours, pour chaque futur commit. Vous avez installé une fois ; le pipeline s’occupe du reste.

Étape 4 — Ajouter le badge de vérification à votre README

Récupérez l’extrait markdown depuis la page de connexion du dépôt — les mêmes données sont disponibles par programmation via le point de terminaison authentifié GET /api/badgeLink/{user}/{repo}, qui renvoie les URL de badge et les extraits markdown.

L’extrait a cette forme (utilisez le bouton de copie ; les URL réelles sont propres à l’instance et au dépôt, en particulier pour les dépôts privés) :

[![Bitcoin timestamped](<badge-url-from-badgeLink>)](<status-page-url>)

Collez-le dans votre README, committez et poussez. Toute personne cliquant sur le badge atterrit sur la vue de vérification publique — sans compte, sans connexion, sans connaissance particulière requise.

Une note sur les dépôts privés. Les URL de statut des dépôts privés ajoutent un HMAC chiffré. Cela signifie que seuls les utilisateurs autorisés peuvent voir le statut de la preuve, tandis que l’ancre Bitcoin sous-jacente reste publiquement vérifiable par quiconque détient le fichier .ots. Le HMAC est spécifique à votre instance de serveur, c’est pourquoi vous devez copier l’URL du badge plutôt que de la construire.

Facultatif mais agréable : intégrez le même badge dans un site de documentation interne ou un tableau de bord d’ingénierie. Ce n’est qu’une URL d’image plus un lien.

Étape 5 — (Facultatif) Auto-héberger avec Docker pour les environnements isolés

Choisissez l’auto-hébergement lorsque vous voulez une sécurité maximale, un réseau isolé (air-gapped) ou des garanties strictes de résidence des données qu’un service géré ne peut pas satisfaire.

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

Puis tirez et démarrez-le :

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Après le démarrage, l’application est disponible à l’adresse http://localhost:8080. Au premier lancement, un assistant de configuration vous guide dans la connexion de votre GitHub App et la configuration de votre instance.

Une licence de démonstration à durée limitée pour l’évaluation est disponible en soumettant le formulaire de demande sur la page Docker License (/docker-license) avec votre nom, votre entreprise, votre e-mail et un numéro de téléphone facultatif. Un fichier de licence de démonstration à durée limitée peut être téléchargé une fois approuvé.

Comment confirmer que cela a fonctionné

Laissez passer un cycle complet (lot de minuit plus environ trois heures), puis vérifiez :

  • Tableau de bord de statut — ouvrez /status/{user}/{repo}. Vous devriez voir 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, et une carte de chaleur calendaire.
  • CSV d’audit — GET /api/audit/{user}/{repo} télécharge le registre d’audit complet.
  • Certificat PDF — GET /api/report/{user}/{repo}/{date} produit un certificat pour un jour précis.
  • Parcours de la chaîne de Merkle — /verification/{user}/{repo}/{date} montre la vérification multi-niveaux étape par étape. Tous les calculs se font localement dans votre navigateur, donc personne — y compris nous — ne voit ce que vous vérifiez.
  • Points de terminaison de statut publics — vérifications rapides :
curl -s https://timestampgit.dev/api/statusLast/{user}/{repo}
curl -s https://timestampgit.dev/api/statusCount/{user}/{repo}
curl -s https://timestampgit.dev/api/statusSummary/{user}/{repo}

statusLast renvoie le dernier bloc Bitcoin ancré, statusCount renvoie le nombre total de commits committés et horodatés, et statusSummary regroupe les données pour Shields.io.

Si vous voulez la procédure détaillée et hors ligne pour transformer un fichier .ots en hauteur de bloc Bitcoin vérifiée, nous la couvrons séparément dans Comment vérifier localement une preuve d’horodatage Bitcoin.

Résolution des problèmes de configuration courants

Aucune preuve n’apparaît après 24 heures. Confirmez que l’application a bien accès au bon dépôt (vérifiez /repos), et confirmez qu’au moins un commit a été poussé après l’installation. Les commits antérieurs à l’installation n’ont jamais été envoyés à la file de hachages.

Le badge s’affiche comme « unknown ». Vérifiez le slug du dépôt dans l’URL du badge. Pour les dépôts privés, assurez-vous que le composant HMAC chiffré est présent — une URL épurée échouera à l’autorisation et ne renverra aucun statut.

Les push vers le dépôt fantôme échouent. Timestamp GIT a besoin d’un accès en lecture-écriture au dépôt cible. Revérifiez les permissions d’installation sur le dépôt fantôme spécifiquement ; les permissions du dépôt source ne s’y étendent pas.

Le mode Enterprise ZK ne produit rien. Dans ce mode, il n’y a pas de détection des commits par webhook. Si la GitHub Action n’est pas installée dans le dépôt source et ne pousse pas activement les hachages vers l’API, aucun hachage n’atteint jamais le service.

Les preuves sont en retard de quelques heures. C’est attendu. Le lot s’exécute à minuit et la confirmation Bitcoin prend généralement environ trois heures. Les retards ici relèvent du timing de la blockchain, pas d’une défaillance.

FAQ

Dois-je installer des outils CLI ou exécuter des commandes OpenTimestamps ?

Non. Timestamp GIT est une GitHub App gérée : vous l’installez une fois, et chaque commit sur un dépôt surveillé est automatiquement ancré dans Bitcoin chaque nuit. Il n’y a aucun outil CLI, aucune commande OpenTimestamps et rien à installer sur les machines des développeurs.

Puis-je utiliser la GitHub App avec des dépôts privés ?

Oui. Les dépôts privés sont pris en charge avec l’offre Pro Agency. Les URL de statut des dépôts privés ajoutent un HMAC chiffré afin que seuls les utilisateurs autorisés puissent consulter le statut de la preuve.

Combien de temps faut-il avant que ma première preuve d’horodatage apparaisse ?

Les commits sont regroupés et ancrés par un worker cron de minuit. La confirmation Bitcoin prend généralement environ trois heures, donc les fichiers manifeste et de reçu .ots sont repoussés vers votre dépôt quelques heures après l’exécution du lot.

Qu’advient-il de mes preuves si Timestamp GIT cesse son activité ?

Les preuves sont indépendantes du fournisseur. Elles reposent uniquement sur SHA-256 et les données de bloc Bitcoin via le protocole OpenTimestamps, vous pouvez donc les vérifier hors ligne à l’aide d’outils standards même si le service n’existe plus.

Conclusion

Tout l’intérêt d’une configuration d’horodatage blockchain via GitHub App est qu’elle doit être ennuyeuse : installez une fois, sélectionnez un dépôt, choisissez où vont les preuves, et laissez une tâche nocturne faire le reste. Tout ce qui suit l’étape deux consiste à attendre que Bitcoin confirme.

À ce stade, vous avez quelque chose que la plupart des équipes n’ont pas — une preuve mathématiquement indéniable du moment où votre code a existé, vérifiable hors ligne, sans que votre source ne quitte jamais votre dépôt. C’est de l’antériorité que vous pouvez remettre à un avocat, un auditeur ou un client sans qu’un seul développeur ne change son flux de travail.

Installez la GitHub App d’abord sur votre dépôt le plus précieux, puis étendez à partir de là. Si vous préférez l’exécuter à l’intérieur de votre propre périmètre, la licence Docker auto-hébergée est le même produit avec votre infrastructure en dessous.

Articles liés

EU label: AI-generated content