Passa al contenuto principale

Tag: Software IT

Documentazione IT per MSP: la checklist delle 10 informazioni minime da registrare per ogni cliente

Un collega è assente e il cliente che segue ha il gestionale bloccato. Tocca a te.

Non conosci quella infrastruttura. Non sai chi autorizza l’intervento, quale accesso usare, se quel servizio rientra davvero nel vostro contratto. La documentazione forse esiste, ma leggerla tutta mentre il cliente è fermo non è un’opzione.

È qui che una checklist può cambiare il risultato. In questo caso non sostituisce la documentazione IT di un MSP: ne definisce le priorità e l’ordine di lettura. Ti suggerisce quali dieci informazioni devono esserci per ogni cliente e in quale sequenza servono quando intervieni a freddo, senza doverle prima tirare fuori tutte per poi capire come muoverti.

Vale per gli MSP, che moltiplicano questo problema per decine di clienti. Ma vale anche per un ufficio IT interno, per uno studio tecnico, per chiunque gestisca infrastrutture che qualcun altro potrebbe dover toccare.

Documentazione IT

La checklist: le 10 informazioni minime da documentare

1. Referenti, sedi e perimetro dell’assistenza

Documenta: le sedi gestite e i loro indirizzi; il referente operativo del cliente; chi può autorizzare interventi e spese; il contatto da coinvolgere in emergenza; quali sistemi e attività sono affidati al tuo MSP e quali restano al cliente o ad altri fornitori.

Verifica pratica: se si blocca il gestionale, un collega sa chi contattare, chi autorizza l’intervento e se deve occuparsene direttamente oppure coinvolgere un altro fornitore?

2. Servizi critici e dipendenze

Documenta: i servizi essenziali per il lavoro del cliente, chi li utilizza, quali sistemi li sostengono e quale impatto avrebbe la loro indisponibilità. Annota le priorità di ripristino concordate con il cliente.

Parti dai servizi aziendali, non dall’elenco dei dispositivi. “Gestione degli ordini” è il servizio; applicazione, database e collegamento tra sedi sono alcuni degli elementi necessari al suo funzionamento. Non tutti sono operati direttamente dall’MSP, ma conoscerli dà cognizione di causa sull’organismo aziendale in cui stai intervenendo.

Verifica pratica: scegli un servizio importante. Dalla documentazione riesci a capire quali sistemi coinvolge e quale attività aziendale si interrompe quando non è disponibile?

3. Accessi amministrativi e modalità di autenticazione

Documenta: come si accede ai sistemi, quali account sono autorizzati, quali privilegi possiedono, gli eventuali passaggi per l’accesso remoto, la gestione dell’autenticazione a più fattori e le procedure autorizzate di recupero dell’accesso. Includi gli account utilizzati da applicazioni e processi, non soltanto quelli delle persone.

Verifica pratica: in assenza del tecnico abituale, un altro tecnico autorizzato sa quale accesso utilizzare e come completare l’autenticazione, senza dover chiedere credenziali tramite messaggi o email?

4. Backup e procedure di ripristino

Documenta: che cosa viene copiato e che cosa resta escluso; frequenza dei backup; durata della conservazione; destinazione e protezione delle copie; chi controlla gli esiti; istruzioni e accessi necessari al ripristino.

Riporta anche data, ambito ed esito dell’ultima prova di ripristino. Per i servizi critici, annota gli obiettivi concordati con il cliente.

Verifica pratica: scegli un sistema. Sai indicare quali dati sono recuperabili, con quale procedura e con quale frequenza vengono copiati?

5. Inventario degli asset

Documenta: dispositivi, sistemi virtuali e software rilevanti, cominciando da quelli che sostengono i servizi critici. Per ciascun elemento registra almeno identificativo, funzione, sede di appartenenza, modello o versione quando pertinente, e i collegamenti alle informazioni correlate. Aggiungi i riferimenti a supporto e garanzia dove necessari.

Non limitarti ai dispositivi fisicamente presenti negli uffici: considera anche gli elementi gestiti in ambienti remoti e cloud. L’inventario degli asset informativi è del resto uno dei controlli espliciti della ISO/IEC 27001:2022, quindi è un punto che un audit ti chiederà comunque.

