Estructura de un informe de postura

Un informe de postura no es una lista de problemas: es una lista de evaluaciones. Cada fila responde a una pregunta del estilo «¿este bucket cumple esta comprobación?» y trae su resultado, sea bueno o malo. Por eso un informe de una cuenta pequeña puede tener cientos de filas y solo unas pocas con problema.

Las columnas que se repiten en casi todos los escáneres abiertos son las mismas: la cuenta, el identificador de la comprobación, el servicio, la severidad, el estado, el recurso evaluado, la región y un texto que explica el resultado. Con esas pocas columnas se puede filtrar, contar y cruzar con el inventario.

El estado de una fila toma pocos valores. PASS dice que la comprobación se cumple; FAIL dice que no; y existe un tercero para lo que el escáner no pudo decidir y deja a revisión humana (en esta exportación, MANUAL). Un MANUAL no es un aprobado ni un fallo: es un hueco que alguien debe cerrar.

Aparte del estado hay una marca que dice si una regla de silencio de la organización cubre el hallazgo. Los escáneres abiertos que la ofrecen conservan el estado original y solo ponen la marca; el hallazgo no desaparece, queda silenciado. Abre informe-prod.csv y mira las columnas de estado y de silencio juntas.

Hay un hueco en la exportación: una comprobación cuyo estado no es ni PASS ni FAIL. Su texto explica por qué: al escáner le faltó un permiso de lectura. Quien lee el informe lo reporta aparte, porque un hueco sin explicar se confunde con un recurso sano.

Para dar la cifra de trabajo pendiente se cuentan los fallos que nadie ha decidido silenciar. El total de FAIL mezcla los dos grupos y hace parecer el trabajo mayor de lo que es, o menor si se resta mal. Cuenta con la exportación delante: primero los FAIL, después los que no están silenciados.

La cabecera de la corrida es parte del informe: dice cuándo se hizo, qué regiones cubrió, si fue de solo lectura y con qué identidad. Un escáner de postura debe correr con una identidad de auditoría sin permisos de escritura; si corrió con otra, la lectura del informe empieza por esa pregunta.