
Todos los validadores de OSCAL afirman que «validan OSCAL». Casi ninguno puede decirle qué significa esa frase.
Los modelos OSCAL del NIST están escritos en Metaschema: ocho módulos raíz más importaciones compartidas, miles de líneas de XML que definen no solo la forma del documento, sino también su semántica: vocabularios de valores permitidos, reglas de unicidad, índices de referencias cruzadas, requisitos de cardinalidad. Un JSON Schema detecta la forma. La semántica es donde los documentos de cumplimiento fallan de verdad, y donde «validamos OSCAL» se convierte discretamente en «validamos parte de OSCAL, no estamos seguros de qué parte».
Nosotros queríamos estar seguros de qué parte. Así que construimos nuestro validador como se audita un sistema: partir de las fuentes, enumerarlo todo y dar cuenta de cada elemento.
La primera decisión fue la importante: las fuentes del NIST son la autoridad, no la implementación de referencia. Fijamos usnistgov/OSCAL en el commit 21403b4a… (v1.2.2), almacenamos en caché cada byte de Metaschema de forma exacta con hashes SHA-256 y tratamos la veterana CLI de OSCAL en Java como lo que realmente es: un comparador al que interrogar, no una verdad que copiar. (Para empezar, incorpora bindings de OSCAL 1.2.1: puede procesar documentos 1.2.2, pero no habla 1.2.2.)
Después inventariamos léxicamente cada aparición de restricción en las fuentes fijadas. No tipos de restricción, sino apariciones, identificadas por archivo y línea, para que dos restricciones que comparten por casualidad un ID nunca se fusionen en una. El recuento dio 348.
Para cada aparición, nuestra compilación debe tener exactamente uno de tres veredictos, impuesto por un generador que recalcula el registro en cada ejecución:
Sin justificar: cero.
Ese último grupo, el de las exclusiones, es donde la cosa se puso interesante.
Cuando se comprueban 348 restricciones una a una, se encuentran cosas. Tres de nuestras exclusiones son defectos de las propias fuentes del NIST:
oscal_mapping-common_metaschema.xml restringe un flag definido cinco líneas antes, que luego nada referencia. Ningún documento que pueda existir contiene ese flag. La restricción es insatisfacible.inventory-item solo se aplica cuando @type es software, hardware o service, pero inventory-item no declara ningún flag type. (Su vecino, asset-id, está a su vez comentado en la fuente.) El predicado nunca puede coincidir.with-child-controls. Una persona que lee la fuente las ve; el esquema compilado nunca las aplica. Los tres hallazgos se han notificado a los responsables del proyecto: usnistgov/OSCAL#2254, #2255, #2256.Y la auditoría funcionó en ambos sentidos: nuestro propio evaluador tenía un error por el que las restricciones dirigidas a flags (como los valores permitidos de action/@type) se compilaban en el inventario pero nunca se activaban, sin dar aviso. No lo encontramos por suerte: la puerta de cierre se negó a aceptar evidencias para esas dos apariciones, que es precisamente el modo de fallo que todo el sistema está diseñado para poner al descubierto.
Afirmar que «la implementación de referencia pasa cosas por alto» solo a partir de la inspección de las fuentes es exactamente el tipo de afirmación sin demostrar que este proyecto existe para eliminar. Así que descargamos la CLI de OSCAL en Java 3.2.0 de Maven Central, verificamos su hash y ejecutamos ambos validadores sobre una familia de fixtures cuyos documentos base superan la validación limpiamente en ambos lados, de modo que cada discrepancia es atribuible a un único cambio inyectado.
OSCAL 1.2.2 cambió exactamente dos restricciones, aparte de los cambios de versión (ambas en el modelo SSP). La CLI de Java, que incorpora bindings de 1.2.1, está en el lado equivocado de todas las consecuencias observables:
rel="validation" colgante infringe 1.2.2. Java: válido, código de salida 0.rel="validated-by" colgante es correcto según 1.2.2 (la restricción se eliminó). Java: inválido.responsible-role sin el party-uuid opcional es correcto según 1.2.2; el NIST añadió el predicado precisamente para corregir esto. Java da un error que dice, literalmente, Key reference [null] not found.Y luego uno que no tiene nada que ver con el desfase de versiones: un catálogo cuyo action de metadatos declara "type": "invented-type", algo prohibido en la línea 877 del Metaschema de metadatos tanto en 1.2.2 como en las fuentes 1.2.1 que incorpora Java. Java lo declara válido, en JSON y en XML. La restricción apunta a un flag; que las restricciones dirigidas a flags no se activen sin avisar es precisamente la clase de error que nuestra puerta de completitud detectó en nuestro propio evaluador. La implementación de referencia tiene la misma clase de error, y ninguna puerta de cierre que la detecte. Lo notificamos a los responsables como metaschema-framework/oscal-cli#279. (Delimitamos la clase de forma mecánica: exactamente 2 de 200 apariciones de valores permitidos apuntan a flags, y el único miembro de nivel error es el que probamos en real. No queda ningún resto sin probar.)
Y el momento de honestidad, porque la ejecución funcionó en ambos sentidos: nuestro validador rechazó el propio catálogo SP 800-53 rev5 del NIST. Veinte errores, todos por un único defecto: nuestro evaluador de índices trataba un campo clave opcional ausente como una infracción, cuando la especificación de Metaschema dice que es una clave nula. Java aceptó el archivo; nosotros estábamos equivocados; lo corregimos el mismo día, y 800-53 valida limpiamente. Más tarde, la ejecución detectó un segundo: seguíamos aplicando el vocabulario de tipos de acción de OSCAL incluso cuando action/@system declaraba un URI personalizado, que es exactamente la segmentación por organización que piden las propias observaciones del NIST. También corregido. Un banco de pruebas diferencial que solo encuentra los errores del otro lado no es un banco de pruebas, es marketing.
(También en la categoría de «ambos lados»: ninguno de los dos resolutores validaba semánticamente su propia salida. El resolve-profile de Java escribe sin problema un catálogo que el propio validate de Java rechaza después, y el nuestro hacía lo mismo, con control de esquema pero sin control semántico. El nuestro ya se niega a escribir resoluciones semánticamente inválidas; el de Java todavía no puede, porque cerrar ese hueco requiere una capa semántica en la que se confíe.)
Lo segundo que faltaba en las herramientas existentes: los documentos OSCAL no viven solos. Un resultado de evaluación importa un plan de evaluación, que importa un SSP, que importa un perfil, que se resuelve contra catálogos. La documentación del modelo está llena de relaciones que ningún validador de un solo archivo puede comprobar: «el objetivo de este hallazgo debe resolverse en una declaración de la línea base», «este POA&M debe identificar su sistema».
Así que construimos una validación entre documentos que resuelve esas relaciones de verdad. Pídale que compruebe un SSP y resolverá la línea base importada a través de todo el proceso de resolución de perfiles (según el borrador de especificación) hasta los catálogos, calculará el conjunto de controles seleccionado y le dirá:
{
"ruleId": "SSP-003.b",
"severity": "warning",
"path": "/…/implemented-requirements/1/control-id",
"message": "implemented control 'ac-99' is not supplied by the resolved import-profile 'file:///…/baseline.json'"
}
Con una regla de diseño crucial: estas comprobaciones de relaciones son interpretaciones de un texto documentado, y las tratamos como tales: desactivadas por defecto, avisos y no errores, el ámbito de resolución de cada campo fijado a su línea de origen y todo lo que sea meramente inferible excluido de forma nominal. Donde la norma es ambigua, un validador no debe ir de farol. (Nuestro ejemplo favorito: la especificación de POA&M dice que se requiere una importación de SSP o un system-id, «Both may be present». Así que solo avisamos cuando no existe ninguno de los dos. Nada de un o exclusivo inventado.)
Porque los documentos viven en navegadores, funciones serverless, CLI y bases de datos, y queríamos un único validador en todos ellos, no un sidecar de JVM junto a cada uno. Los validadores son módulos independientes de Ajv precompilados: JavaScript generado sin más, cero compilación de esquemas en tiempo de ejecución, salida estable byte a byte. El mismo código que impulsa nuestras superficies de validación se ejecuta sin cambios en la pestaña de su navegador y en nuestra CLI. Y el determinismo no es solo una comodidad operativa: es lo que hace posibles, para empezar, las evidencias fijadas por hash.
import { createDiagnosticsOscalProcessor } from "@secani/oscal/diagnostics";
const result = createDiagnosticsOscalProcessor({ maxIssues: 50 }).validate(doc);
validate --resolve-imports --interpretive all)El informe técnico completo (modelo de autoridad, cierre de completitud, la tabla de comprobantes diferenciales y lo que deliberadamente no afirmamos) se encuentra en la documentación del validador. El validador está en una fase de preproducción privada antes de su publicación como código abierto; la API de validación alojada ofrece hoy el nivel de esquema, y la capa semántica llegará después.

OSCAL · 26 de julio de 2026 · 20 Min.
OLIR aporta contenido de correspondencias y gobernanza. OSCAL aporta la estructura legible por máquina para usar esas correspondencias en análisis de carencias, reutilización de evidencias y flujos de análisis del impacto de los cambios.

OSCAL · 14 de julio de 2026 · 7 Min.
OSCAL convierte los documentos de cumplimiento en datos estructurados: ocho modelos de documento, tres formatos y un ecosistema que se está convirtiendo en el estándar de la regulación.

OSCAL · 16 de julio de 2026 · 6 Min.
Con el RFC-0024 y las Consolidated Rules 2026, FedRAMP hace obligatorios los datos de autorización estructurados. Los plazos son escalonados; la dirección, inequívoca.
Secani conecta Scopes, evidencias, tareas y agentes de IA en un espacio de trabajo compartido.