Verifica pratica: apri una scheda dell’inventario. Un collega capisce che cosa sia quell’elemento, a che cosa serva e dove trovare accessi, documentazione e informazioni sul backup?

6. Rete e connettività

Documenta: collegamenti Internet e fornitori; apparati principali; reti e segmenti utilizzati; Wi-Fi aziendale e ospiti; collegamenti tra sedi; accessi remoti; eventuali connessioni di riserva.

Prepara uno schema essenziale della rete, con nomi e riferimenti coerenti con l’inventario. L’obiettivo iniziale non è disegnare ogni cavo, ma permettere a un altro tecnico di orientarsi.

Verifica pratica: partendo da una sede, riesci a capire come raggiunge Internet, come comunica con le altre sedi e quali apparati o collegamenti sono coinvolti?

7. Gestione degli utenti e degli ambienti virtuali

Documenta: dove vengono gestiti utenti, gruppi e autorizzazioni; quali ambienti ospitano posta, file condivisi e applicazioni cloud; a quale organizzazione appartengono; chi li amministra e quali deleghe sono assegnate ai fornitori.

Questo punto riguarda l’organizzazione delle identità e dei servizi. Il punto 3 riguarda invece le modalità per accedervi: sono due cose diverse e vanno documentate separatamente.

Verifica pratica: quando entra o esce un dipendente, un collega sa quali ambienti controllare, chi deve autorizzare le modifiche e quale procedura seguire?

8. Domini, DNS e certificati

Documenta: domini utilizzati, intestatario, fornitore di registrazione, soggetto che gestisce i DNS, servizi collegati, certificati rilevanti, scadenze e responsabilità dei rinnovi. Indica anche come avviene il rinnovo e chi verifica che sia stato completato.

Verifica pratica: scegli un dominio del cliente. Sai chi lo controlla, dove vengono gestiti i DNS, quali servizi ne dipendono e chi deve occuparsi del rinnovo?

9. Licenze, contratti e assistenza dei fornitori

Documenta: licenze e abbonamenti attivi, quantità e assegnazioni quando pertinenti, intestatari, rinnovi, garanzie e coperture di assistenza. Conserva il riferimento ai contratti e le istruzioni per aprire una richiesta ai fornitori.

Metti in evidenza ciò che serve al tecnico: contatto, canale di assistenza, identificativo del contratto o del prodotto e condizioni rilevanti per l’intervento. Non occorre ricopiare tutti i documenti amministrativi: può bastare un collegamento alla fonte corretta, accompagnato dai dati operativi essenziali.

Verifica pratica: se un apparato si guasta, un collega riesce a verificare la copertura e ad aprire una richiesta senza cercare nelle vecchie email?

10. Procedure operative, eccezioni e problemi noti

Documenta: le istruzioni per le attività ricorrenti e gli interventi critici, con prerequisiti, autorizzazioni, passaggi da eseguire e verifiche finali. Registra anche le particolarità del cliente e i problemi conosciuti.

Parti dalle attività che richiedono più spesso il coinvolgimento del tecnico abituale: attivazione e disattivazione utenti, interventi ricorrenti, ripristini, gestione di un servizio specifico.

Verifica pratica: un collega con le competenze necessarie riesce a seguire la procedura senza dover chiedere i passaggi mancanti a chi l’ha scritta?

Come usare la checklist per trovare cosa hai lasciato indietro

Per individuare le lacune nella documentazione di un cliente, attraversa i dieci punti e segna ciascuno come completo, parziale o assente, usando la verifica pratica e non la sensazione. Poi parti dai punti assenti che riguardano i servizi critici: sono quelli che generano fermo macchina e dipendenza da una singola persona.

Il valore di questa checklist non sta nel compilarla sui clienti nuovi. Sta nell’usarla sui clienti che segui da cinque anni, dove la documentazione si è stratificata e nessuno sa più cosa manca davvero.

Un metodo rapido, un cliente alla volta:

Stato del puntoChe cosa significaPriorità
CompletoLa verifica pratica ha risposta affermativa, senza chiedere nulla a nessunoTenere aggiornato
ParzialeL’informazione esiste ma è sparsa, obsoleta o incompletaConsolidare
AssenteVive nella memoria di un tecnico o dentro un’emailIntervento immediato se tocca un servizio critico

