Documentación del entorno IT: qué debe registrarse y por qué
Lo que no está escrito, no existe. El alcance mínimo de documentación para cualquier empresa.
La documentación del entorno IT es lo primero que se echa en falta cuando ocurre un incidente o cuando se marcha un empleado clave. No es necesario imaginar manuales extensos; lo más importante es que sea breve, precisa y accesible incluso cuando los sistemas no funcionan.
TL;DR — Puntos clave
- Mínimo: esquema de red, lista de sistemas, accesos, copias de seguridad y contactos.
- La documentación debe ser accesible incluso sin una red operativa.
- Cada sistema necesita un runbook corto, no un manual.
- La actualización es parte de cada cambio, no un proyecto independiente.
Qué debe contener
El bloque básico es el inventario: qué servidores y servicios existen, dónde se ejecutan, quién es el propietario y qué sucede si fallan. Le siguen el esquema de red con el plan de direccionamiento, la lista de accesos y permisos, y la descripción de las copias de seguridad con plazos de retención y procedimientos de restauración.
A continuación vienen los runbooks para tareas recurrentes: alta de nuevo empleado, baja de empleado, restauración de archivos, restablecimiento de MFA o actuación ante una caída de la conexión a internet. Cada uno debe ocupar una sola página.
Por qué vale la pena documentar
Su valor se demuestra en el peor momento posible.
- Ante un incidente, el tiempo de resolución se reduce de horas a minutos.
- Al cambiar de partner IT, la transición se realiza sin conjeturas.
- Ante la baja laboral de una persona clave, el trabajo no se detiene.
- Las auditorías y las aseguradoras exigen explícitamente esta documentación.
Cómo empezar — procedimiento recomendado
- Comience con el inventario de sistemas y propietarios, sin detalles técnicos.
- Añada el esquema de red y el plan de direccionamiento.
- Registre el proceso de backup y restauración, junto con la fecha de la última prueba.
- Prepare los cinco runbooks más frecuentes.
- Guarde una copia fuera de la red (impresa o en una bóveda de seguridad separada).
- Actualice el registro con cada cambio; realice una revisión anual.
Alcance mínimo de la documentación
| Documento | Contenido | Actualización |
|---|---|---|
| Inventario de sistemas | Servidores, servicios, propietarios | Con cada cambio |
| Esquema de red | Segmentos, direcciones, equipos | Con cada cambio |
| Registro de accesos | Quién tiene qué, proveedores externos | Trimestral |
| Backup y restauración | Alcance, retención, proceso, prueba | Tras cada prueba |
| Runbooks | Procedimientos frecuentes | Con cada cambio |
| Contactos | Proveedores, operadores, guardias | Anual |
Errores más comunes
El error más frecuente es guardar la documentación exclusivamente en el sistema que deja de estar disponible durante un incidente. Debe existir una copia fuera del entorno que se describe.
El segundo error es el exceso de información. Un documento que nadie actualiza es peor que uno breve que sea exacto.
Cómo ayudamos en VitalIT
En VitalIT preparamos y mantenemos la documentación como parte de nuestro servicio de soporte y mantenimiento IT. Consulte también nuestra sección de consultoría IT.
Relacionado: Auditoría IT anual y Cómo elegir un partner IT (MSP).
Preguntas frecuentes (FAQ)
- ¿Quién debe mantener la documentación?
- Quien ejecute los cambios, bajo la obligación establecida en el procedimiento de gestión de cambios.
- ¿Dónde debe guardarse?
- En un sistema con control de acceso y de versiones, con una copia de seguridad fuera del entorno principal.
- ¿Debe contener las contraseñas?
- No. Las contraseñas deben estar en un gestor de contraseñas; la documentación solo debe incluir una referencia al mismo.
- ¿Cuánto tiempo lleva la preparación?
- Para un entorno pyme típico, entre una y dos semanas para el alcance básico.
- ¿Recibiremos la documentación si finaliza la colaboración?
- Con nosotros sí: toda la documentación es propiedad suya y se le entrega al finalizar la colaboración.