Configura la protezione della proprietà intellettuale con una singola installazione della GitHub App
Non hai bisogno di un budget legale, di una toolchain CLI o di cambiare il modo in cui il tuo team scrive codice per ottenere una prova crittografica che il tuo repository esisteva in un momento specifico. Ti serve una sola installazione.
Questa guida illustra l’intera configurazione di una github app per la protezione della proprietà intellettuale: installa la GitHub App Timestamp GIT, scegli i tuoi repository, lascia che l’automazione notturna raggruppi gli hash dei tuoi commit e li ancori in Bitcoin, poi verifica che la prova sia reale. Ogni passaggio qui sotto è un clic, un’impostazione o un breve file di configurazione. Nessuno sviluppatore del tuo team digita un nuovo comando e nessun codice sorgente lascia mai la tua organizzazione GitHub.
Quello che ottieni: una ricevuta .ots immutabile al giorno, una pagina di stato pubblica supportata dai dati dei blocchi Bitcoin, un badge nel tuo README e un certificato CSV o PDF di audit che puoi consegnare a un avvocato o a un revisore.
Perché una GitHub App è la via più rapida alla protezione della PI
Il modo difficile per farlo è ancorare manualmente i commit da soli — eseguendo a mano gli strumenti OpenTimestamps e monitorando le conferme Bitcoin per ogni batch. Funziona, ma è soggetto a errori, dipende da una persona che si ricorda di farlo e crolla nel momento in cui hai cinque sviluppatori e cento commit al giorno.
Il modo gestito è una singola installazione della GitHub App. Timestamp GIT si basa sulle stesse primitive crittografiche, ma nasconde il protocollo dietro l’automazione:
- Installa una volta. Nessuna CLI, nessun strumento locale, nulla da installare sulle macchine degli sviluppatori.
- Rilevamento automatico. Ogni nuovo commit su un repository monitorato viene intercettato tramite webhook.
- Ancoraggio notturno. Gli hash vengono raggruppati a mezzanotte, organizzati in un Merkle root e ancorati in Bitcoin tramite OpenTimestamps.
- Consegnati a te. I manifest e le ricevute
.otsfiniscono in un branch dedicato o in un repository shadow separato. - Zero-knowledge. Vengono elaborati solo gli hash dei commit. Il tuo codice sorgente non viene mai letto, copiato o memorizzato.
Se vuoi il contesto strategico sul perché questo sia importante legalmente prima di iniziare a cliccare, leggi Prove Prior Art Before You File: A Founder’s Guide. Questo articolo resta concentrato sulla configurazione.
Prerequisiti: cosa ti serve prima di iniziare
- Un account GitHub con diritti di amministratore sul repository — o sull’organizzazione — che vuoi proteggere. Non puoi installare una GitHub App su un repo su cui hai solo accesso in scrittura.
- Un account Timestamp GIT. Il piano Open Source è gratuito per i repository pubblici; i repository privati richiedono un piano a pagamento.
- Un modello mentale di base di Git. Dovresti sapere che un commit ha un hash SHA-1 o SHA-256. Questo è l’unico livello di conoscenza crittografica richiesto.
- Una decisione su dove risiedono le prove. Stesso repository su un branch dedicato, oppure un repository shadow separato. Un repo shadow mantiene pulito il tuo repository principale ma richiede un repo di destinazione a cui puoi concedere accesso in scrittura.
- Opzionale: Docker. Solo se prevedi di ospitarlo autonomamente in seguito — trattato in una sezione successiva.
Passaggio 1: installa la GitHub App Timestamp GIT
- Vai su timestampgit.dev e accedi con GitHub.
- Clicca su Install GitHub App.
- Scegli All repositories o Only select repositories, poi seleziona i repo che vuoi monitorare.
- Esamina i permessi che GitHub ti mostra. In modalità standard l’app richiede:
- Accesso in sola lettura ai tuoi repository sorgente — GitHub non offre accesso solo agli hash dei commit, quindi la lettura è il minimo.
- Accesso in lettura e scrittura a un repository di destinazione in cui vengono scritte le prove.
- Conferma. Arrivi alla dashboard con i tuoi repository connessi elencati.
Puoi rivedere e modificare la selezione dei repository in qualsiasi momento dalla pagina delle impostazioni della GitHub App; l’app non richiede una reinstallazione per rilevare i repo aggiunti di recente.
Passaggio 2: configura le impostazioni del repository
Seleziona il repository che hai appena connesso. Due decisioni contano qui:
Dove vanno le prove? O un branch dedicato timestamps nello stesso repository, oppure un repository shadow separato. Se stai apponendo timestamp su un repository che prevedi di rendere open source in seguito, un repo shadow tiene la cronologia delle prove fuori dall’albero pubblico finché non vuoi che sia visibile.
Quando viene eseguito l’ancoraggio? Ogni notte a mezzanotte è l’impostazione predefinita e quella consigliata — raggruppare molti commit in un unico Merkle root è ciò che rende le prove giornaliere economiche e coerenti. Lasciare invariata la pianificazione è quasi sempre la scelta giusta.
Poi copia il codice di incorporamento del badge. Apri la pagina del repository connesso (/connected/{user}/{repo}) per un’anteprima dal vivo del badge di verifica Shields.io e del Markdown esatto da incollare.
Una nota sulla privacy: gli URL di stato per i repository privati contengono un HMAC crittografato specifico della tua istanza server, quindi solo gli utenti autorizzati possono leggere lo stato di un repo privato. Non rimuovere quel parametro quando copi un URL.
Salva le impostazioni. Gli hash dei commit iniziano a fluire immediatamente nella coda.
Passaggio 3: lascia che l’automazione faccia il suo lavoro
Non c’è nulla da fare qui se non fare push del codice. Dietro le quinte:
- Rilevamento dei commit — la GitHub App vede i nuovi commit tramite webhook.
- Coda degli hash — gli hash dei commit si accumulano in un archivio chiave-valore in memoria per il raggruppamento.
- Worker cron di mezzanotte — un worker raggruppa tutti gli hash in sospeso, scrive un file manifest di testo per ogni repository, costruisce nativamente un Merkle tree, genera prove OpenTimestamps rispetto ai calendari OTS pubblici e ancora il Merkle root in Bitcoin.
- Consegna delle prove — i file manifest e ricevuta
.otsvengono inviati al tuo branch timestamps o al repo shadow.
Metti in conto la finestra di conferma Bitcoin. Il batch viene inviato a mezzanotte, ma l’inclusione in un blocco richiede normalmente circa tre ore. In pratica, le prove di un commit inviato oggi sono disponibili domani mattina.
Ancora sul punto zero-knowledge, perché è la cosa che i revisori chiedono: il servizio gestisce sempre e solo gli hash dei commit. Il tuo diff, i tuoi file, i tuoi segreti — nulla di tutto ciò viene trasmesso.
Passaggio 4: aggiungi il badge di verifica al tuo README
Incolla lo snippet dalla pagina del repository connesso nel tuo README. Assomiglia più o meno a questo — usa l’URL esatto che ti fornisce l’app, non il segnaposto:
<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[](https://timestampgit.dev/status/your-user/your-repo)
Chiunque clicchi arriva alla pagina di stato pubblica e può riverificare autonomamente il timestamp dal file .ots. Quel percorso di verifica pubblico e cliccabile è ciò che trasforma una rivendicazione proprietaria in una prova che una terza parte accetterà.
Come confermare che ha funzionato
Aspetta una notte, poi controlla tre cose.
1. La pagina di stato del repository. Apri /status/{user}/{repo}. Dovresti vedere la longevità delle prove, la data di ancoraggio più antica, la regolarità giornaliera, i dati del blocco e della transazione Bitcoin per ogni ancoraggio e una heatmap del calendario. Un buco nella heatmap significa un giorno senza commit — non un errore.
2. L’API, se la vuoi in una dashboard.
# 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 certificato PDF per una data specifica. Scaricalo per qualsiasi giorno ancorato:
curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19
Per la procedura completa di come appare davvero passo dopo passo la verifica di una catena Merkle — tutto calcolato localmente nel tuo browser — vedi How to Verify a Bitcoin Timestamp Proof for Your Code. La versione breve: il file .ots e il manifest sono prove OpenTimestamps standard, verificabili rispetto ai dati dei blocchi Bitcoin da qualsiasi strumento compatibile. Nessun lock-in, nessuna dipendenza dal fatto che noi restiamo in attività.
Opzionale: self-hosting con Docker per ambienti air-gapped
Per il massimo controllo — ambienti regolamentati, reti air-gapped o team che vogliono il servizio sulla propria infrastruttura — Timestamp GIT è distribuito come immagine Docker con licenza self-hosted.
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 nella connessione della tua GitHub App e nella configurazione dell’istanza.
Per valutarla, richiedi una licenza demo a tempo dalla pagina Docker License con nome, azienda, email e numero di telefono opzionale; ricevi un file di licenza da scaricare. Il self-hosting significa gestire la tua GitHub App e la tua infrastruttura, ma le garanzie zero-knowledge sono identiche.
Risoluzione dei problemi di configurazione più comuni
- L’installazione fallisce o i permessi sembrano sbagliati. Ti servono diritti di amministratore sul repo o sull’org e, in modalità standard, l’app deve avere accesso anche al repository di destinazione in cui vengono scritte le prove. Un repo di destinazione mancante è la causa più comune di “connesso ma non succede nulla”.
- Nessuna prova dopo 24 ore. Verifica che il repository stia effettivamente ricevendo commit e che l’app non sia stata sospesa da GitHub. Controlla la pagina di stato per eventuali errori prima di segnalare qualcosa — un repo inattivo non produce alcun manifest, il che è il comportamento previsto.
- Il badge viene visualizzato come immagine rotta. Ricopia l’URL del badge dalla pagina del repository connesso. Per i repo privati, l’URL deve includere l’HMAC crittografato; un URL troncato fallirà.
- L’ancoraggio è in ritardo. I tempi dei blocchi Bitcoin variano. Una conferma ritardata viene comunque ancorata — una volta che il blocco esiste, la prova è immutabile. Non serve rieseguire nulla.
- Le prove compaiono in un posto inaspettato. Controlla se il repo è configurato per un branch nello stesso repo o per un repo shadow; cambiare modalità non riscrive le prove storiche.
FAQ
Devo cambiare il mio flusso di lavoro Git per usare Timestamp GIT? No. Una volta installata la GitHub App, rileva automaticamente i nuovi commit e li ancora ogni notte. Gli sviluppatori continuano a usare Git come al solito — nessun nuovo comando o strumento da imparare.
Quali permessi GitHub richiede Timestamp GIT? In modalità standard, l’app richiede accesso in sola lettura ai tuoi repository sorgente (per leggere gli hash dei commit) e accesso in lettura e scrittura a un repository di destinazione in cui vengono memorizzate le prove. La modalità Enterprise ZK inverte questo schema con una GitHub Action che invia solo l’hash del commit dalla tua infrastruttura, così il servizio non richiede alcun accesso in lettura al repository sorgente.
Quanto tempo ci vuole perché un commit venga marcato con timestamp su Bitcoin? Gli hash dei commit vengono raggruppati e ancorati una volta al giorno a mezzanotte. Dopo l’invio del batch alla blockchain Bitcoin tramite OpenTimestamps, la conferma richiede tipicamente circa 3 ore — quindi le prove sono di solito disponibili la mattina successiva.
Posso verificare la prova del timestamp in modo indipendente senza Timestamp GIT?
Sì. Il file di ricevuta .ots e il manifest sono prove OpenTimestamps standard. Puoi verificarli usando qualsiasi strumento compatibile con OpenTimestamps rispetto alla blockchain Bitcoin, garantendo l’indipendenza dal fornitore.
L’installazione è l’intero progetto
Un’installazione della GitHub App, una selezione del repository, una pagina di impostazioni. Dopo di che, la protezione della PI diventa una proprietà di sfondo del tuo repository anziché un compito trimestrale: ogni hash di commit raggruppato ogni notte, ogni batch organizzato in un Merkle root in un blocco Bitcoin, ogni prova riscritta in un branch che controlli e verificabile da chiunque con il file .ots.
Questo è l’intero costo di adozione. Se hai rimandato la protezione del prior art perché sembrava un processo legale con annessa una tassa ingegneristica, inizia oggi con il piano Open Source gratuito su un repo pubblico e guarda la prima prova arrivare domani mattina — inizia qui. Per i team che prima vogliono valutare il panorama degli strumenti, Best Tools to Timestamp Source Code for Auditors confronta le opzioni.
Post correlati
- How to Verify a Bitcoin Timestamp Proof for Your Code
- Prove Prior Art Before You File: A Founder’s Guide
- Best Tools to Timestamp Source Code for Auditors