Timestamp GIT

← Tous les articles

2026-11-20

Configurez la protection de la propriété intellectuelle avec une seule installation de l'application GitHub

Configurez la protection de la propriété intellectuelle avec une seule installation de l'application GitHub
timestamp git blockchain proof

Configurer la protection de votre propriété intellectuelle avec une seule installation de GitHub App

Vous n’avez pas besoin d’un budget juridique, d’une chaîne d’outils CLI ni de changer la façon dont votre équipe écrit du code pour obtenir une preuve cryptographique que votre dépôt existait à un moment précis. Il vous suffit d’une installation.

Ce guide détaille toute la configuration d’une github app for intellectual property protection : installez la GitHub App Timestamp GIT, sélectionnez vos dépôts, laissez l’automatisation nocturne regrouper vos hashs de commits et les ancrer dans Bitcoin, puis confirmez que la preuve est réelle. Chaque étape ci-dessous est un clic, un réglage ou un court fichier de configuration. Aucun développeur de votre équipe ne tape une nouvelle commande, et aucun code source ne quitte jamais votre organisation GitHub.

Ce que vous obtenez au final : un reçu .ots immuable par jour, une page de statut publique adossée aux données de blocs Bitcoin, un badge dans votre README, et un certificat d’audit au format CSV ou PDF que vous pouvez remettre à un avocat ou à un auditeur.

Pourquoi une GitHub App est la voie la plus rapide vers la protection de la PI

La méthode difficile consiste à ancrer vous-même les commits manuellement — en exécutant les outils OpenTimestamps à la main et en suivant les confirmations Bitcoin pour chaque lot. Cela fonctionne, mais c’est source d’erreurs, cela dépend d’une personne qui doit y penser, et cela s’effondre dès que vous avez cinq développeurs et une centaine de commits par jour.

La méthode gérée est une simple installation de GitHub App. Timestamp GIT repose sur les mêmes primitives cryptographiques, mais dissimule le protocole derrière l’automatisation :

  • Installez une fois. Pas de CLI, pas d’outils locaux, rien à installer sur les machines des développeurs.
  • Détection automatique. Chaque nouveau commit sur un dépôt surveillé est détecté via des webhooks.
  • Ancrage nocturne. Les hashs sont regroupés à minuit, enracinés dans un arbre de Merkle et ancrés dans Bitcoin via OpenTimestamps.
  • Livraison chez vous. Les manifestes et les reçus .ots arrivent dans une branche dédiée ou un dépôt shadow séparé.
  • Zero-knowledge. Seuls les hashs de commits sont traités. Votre source n’est jamais lue, copiée ni stockée.

Si vous voulez le contexte stratégique sur l’importance juridique de tout cela avant de commencer à cliquer, lisez Prove Prior Art Before You File: A Founder’s Guide. Cet article reste centré sur la configuration.

Prérequis : ce dont vous avez besoin avant de commencer

  • Un compte GitHub avec des droits d’administrateur sur le dépôt — ou l’organisation — que vous voulez protéger. Vous ne pouvez pas installer une GitHub App sur un dépôt auquel vous n’avez qu’un accès en écriture.
  • Un compte Timestamp GIT. L’offre Open Source est gratuite pour les dépôts publics ; les dépôts privés nécessitent un forfait payant.
  • Un modèle mental de base de Git. Vous devez savoir qu’un commit possède un hash SHA-1 ou SHA-256. C’est l’étendue des connaissances cryptographiques requises.
  • Une décision sur l’emplacement des preuves. Même dépôt sur une branche dédiée, ou dépôt shadow séparé. Un dépôt shadow garde votre dépôt principal propre, mais nécessite un dépôt cible auquel vous pouvez accorder un accès en écriture.
  • Facultatif : Docker. Uniquement si vous prévoyez d’auto-héberger plus tard — abordé dans une section ultérieure.

Étape 1 : installer la GitHub App Timestamp GIT

  1. Rendez-vous sur timestampgit.dev et connectez-vous avec GitHub.
  2. Cliquez sur Install GitHub App.
  3. Choisissez All repositories ou Only select repositories, puis sélectionnez les dépôts que vous voulez surveiller.
  4. Examinez les permissions affichées par GitHub. En mode standard, l’application a besoin de :
    • Un accès en lecture seule à vos dépôts sources — GitHub ne propose pas d’accès limité aux seuls hashs de commits, l’accès en lecture est donc le minimum.
    • Un accès en lecture-écriture à un dépôt cible où les preuves sont écrites.
  5. Confirmez. Vous arrivez sur le tableau de bord avec la liste de vos dépôts connectés.

