GitBook, la piattaforma usata da migliaia di aziende e progetti software per pubblicare documentazione tecnica, ha pubblicato la ricostruzione di una violazione avvenuta il 2 novembre 2026. In poco più di cinque ore un attaccante è passato da una falla nel login SSO all'accesso completo all'infrastruttura di produzione. L'azienda ha spento la piattaforma per circa 16 ore, ha ruotato tutti i segreti e ora tratta come potenzialmente esposti i dati di tutti i clienti, anche se sostiene che il bersaglio fosse uno solo. Il caso non riguarda solo chi usa GitBook: è un esempio da manuale di come un fornitore SaaS diventi parte del perimetro di sicurezza dei suoi clienti.

Cosa è successo

Secondo il post-mortem ufficiale, la catena d'attacco è stata questa:

  • Falla nel flusso SSO: l'attaccante ha sfruttato un difetto nel login single sign-on per creare sessioni che si presentavano come quelle di dipendenti GitBook.
  • GitHub App configurata male: con quelle sessioni ha recuperato i dati di autenticazione di un'integrazione GitHub dell'organizzazione GitBook, ottenendo accesso ai repository di codice interni.
  • Segreto dimenticato nel codice: nei repository ha trovato una chiave API Cloudflare, che gli ha aperto i segreti di produzione.
  • Account di servizio: con quei segreti ha ottenuto l'accesso completo all'infrastruttura.

La cronologia, in ora UTC, è serrata. Alle 12:27 viene dirottato il primo account presso il cliente bersaglio; alle 16:32 l'attaccante ha sessioni da dipendente e accesso al codice; alle 17:48 è in produzione. Il primo allarme interno scatta alle 18:10, la falla SSO viene chiusa alle 19:58 e alle 20:32 GitBook disattiva gli account compromessi e spegne l'applicazione. Il servizio torna pienamente operativo il 3 novembre alle 11:56, dopo la rotazione di tutti i segreti. L'attaccante ha avuto accesso alla produzione per circa 2 ore e 45 minuti la sera del 2 novembre e per altri 40 minuti nelle prime ore del 3.

Il cliente preso di mira, secondo quanto riferito dal responsabile sicurezza di SlowMist, sarebbe Trade.xyz, una piattaforma di trading di cripto-asset; GitBook non lo ha confermato e Trade.xyz dichiara di non aver trovato segni di compromissione nei propri sistemi.

Cosa era raggiungibile: token API GitBook, token e segreti delle integrazioni, chiavi di firma delle sessioni, le domande poste dai visitatori all'assistente AI dei siti di documentazione, i siti con accesso autenticato, i contenuti dei clienti e, soprattutto, le connessioni GitHub e GitLab, con cui l'attaccante poteva agire nei repository a cui i clienti avevano concesso accesso. GitBook afferma che dati di pagamento, password e indirizzi IP non sono stati coinvolti, ma ammette di non poter stabilire se l'attaccante abbia compiuto azioni nei repository dei clienti.

GitBook attribuisce la velocità e la precisione dell'attacco a un'automazione spinta, probabilmente basata su strumenti di intelligenza artificiale, pur senza prove dirette su questo singolo episodio.

Cosa significa per le aziende italiane

Molte software house, startup e uffici IT italiani usano GitBook per la documentazione di prodotto, le API pubbliche o le knowledge base interne, spesso con la sincronizzazione Git attiva verso GitHub o GitLab. È qui che sta il rischio vero. La documentazione in sé raramente è un segreto industriale; i permessi concessi all'app GitBook sui repository, invece, possono esserlo. Un attaccante che agisce come "l'app GitBook" può in teoria aprire pull request, modificare file o leggere codice nei repository autorizzati. Un commit malevolo passato per una modifica alla documentazione è un vettore di attacco alla supply chain del software tutt'altro che teorico.

Il secondo punto è più generale. La catena di GitBook non ha richiesto zero-day sofisticate: una falla di autenticazione, un'integrazione con troppi permessi e una chiave rimasta nel codice. Sono gli stessi tre errori che si trovano in quasi ogni assessment, anche nelle aziende italiane: credenziali a lunga durata, privilegi eccessivi concessi alle integrazioni e segreti nei repository. Vale la pena ricordare che anche il caso Fireworks AI di pochi giorni fa è partito da chiavi API rubate.

Sul piano normativo, per i soggetti NIS2 la sicurezza della catena di approvvigionamento è una delle misure obbligatorie: un fornitore SaaS che ha accesso in scrittura ai repository del codice è un fornitore critico e va trattato come tale, con valutazione del rischio, clausole contrattuali e verifica dei permessi. Sul fronte GDPR, chi usa l'assistente AI di GitBook o siti di documentazione ad accesso autenticato deve chiedersi se le domande dei visitatori o gli account dei lettori contengano dati personali: in quel caso GitBook è un responsabile del trattamento e l'azienda cliente, come titolare, deve valutare il rischio per gli interessati e decidere, documentandolo, se notificare la violazione al Garante entro 72 ore dalla conoscenza dell'evento. Le comunicazioni ricevute da GitBook vanno conservate come prova della data in cui si è venuti a sapere della violazione.

Cosa fare subito

  • Generare nuovi token API GitBook e aggiornare gli script e le applicazioni che li usano: quelli emessi prima dell'incidente sono stati invalidati.
  • Ruotare i segreti degli strumenti di terze parti collegati a GitBook e delle integrazioni pubblicate che usano segreti.
  • Rigenerare la chiave di firma per i siti con accesso autenticato tramite backend personalizzato e aggiornarla sul backend.
  • Riautenticare i server MCP collegati a GitBook, come indicato dal fornitore.
  • Controllare i repository sincronizzati: rivedere commit, pull request e modifiche effettuate dall'app GitBook tra il 2 e il 3 novembre, con particolare attenzione a file diversi dalla documentazione (workflow CI, script, dipendenze).
  • Cercare gli IoC nei propri log (accessi a GitHub, GitLab, VPN e applicazioni): gli indirizzi 94.183.188.91, 45.139.84.195 e 198.251.83.217.
  • Ridurre i permessi dell'app GitBook su GitHub e GitLab ai soli repository di documentazione, preferibilmente separati da quelli del codice.
  • Fare la stessa verifica su tutte le integrazioni SaaS: elencare le app con accesso ai repository, eliminare quelle inutilizzate, attivare la secret scanning e sostituire le chiavi a lunga durata con credenziali a breve scadenza.
  • Valutare l'obbligo di notifica GDPR se nei contenuti o nell'assistente erano presenti dati personali, e aggiornare il registro dei fornitori critici previsto da NIS2.