ENS (2022) – Catálogo OSCAL: ANEXO II – README 1. Propósito Este documento explica la estructura y convenciones del fichero JSON que contiene el Catálogo ENS (Anexo II) en formato OSCAL. El catálogo OSCAL es un formato estandarizado en JSON que permite describir de manera estructurada y consistente conjuntos de controles de seguridad y su organización, por lo que su objetivo es describir la lógica de su estructura, los elementos que lo componen y cómo interpretar cada medida, incluidos refuerzos, aplicabilidad y parámetros. 2. Modelo y correspondencia entre ENS y OSCAL Este archivo JSON utiliza el modelo Catalog de OSCAL versión 1.1.3. por su capacidad para describir catálogos de controles, jerarquías y texto normativo, lo que permite organizar medidas en grupos, definir propiedades de aplicabilidad y estructurar el texto normativo. Correspondencia general: - Marco ENS (Organizativo, Operacional, Proteccion): group. - Aplicabilidad (categoría, dimensión, nivel): props con ns (namespace) "urn:es:ens". - Medida: control. - Requisitos y subpuntos: parts con nombre "requisitos" e items. - Refuerzo: control adicional con class definida como "ens-refuerzo". 3. Metadatos del catálogo (metadata) El JSON contiene metadatos obligatorios del modelo OSCAL: uuid, título (title), versión (version), fecha de modificación (last-modified), versión de OSCAL (oscal-version = 1.1.3) y propiedades informativas (props). Para asegurar la trazabilidad y la identidad unívoca del documento en todas sus versiones, los identificadores se generan mediante UUIDv5. Este proceso garantiza la reproducibilidad técnica al utilizar parámetros constantes: un Namespace (UUIDv4 base) fijo (23c50007-1fcf-4284-a967-79803ffed459) y el nombre de recurso urn:es:ENS 4. Estructura general del catálogo El catálogo se organiza en tres grupos que representan los marcos ENS. Cada grupo contiene controles (medidas). Se tiene: - Grupos (groups): Tres grupos principales que reproducen los marcos ENS (organizativo -org-, operacional -op- y medidas de protección -mp-), con su clase ("class":"family") y propiedades (props.label) para identificación breve; cada grupo puede incluir una parte de descripción general (overview). - Controles (controls): cada medida se modela como un control con identificador (id), título (title), y propiedades (props) de aplicabilidad, y partes (parts) con el texto normativo que identifican cada bloque anidado con cada requisito. - Controles anidados: materializan los refuerzos del ENS como unidades de cumplimiento con identidad propia ("class": "ens-refuerzo") asociados a la medida principal. 5. Estructura común de cada medida La estructura base de todas las medidas es similar, todas siguen un patrón común pero con variaciones según la redacción del ENS. Esta estructura común incluye: - Identificador (id) alineado con la numeración ENS. - Título (title) de la medida. - Propiedades (props) que incluyen etiqueta legible y aplicabilidad. - Partes (parts): Bloque de requisitos y su desglose. Las viñetas se mantienen usando items y una propiedad 'label' que conserva el literal original. EJEMPLO estructura general en JSON: { "id": "", "title": "", "props": [ {"name": "label", "value": ""}, {"ns": "urn:es:ens", "name": "categoria", "value": ""}, {"ns": "urn:es:ens", "name": "dimension", "value": ""}, {"ns": "urn:es:ens", "name": "nivel", "value": ""} // cuando proceda ], "parts": [ {"id": ".req", "name": "requisitos", "prose": "", "parts": [ {"id": ".req.1", "name": "item", "props": [{"name": "label", "value": ""}], "prose": ""} ]} ] } Notas: las viñetas (a), b)…) se muestran como 'item' anidados y 'props.label' con su literal; los saltos de línea se conservan en 'prose' usando `\n`. Se ha evitado el uso de acentuación fuera del 'prose' 6. Aplicabilidad (categorías, dimensiones y niveles) La aplicabilidad de cada medida o refuerzo se expresa mediante propiedades (props) tal que: - Ámbito de aplicabilidad ("name": "aplicacion-por"): diferencia cuando se aplica por categoría ("categoria") o por nivel ("nivel-dimension"). - Categoría ("name": "categoria"): con valores BASICA, MEDIA o ALTA, cuando aplica. Si no aplica, no aparece. - Dimensión ("name": "dimension"): Confidencialidad, Integridad, Trazabilidad, Autenticidad o Disponibilidad, cuando aplica. Si no aplica, no aparece. - Nivel ("name": "nivel"): BAJO, MEDIO o ALTO, cuando aplica. Si no aplica no aparece. Esto permite conocer el alcance sin necesidad de consultar tablas externas. 7. Refuerzos Los refuerzos se representan como controles vinculados a la medida principal. Su identificación sigue el patrón original del ENS (ej. op.acc.5.r1) y se les asigna la clase técnica ens-refuerzo. Esta estructura permite un cumplimiento modular. Incluyen requisitos propios y pueden ser obligatorios u opcionales según la medida. 8. Disyunciones (selección de un refuerzo) En las medidas que requieren seleccionar un único refuerzo, según categoría o nivel, se emplea un parámetro (params). Este parámetro contiene una lista de opciones que utiliza la semántica de selección de OSCAL: "how-many":"one". Esto permite representar decisiones obligatorias dentro del JSON. EJEMPLO Disyunción en JSON "params": [ { "id": ".prm.rfz.", "label": "Refuerzo seleccionado", "select": {"how-many": "one", "choice": [".r1", ... "."]}, "props": [{"ns": "urn:es:ens", "name": "tipo-param", "value": "seleccion-refuerzo"}] } ] Nota: Este patrón aparece, por ejemplo, en las medidas op.acc.5, op.acc.6, mp.com.4 o mp.s.2, donde las opciones y el ámbito (bajo/medio/alto o BASICA/MEDIA/ALTA) varían por medida. 9. Nomenclatura Se han seguido las siguientes reglas de nomenclatura: - Identificadores con puntos siguiendo la estructura ENS - Etiqueta duplicada mediante "props"."name" = "label": duplica el id para facilitar filtrado y trazabilidad. - Clases descriptivas en grupos ("class": "family" | "subfamily"), refuerzos ("class": "ens-refuerzo") y en refuerzos con disyunciones ("class": "opcion"). - Saltos de linea explícitos con \n en el bloque texto libre (prose) para mantener párrafos del texto normativo. - Se ha evitado el uso de acentuación fuera del 'prose' para conservar un formato uniforme y compatible con el procesamiento del JSON. Estas convenciones aseguran consistencia y fácil mantenimiento. 10. Diferencias habituales entre medidas Las medidas pueden diferir en: - Estructura de items y subitems, con viñetas y texto extenso (como en op.pl.2, op.acc.5/6, mp.s.2/3). - Número y tipo de refuerzos. - Aplicabilidad condicionada por categoría, nivel de dimensión o dimensión concreta. - Presencia de parámetros de selección (como en op.acc.5, op.acc.6, mp.com.4, mp.s.2). Estas diferencias se reflejan en la estructura interna sin alterar la fidelidad respecto al ENS. 11. Validación del JSON El fichero JSON se valida utilizando AJV (Another JSON Validator) aplicando el esquema oficial correspondiente al modelo Catalog de la versión 1.1.3 de OSCAL. La validación comprueba que la estructura y los tipos de datos del JSON se ajustan al modelo declarado en el propio documento. La validación se realiza directamente sobre el JSON entregado. No se requieren archivos adicionales. 12. Estado de enlaces internos Las referencias internas y externas serán incluidas en próximas versiones. 13. Licencia El fichero JSON se publica como software de código abierto bajo la Licencia Pública de la Unión Europea (EUPL), versión 1.2. El texto íntegro de la licencia se incluye en el archivo LICENSE_EUPL-1.2_ES.txt del proyecto y se encuentra disponible en: https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 14. Descargo de responsabilidad El presente documento tiene carácter meramente informativo y no constituye, en ningún caso, una interpretación jurídica auténtica ni vinculante. Su contenido se ofrece a efectos exclusivamente de apoyo técnico, sin que pueda derivarse de él derecho u obligación jurídica alguna, ni sustituir a los informes, dictámenes o pronunciamientos que, en su caso, deban ser emitidos por los órganos competentes conforme al ordenamiento jurídico vigente. En consecuencia, la utilización de la información contenida en este documento se realiza bajo la exclusiva responsabilidad de quien la emplee, sin perjuicio de la necesaria verificación posterior a través de las fuentes normativas oficiales y de los procedimientos legalmente establecidos.