Due segnali rivelano quasi sempre una lacuna: devi chiamare un collega per procedere, oppure apri più di tre strumenti diversi per ricostruire una sola informazione. Il secondo è il motivo per cui la frammentazione tra fogli Excel, note personali e password manager separati costa più del tempo che sembra far risparmiare.

Completare la checklist è il primo passo. Mantenerla aggiornata è il lavoro vero

Una checklist compilata una volta ha una data di scadenza breve. I clienti cambiano sede, i servizi migrano, i tecnici ruotano, le licenze scadono. Una documentazione che non viene aggiornata torna a essere quello che era prima: un file in una cartella che nessuno apre.

La differenza non la fa il modello con cui raccogli le informazioni, ma il sistema in cui vivono dopo. Un sistema in cui un asset è collegato alle sue credenziali, una credenziale al servizio che protegge, un servizio alla sede e al contratto che lo copre, così che aggiornare un dato non significhi aggiornarlo in cinque posti diversi.

Docugarden è il software di documentazione IT europeo nato per questo: sviluppato dall’esperienza diretta di chi lavora come MSP, tiene insieme asset, password, scadenze, procedure e relazioni tra elementi in un unico ambiente, con dati su server europei, conformità nativa al GDPR e nessun vincolo contrattuale pluriennale. La documentazione tecnica non è un archivio da abbandonare in una cartella: è un giardino, e va curata perché continui a dare frutti.

👉 Richiedi una demo di Docugarden e scopri come mantenere aggiornate queste informazioni senza rincorrerle in cinque strumenti diversi.

FAQ

Che cosa si intende per documentazione IT di un cliente?

È l’insieme strutturato delle informazioni necessarie per gestire l’infrastruttura di quel cliente: referenti e perimetro del servizio, servizi critici, accessi, backup, asset, rete, identità, domini, licenze e procedure operative. Si distingue da un semplice archivio di file perché le informazioni sono collegate tra loro e mantenute aggiornate.

Quante informazioni servono come minimo per ogni cliente IT?

Dieci aree sono il minimo operativo: referenti e perimetro, servizi critici, accessi amministrativi, backup e ripristino, inventario asset, rete, gestione utenti, domini e certificati, licenze e contratti, procedure operative. Il criterio di completezza non è la quantità di campi compilati, ma la capacità di un tecnico esterno di operare senza chiedere informazioni a nessuno.

Un foglio Excel è sufficiente per documentare i clienti IT?

Per iniziare può funzionare come raccolta, ma mostra i suoi limiti rapidamente: nessuna tracciabilità delle modifiche, nessun controllo su chi vede cosa, nessun collegamento tra asset, credenziali e servizi, e un rischio concreto sul fronte della protezione dei dati quando contiene credenziali. Oltre i primi clienti, il tempo perso a tenerlo allineato supera il costo di un software di documentazione IT dedicato.

Da sogni universitari a Docugarden: la nascita di un software di documentazione IT

A volte le idee nascono nel modo meno serio possibile.

Durante una festa tra amici, in una pausa caffè tra una lezione universitaria e l’altra, in una notte passata a ragionare su progetti improbabili o durante un hackathon affrontato con solo un paio di ore di sonno. Sono momenti in cui battute, nomi inventati e sogni campati per aria sembrano destinati a durare pochi minuti, fugaci e impalpabili.

Eppure, a volte, alcune idee restano.

Restano sospese nel tempo, quasi senza che ce ne accorgiamo. Poi, anni dopo, tornano con una forma diversa. Sotto l’ironia e l’incoscienza della gioventù può nascondersi qualcosa di più serio: il desiderio di costruire qualcosa insieme.

La storia di Docugarden nasce proprio in questo modo.

Gli anni universitari a Cesena

Alcuni di noi si conoscevano già da prima, ma il vero punto d’incontro è stato il periodo universitario a Cesena. Sono stati anni di formazione, esperimenti, discussioni tecniche, amicizie, hackathon e progetti immaginati più o meno seriamente. In quel contesto era nata anche una battuta ricorrente: la “Maltosoft”, l’azienda che, scherzando, avremmo dovuto fondare insieme prendendo ispirazione dal nome di uno dei founder.

Era un gioco, certo. Ma era già un piccolo segnale per noi e per il nostro futuro.

