Établir et mettre à jour la documentation technique du réseau¶
1. Objectif du cours¶
Comprendre l'importance, le contenu et la structuration d'une documentation technique de réseau en entreprise. Savoir rédiger, versionner, réviser et valider cette documentation pour faciliter la maintenance, la sécurité et l'évolution des infrastructures.
2. Notions et définitions essentielles¶
- Documentation technique : ensemble d'informations logistiques, organisationnelles, techniques et fonctionnelles décrivant un projet ou une infrastructure.
- Réseau (contexte informatique) : ensemble d'appareils liés entre eux (ordinateurs, switchs, routeurs, points d'accès WiFi, serveurs, etc.).
- Plan d'adressage IP : schéma indiquant la répartition des adresses, masques et plages DHCP pour situer les machines dans le réseau.
- Registre de modifications / Versionning : suivi des versions indiquant qui a modifié la documentation, quand et quelle a été la nature du changement.
- ITIL / ISO / AFNOR : cadres et normes cités comme références pour structurer et qualifi er la documentation.
3. Fonctionnement et principes¶
La documentation sert à rendre compréhensible l'architecture et faciliter intervention, maintenance et montée en charge. Elle doit représenter visuellement la topologie (schéma d'architecture), inventorier chaque équipement (marque, modèle, numéro de série, emplacement), décrire configurations réseau (VLAN, routage, tables), lister politiques et procédures (sécurité, sauvegarde, restauration) et préciser les modes de connexion (VPN, WLAN, liaisons Internet/Intranet). Un registre de modifications historise évolutions et validations. La documentation doit être logique, claire, organisée, facilement navigable, versionnée et stockée dans un emplacement sécurisé.
4. Commandes et manipulations¶
Non abordé dans ce cours
5. Sécurité et bonnes pratiques¶
- Stocker la documentation dans un accès spécifique et sécurisé pour éviter qu'elle ne tombe entre de mauvaises mains.
- Mettre en place un registre de modifications : version, éditeur, date de rédaction, date de validation, validateur, type de mise à jour (mineure, majeure, réécriture complète), impacts.
- Prévoir révisions périodiques (ex. semestrielles) pour auditorier la documentation par rapport à l'existant.
- Validation par un profil confirmé : responsabilité du validateur historisée.
- Inclure procédures et politiques de sécurité (pare-feu, antivirus global, IDS, IPS, SOC) et gestion des contrôles d'accès / mots de passe (politique de changement automatisé mentionnée).
- Se référer, si pertinent, aux normes ISO (27001 pour la sécurité de l'information, 9001 qualité, 20000 gestion des services) et au cadre ITIL pour les bonnes pratiques.
6. Points essentiels à retenir pour le TSSR¶
- Un bon schéma d'architecture permet d'identifier rapidement topologie, sous-réseaux et interconnexions.
- L'inventaire des équipements doit être exhaustif et inclure marque, modèle, numéro de série et emplacement.
- Le plan d'adressage IP et la liste des VLANs permettent de vérifier si une machine est à sa place sur le réseau.
- Les politiques et procédures (sécurité, sauvegarde, restauration, maintenance) doivent être documentées et accessibles.
- Le registre de modifications (versionning) est indispensable pour tracer qui a modifié quoi et quand.
- La documentation doit être régulièrement révisée et validée par un profil compétent (périodicité recommandée : semestrielle).
- Stocker la documentation sur un espace sécurisé (drive/SharePoint/Confluence/Notion) facilite collaboration et gestion des versions.
- Inclure contacts d'urgence et manuels d'urgence pour actions en cas de crise.
7. Tableau récapitulatif¶
| Élément | Objectif principal | Contenu clé | Exemples cités |
|---|---|---|---|
| Schéma d'architecture | Visualiser topologie | Diagrammes, légendes, choix de topologie | Topologie, sous-réseaux |
| Inventaire équipements | Identifier matériel | Marque, modèle, n° de série, emplacement | Routeurs, switchs, imprimantes |
| Plan d'adressage IP | Localiser machines | Plages DHCP, masques, IP statiques | VLANs, assignation IP |
| Registre de modifications | Tracer évolutions | Version, éditeur, validateur, type mise à jour | Mineure / Majeure / Réécriture |
| Stockage & outils | Collaboration / sécurité | Word/PDF sur drive ou plateformes collaboratives | Notion, Confluence, SharePoint |
8. Vérifications pratiques¶
- Vérifier que le schéma d'architecture correspond à la topologie réelle (positions et interconnexions visibles).
- Contrôler dans l'inventaire que chaque équipement a sa marque, modèle et numéro de série renseignés.
- Confirmer via le plan d'adressage que l'IP d'une machine appartient à la plage attendue et au VLAN correct.
- Consulter le registre de modifications pour voir la dernière version, l'éditeur et la validation effectuée.
- Vérifier la présence et l'exactitude des procédures d'urgence et des contacts listés.
- Croiser documentation des configurations (tables de routage, VPN, WLAN) avec les configurations en production pour détecter divergences.
9. Flashcards Anki¶
Qu'est-ce que la documentation technique :: Ensemble d'informations logistiques, organisationnelles, techniques et fonctionnelles décrivant une infrastructure.
Que contient un schéma de l'Architecture Réseau :: Diagrammes de topologie, explication du choix de topologie et légendes.
Quels éléments doit contenir l'inventaire des équipements :: Marque, modèle, numéro de série et positionnement.
Qu'est-ce qu'un plan d'adressage IP :: Structure d'adressage avec masques, plages DHCP et assignations IP.
Que doit contenir le registre de modifications :: Version, éditeur, date de rédaction, date de validation, validateur, type de mise à jour.
Citer trois types de politiques de sécurité mentionnées :: Pare-feu, IDS, IPS (également SOC et antivirus global).
Quel est l'objectif d'une révision périodique de la documentation :: S'assurer que la documentation est conforme à l'état réel de l'infrastructure.
Où stocker la documentation pour la sécuriser :: Dans un accès spécifique et sécurisé (drive, SharePoint, etc.).
Nommer deux outils collaboratifs cités pour créer la documentation :: Notion et Confluence.
Quelle norme ISO est orientée vers la sécurité de l'information :: ISO 27001.