Vous pouvez revenir sur la sélection des dépôts et la modifier à tout moment depuis la page de paramètres de la GitHub App ; l’application ne nécessite pas de réinstallation pour prendre en compte les dépôts nouvellement ajoutés.

Étape 2 : configurer les paramètres de votre dépôt

Sélectionnez le dépôt que vous venez de connecter. Deux décisions comptent ici :

Où vont les preuves ? Soit une branche timestamps dédiée dans le même dépôt, soit un dépôt shadow séparé. Si vous horodatez un dépôt que vous prévoyez d’ouvrir en source plus tard, un dépôt shadow garde l’historique des preuves hors de l’arborescence publique jusqu’à ce que vous vouliez le rendre visible.

Quand l’ancrage s’exécute-t-il ? Chaque nuit à minuit est le réglage par défaut et recommandé — regrouper de nombreux commits dans un seul arbre de Merkle est ce qui rend les preuves quotidiennes peu coûteuses et régulières. Laisser le calendrier tel quel est presque toujours le bon choix.

Copiez ensuite le code d’intégration de votre badge. Ouvrez la page du dépôt connecté (/connected/{user}/{repo}) pour un aperçu en direct du badge de vérification Shields.io et du Markdown exact à coller.

Une note sur la confidentialité : les URL de statut des dépôts privés portent un HMAC chiffré propre à votre instance serveur, de sorte que seuls les utilisateurs autorisés peuvent lire le statut d’un dépôt privé. Ne supprimez pas ce paramètre lorsque vous copiez une URL.

Enregistrez les paramètres. Les hashs de commits commencent immédiatement à affluer dans la file d’attente.

Étape 3 : laisser l’automatisation opérer

Il n’y a rien à faire ici, à part pousser du code. En coulisses :

  1. Détection des commits — la GitHub App voit les nouveaux commits via des webhooks.
  2. File de hashs — les hashs de commits s’accumulent dans un magasin clé-valeur en mémoire pour le regroupement.
  3. Worker cron de minuit — un worker regroupe tous les hashs en attente, écrit un fichier manifeste texte par dépôt, construit un arbre de Merkle nativement, génère des preuves OpenTimestamps auprès des calendriers OTS publics et ancre la racine de Merkle dans Bitcoin.
  4. Livraison des preuves — le manifeste et les fichiers de reçu .ots sont repoussés vers votre branche timestamps ou votre dépôt shadow.

Prévoyez la fenêtre de confirmation Bitcoin. Le lot est soumis à minuit, mais son inclusion dans un bloc prend normalement environ trois heures. En pratique, les preuves d’un commit poussé aujourd’hui sont disponibles demain matin.

Encore un mot sur le point zero-knowledge, car c’est ce que les auditeurs demandent : le service ne manipule jamais que des hashs de commits. Votre diff, vos fichiers, vos secrets — rien de tout cela n’est transmis.

Étape 4 : ajouter le badge de vérification à votre README

Collez l’extrait de la page du dépôt connecté dans votre README. Il ressemble à peu près à ceci — utilisez l’URL exacte fournie par l’application, pas l’espace réservé :

