Capítulo 48 — Expediente de evidencia

Mapa de la lección

Lección 48 publicada. Mapa, ejemplo, EX095.

flowchart TD
  N0["Resultados de aprendizaje y conexión"]
  N1["48.1 Qué es el expediente"]
  N2["48.2 Procedencia"]
  N3["48.3 Sensibilidad"]
  N4["48.4 Comprobación de coherencia"]
  N5["48.6 Actividad práctica"]
  N6["Síntesis del capítulo"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6
  N6 --> EX["Ejemplo resuelto"]
  EX --> Q["Ejercicio EX095"]

Dibujo lógico

flowchart LR
  N0["Resultados de aprendizaje y conexión"]
  N1["48.1 Qué es el expediente"]
  N2["48.2 Procedencia"]
  N3["48.3 Sensibilidad"]
  N4["48.4 Comprobación de coherencia"]
  N5["48.6 Actividad práctica"]
  N6["Síntesis del capítulo"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> Q["EX095"]

[Resultados de aprendizaje y conexión]
    |
    v
[48.1 Qué es el expediente]
    |
    v
[48.2 Procedencia]
    |
    v
[48.3 Sensibilidad]
    |
    v
[48.4 Comprobación de coherencia]
    |
    v
[48.6 Actividad práctica]
    |
    v
[Síntesis del capítulo]
    |
    v
[Ejemplo resuelto] --> [Ejercicio EX095]

Resultados de aprendizaje y conexión

Al terminar este capítulo, usted podrá (1) reunir un expediente de evidencia de ingeniería que respalde las afirmaciones del proyecto final; (2) organizar la evidencia por afirmación con su procedencia; (3) proteger la evidencia sensible manteniéndola revisable; y (4) comprobar la coherencia del expediente antes de su entrega. Reúne los capítulos 44–47 y prepara la tesis de ingeniería.

48.1 Qué es el expediente

El expediente de evidencia es el conjunto de artefactos que respalda el caso de aseguramiento: los requisitos y la trazabilidad; los documentos de diseño y los registros de decisiones; los análisis (modelos de amenazas, árboles de fallos, rendimiento, fiabilidad); los registros de implementación (revisión del código fuente, SBOM, procedencia de la compilación); los resultados de la verificación y la validación; los hallazgos de la revisión y las respuestas; los informes de los ensayos; los documentos operativos; y el registro de riesgos residuales con sus responsables. Organícelo por afirmación, no por fecha: un revisor debería poder partir de una afirmación y encontrar su evidencia en dos clics.

Para el TMRP, las afirmaciones del expediente son C1 a C4.

48.2 Procedencia

Cada elemento de evidencia indica qué es, quién lo produjo, cuándo, a partir de qué versión del sistema y con qué herramientas. Las cifras de la tesis deben poder trazarse hasta un archivo de resultados (compárese con la comprobación de procedencia del libro de maestría, en su capítulo 7). Use hashes de contenido para los archivos de resultados y regístrelos en un índice, como hace con los registros la cadena de hashes del capítulo 13. Para el TMRP, cada entrada del índice del expediente lleva una versión, como la versión publicada de la pasarela o la fecha del ensayo, y los primeros caracteres de su hash.

48.3 Sensibilidad

Los expedientes sobre infraestructuras contienen detalles sensibles. Mantenga una versión completa restringida para los revisores autorizados y una versión censurada para públicos más amplios, y registre qué se censuró y por qué. En los trabajos del curso con casos sintéticos la sensibilidad es menor, pero practique la disciplina. Para el TMRP, la versión restringida incluiría las configuraciones de las pasarelas y los procedimientos de gestión de claves, mientras que la versión censurada describe la arquitectura al nivel de zonas y conductos. El registro de censura enumera cada elemento eliminado y el motivo, de modo que un revisor de la versión censurada sabe qué se ha retenido y puede solicitar acceso por la vía adecuada.

48.4 Comprobación de coherencia

Antes de la entrega: cada afirmación tiene evidencia; cada cifra de la tesis coincide con su fuente; los estados concuerdan entre documentos (nada de «superada» en uno y «fallida» en otro, como en el hallazgo F1 del capítulo 45); los riesgos residuales tienen responsable; y todos los hallazgos de la revisión están cerrados o tienen un tratamiento decidido. El expediente del TMRP no superó esta comprobación una vez, cuando C2 citaba T3 como superada mientras la matriz aún la mostraba como fallida. La corrección consistió en registrar la repetición de la prueba en v2 como T3b y actualizar todos los documentos que se referían a ella, de modo que el índice muestra ahora el mismo estado en todas partes.

48.5 Ejemplo resuelto: extracto del índice del expediente (sintético)

Tabla de la lección; desplázate para ver todas las columnas →

(Los hashes son marcadores ilustrativos para el caso sintético).

48.6 Actividad práctica

Construya el índice de su expediente con hashes de contenido reales de sus archivos de resultados (hashlib.sha256) y ejecute la comprobación de coherencia del §48.4. Use el script del EX095 para calcular los hashes y guarde el índice bajo control de versiones para que su historial forme parte de la evidencia. Después, ejecute la comprobación de coherencia frente al borrador de su tesis. Cada cifra del borrador debe aparecer en un archivo de resultados incluido en el índice, y cada estado debe coincidir. Corrija primero cualquier discrepancia en el documento fuente y, después, vuelva a generar el índice.

48.7 Errores comunes y límites

• Expedientes organizados por fecha o por autor en lugar de por afirmación.
• Cifras de la tesis sin archivo fuente.
• Incoherencias de estado entre documentos.
• Censura sin registro.

El índice del TMRP evita el primer error organizando la evidencia por afirmación, y su registro de C3 como no cumplido impide que aparezca el tercero. Un registro de censura acompaña a la versión compartida. Cada cifra de la tesis se traza hasta un archivo de resultados incluido en el índice, y la versión compartida lleva un registro de lo que se censuró y por qué.

Ejercicios — capítulo 48

EX095 — Script de índice. Objetivo: automatizar la procedencia. Entradas: una carpeta de resultados. Pasos: escriba un script con la biblioteca estándar que recorra la carpeta, calcule el SHA-256 de cada archivo y escriba un índice CSV con la ruta, el tamaño, el hash y la hora de modificación; explique por qué la hora de modificación es una evidencia débil. Evidencia esperada: script y explicación. Rúbrica: 3 = script que funciona, explicación (la mtime se cambia fácilmente; el hash junto con un commit del control de versiones es más sólido); 2 = sin explicación; 1 = no funciona; 0 = nada.

EX096 — Auditoría de coherencia. Objetivo: detectar incoherencias. Entradas: el extracto del §48.5 y una frase del resumen: «Todos los requisitos se verificaron y el sistema restablece la operación remota en menos de 8 horas». Pasos: identifique la incoherencia y reescriba la frase. Evidencia esperada: reescritura. Rúbrica: 3 = identifica la contradicción con C3, reescritura precisa y aún positiva donde está justificado; 2 = reescritura vaga; 1 = no la detecta; 0 = nada.

Síntesis del capítulo

El expediente es el conjunto de evidencia, organizado por afirmación y con su procedencia trazada, que sustenta el caso de aseguramiento. Mantenga versiones restringida y censurada con un registro de censura, y compruebe la coherencia de cada afirmación, cifra y estado antes de que lo haga cualquier otra persona.