
Każdy walidator OSCAL twierdzi, że „waliduje OSCAL”. Prawie żaden nie potrafi powiedzieć, co to zdanie właściwie oznacza.
Modele OSCAL od NIST są pisane w Metaschema – osiem modułów głównych plus wspólne importy, tysiące linii XML, które definiują nie tylko kształt dokumentu, ale też jego semantykę: słowniki dozwolonych wartości, reguły unikalności, indeksy odwołań krzyżowych, wymagania dotyczące liczności. JSON Schema wychwytuje kształt. To semantyka jest miejscem, w którym dokumenty compliance faktycznie się psują – i w którym „walidujemy OSCAL” po cichu zamienia się w „walidujemy jakąś część OSCAL, nie jesteśmy pewni którą”.
Chcieliśmy mieć pewność, którą. Zbudowaliśmy więc nasz walidator tak, jak audytuje się system: zaczynając od źródeł, wyliczając wszystko i rozliczając każdy pojedynczy element.
Pierwsza decyzja była tą najważniejszą: autorytetem są źródła NIST, a nie implementacja referencyjna. Przypięliśmy usnistgov/OSCAL do commita 21403b4a… (v1.2.2), zbuforowaliśmy każdy plik Metaschema bajt w bajt wraz z hashami SHA-256 i potraktowaliśmy zasłużone Java OSCAL CLI jako to, czym faktycznie jest: punkt odniesienia do krzyżowego sprawdzania, a nie prawdę do skopiowania. (Choćby dlatego, że zawiera wbudowane powiązania dla OSCAL 1.2.1 – potrafi przetwarzać dokumenty 1.2.2, ale nie mówi w 1.2.2).
Następnie przeprowadziliśmy leksykalną inwentaryzację każdego wystąpienia ograniczenia w przypiętych źródłach. Nie typów ograniczeń, lecz wystąpień, identyfikowanych przez plik i linię, tak aby dwa ograniczenia, które przypadkiem mają ten sam identyfikator, nigdy nie zlały się w jedno. Wyszło 348.
Dla każdego wystąpienia nasz build musi mieć dokładnie jeden z trzech werdyktów, egzekwowany przez generator, który przy każdym uruchomieniu przelicza rejestr od nowa:
Nierozliczone: zero.
Ta ostatnia kategoria – wyłączenia – okazała się najciekawsza.
Gdy sprawdza się 348 ograniczeń jedno po drugim, coś się znajduje. Trzy z naszych wyłączeń to defekty w samych źródłach NIST:
oscal_mapping-common_metaschema.xml w linii 657 ogranicza flagę zdefiniowaną pięć linii wcześniej – do której potem nic się nie odwołuje. Żaden dokument, który może istnieć, nie zawiera tej flagi. Ograniczenia nie da się spełnić.inventory-item ma zastosowanie tylko wtedy, gdy @type ma wartość software, hardware lub service – ale inventory-item w ogóle nie deklaruje flagi type. (Jej sąsiad, asset-id, jest w źródle sam zakomentowany). Predykat nigdy nie może zostać spełniony.with-child-controls w profilu. Człowiek czytający źródło je widzi; skompilowany schemat nigdy ich nie egzekwuje. Wszystkie trzy ustalenia zgłosiliśmy do projektu źródłowego: usnistgov/OSCAL#2254, #2255, #2256.Audyt działał zresztą w obie strony: nasz własny ewaluator miał błąd, przez który ograniczenia dotyczące flag (na przykład dozwolone wartości action/@type) trafiały do inwentarza, ale po cichu nigdy nie były uruchamiane. Nie znaleźliśmy go przypadkiem – bramka domknięcia odmówiła przyjęcia dowodów dla tych dwóch wystąpień, a to jest dokładnie ten tryb awarii, który cały system ma ujawniać.
Twierdzenie, że „implementacja referencyjna coś pomija”, oparte wyłącznie na analizie źródeł, to dokładnie ten rodzaj nieudowodnionej tezy, z którą ten projekt ma walczyć. Pobraliśmy więc Java OSCAL CLI 3.2.0 z Maven Central, zweryfikowaliśmy jego hash i uruchomiliśmy oba walidatory na rodzinie fixture'ów, których dokumenty bazowe przechodzą bez błędów po obu stronach – tak aby każdą rozbieżność można było przypisać jednej wprowadzonej zmianie.
OSCAL 1.2.2 zmienił, poza podbiciem wersji, dokładnie dwa ograniczenia (oba w modelu SSP). Java CLI – z wbudowanymi powiązaniami dla 1.2.1 – jest po złej stronie każdej obserwowalnej konsekwencji:
rel="validation" narusza 1.2.2. Java: poprawny, kod wyjścia 0.rel="validated-by" jest według 1.2.2 w porządku (to ograniczenie usunięto). Java: niepoprawny.responsible-role bez opcjonalnego party-uuid jest według 1.2.2 w porządku – NIST dodał predykat specjalnie po to, by to naprawić. Java zgłasza błąd o dosłownej treści Key reference [null] not found.A potem przypadek, który w ogóle nie dotyczy rozbieżności wersji: katalog, którego action w metadanych deklaruje "type": "invented-type" – co jest zabronione w linii 877 Metaschema metadanych zarówno w 1.2.2, jak i w źródłach 1.2.1 wbudowanych w Javę. Java uznaje go za poprawny, w JSON i w XML. Ograniczenie dotyczy flagi; ograniczenia dotyczące flag, które po cichu się nie uruchamiają, to dokładnie ta klasa błędów, którą nasza bramka kompletności wychwyciła we własnym ewaluatorze. Implementacja referencyjna ma błąd tej samej klasy – i nie ma bramki domknięcia, która by go wychwyciła. Zgłosiliśmy go do projektu źródłowego jako metaschema-framework/oscal-cli#279. (Tę klasę zmapowaliśmy mechanicznie: dokładnie 2 z 200 wystąpień allowed-values dotyczą flag, a jedynym elementem o randze błędu jest ten, który przetestowaliśmy na żywo. Nie ma nieprzetestowanej reszty).
I moment szczerości, bo przebieg działał w obie strony: nasz walidator odrzucił własny katalog NIST SP 800-53 rev5. Dwadzieścia błędów, wszystkie z powodu jednego defektu – nasz ewaluator indeksów traktował brakujące opcjonalne pole klucza jako naruszenie, podczas gdy specyfikacja Metaschema mówi, że jest to klucz null. Java zaakceptowała plik; to my się myliliśmy; naprawiliśmy to tego samego dnia i 800-53 waliduje się bez błędów. Później przebieg wychwycił drugi błąd: nadal egzekwowaliśmy słownik typów akcji OSCAL nawet wtedy, gdy action/@system deklarował niestandardowy URI – czyli dokładnie taką segmentację per organizacja, jaką przewidują uwagi samego NIST. Również naprawione. Uprząż różnicowa, która zawsze znajduje wyłącznie błędy drugiej strony, nie jest uprzężą testową, tylko marketingiem.
(Do kategorii „obie strony” należy też to: żaden z resolverów nie walidował semantycznie własnych wyników. resolve-profile w Javie bez oporów zapisze katalog, który validate w tej samej Javie potem odrzuci – i nasz robił to samo, z bramką na poziomie schematu, ale bez bramki semantycznej. Nasz odmawia teraz zapisania semantycznie niepoprawnych rozwiązań; Java nadal tego nie potrafi, bo zamknięcie tej luki wymaga warstwy semantycznej, której można ufać).
Druga rzecz, której brakuje w istniejących narzędziach: dokumenty OSCAL nie istnieją w izolacji. Wynik oceny importuje plan oceny, który importuje SSP, który importuje profil, który jest rozwiązywany względem katalogów. Dokumentacja modeli pełna jest relacji, których żaden walidator pojedynczych plików nie jest w stanie sprawdzić – „cel tego ustalenia musi wskazywać na stwierdzenie w baseline”, „ten POA&M musi identyfikować swój system”.
Zbudowaliśmy więc walidację międzydokumentową, która naprawdę rozwiązuje te krawędzie. Poproście ją o sprawdzenie SSP, a rozwiąże zaimportowany baseline przez pełny potok rozwiązywania profili (według projektu specyfikacji) aż do katalogów, wyliczy wybrany zestaw zabezpieczeń i poinformuje:
{
"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'"
}
Z jedną kluczową zasadą projektową: te sprawdzenia relacji są interpretacjami udokumentowanej prozy i tak je traktujemy – domyślnie wyłączone, jako ostrzeżenia, a nie błędy, z zakresem rozwiązywania każdego pola przypiętym do linii źródłowej i z wyłączeniem po nazwie wszystkiego, co jest jedynie możliwe do wywnioskowania. Tam, gdzie standard się asekuruje, walidator nie powinien blefować. (Nasz ulubiony przykład: specyfikacja POA&M mówi, że wymagany jest import SSP lub system-id – „Both may be present”. Ostrzegamy więc tylko wtedy, gdy nie ma żadnego z nich. Bez wymyślonej alternatywy wykluczającej).
Ponieważ dokumenty żyją w przeglądarkach, funkcjach serverless, narzędziach CLI i bazach danych – a my chcieliśmy mieć jeden walidator we wszystkich tych miejscach, a nie sidecar z JVM obok każdego z nich. Walidatory to prekompilowane samodzielne moduły Ajv: zwykły wygenerowany JavaScript, zero kompilacji schematów w czasie działania, wynik stabilny co do bajtu. Ten sam kod, który napędza nasze powierzchnie walidacji, działa bez zmian w karcie Waszej przeglądarki i w naszym CLI. A determinizm nie jest tylko udogodnieniem operacyjnym – to on w ogóle umożliwia dowody przypięte hashami.
import { createDiagnosticsOscalProcessor } from "@secani/oscal/diagnostics";
const result = createDiagnosticsOscalProcessor({ maxIssues: 50 }).validate(doc);
validate --resolve-imports --interpretive all)Pełny raport techniczny – model autorytetu, domknięcie kompletności, tabela potwierdzeń z porównania różnicowego oraz to, czego celowo nie twierdzimy – znajduje się w dokumentacji walidatora. Walidator jest w prywatnym środowisku przejściowym przed wydaniem jako open source; hostowane API walidacji udostępnia już dziś poziom schematu, a warstwa semantyczna pojawi się wkrótce.

OSCAL · 26 lipca 2026 · 20 Min.
OLIR dostarcza treści mapowań i zasady ich zarządzania. OSCAL zapewnia czytelną maszynowo strukturę do wykorzystania tych mapowań w analizie luk, ponownym wykorzystaniu dowodów i procesach oceny wpływu zmian.

OSCAL · 14 lipca 2026 · 7 Min.
OSCAL zamienia dokumenty dotyczące zgodności w ustrukturyzowane dane: osiem modeli dokumentów, trzy formaty i ekosystem, który staje się standardem w regulacjach.

OSCAL · 16 lipca 2026 · 6 Min.
Wraz z RFC-0024 i Consolidated Rules 2026 FedRAMP czyni ustrukturyzowane dane autoryzacyjne obowiązkowymi. Terminy są rozłożone w czasie – kierunek jest jednoznaczny.
Secani łączy w jednej wspólnej przestrzeni roboczej zakresy, dowody, zadania i agentów AI.