<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[![Bitcoin-timestamped](BADGE_URL_FROM_TIMESTAMPGIT)](https://timestampgit.dev/status/your-user/your-repo)

Quiconque clique accède à la page de statut publique et peut revérifier l’horodatage à partir du fichier .ots lui-même. Ce chemin de vérification public et cliquable est ce qui transforme une revendication propriétaire en preuve qu’un tiers acceptera.

Comment confirmer que cela a fonctionné

Laissez passer une nuit, puis vérifiez trois choses.

1. La page de statut du dépôt. Ouvrez /status/{user}/{repo}. Vous devriez voir la longévité des preuves, la date du premier ancrage, la régularité quotidienne, les données de bloc et de transaction Bitcoin pour chaque ancrage, ainsi qu’une carte de chaleur calendaire. Un trou dans la carte de chaleur signifie un jour sans commits — pas un échec.

2. L’API, si vous la voulez dans un tableau de bord.

# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo

# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo

3. Un certificat PDF pour une date précise. Téléchargez-le pour n’importe quel jour ancré :

curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19

Pour le déroulé complet de ce à quoi ressemble concrètement une vérification de chaîne de Merkle, étape par étape — le tout calculé localement dans votre navigateur — voir How to Verify a Bitcoin Timestamp Proof for Your Code. En bref : le fichier .ots et le manifeste sont des preuves OpenTimestamps standard, vérifiables par rapport aux données de blocs Bitcoin avec n’importe quel outil compatible. Aucun verrouillage, aucune dépendance à notre pérennité.

Facultatif : auto-héberger avec Docker pour les environnements isolés

Pour un contrôle maximal — environnements réglementés, réseaux isolés, ou équipes qui veulent le service sur leur propre infrastructure — 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
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.

Pour l’évaluer, demandez une licence de démonstration à durée limitée depuis la page Docker License en indiquant votre nom, votre entreprise, votre e-mail et, facultativement, votre numéro de téléphone ; vous recevez un fichier de licence à télécharger. L’auto-hébergement implique de gérer votre propre GitHub App et votre infrastructure, mais les garanties zero-knowledge sont identiques.

Résolution des problèmes de configuration courants

  • L’installation échoue ou les permissions semblent incorrectes. Vous avez besoin de droits d’administrateur sur le dépôt ou l’organisation, et en mode standard l’application doit aussi avoir accès au dépôt cible où les preuves sont écrites. Un dépôt cible manquant est la cause la plus fréquente du cas « connecté mais rien ne se passe ».
  • Aucune preuve après 24 heures. Vérifiez que le dépôt reçoit bien des commits et que l’application n’a pas été mise en pause côté GitHub. Consultez la page de statut pour les erreurs avant de signaler quoi que ce soit — un dépôt inactif ne produit aucun manifeste, ce qui est le comportement attendu.
  • Le badge s’affiche comme une image cassée. Recopiez l’URL du badge depuis la page du dépôt connecté. Pour les dépôts privés, l’URL doit inclure le HMAC chiffré ; une URL tronquée échouera.
  • L’ancrage est en retard. Les temps de bloc Bitcoin varient. Une confirmation retardée finit quand même par ancrer — une fois le bloc existant, la preuve est immuable. Rien n’a besoin d’être relancé.
  • Les preuves apparaissent à un endroit inattendu. Vérifiez si le dépôt est configuré pour une branche du même dépôt ou pour un dépôt shadow ; changer de mode ne réécrit pas les preuves historiques.

FAQ

Dois-je modifier mon workflow Git pour utiliser Timestamp GIT ? Non. Une fois la GitHub App installée, elle détecte automatiquement les nouveaux commits et les ancre chaque nuit. Les développeurs continuent d’utiliser Git comme d’habitude — aucune nouvelle commande ni aucun nouvel outil à apprendre.

Quelles permissions GitHub Timestamp GIT requiert-il ? En mode standard, l’application a besoin d’un accès en lecture seule à vos dépôts sources (pour lire les hashs de commits) et d’un accès en lecture-écriture à un dépôt cible où les preuves sont stockées. Le mode Enterprise ZK inverse cela avec une GitHub Action qui ne pousse que le hash de commit depuis votre propre infrastructure, de sorte que le service n’a besoin d’aucun accès en lecture au dépôt source.

Combien de temps faut-il pour qu’un commit soit horodaté sur Bitcoin ? Les hashs de commits sont regroupés et ancrés une fois par jour à minuit. Une fois le lot soumis à la blockchain Bitcoin via OpenTimestamps, la confirmation prend généralement environ 3 heures — les preuves sont donc habituellement disponibles le lendemain matin.

Puis-je vérifier la preuve d’horodatage indépendamment, sans Timestamp GIT ? Oui. Le fichier de reçu .ots et le manifeste sont des preuves OpenTimestamps standard. Vous pouvez les vérifier à l’aide de n’importe quel outil compatible OpenTimestamps par rapport à la blockchain Bitcoin, ce qui garantit l’indépendance vis-à-vis du fournisseur.

L’installation, c’est tout le projet

Une installation de GitHub App, une sélection de dépôt, une page de paramètres. Ensuite, la protection de la PI devient une propriété de fond de votre dépôt plutôt qu’une corvée trimestrielle : chaque hash de commit regroupé chaque nuit, chaque lot enraciné dans un arbre de Merkle dans un bloc Bitcoin, chaque preuve réécrite dans une branche que vous contrôlez et vérifiable par quiconque possède le fichier .ots.

C’est tout le coût d’adoption. Si vous avez repoussé la protection de l’art antérieur parce qu’elle ressemblait à un processus juridique assorti d’une taxe d’ingénierie, commencez dès aujourd’hui avec l’offre Open Source gratuite sur un dépôt public et regardez la première preuve arriver demain matin — get started here. Pour les équipes qui évaluent d’abord le paysage des outils, Best Tools to Timestamp Source Code for Auditors compare les options.

Articles similaires

EU label: AI-generated content