Poi ognuno ha seguito la propria strada. Abbiamo costruito esperienze diverse, carriere diverse, nuove competenze e relazioni professionali. La costante, però, è sempre rimasta la nostra amicizia, che ha continuato a resistere negli anni, anche quando le nostre vite ci portavano in direzioni diverse.

Quando un’idea torna con una forma concreta

Poi, come spesso accade, arriva un momento in cui le cose cambiano.

Cambiano le priorità, cambiano le prospettive, cambia il modo in cui si guarda al lavoro e al futuro. In quel momento l’idea di fare qualcosa insieme è riemersa. Questa volta, però, non era più una battuta fatta nei corridoi dell’università o davanti a una birra. Era una possibilità concreta.

Da lì è iniziato un percorso molto diverso da quello immaginato anni prima.

Non siamo partiti con l’idea generica di “fondare una startup” solo per il gusto di farlo. Siamo partiti da un problema reale che, in modi diversi, avevamo percepito nel corso delle nostre personali esperienze: il modo in cui molte aziende, MSP, consulenti IT e team tecnici gestiscono ancora oggi la documentazione informatica, le procedure, le infrastrutture, le relazioni tra asset, credenziali, sedi, servizi e responsabilità operative.

È un tema spesso sottovalutato, ma centrale per chi vuole affrontare un futuro tecnologico sempre più complesso.

Chi lavora nell’IT lo sa bene: la documentazione non è solo un archivio. È memoria operativa, continuità aziendale, sicurezza e capacità di reagire ai problemi. Da questi elementi dipende anche la possibilità di far crescere un’organizzazione senza perderne il controllo.

E poi arrivano i nostri

Docugarden nasce proprio per affrontare queste problematiche con un approccio strutturato.

Vogliamo costruire un software di documentazione IT pensato per organizzare, collegare e rendere davvero utilizzabile la conoscenza tecnica delle aziende, uno strumento progettato per chi lavora ogni giorno su infrastrutture complesse, numerosi clienti e reti distribuite, spesso immerso in procedure intricate ed informazioni sensibili.

E’ necessario un unico luogo dove centralizzare la conoscenza tecnica in modo da renderla più accessibile e gestirla in modo sicuro e controllato.

Docugarden è un prodotto europeo, concreto ed orientato alla sovranità del dato, nato con l’obiettivo di rispondere alle esigenze reali del nostro mercato.

Una scelta personale e imprenditoriale

Per arrivare a questo obiettivo abbiamo lasciato lavori, cambiato traiettorie di vita e deciso di investire tempo, energie e competenze in un progetto davvero nostro. Non è stata una decisione presa alla leggera, ma una scelta maturata dopo molte riflessioni, dubbi, confronti in famiglia ed analisi del mercato.

Non siamo più gli stessi ragazzi che scherzavano sulla Maltosoft durante gli anni universitari. Abbiamo più esperienza, più consapevolezza, più disciplina e una visione molto più concreta del nostro obiettivo.

Ma una cosa è rimasta uguale: la voglia di creare qualcosa di nostro.

Docugarden è il punto in cui una storia personale, un’amicizia profonda, un insieme di competenze tecniche e una visione imprenditoriale si incontrano. È il risultato di tante idee lasciate in sospeso, oggi sbocciate in un progetto costruito con metodo, responsabilità ed ambizione.

Siamo consapevoli che il mercato tech europeo è in continua evoluzione e con esigenze complesse.

Sappiamo anche che questa sarà una sfida complessa.

Ma noi siamo pronti ad affrontarla.

Docugarden nasce da alcune battute tra amici.

Oggi quelle stesse battute e sogni sono diventati il nostro modo di costruire il futuro che vogliamo.

Segui il percorso di Docugarden

Questo è solo il primo passo del nostro percorso. Nei prossimi mesi racconteremo più da vicino il prodotto, le scelte che ci stanno guidando e il modo in cui vogliamo contribuire a rendere la documentazione IT più chiara, sicura e utile per aziende, MSP e team tecnici.

Se anche per te la documentazione IT non dovrebbe essere un insieme disperso di file, fogli di calcolo e appunti difficili da mantenere, continua a seguirci: Docugarden nasce proprio per affrontare questo problema.