Perché il tuo Git log non è una prova — e come renderlo a prova di manomissione
Poniti una domanda concreta: se un avvocato, un revisore o il legale di un patent troll ti chiedesse di dimostrare che uno specifico commit esisteva in una data specifica, cosa gli consegneresti davvero?
Uno screenshot di git log? Un export della tua attività su GitHub? Entrambi vengono liquidati con facilità. Se vuoi una vera prova di manomissione della cronologia git con Bitcoin, la risposta non è un export migliore — è un timestamp che nessuno, te compreso, può retrodatare o alterare. Questa guida illustra i meccanismi per cui il tuo log fallisce come prova, e poi i passaggi esatti per renderlo a prova di manomissione, con la GitHub App che fa il lavoro durante la notte.
Perché il tuo Git log non è a prova di manomissione (e cosa significa per la conformità)
Git è content-addressed, il che induce a credere che la cronologia sia immutabile. Non lo è. Ogni hash di commit è un hash dell’albero, del parent, del messaggio e dei metadati — ma la catena di quegli hash vive in un repository su un server che non controlli. Tre cose compromettono il valore probatorio:
- La cronologia è riscrivibile per progettazione.
git rebase,git commit --amende un force-push sostituiscono i commit con nuovi hash. Gli oggetti vecchi restano finché non avviene la garbage collection, e poi spariscono. Un maintainer con diritti di push può riscrivere mesi di cronologia in un minuto. - Le date sono autodichiarate. I timestamp di author e committer sono solo metadati che puoi impostare. Qualsiasi log interno che registra l’ora è affidabile solo quanto la macchina che l’ha scritto.
- Il log vive sull’infrastruttura di qualcun altro. La tua organizzazione GitHub, il tuo database CI, la tua wiki interna — tutto modificabile, tutto sotto il tuo controllo. In un audit legale, questo li rende prove “di parte” e facili da contestare.
Quest’ultimo punto conta più di quanto gli sviluppatori si aspettino. Un registro che avresti potuto modificare è un registro che la controparte sosterrà che hai effettivamente modificato. La soluzione non è registrare di più — è esternalizzare la prova a un sistema la cui cronologia nessuna singola parte può riscrivere.
È l’idea alla base dello stato dell’arte crittografico: prendi le impronte che Git già produce (gli hash dei commit), le raggruppi, calcoli di nuovo l’hash del batch in un albero di Merkle e ancori la radice nella blockchain di Bitcoin tramite il protocollo OpenTimestamps. Qualcuno può riscrivere il tuo repo, ma non può riscrivere un blocco Bitcoin.
Timestamp GIT automatizza l’intera catena — nessuno strumento CLI, nessun comando OpenTimestamps, nessuna modifica al flusso di lavoro degli sviluppatori. Per un contesto più approfondito, vedi come dimostrare lo stato dell’arte per un’idea software senza brevetto e se un timestamp blockchain è una prova legalmente valida.
Prerequisiti: cosa ti serve prima di ancorare il tuo primo commit
- Un repository GitHub (pubblico o privato) su cui hai diritti di amministratore, così da poter installare la GitHub App di Timestamp GIT.
- Un account Timestamp GIT — gratuito per repo open source / pubblici, Pro Agency (49 $/mese) per i repo privati, Enterprise ZK (199 $/mese) per la modalità GitHub Actions.
- Un repository di destinazione per le prove. O un branch nello stesso repo o un repo shadow separato. Il modello di permessi di GitHub richiede almeno accesso in sola lettura al repo sorgente (non esiste uno scope “solo hash del commit”), più lettura-scrittura sulla destinazione.
- Per la modalità Enterprise ZK: un workflow GitHub Actions e una chiave API. Qui serve solo l’accesso in lettura-scrittura al repo di destinazione — il repo sorgente non richiede alcun accesso in lettura.
- Per il self-hosting: Docker e Docker Compose, più una licenza demo a tempo dalla pagina Docker License.
Niente viene installato sulle macchine degli sviluppatori.
Passo dopo passo: rendi la tua cronologia Git a prova di manomissione con Timestamp GIT
Passo 1 — Installa la GitHub App e collega il repository
Installa la GitHub App di Timestamp GIT sulla tua organizzazione e seleziona i repository da monitorare. Concedi l’accesso in sola lettura ai repo sorgente e in lettura-scrittura alla destinazione (branch o repo shadow). L’app registra i webhook e rileva automaticamente i nuovi commit — nessuna azione per singolo commit da parte del tuo team.
In modalità Standard l’app legge solo l’hash del commit HEAD di ogni repository monitorato. Non legge mai il working tree, i diff o il contenuto dei file.
Passo 2 — (Opzionale) Passa alla modalità Enterprise ZK
Se anche un solo hash di commit che esce dalla tua rete è troppo, la modalità Enterprise ZK sostituisce il percorso webhook con una breve GitHub Action che gira sui tuoi runner. Invia solo l’hash — il servizio non ottiene mai accesso in lettura al repo sorgente.
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}.
Questa è l’intera superficie esposta: un hash, una richiesta autenticata.
Passo 3 — Lascia che il worker cron notturno faccia l’ancoraggio
Qui non fai nulla. Ogni notte, un worker:
- Raggruppa tutti gli hash di commit in sospeso dalla coda in memoria.
- Costruisce un manifest
.txtper ogni repository. - Costruisce un albero di Merkle nativamente sul batch.
- Crea le prove OpenTimestamps usando i calendari OTS pubblici.
- Ancora la radice di Merkle nella blockchain di Bitcoin.
Il batching è il punto — mille commit su cento repo costano un solo ancoraggio.
Passo 4 — Raccogli le ricevute .ots e i manifest
Dopo la conferma Bitcoin, il manifest e i file di ricevuta .ots vengono inviati al tuo branch timestamps dedicato o al repo shadow. La conferma Bitcoin richiede tipicamente circa 3 ore, quindi le prove arrivano qualche ora dopo l’esecuzione notturna — non istantaneamente. Regola le tue aspettative di conseguenza, soprattutto se lo stai mostrando in demo al team di conformità.
Passo 5 — Incorpora un badge di verifica
Prendi lo snippet dalla pagina del tuo repository collegato (/connected/{user}/{repo}), che mostra un’anteprima live di Shields.io:
[](https://timestampgit.dev/status/acme/payments-service)
Chiunque clicchi arriva alla dashboard di stato pubblica. I repo privati aggiungono un HMAC cifrato all’URL — specifico dell’istanza — così solo i visualizzatori autorizzati vedono i dati.
Passo 6 — (Alternativa) Self-hosting con Docker Compose
Per ambienti air-gapped o di massimo controllo, la stessa pipeline gira come immagine Docker. Un setup Docker Compose di avvio rapido è questo:
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 è disponibile su http://localhost:8080. Al primo avvio, una procedura guidata ti accompagna nel collegamento della tua GitHub App e nella configurazione dell’istanza. Inserisci la tua licenza demo dalla pagina Docker License quando richiesto.
Come confermare che ha funzionato: verifica e tracce di audit
Quattro controlli, in ordine crescente di rigore:
1. La dashboard di stato. Visita /status/{user}/{repo} per la longevità delle prove, la data del primo ancoraggio, la regolarità giornaliera e i dati del blocco e della transazione Bitcoin dietro ogni batch. Una heatmap a calendario rende evidenti le lacune — utile quando un revisore chiede “è stato continuativo?”
2. La pagina di verifica. /verification/{user}/{repo}/{date} ti guida passo dopo passo nella catena di Merkle multilivello. Tutto il calcolo avviene localmente nel tuo browser: zero-knowledge, e nessuno vede cosa verifichi. È la pagina da aprire in riunione quando qualcuno mette in dubbio il timestamp.
3. Export di audit. Estrai record strutturati per 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. Verifica indipendente. Poiché la prova si basa solo su SHA-256 e sui dati dei blocchi Bitcoin, chiunque può verificare una ricevuta .ots rispetto alla blockchain con i normali strumenti di verifica OpenTimestamps — offline, senza Timestamp GIT. È la garanzia di indipendenza dal fornitore: se l’azienda sparisce domani, le tue prove si verificano comunque.
Risoluzione dei problemi comuni
- App installata ma nulla è monitorato. Ricontrolla i permessi: sola lettura sul sorgente, lettura-scrittura sulla destinazione. La modalità Enterprise ZK è l’eccezione — richiede solo lettura-scrittura sulla destinazione e nessun accesso in lettura al sorgente.
- Prove “mancanti” dopo un push. Non lo sono. La conferma Bitcoin richiede diverse ore e i file di prova vengono scritti dopo. Controlla la pagina di stato per gli ancoraggi in sospeso prima di aprire un bug.
- Il badge restituisce 404 su un repo privato. L’URL include un HMAC cifrato specifico della tua istanza server. Copia il link da
/api/badgeLink/{user}/{repo}invece di costruirlo a mano. - Il container self-hosted si avvia ma la procedura guidata fallisce. Verifica che
./datasia montato correttamente e scrivibile, poi controlladocker compose logs -f timestampgit. La maggior parte dei fallimenti al primo avvio è un problema di permessi o di volume, non dell’app.
FAQ
Posso comunque riscrivere la cronologia Git dopo aver usato Timestamp GIT? Sì — puoi fare rebase, amend o force-push in locale. Ma gli hash dei commit ancorati in Bitcoin restano immutabili. Qualsiasi manomissione dei commit originali diventa evidente, perché gli hash ancorati a Bitcoin non corrisponderanno alla cronologia alterata.
Timestamp GIT ha accesso al mio codice sorgente? No. In modalità Standard, la GitHub App legge solo l’hash del commit HEAD. In modalità Enterprise ZK, una GitHub Action invia solo l’hash del commit all’API. Il tuo codice sorgente non lascia mai il tuo ambiente.
Cosa succede se Timestamp GIT chiude?
Le tue prove sono indipendenti dal fornitore. I file di ricevuta .ots più i dati della blockchain di Bitcoin permettono a chiunque di verificare il timestamp offline usando i normali strumenti OpenTimestamps, senza dipendere da Timestamp GIT.
Quanto tempo serve perché un commit venga ancorato?
I commit vengono raggruppati ogni notte. Dopo l’ancoraggio del batch, la conferma Bitcoin richiede tipicamente circa 3 ore, e i file di prova vengono scritti qualche ora dopo. Troverai le ricevute .ots nel branch timestamps del tuo repository.
Conclusione
Il tuo Git log è un registro operativo, non una prova. Risiede su infrastruttura che controlli, contiene date che puoi impostare ed è riscrivibile da chiunque abbia diritti di push — ed è esattamente per questo che i revisori lo scartano. Ancorare gli hash dei commit in Bitcoin trasforma quel registro in qualcosa fuori dal tuo controllo e fuori dalla tua capacità di alterarlo.
Timestamp GIT lo fa senza chiedere ai tuoi sviluppatori di imparare un protocollo: installa la GitHub App una volta, lascia che il worker notturno ancori, incorpora il badge e conserva le ricevute .ots e gli export di audit per il giorno in cui ti serviranno davvero.
Prossimo passo: installa l’app oggi stesso sul tuo repository più critico per il business. L’ancoraggio più vecchio che avrai mai è quello che crei stanotte.
Articoli correlati
- Automatizzare la protezione della proprietà intellettuale per il codice delle startup: guida per fondatori
- Un timestamp blockchain è una prova legalmente valida?
- Timestamp GIT vs OpenTimestamps CLI: quale si adatta al tuo team?