I timestamp dei commit Git non sono a prova di manomissione — cosa lo è
Apri il terminale ed esegui git log. Vedrai una data accanto a ogni commit. Ora immagina che un avvocato, un revisore o il CTO dell’azienda che ti sta acquisendo ponga una semplice domanda di follow-up: “Come faccio a sapere che quella data è reale?”
La risposta onesta è che non puoi dimostrarlo. Non con git log, non con il feed delle attività di GitHub, non con il tuo database di audit interno. Sono tutti registri che controlli tu, e i registri che controlli tu possono essere modificati. Questo articolo spiega cosa significa davvero “a prova di manomissione”, perché i timestamp di Git falliscono il test e come l’ancoraggio crittografico a Bitcoin lo risolva — automaticamente, tramite Timestamp GIT.
La domanda: puoi davvero fidarti del timestamp di un commit Git?
Ogni commit Git porta due timestamp: la data dell’autore e la data del committer. Ecco come vederli entrambi:
git log -1 --format='commit %H%nauthor %an <%ae> %ad%ncommitter %cn <%ce> %cd' --date=iso
Queste date provengono dall’orologio della macchina che ha eseguito git commit. Sono input, non osservazioni. Git non consulta una fonte temporale attendibile e non attesta nulla esternamente.
Il che significa che puoi impostarle come preferisci:
GIT_AUTHOR_DATE="2026-01-14T09:12:00+00:00" \
GIT_COMMITTER_DATE="2026-01-14T09:12:00+00:00" \
git commit -m "Add billing reconciliation job"
Non è un exploit. È un comportamento documentato e intenzionale — lo stesso meccanismo che ti consente di importare un vecchio repository con la sua cronologia originale intatta.
Quindi quando diciamo a prova di manomissione, intendiamo qualcosa di specifico e rigoroso:
- Nessuno — non un collega, non un amministratore della piattaforma, non un attaccante e nemmeno tu — può alterare il registro a posteriori.
- Chiunque può verificarlo senza doversi fidare della parte che lo ha prodotto.
I timestamp di Git non soddisfano nessuna delle due condizioni. Ecco perché, e cosa invece le soddisfa.
Perché i timestamp di Git sono a prova di manomissione solo in teoria
Il modello di integrità di Git è una catena di hash. Ogni commit contiene l’hash del suo genitore, quindi modificare il contenuto di qualsiasi commit cambia ogni hash a valle. Questa è vera integrità crittografica — per il contenuto.
Il timestamp è solo un campo all’interno dell’oggetto commit. Nulla di esterno ancora l’esistenza del commit a un punto nel tempo. La catena dimostra “questo contenuto è coerente con questa cronologia”, non “questo contenuto esisteva in questa data”.
Chiunque abbia accesso in scrittura può riscrivere la cronologia e le date insieme ad essa:
# Amend the most recent commit with an arbitrary date
git commit --amend --no-edit --date="2025-06-01T08:00:00"
# Rewrite every commit in every branch with a new date
git filter-branch --env-filter '
export GIT_AUTHOR_DATE="2025-06-01T08:00:00"
export GIT_COMMITTER_DATE="2025-06-01T08:00:00"
' -- --all
Anche sulle piattaforme ospitate, un force-push sostituisce la cronologia in blocco. E i log lato piattaforma — consegne di webhook, audit trail, feed delle attività — risiedono in database a cui amministratori e attaccanti possono accedere. In una controversia, “lo abbiamo nei nostri log” è esattamente il tipo di prova che l’avvocato della controparte scarta come autoreferenziale.
L’analogia: un timestamp di Git è una data scritta a matita nel tuo diario personale. Potrebbe essere perfettamente accurata. Potrebbe essere il diario più onesto del mondo. Ma chiunque abbia una gomma può cambiarla, e nessuna terza parte ti ha visto scriverla. L’ancoraggio crittografico è l’equivalente di portare quella pagina di diario da un notaio e farla timbrare in un registro pubblico che nessuno — nemmeno il notaio — può riscrivere in seguito.
Come l’ancoraggio crittografico rende i timestamp a prova di manomissione
La soluzione è prendere l’impronta del tuo lavoro e pubblicarla da qualche parte che non controlli. Tutto qui. È tutta l’idea.
Passo 1 — L’impronta
Quando esegui un commit, Git calcola l’hash dell’intero stato del repository in un identificatore univoco (SHA-1 o SHA-256). Quell’hash è un’impronta unidirezionale: identifica il tuo esatto stato del codice senza rivelare nulla del codice stesso.
Passo 2 — L’ancora
Timestamp GIT raccoglie gli hash dei commit di un repository in un file manifest giornaliero, calcola l’hash di quel manifest, costruisce un albero di Merkle sul batch e incorpora la radice di Merkle in una transazione Bitcoin usando il protocollo OpenTimestamps. La blockchain di Bitcoin è append-only e replicata su migliaia di nodi — una volta che la tua radice è confermata in un blocco, il registro “questo hash esisteva entro questa data” è permanente.
Passo 3 — La prova
Ottieni un file di ricevuta .ots immutabile. Collega l’hash del tuo commit attraverso l’albero di Merkle fino a uno specifico blocco Bitcoin. Chiunque può percorrere quella catena rispetto alla blockchain pubblica e confermare il timestamp — senza fidarsi di te e senza fidarsi di Timestamp GIT.
Quest’ultimo punto conta più di quanto sembri. Le garanzie del prodotto sono volutamente noiose:
- Zero-knowledge: il tuo codice sorgente non viene mai letto, copiato o memorizzato. Solo gli hash lasciano il tuo repository.
- Indipendente dal fornitore: la prova usa SHA-256 e i dati dei blocchi Bitcoin. Nessun formato proprietario, nessun lock-in. Se Timestamp GIT sparisse domani, i tuoi file
.otssarebbero comunque verificabili. - Nulla da installare sulle macchine degli sviluppatori.
Il modo difficile per arrivare qui è gestire da soli il protocollo OpenTimestamps e le transazioni Bitcoin — un progetto a sé stante, trattato separatamente in Timestamp GIT vs OpenTimestamps CLI. Timestamp GIT esiste proprio per evitarti questo.
Perché è importante: fraintendimenti comuni e rischi reali
Fraintendimento: “I timestamp di Git bastano per un audit.” I log interni vengono abitualmente screditati come manipolabili. Un audit trail che generi e conservi tu stesso dimostra l’intenzione, non l’esistenza.
Fraintendimento: “I timestamp blockchain servono solo ai progetti crypto.” Qualsiasi hash di commit può essere ancorato — un monolite Rails, un repository di firmware, un sistema di trading interno. Alla tecnologia non importa cosa c’è nel codice.
Fraintendimento: “Ce ne accorgeremmo se qualcuno cambiasse la nostra cronologia.” Force-push, rebase e modifiche a livello di amministratore sono silenziosi per design. A meno che tu non confronti ogni ref con un registro esterno, non te ne accorgeresti.
I rischi reali sono concreti:
- Patent troll. Un’entità non praticante deposita un brevetto ampio su qualcosa che hai rilasciato mesi prima. Senza una prova datata e verificabile in modo indipendente, stai argomentando a memoria.
- Controversie con dipendenti e collaboratori. Quando uno sviluppatore lead se ne va, “quando è stata effettivamente costruita questa funzionalità?” diventa una gara di credibilità. Un timestamp immutabile la chiude.
- Rivendicazioni di “clean room”. Un concorrente afferma di aver sviluppato una logica simile in modo indipendente. Dimostrare che avevi codice funzionante e completato 18 mesi prima crea un muro che non possono scalare.
- Conformità e segreti commerciali. Revisori e team legali chiedono sempre più spesso prove di esistenza per la proprietà intellettuale e i sistemi interni — senza pubblicare il codice sorgente.
Come Timestamp GIT automatizza i timestamp a prova di manomissione
Ecco la parte in cui la crittografia smette di essere un tuo problema.
Installa una volta, ancora ogni notte
Installa la GitHub App sui repository che vuoi proteggere. Rileva i nuovi commit tramite webhook. Da quel momento non ci sono comandi da eseguire, file da gestire, modifiche al flusso di lavoro degli sviluppatori — ogni commit viene ancorato automaticamente ogni notte.
Sotto il cofano, gli hash in sospeso si accodano in un archivio chiave-valore in memoria. A mezzanotte, un worker li raggruppa, scrive un manifest .txt per repository, costruisce l’albero di Merkle e ancora la radice in Bitcoin tramite i calendari pubblici di OpenTimestamps. La conferma di Bitcoin richiede normalmente circa tre ore, quindi le prove finite tornano nel tuo repository poche ore dopo l’esecuzione notturna.
Le prove arrivano nel tuo repo
Il manifest e i file di ricevuta .ots vengono inviati a un ramo dedicato timestamps, oppure a un repository ombra separato se preferisci tenerli fuori dal repository sorgente. In modalità standard la GitHub App necessita di accesso in sola lettura al repository sorgente e in lettura-scrittura al repository di destinazione.
Verifica senza fidarti di nessuno
- I badge nel README mostrano lo stato di verifica in tempo reale, con un link che chiunque può seguire per controllarlo.
- La dashboard di stato del repository (
/status/{user}/{repo}) espone la longevità delle prove, la data di ancoraggio più antica, la regolarità giornaliera, i dati dei blocchi e delle transazioni Bitcoin, una heatmap del calendario e CSV di audit e certificato PDF scaricabili. - La pagina di verifica (
/verification/{user}/{repo}/{date}) percorre l’intera catena di Merkle multilivello — tutti i calcoli avvengono localmente nel tuo browser, quindi nessuno vede cosa verifichi. - L’API REST ti fornisce gli stessi dati in modo programmatico:
# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
# Total stamped commit count (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq
# Full audit ledger as CSV (used for compliance exports)
curl -sL https://timestampgit.dev/api/audit/acme/payments-api -o audit-ledger.csv
I repository privati aggiungono un HMAC crittografato a questi URL, limitato alla tua istanza del server, così solo gli utenti autorizzati possono leggerne lo stato.
Modalità Enterprise ZK
Se la tua policy di sicurezza vieta del tutto di concedere a una terza parte l’accesso al repository, la modalità Enterprise ZK sostituisce la GitHub App con una piccola GitHub Action che viene eseguita sulla tua infrastruttura. L’Action invia gli hash dei commit all’API di Timestamp GIT; il repository di destinazione riceve comunque le prove. Il tuo repository sorgente non viene mai letto.
Docker self-hosted per ambienti air-gapped
Per il massimo controllo, Timestamp GIT è distribuito come immagine Docker. Una configurazione Docker Compose di avvio rapido è questa:
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’applicazione è disponibile su http://localhost:8080 dopo l’avvio. Al primo avvio, una procedura guidata ti accompagna nel collegamento della tua GitHub App e nella configurazione dell’istanza. Una licenza demo a tempo è disponibile inviando il modulo di richiesta nella pagina Docker License.
FAQ
Posso cambiare il timestamp di un commit Git a posteriori?
Sì, i timestamp di Git sono solo metadati impostati dalla macchina del committer. Puoi modificare un commit con git commit --amend --date, riscrivere la cronologia con git rebase o modificare direttamente l’oggetto commit. Anche su piattaforme ospitate come GitHub, i force-push possono alterare i timestamp, quindi non sono a prova di manomissione da soli.
In che modo l’ancoraggio a Bitcoin rende un timestamp a prova di manomissione?
Timestamp GIT prende gli hash dei tuoi commit, costruisce un albero di Merkle e incorpora la radice in una transazione Bitcoin tramite OpenTimestamps. Una volta confermato in un blocco Bitcoin, il timestamp è immutabile — nessuno, incluso Timestamp GIT, può alterarlo. Ricevi una ricevuta .ots che chiunque può verificare rispetto alla blockchain di Bitcoin.
Devo eseguire comandi OpenTimestamps per usare Timestamp GIT? No. Timestamp GIT è un servizio gestito: installi la GitHub App una volta e questa ancora automaticamente i tuoi commit ogni notte. Non c’è CLI, né timbratura manuale, né necessità di imparare il protocollo OpenTimestamps. Per ambienti air-gapped è disponibile un’opzione Docker self-hosted.
Un timestamp ancorato a Bitcoin è una prova legalmente valida?
I timestamp crittografici forniscono una prova di esistenza solida che è sempre più accettata in contesti legali, ma la validità dipende dalla giurisdizione e da come viene presentata la prova. Timestamp GIT fornisce ricevute .ots e certificati PDF pronti per il tribunale che puoi condividere con avvocati o revisori. Per una discussione più approfondita, vedi Is a Blockchain Timestamp Legally Valid Evidence?
In conclusione
Un timestamp di Git è un’affermazione. Un timestamp ancorato a Bitcoin è una prova. Il divario tra i due è la differenza tra il dire “l’abbiamo costruito noi per primi” e l’essere in grado di dimostrarlo anni dopo, davanti a persone che hanno ogni motivo per dubitarne.
La buona notizia è che colmare quel divario non richiede più un progetto di crittografia. Installa la GitHub App una volta, lascia che ancori i tuoi commit ogni notte e conserva le ricevute .ots — insieme a un badge incorporabile, una dashboard di stato pubblica e un certificato PDF per chiunque lo chieda.
I piani partono con un livello gratuito per i repository pubblici, Pro Agency a 49 $/mese per i repository privati ed Enterprise ZK a 199 $/mese per i team che necessitano del flusso di lavoro con GitHub Action. Scegli quello che corrisponde alla visibilità del tuo repository e ottieni il tuo primo ancoraggio stanotte.
Post correlati
- Best Code Timestamping Tools in 2026
- Why Your Git Log Isn’t Proof — and How to Make It Tamper-Proof
- Automate IP Protection for Startup Code: A Founder’s Guide