
Documentation informatique : ce qu’il faut consigner avant qu’une personne parte
La documentation informatique est le travail qu’on repousse jusqu’au jour où il est trop tard. Tant que votre informaticien est là, il suffit de lui demander ; le jour où il est malade, en congé ou parti, on découvre ce qui n’existait que dans sa tête. Voici ce qu’elle doit contenir, où la ranger et qui la tient à jour.
Le vrai risque n’est pas la démission mais l’absence que personne n’annonce. Quelqu’un d’autre pourrait-il demain entrer dans le pare-feu, renouveler le domaine et restaurer une sauvegarde ?
Une bonne documentation informatique n’est pas un manuel mais un ensemble fixe d’éléments : schéma réseau, plan d’adressage, droits d’administration, coffre-fort de mots de passe, licences, fournisseurs, sauvegardes et procédures.
Elle n’est pas stockée sur le système qu’elle décrit, elle a un responsable, et elle n’est terminée que lorsqu’une autre personne a réalisé une tâche avec.
Le facteur bus d’un informaticien unique
Le facteur bus, c’est le nombre de personnes qui doivent disparaître pour que quelque chose s’arrête. Dans beaucoup de PME, il vaut exactement un pour l’informatique : un collègue qui sait comment le réseau est monté, où sont les mots de passe d’administration et chez quel registraire le domaine est déposé.
Le moment dangereux est rarement le départ annoncé. Un préavis laisse des semaines pour la passation. Ce qui fait mal, c’est l’absence que personne ne voit venir : un arrêt maladie, un accident, des congés sans réseau le jour où le pare-feu refuse une mise à jour.
La question utile pour la direction ne porte donc pas sur la documentation mais sur aujourd’hui : si notre informaticien est injoignable pendant deux semaines, qui peut récupérer un compte administrateur, renouveler un certificat et restaurer un dossier supprimé ? Si la réponse est « personne » ou « je ne sais pas », la mission est là.
Ce que doit contenir la documentation informatique
La documentation informatique n’a pas besoin d’être un gros classeur. En France on parle souvent de dossier d’exploitation : un ensemble fixe d’éléments, chacun aussi court que possible sans que personne doive deviner.
- Schéma réseau. Quels sites, quelles liaisons, où se trouvent le pare-feu, les commutateurs et les bornes wifi et comment ils sont reliés. Un croquis annoté suffit, à condition qu’il soit juste.
- Plan d’adressage IP. Quelles plages et quels VLAN existent, ce qui a une adresse fixe (imprimantes, serveurs, caméras) et où tourne le DHCP. Sans lui, on reconstitue le plan en regardant les équipements tomber.
- Comptes et droits d’administration. Qui détient quel rôle d’administration dans Microsoft 365, sur le pare-feu, chez le registraire du domaine et dans l’outil de sauvegarde. Y compris les comptes qui n’appartiennent à personne.
- Licences et contrats. Ce que vous utilisez, au nom de qui, la date d’échéance et le préavis. Renvoyez ici à votre inventaire du parc informatique plutôt que d’en tenir une seconde copie.
- Fournisseurs et contacts. Internet, téléphonie, imprimantes, logiciels, maintenance de la salle serveur : qui appeler, avec quel numéro client, et ce que couvre le contrat.
- Configuration des sauvegardes et test de restauration. Ce qui est sauvegardé, à quelle fréquence, vers où, combien de temps c’est conservé, et quand une restauration a eu lieu pour la dernière fois.
- Procédures. Les tâches rares que personne ne connaît par cœur : créer un nouvel arrivant, clôturer un départ, renouveler le domaine, remplacer un certificat, redémarrer après une coupure de courant.
Les mots de passe vont dans un coffre-fort, pas dans Excel
Le tableur de mots de passe est la forme la plus répandue de documentation informatique, et la pire. Quiconque ouvre le fichier a tout, on ne voit pas qui l’a consulté, et la copie sur le bureau de quelqu’un est obsolète depuis des mois.
Un coffre-fort de mots de passe règle trois choses à la fois. On partage par coffre au lieu de tout ou rien, on voit qui a ouvert quoi, et lors d’un départ on retire l’accès sans devoir changer chaque mot de passe le jour même. Le choix du coffre est traité dans notre article sur la gestion des mots de passe et les passkeys.
Deux pièges fréquents. Le premier est le compte administrateur au nom de l’informaticien, avec l’authentification multifacteur sur son téléphone personnel : l’accès part avec le téléphone. Le second est l’absence de compte d’urgence : un compte administrateur rattaché à personne, avec un long mot de passe conservé en lieu sûr à deux endroits, et dont l’utilisation ne passe pas inaperçue.
Une sauvegarde sans test de restauration est une hypothèse
Presque tout le monde sait qu’une sauvegarde tourne. Ce qui est rarement écrit, c’est la partie utile le jour où tout va mal : où se trouve la copie, qui y a accès, et comment récupérer un fichier, une boîte mail ou un serveur entier.
Consignez donc le test de restauration, pas seulement la sauvegarde. La date, ce qui a été restauré, combien de temps cela a pris et ce qui a coincé. Un statut « réussi » dans l’outil de sauvegarde dit que quelque chose a été écrit, pas que cela se relit.
C’est aussi ce que demandent les référentiels. NIS2 cite la gestion des sauvegardes et la gestion des actifs parmi ses mesures, et l’ISO/IEC 27001 attend des procédures d’exploitation documentées. Le guide d’hygiène informatique de l’ANSSI va dans le même sens. Ce que vous consignez pour vous-même, vous l’avez aussi pour l’auditeur.
Où la ranger : pas sur le système qu’elle décrit
L’erreur la plus courante est aussi la plus logique : la documentation est sur le serveur de fichiers, ou dans SharePoint. Jusqu’au jour où le serveur est chiffré ou le compte Microsoft 365 ne s’ouvre plus. Le guide de reprise se trouve alors derrière ce qu’il faut reprendre.
- Gardez une copie hors de l’environnement lui-même, par exemple dans le coffre-fort de mots de passe, qui fonctionne comme un service distinct de vos systèmes, ou chez un tiers.
- Veillez à ce qu’au moins deux personnes y aient accès, dont une qui n’est pas l’informaticien. Souvent quelqu’un de la direction, qui n’a pas besoin de la comprendre mais doit pouvoir l’ouvrir.
- Conservez l’essentiel aussi hors ligne : le compte d’urgence, le numéro du support du fournisseur d’accès, les étapes pour ouvrir le coffre lui-même. Une enveloppe dans un coffre est démodée, et elle fonctionne.
Qui la tient à jour, et comment savoir qu’elle est juste
Une documentation écrite une fois est dépassée en moins d’un an. Ce qui marche n’est pas un grand ménage mais une habitude : une modification n’est terminée que lorsque la documentation est mise à jour. Nouveau commutateur, nouveau fournisseur, nouveau compte administrateur : le ticket ne se ferme que lorsque c’est dans le plan.
Donnez-lui un responsable. C’est généralement l’informaticien, mais la direction doit le savoir et demander une fois par trimestre quand elle a été vérifiée pour la dernière fois.
Le vrai test, c’est de s’en servir, pas de la lire. Demandez à une autre personne d’exécuter une procédure avec la seule documentation en main : créer un utilisateur, restaurer un fichier. Là où elle bloque, il manque une ligne. Un exercice de ce type par an en dit plus qu’un document qui a l’air complet.
Dans les semaines qui précèdent un départ
Quand la personne qui portait l’informatique s’en va, le préavis est la dernière occasion de mettre sur papier ce qu’elle a en tête. Consacrez ces semaines à la passation, pas à boucler des projets.
- Faites faire le successeur pendant que le partant observe, et pas l’inverse. Ce que le partant montre paraît clair ; ce que le successeur doit faire seul révèle ce qui manque.
- Transférez chaque compte à son nom : le registraire, les portails fournisseurs, les comptes des magasins d’applications, l’authentification multifacteur. C’est distinct de la clôture de son propre compte, qui vient ensuite.
- Demandez ce qui n’est écrit nulle part : la tâche annuelle, l’imprimante qui ne marche qu’après redémarrage, le fournisseur qu’il faut appeler plutôt qu’écrire.
S’il n’y a personne à qui transmettre, c’est le moment de décider si le savoir repose de nouveau sur un seul nouveau collègue, ou sur une équipe.
Là où notre travail s’arrête
Ce que nous faisons. Pour un environnement que nous gérons, nous rédigeons et tenons à jour la documentation informatique dans le cadre du travail : schéma réseau, plan d’adressage, droits, fournisseurs, sauvegardes et procédures. Quand nous reprenons un environnement, nous commençons par cartographier l’existant, et le facteur bus devient alors une équipe plutôt qu’une personne.
La documentation et le coffre-fort sont à vous, pas à nous. Ils sont dans votre environnement ou dans un coffre dont vous êtes titulaire, avec un accès pour quelqu’un de votre propre organisation. Un prestataire qui est le seul à détenir les mots de passe, c’est le facteur bus d’un sous un autre habit.
Ce que nous ne faisons pas. Nous ne rédigeons pas de processus métier hors informatique ni de manuel qualité pour toute l’organisation. Nous n’analysons pas les contrats sur le plan juridique : nous consignons ce qui court et quand cela prend fin, mais la portée d’une clause relève d’un juriste. Et nous ne certifions personne : la conformité d’une documentation à l’ISO/IEC 27001 est décidée par l’organisme certificateur.
Ce qu’on nous demande à ce sujet
Les cinq questions qui reviennent le plus.
Que doit contenir la documentation informatique d’une entreprise ?
Au minimum un schéma réseau, un plan d’adressage IP, la liste des comptes et droits d’administration, un coffre-fort de mots de passe, les licences et contrats avec leur échéance, les fournisseurs et leurs contacts, la configuration des sauvegardes avec le dernier test de restauration, et les procédures des tâches rares. Elle peut être courte, tant que personne ne doit deviner.
Quelle est la différence avec un dossier d’exploitation ?
Il n’y en a guère : le dossier d’exploitation est le nom qu’on donne souvent en France à cette documentation, centré sur ce qu’il faut pour faire tourner et reprendre le système au quotidien. L’essentiel est le même : ce qui existe, qui y a accès, comment le restaurer et comment exécuter les tâches rares.
Où ranger la documentation informatique ?
Pas sur le système qu’elle décrit. Si le guide de reprise est sur le serveur de fichiers qui vient d’être chiffré, il ne sert à rien. Gardez une copie hors de votre propre environnement, assurez-vous que deux personnes y ont accès, et conservez hors ligne le compte d’urgence et les étapes pour ouvrir le coffre.
À quelle fréquence mettre à jour la documentation informatique ?
À chaque modification, comme partie intégrante de cette modification, avec en plus une courte vérification chaque trimestre. Le meilleur test consiste, une fois par an, à faire exécuter une procédure par quelqu’un d’autre avec la seule documentation.
Rédigez-vous notre documentation, et à qui appartient-elle ?
Pour un environnement que nous gérons, nous la rédigeons et la tenons à jour. Elle reste à vous : elle est dans votre environnement ou dans un coffre dont vous êtes titulaire. Nous ne rédigeons pas de processus métier hors informatique, n’analysons pas les contrats juridiquement et ne certifions personne.
Où cela s’inscrit dans notre travail
Les éléments qui se retrouvent dans votre documentation.
Regardons ensemble votre facteur bus ?
Dites-nous comment votre informatique est organisée aujourd’hui et qui sait quoi. Nous vous montrons quelles parties de la documentation existent, lesquelles manquent, et ce qui passe en premier si votre seul informaticien est injoignable demain.
Des connaissances informatiques concrètes dans votre boîte mail
De nouveaux guides sur la gestion, la sécurité et le poste de travail, écrits par ceux qui font le travail. Sans discours commercial, et la désinscription se fait en un clic.