
Tous les validateurs OSCAL affirment « valider OSCAL ». Presque aucun ne peut vous dire ce que signifie cette phrase.
Les modèles OSCAL du NIST sont rédigés en Metaschema : huit modules racines plus des imports partagés, des milliers de lignes de XML qui définissent non seulement la forme des documents, mais aussi leur sémantique : vocabulaires de valeurs autorisées, règles d’unicité, index de références croisées, exigences de cardinalité. Un JSON Schema contrôle la forme. C’est dans la sémantique que les documents de conformité se trompent réellement, et c’est là que « nous validons OSCAL » devient discrètement « nous validons une partie d’OSCAL, sans trop savoir laquelle ».
Nous voulions savoir exactement laquelle. Nous avons donc construit notre validateur comme on audite un système : partir des sources, tout recenser et rendre compte de chaque élément, sans exception.
La première décision était la plus importante : ce sont les sources NIST qui font autorité, pas l’implémentation de référence. Nous avons figé usnistgov/OSCAL au commit 21403b4a… (v1.2.2), mis en cache chaque octet de Metaschema à l’identique avec des empreintes SHA-256, et traité le vénérable CLI OSCAL en Java pour ce qu’il est réellement : un point de comparaison à contre-interroger, pas une vérité à copier. (Il embarque d’ailleurs des bindings OSCAL 1.2.1 : il peut traiter des documents 1.2.2, mais il ne parle pas 1.2.2.)
Nous avons ensuite inventorié lexicalement chaque occurrence de contrainte dans les sources figées. Pas les types de contraintes, mais les occurrences, identifiées par fichier et par ligne, afin que deux contraintes partageant par hasard un même identifiant ne soient jamais fusionnées. Le total s’élève à 348.
Pour chaque occurrence, notre build doit retenir exactement l’un de trois verdicts, imposé par un générateur qui recalcule le registre à chaque exécution :
Non comptabilisées : zéro.
C’est cette dernière catégorie, les exclusions, qui s’est révélée intéressante.
Quand on vérifie 348 contraintes une par une, on trouve des choses. Trois de nos exclusions sont des défauts des sources NIST elles-mêmes :
oscal_mapping-common_metaschema.xml, ligne 657, contraint un flag défini cinq lignes plus haut, et qui n’est ensuite référencé nulle part. Aucun document possible ne porte ce flag. La contrainte est insatisfiable.inventory-item ne s’applique que lorsque @type vaut software, hardware ou service, mais inventory-item ne déclare aucun flag type. (Son voisin, asset-id, est lui-même commenté dans la source.) Le prédicat ne peut jamais correspondre.with-child-controls dans les profils. Un humain qui lit la source les voit ; le schéma compilé ne les applique jamais. Les trois constats ont été signalés en amont : usnistgov/OSCAL#2254, #2255, #2256.Et l’audit a joué dans les deux sens : notre propre évaluateur avait un bug qui faisait que les contraintes ciblant des flags (comme les valeurs autorisées de action/@type) étaient compilées dans l’inventaire mais ne se déclenchaient jamais, sans le moindre signal. Nous ne l’avons pas trouvé par chance : la barrière de clôture a refusé d’accepter des preuves pour ces deux occurrences, ce qui est précisément le mode de défaillance que tout le système est conçu pour révéler.
Affirmer que « l’implémentation de référence laisse passer des choses » sur la seule base d’une inspection des sources est exactement le type d’assertion non prouvée que ce projet veut éliminer. Nous avons donc téléchargé le CLI OSCAL Java 3.2.0 depuis Maven Central, vérifié son empreinte et exécuté les deux validateurs sur une famille de fixtures dont les documents de référence passent sans erreur des deux côtés, de sorte que chaque désaccord est imputable à une seule modification injectée.
OSCAL 1.2.2 a modifié exactement deux contraintes au-delà des changements de numéro de version (toutes deux dans le modèle SSP). Le CLI Java, qui embarque des bindings 1.2.1, se trouve du mauvais côté de chaque conséquence observable :
rel="validation" pendant viole 1.2.2. Java : valide, code de sortie 0.rel="validated-by" pendant est correct selon 1.2.2 (la contrainte a été supprimée). Java : invalide.responsible-role sans le party-uuid facultatif est correct selon 1.2.2 ; le NIST a ajouté le prédicat précisément pour corriger cela. Java renvoie une erreur, littéralement : Key reference [null] not found.Puis un cas qui n’a rien à voir avec un décalage de version : un catalogue dont l’action de métadonnées déclare "type": "invented-type", ce qu’interdit la ligne 877 du Metaschema des métadonnées à la fois dans la 1.2.2 et dans les sources 1.2.1 que Java embarque. Java le déclare valide, en JSON comme en XML. La contrainte cible un flag ; des contraintes ciblant des flags qui ne se déclenchent pas, sans le moindre signal, c’est précisément la classe de bugs que notre barrière d’exhaustivité a détectée dans notre propre évaluateur. L’implémentation de référence présente la même classe de bugs, sans barrière de clôture pour la détecter. Nous l’avons signalé en amont : metaschema-framework/oscal-cli#279. (Nous avons cartographié cette classe de manière mécanique : exactement 2 des 200 occurrences de valeurs autorisées ciblent des flags, et le seul membre de niveau erreur est celui que nous avons testé en conditions réelles. Aucun reste non testé.)
Et le moment d’honnêteté, car l’exécution a joué dans les deux sens : notre validateur a rejeté le propre catalogue SP 800-53 rev5 du NIST. Vingt erreurs, toutes dues à un seul défaut : notre évaluateur d’index traitait un champ de clé facultatif manquant comme une violation, alors que la spécification Metaschema le considère comme une clé nulle. Java acceptait le fichier ; nous avions tort ; nous l’avons corrigé le jour même, et 800-53 se valide désormais sans erreur. L’exécution en a ensuite révélé un second : nous continuions d’appliquer le vocabulaire des types d’action OSCAL même lorsque action/@system déclarait un URI personnalisé, soit exactement la segmentation par organisation que préconisent les remarques du NIST lui-même. Corrigé aussi. Un banc d’essai différentiel qui ne trouve jamais que les bugs de l’autre camp n’est pas un banc d’essai, c’est du marketing.
(À classer également sous « des deux côtés » : aucun des deux résolveurs ne validait sémantiquement sa propre sortie. Le resolve-profile de Java écrit sans broncher un catalogue que le validate de Java rejette ensuite, et le nôtre faisait de même, contrôlé par le schéma mais pas par la sémantique. Le nôtre refuse désormais d’écrire des résolutions sémantiquement invalides ; Java ne le peut toujours pas, car combler cette faille exige une couche sémantique digne de confiance.)
Le deuxième manque des outils existants : les documents OSCAL ne vivent pas isolément. Un résultat d’évaluation importe un plan d’évaluation, qui importe un SSP, qui importe un profil, qui se résout à partir de catalogues. La documentation du modèle regorge de relations qu’aucun validateur limité à un seul fichier ne peut vérifier : « la cible de ce constat doit se résoudre en une déclaration de la baseline », « ce POA&M doit identifier son système ».
Nous avons donc construit une validation inter-documents qui résout réellement ces liens. Demandez-lui de vérifier un SSP : elle résout la baseline importée à travers l’intégralité du pipeline de résolution de profils (selon le projet de spécification) jusqu’aux catalogues, calcule l’ensemble des contrôles sélectionnés et vous indique :
{
"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'"
}
Avec une règle de conception essentielle : ces vérifications de relations sont des interprétations d’une prose documentée, et nous les traitons comme telles. Elles sont désactivées par défaut, produisent des avertissements et non des erreurs, la portée de résolution de chaque champ est rattachée à sa ligne source, et tout ce qui est seulement déductible est exclu nommément. Là où la norme reste prudente, un validateur ne doit pas bluffer. (Notre exemple préféré : la spécification POA&M indique qu’un import de SSP ou un system-id est requis, « Both may be present ». Nous n’émettons donc un avertissement que lorsque ni l’un ni l’autre n’existe. Pas de ou exclusif inventé.)
Parce que les documents vivent dans des navigateurs, des fonctions serverless, des CLI et des bases de données, et que nous voulions un seul validateur partout, pas un sidecar JVM à côté de chacun. Les validateurs sont des modules autonomes Ajv précompilés : du JavaScript généré ordinaire, aucune compilation de schéma à l’exécution, une sortie stable à l’octet près. Le même code qui alimente nos interfaces de validation s’exécute sans modification dans l’onglet de votre navigateur et dans notre CLI. Et le déterminisme n’est pas qu’un confort d’exploitation : c’est ce qui rend possibles des preuves figées par empreinte.
import { createDiagnosticsOscalProcessor } from "@secani/oscal/diagnostics";
const result = createDiagnosticsOscalProcessor({ maxIssues: 50 }).validate(doc);
validate --resolve-imports --interpretive all)Le rapport technique complet (modèle d’autorité, clôture d’exhaustivité, tableau des résultats différentiels et ce que nous ne revendiquons délibérément pas) se trouve dans la documentation du validateur. Le validateur est en préproduction privée avant une publication en open source ; l’API de validation hébergée expose dès aujourd’hui le niveau schéma, la couche sémantique suivra.

OSCAL · 26 juillet 2026 · 20 Min.
OLIR fournit le contenu des correspondances et leur gouvernance. OSCAL fournit la structure lisible par machine qui permet de les exploiter dans l’analyse des écarts, la réutilisation des preuves et les processus d’analyse d’impact des changements.

OSCAL · 14 juillet 2026 · 7 Min.
OSCAL transforme les documents de conformité en données structurées : huit modèles de documents, trois formats et un écosystème qui devient la norme pour la réglementation.

OSCAL · 16 juillet 2026 · 6 Min.
Avec la RFC-0024 et les Consolidated Rules 2026, FedRAMP rend obligatoires les données d'autorisation structurées. Les échéances sont échelonnées, mais la direction est sans équivoque.
Secani réunit Scopes, preuves, tâches et agents d’IA dans un espace de travail partagé.