I timestamp dei commit Git valgono come prova?
Apri un terminale, esegui git log e ogni commit ti fissa con una data. Sembra autorevole — un record permanente, generato automaticamente dalla macchina, che il codice esisteva in quel momento. Quindi quando settimane o anni dopo sorge una domanda (“chi ce l’aveva per primo?”, “quando è stato effettivamente rilasciato?”), è tentante trattare quelle date come prove.
Non lo sono. Non nel senso che conta quando dall’altra parte del tavolo c’è un avvocato, un revisore o un ex dipendente.
Questo articolo risponde direttamente alla domanda — i commit Git hanno timestamp di cui ci si può fidare? — e poi mostra come appare davvero un timestamp di cui puoi fidarti: un hash di commit ancorato alla blockchain di Bitcoin, prodotto automaticamente da una GitHub App che installi una volta sola.
La risposta breve: i timestamp Git non sono prove
I timestamp dei commit Git sono metadati auto-dichiarati. Sono impostati dalla macchina che ha creato il commit, possono essere modificati in seguito e nulla nel protocollo Git verifica che corrispondano al tempo reale.
Concretamente:
- Git memorizza una data autore e una data committer come semplici campi all’interno dell’oggetto commit. Chiunque possa creare un commit può impostarle a qualsiasi valore.
- Quei campi non sono firmati da una fonte temporale attendibile. Non c’è alcun meccanismo di consenso, nessuna terza parte, nessun testimone.
- La cronologia può essere riscritta: commit modificati con amend, rebase o ricreati da zero con nuove date e nuovi hash.
C’è un secondo problema, più sottile. Anche se non tocchi mai le date, l’unica copia di “quando è successo” vive su infrastrutture che non controlli — i server di GitHub, i log della tua CI, il reflog del tuo portatile. In una disputa, i log interni vengono regolarmente respinti come auto-favorevoli: ovviamente il tuo sistema dice che l’hai fatto prima tu, il sistema l’hai scritto tu.
Quindi c’è una distinzione reale da tracciare:
| Scopo | Il timestamp Git è… |
|---|---|
| Ordinare i commit, leggere la cronologia, fare bisect dei bug | Perfettamente adeguato |
| Messaggi su Slack, changelog, note di rilascio | Adeguato |
| Dispute sui brevetti, rivendicazioni di proprietà intellettuale, dispute sui pagamenti, audit | Non è una prova |
I timestamp Git sono una comodità di workflow. Non sono mai stati progettati per essere una prova.
Perché i timestamp Git sono così facili da falsificare
L’orologio è tuo
Git legge l’orologio di sistema della macchina su cui viene creato il commit. Cambia l’orologio, cambia il timestamp:
GIT_AUTHOR_DATE="2019-03-04T10:00:00" \
GIT_COMMITTER_DATE="2019-03-04T10:00:00" \
git commit -m "Feature that definitely existed in 2019"
Quel commit è un oggetto Git perfettamente valido. Verrà pushato, clonato e visualizzato nell’interfaccia di GitHub senza problemi. Chiunque abbia accesso al repository può farlo, e non esiste alcuna traccia di audit che mostri che la data è stata fabbricata.
La cronologia è mutabile per design
La cronologia di Git è una catena di hash, ma la catena puoi ricostruirla tu:
git commit --amend --date="2019-03-04T10:00:00"
git rebase -i HEAD~10 # reword, squash, reorder, re-date
Riscrivere la cronologia produce nuovi hash di commit — ed è esattamente il punto. Il vecchio hash scompare, quello nuovo porta la data che hai digitato, e nulla di esterno testimonia la transizione. Se ti stai chiedendo se il contenuto di un commit è a prova di manomissione (lo è — cambiare un byte cambia l’hash), è una proprietà separata dall’attendibilità della data. L’hash dimostra qual era il codice. Non dice nulla su quando.
La piattaforma di hosting non è un notaio
GitHub registra le date che Git gli passa. I suoi log vivono sui suoi server e sono modificabili dalla piattaforma, dagli amministratori del repository e da chiunque riscriva e faccia force-push. In un contesto legale, “la nostra cronologia dei commit su GitHub lo dice” è un’asserzione, non una prova matematica.
L’analogia del diario
Pensa a una pagina di diario contro un documento autenticato da un notaio. Entrambi registrano una data. Entrambi sembrano ufficiali quando li leggi. Ma solo quello autenticato è creduto da un estraneo, perché una terza parte senza interessi in gioco ha confermato la data e l’ha resa impossibile da modificare in seguito senza che venga rilevato.
Un timestamp di commit Git è una pagina di diario. La marcatura temporale crittografica è il notaio.
Cosa dimostra davvero che il codice esisteva in un momento specifico
Il meccanismo è più semplice di quanto sembri:
- Impronta il contenuto. Esegui un hash crittografico (SHA-256) sui dati. L’hash è una stringa di dimensione fissa che cambia completamente se cambia un singolo byte dell’input.
- Ancora pubblicamente l’impronta. Scrivi quell’hash in un registro che nessuna singola parte controlla e che non può essere riscritto — Bitcoin.
- Conserva la ricevuta. Ora chiunque abbia i dati originali può ricalcolare l’hash, confrontarlo con il valore ancorato e confermare che esisteva al momento del blocco o prima.
Bitcoin è l’ancora giusta perché è decentralizzato: nessuna azienda, inclusa quella che fornisce il servizio, può alterare un blocco confermato. Una volta che una transazione è sepolta a qualche blocco di profondità, riscriverla richiederebbe di rifare più lavoro di quanto la rete produca.
OpenTimestamps rende questo praticabile su larga scala. Invece di mettere ogni hash direttamente on-chain, raggruppa molti hash in un Merkle tree e committa solo la radice, così migliaia di commit condividono una singola transazione Bitcoin — economico, veloce e rispettoso della privacy. Il risultato è un piccolo file di ricevuta .ots che puoi verificare in modo indipendente.
Il problema è operativo: farlo a mano significa eseguire tooling, gestire i calendar e gestire le ricevute per ogni batch. È il modo difficile, ed è esattamente ciò che Timestamp GIT automatizza.
Come Timestamp GIT rende attendibili i timestamp Git
Timestamp GIT è un servizio gestito costruito attorno a una GitHub App. Installi l’app una volta su un repository; da quel momento, ogni commit viene ancorato automaticamente a Bitcoin. Nessuna CLI, nessuno script, nulla da eseguire sulle macchine degli sviluppatori.
Passo 1 — L’impronta. Git produce già un hash univoco per ogni commit. Quell’hash è un’impronta unidirezionale dello stato del tuo repository in quel momento.
Passo 2 — L’ancora. Ogni notte, un worker raccoglie gli hash dei commit in sospeso della giornata, li scrive in un manifest per repository (.txt), costruisce un Merkle tree e ancora la radice Merkle in un blocco Bitcoin tramite i calendar pubblici di OpenTimestamps. La conferma Bitcoin richiede tipicamente circa tre ore, quindi i file di prova arrivano qualche ora dopo l’esecuzione del batch.
Passo 3 — La prova. Il manifest e i corrispondenti file di ricevuta .ots vengono pushati nel tuo repository — in un branch dedicato ai timestamp, o in un repository shadow separato se preferisci tenerli distinti. Ora possiedi una ricevuta che dimostra che gli hash esistevano prima di uno specifico blocco Bitcoin.
Le garanzie che derivano da questo design:
- Zero-knowledge. Il servizio legge solo gli hash dei commit. Il tuo codice sorgente non viene mai copiato, memorizzato o ispezionato.
- Indipendente dal fornitore. La prova è SHA-256 più i dati del blocco Bitcoin. Nessun formato proprietario, nessun lock-in — un verificatore OpenTimestamps di terze parti può controllarla senza il nostro coinvolgimento.
- Verificabile offline. Il file
.otsè autosufficiente. Se il servizio sparisse domani, la prova resterebbe comunque valida.
Per la conferma quotidiana, non devi nemmeno aprire le ricevute. La pagina di stato pubblica di un repository mostra la longevità della prova, la data di ancoraggio più antica, la regolarità giornaliera e i dati del blocco e della transazione Bitcoin — più un CSV di audit scaricabile e un certificato PDF per ogni data. C’è una pagina di verifica basata su browser che percorre la catena Merkle passo dopo passo, calcolando tutto localmente così nessuno — noi compresi — vede cosa stai verificando. E un badge Shields.io incorporabile può andare direttamente nel tuo README.
Se vuoi integrare tutto questo nel tuo tooling, l’API è semplice:
# Combined summary (feeds the Shields.io badge)
curl https://timestampgit.dev/api/statusSummary/acme/payments-service
# Latest anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/acme/payments-service
# Full Merkle chain data for a specific day, for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-11-15
I repository privati aggiungono un HMAC crittografato a questi URL, così lo stato resta visibile solo agli utenti autorizzati.
Idee sbagliate comuni su Git e i timestamp
“I commit Git sono immutabili, quindi i timestamp devono essere attendibili.” L’immutabilità riguarda il contenuto, non i metadati. Cambiare la data di un commit produce un hash diverso — ed è esattamente per questo che la data non è una prova: crei semplicemente un nuovo commit con un nuovo hash e una nuova data, e quello vecchio svanisce dal branch.
“La cronologia dei commit di GitHub è una prova sufficiente.” I log della piattaforma non sono ancorati crittograficamente a nulla al di fuori della piattaforma. Possono essere riscritti dagli amministratori e con i force-push, e nelle dispute vengono spesso respinti come auto-dichiarati.
“La marcatura temporale su blockchain richiede conoscenze crypto approfondite o tooling manuale.” Farlo in modo grezzo sì. Usare un servizio gestito no: installi la GitHub App e l’ancoraggio avviene con una pianificazione notturna a cui non pensi mai. La crittografia è reale; il carico operativo è zero.
“La marcatura temporale espone il mio codice.” Solo gli hash lasciano il tuo repository. L’hash di un commit non rivela nulla del suo contenuto — non puoi invertirlo e non puoi confrontarlo con nulla senza avere già l’originale.
Quando ti serve una prova crittografica (e quando no)
Per lo sviluppo quotidiano, i timestamp Git vanno bene. Non ancorerai ogni branch di bugfix, e non dovresti.
Ricorri alla prova crittografica quando una data potrebbe dover sopravvivere a una conversazione conflittuale:
- Dispute sui brevetti. Un’entità non praticante deposita un brevetto ampio su qualcosa che hai rilasciato mesi prima. Lo stato dell’arte ancorato è il modo per invalidare la rivendicazione. (Maggiori dettagli in Cryptographic Prior Art: The Startup Shield Against Patent Trolls.)
- Rivendicazioni IP dei dipendenti. Un lead developer in uscita contesta quando è stata concepita una funzionalità. Un timestamp immutabile mette fine al “lui dice, lei dice”.
- Dispute sui pagamenti con i clienti. Le agenzie possono dimostrare le date di consegna invece di discutere sulle tempistiche delle fatture.
- Plagio nel freelance. Dimostra che una libreria o un pezzo di portfolio era tuo per primo.
- Compliance e audit. Mostra un record verificabile, ancorato a terze parti, di quando il codice è cambiato — senza consegnare il sorgente.
Se una tale prova sia ammissibile dipende dalla giurisdizione e dalle circostanze; è una conversazione da fare con il tuo avvocato, e trattiamo le sfumature in Is a Bitcoin Timestamp Admissible as Evidence?.
I prezzi riflettono questa distinzione: la marcatura temporale è gratuita per i repository open source pubblici, con piani a pagamento per i repository privati e i team più grandi.
Eseguirlo all’interno della tua rete
Per ambienti regolamentati o configurazioni air-gapped, Timestamp GIT è distribuito come immagine Docker che ospiti tu stesso. 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’app si avvia su http://localhost:8080; una procedura guidata al primo avvio ti accompagna nel collegamento della tua GitHub App. Una licenza demo a tempo è disponibile tramite il modulo di richiesta nella pagina Docker License. I dettagli completi del deployment sono in Self-Host Git Timestamping With Docker Compose.
FAQ
Posso semplicemente cambiare l’orologio di sistema per falsificare la data di un commit Git? Sì. Git usa il tuo orologio locale e puoi impostarlo a qualsiasi data — oppure riscrivere la data in seguito con un amend o un rebase. È esattamente per questo che i timestamp Git da soli non sono una prova attendibile di nulla.
GitHub fornisce timestamp attendibili per i commit? GitHub registra le date fornite da Git, ma non sono ancorate crittograficamente. I suoi log vivono sui suoi server, possono essere alterati e possono essere respinti come auto-favorevoli in un contesto legale.
Come fa Timestamp GIT a dimostrare che il mio codice esisteva in un certo momento senza vedere il mio codice? Elabora solo gli hash dei commit — impronte crittografiche dello stato del tuo repository. Quegli hash vengono raggruppati e ancorati a Bitcoin tramite OpenTimestamps. Il tuo codice sorgente non lascia mai il tuo repository.
La prova di Timestamp GIT è ammissibile in tribunale? La prova si basa sul registro immutabile di Bitcoin e sull’hashing SHA-256 standard, che sono sempre più riconosciuti in contesti legali. L’ammissibilità dipende comunque dalla tua giurisdizione e dalle circostanze specifiche — consulta un professionista legale. Per una discussione più approfondita, vedi il nostro articolo sull’ammissibilità dei timestamp Bitcoin.
In conclusione
I timestamp dei commit Git rispondono alla domanda “in che ordine sono avvenuti questi cambiamenti su questa macchina?”. Non rispondono alla domanda “puoi dimostrare a un estraneo che questo codice esisteva in questa data?”. Per la seconda domanda ti serve un’impronta ancorata da qualche parte che non controlli — e il modo pratico per ottenerla è smettere di trattare i timestamp come un compito manuale.
Installa la GitHub App una volta, lascia che il batch notturno faccia il suo lavoro, e ogni commit nel repository diventa supportato da un blocco Bitcoin. Puoi vedere l’intero flusso — e le pagine di verifica e i badge che ne derivano — su timestampgit.dev.
Post correlati
- Automatic Git Commit Timestamping Without Any CLI
- OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?
- Self-Host Git Timestamping With Docker Compose