Checks · Kern 2.0.0, Release-Kandidat

Wenn der Prüfer eine Maschine ist

Ein Scanner, der mit 0 oder 1 endet, verbirgt seinen Schwellenwert, ignoriert das Tailoring und hinterlässt nichts, was sich erneut untersuchen ließe. Ein Check veröffentlicht die Fakten, die ein Kollektor melden muss, und die Vergleiche, die entscheiden. Der Datensatz des Laufs enthält, was beobachtet wurde, sodass jeder das Urteil aus dem Datensatz nachrechnen kann.

elfter Kerntyp, Kandidat für 2.0.0 205 Vektoren bestehen in drei Implementierungen 2.0.0 ist nicht getaggt

01 Die Lücke

Die Automatisierung existiert beim Herausgeber und geht unterwegs verloren

JASCON 1.0.0 kann sagen, dass eine Anforderung geprüft wurde und zu welchem Schluss der Prüfer kam. Es kann nicht sagen, wie eine Maschine entscheidet.

291 von 312

Regeln des CIS Ubuntu 24.04 Benchmark sind als automatisiert gekennzeichnet

Jede von ihnen kommt in einem konvertierten Bundle als Zeichenkette audit mit Shell-Auszügen im Fließtext an. Die Bestehensbedingung ist ein Satz wie „verify the output is“, den ein Mensch lesen muss.

0 von 3

in der Erhebung untersuchten Herausgebern kodieren einen maschinell entscheidbaren Check

ISM, Grundschutz++ und SP 800-53 nennen Methoden (Untersuchen, Befragen, Testen) und geforderte Dokumentation. FedRAMP CR26 führt Schlüsseltests als Fließtext. Keiner von ihnen spezifiziert einen Check, den ein Programm auswerten kann.

Zählungen: CP-CHECK-1, Abschnitt 2.1, aus den Abdeckungsberichten der konvertierten Korpora.

02 Das Design

Der Kollektor beobachtet, die Kriterien entscheiden

Die Grenze verläuft dort, wo Tools übereinstimmen müssen. Zwei konforme Tools, die denselben Check und dieselbe Beobachtung erhalten, liefern dasselbe Urteil. Alles, was sich zwischen redlichen Tools unterscheiden darf, ohne das Urteil zu ändern, bleibt außerhalb des Kerns.

Facette, außerhalb des Kerns

Kollektor

Ein Shell-Skript, ein Ansible-Task oder ein API-Aufruf, im Check mitgeführt, damit der Digest des Checks genau diesen Code abdeckt. Er gibt eine Beobachtung aus und entscheidet nichts.

Kern: der Faktenvertrag

Beobachtung

Benannte, typisierte Fakten wie sshd.maxauthtries: Ganzzahl. Ein Kollektor meldet effektive Werte, mit aufgelösten Standardwerten. Ein fehlender Schlüssel bedeutet „gesucht und nicht gefunden“.

Kern: zwölf Komparatoren

Kriterien

Eine flache Konjunktion wie at-most {param}. Der erwartete Wert ist ein Literal oder ein Parameter der Anforderung, also legt das Tailoring, das den Parameter bindet, die Bestehensgrenze fest.

Kern: check-verdict

Urteil

Erfüllt, nicht erfüllt, nicht eindeutig oder nicht anwendbar: eine reine Funktion des Checks, der Beobachtung und der gebundenen Parameter. Der Validator rechnet jedes aufgezeichnete Urteil nach.

Ein per Tailoring angepasster Parameter justiert den Check neu

Verschärfen Sie max-auth-tries im Tailoring von 6 auf 4, und die gestrige Beobachtung von 5 wechselt von erfüllt zu nicht erfüllt. Keine Codezeile ändert sich, und wer die Anforderung umsetzt, kann seine Bestehensgrenze nicht selbst festlegen.

Ein Urteil wird nachgerechnet, nie blind übernommen

Die Zeile im Assessment enthält die Beobachtung selbst. Eine zweite Partei wertet die Kriterien darauf aus und vergleicht. Ein aufgezeichnetes Ergebnis, das vom berechneten abweicht, ist ein Validierungsfehler.

Der Datensatz zeigt, was beobachtet wurde

Eine fehlgeschlagene Zeile lautet sshd.ciphers matches-not ".*-cbc", beobachtet: eine Liste, die aes128-cbc enthält. Ein Exit-Code hätte 1 gesagt.

03 Ausprobieren

Beobachtung setzen, Bestehensgrenze verschieben

Das ausgearbeitete Beispiel aus dem Repository: eine Anforderung mit zwei Klauseln, ein Tailoring für Produktions-Hosts, zwei Checks und zwei aufgezeichnete tägliche Läufe eines Bastion-Hosts. Ändern Sie, was der Kollektor gesehen hat oder was das Tailoring bindet.

LNX-SSH-1 auf bastion-01 ausgearbeitetes Beispiel aus dem Repository
Die Anforderung

s1 Der SSH-Daemon erlaubt höchstens 4 Authentifizierungsversuche je Verbindung.

s2 Der SSH-Daemon bietet keine Chiffre im CBC-Modus an.

Der Kollektor beobachtetesshd.ciphers
Aufgezeichnete Läufe
Ergebnis der Prüfung …

In Ihrem Browser berechnet von der Portierung von check-verdict in der App, also von dem Code, der die 205 Check-Vektoren besteht. Hier läuft kein Kollektor; die Beobachtung ist die, die Sie eingestellt haben.

{
  "id": "https://cso.example/check/LNX-SSH-1-maxauthtries",
  "requirement-ref": "https://cso.example/req/LNX-SSH-1",
  "statement-ids": ["s1"],
  "platform": "https://cso.example/platform/linux-host",
  "observes": [
    { "name": "sshd.maxauthtries", "type": "integer" }
  ],
  "criteria": [
    { "fact": "sshd.maxauthtries", "op": "at-most",
      "expected": { "param": "max-auth-tries" } }
  ],
  "validity": { "num": 24, "unit": "hours" },
  "confidence": "reviewed",
  "facets": {
    "https://ns.jascon.net/stdlib/facet/collector@1": {
      "collectors": [
        { "id": "bash", "runtime": "bash", "privileges": "root",
          "source": "#!/bin/bash\nv=$(sshd -T | awk '$1==\"maxauthtries\"{print $2}') ..." }
      ]
    }
  }
}
{
  "check-ref": "https://cso.example/check/LNX-SSH-1-ciphers",
  "check-digest": "sha256:b5ec275f0904a0a882d27e1434efb28e0595a74c6c0814297b2537fa49833f56",
  "collector-id": "bash",
  "outcome": "not-satisfied",
  "time": "2026-11-03T06:00:04Z",
  "observation": {
    "facts": {
      "sshd.ciphers": ["chacha20-poly1305@openssh.com",
                       "aes256-gcm@openssh.com", "aes256-ctr", "aes128-cbc"]
    }
  },
  "evidence-record": {
    "ref": "evidence/sha256/61c0ab97f7c9033b00b61a1eb09b5aa40d648114422ffa040aa779b09a9118fc",
    "digest": "sha256:61c0ab97f7c9033b00b61a1eb09b5aa40d648114422ffa040aa779b09a9118fc"
  }
}
{
  "id": "https://cso.example/finding/bastion-01-ssh-cbc",
  "assessment-ref": "https://cso.example/assessment/bastion-01-2026-11-03",
  "requirement-ref": "https://cso.example/req/LNX-SSH-1",
  "statement-ref": "s2",
  "check-ref": "https://cso.example/check/LNX-SSH-1-ciphers",
  "state": "closed",
  "actions": [
    { "description": { "en": "Remove aes128-cbc from the Ciphers line of sshd_config; the next daily run verifies." },
      "status": "done" }
  ]
}
Auszüge · jascon/examples

Was das Beispiel-Bundle aufzeichnet

  • 3. November: vier Authentifizierungsversuche bei einer Obergrenze von vier, erfüllt. Die Chiffrenliste enthält aes128-cbc, nicht erfüllt. Das Ergebnis des Assessments ist die Aggregation seiner Zeilen.
  • Ein Finding zu Klausel s2 verweist auf den Check, der es ausgelöst hat. Seine Maßnahme: die Chiffre entfernen.
  • 10. November: beide Zeilen erfüllt. Das Finding ist geschlossen und bezieht sich auf den Lauf, der es verifiziert hat.

Das Beispiel hat keinen echten Host geprüft. Jeder Lauf hat den Bash-Kollektor des Checks unverändert gegen einen Stub von sshd ausgeführt, der eine feste Konfiguration ausgibt, und jeder Nachweisdatensatz sagt das.

Das Beispiel auf der Seite Prüfungen (Checks) der App öffnen

04 Die Komparatoren

Zwölf, und eine Liste dessen, was draußen bleibt

Die Menge ist absichtlich klein. Ein Check, der nicht passt, bleibt manuell und wird gezählt.

  • Die Kriterien sind eine Konjunktion. Es gibt kein ODER, kein NICHT und keine Verschachtelung; Alternativen für einen Wert sind one-of, und die Negation steckt in den Operatorpaaren.
  • Keine Arithmetik und kein Vergleich zwischen zwei Fakten. Zählen und Ableiten sind Sache des Kollektors.
  • Die Verknüpfung ist das starke Kleene-UND: Ein eindeutiger Fehlschlag entscheidet, und ein Fehlschlag wird nie hinter einem Unbekannten an anderer Stelle versteckt.
  • Ein ungebundener Parameter ergibt „nicht eindeutig“. Ein Standardwert wird nie eingesetzt.
  • at-most bindet nie einen Parameter, der nach oben verschärft, damit das Verschärfen eines Parameters keinen Check lockern kann.
  • Ein Check über viele Ressourcen besteht nur, wenn jede anwendbare besteht. Jede Ressource wird ausgewertet, keine wird nach dem ersten Fehlschlag übersprungen, und das Urteil kommt mit Anzahl und Anteil: „12 von 200 anwendbaren Bucket-Ressourcen nicht erfüllt (6 %)“.
OperatorAufGilt, wenn
equalsein Wertder Wert gleich dem erwarteten ist; Dezimalzahlen nach Wert
not-equalsein Wertder Wert vom erwarteten abweicht; nicht eindeutig bei fehlendem Fakt
one-ofein Wertder Wert in der Liste steht
at-least at-mostGanzzahl, DezimalzahlOrdnung; Dezimalzahlen nie als Gleitkommazahlen
present absentjeder Faktder Schlüssel in der Beobachtung enthalten ist bzw. nicht enthalten ist
includes-alleine Listejeder aufgeführte Wert vorkommt
excludes-alleine Listekein aufgeführter Wert vorkommt
subset-ofeine Listejeder beobachtete Wert aufgeführt ist
matches matches-notZeichenkette, Codeder ganze Wert auf ein I-Regexp-Muster passt bzw. keiner passt

Warum ein regulärer Ausdruck erlaubt ist

Das Handbuch lehnt Ausdruckssprachen ab, weil zwei konforme Tools dann zwei Urteile liefern können. Python, .NET und JavaScript sind sich genau bei den Konstrukten uneins, zu denen man greift: \d, \w, Anker, Flags, Lookaround. Der Dialekt ist deshalb I-Regexp (RFC 9485), von der IETF für Interoperabilität geschaffen und von JSONPath verwendet.

Was der Kern über den RFC hinaus festlegt

  • Ein Muster passt auf den ganzen Wert. ^ und $ sind gewöhnliche Zeichen.
  • Grenzen: 256 Zeichen je Muster, 1.000 Zustände, 4.096 Zeichen je Wert. Darüber hinaus ist die Zeile nicht eindeutig.
  • Keine Regex-Engine des Hosts. Jede Implementierung parst die Grammatik selbst, so wie RFC 9485 sie veröffentlicht, und wertet ohne Backtracking aus, sodass ein Muster keinen Validator lahmlegen kann.
  • Eine Abhängigkeit bleibt und ist benannt: Eine Unicode-Kategorie \p{..} wird aus der Datenbank des Hosts gelesen (Backlog 59).

05 Nachweise

Jedes Glied lässt sich offline prüfen

Der Nachweis ist ein Verzeichnis neben dem Inhaltsmanifest. Jede Datei ist nach dem SHA-256 ihrer Bytes benannt. Geschwärzt wird vor dem Hashen, und die Rohausgabe ist eine eigene Datei; so bleibt der Datensatz nach einer Löschung wegen abgelaufener Aufbewahrungsfrist verifizierbar: Der Validator meldet die Datei als zurückgehalten.

06 Gemessene Passung

481 von 510 Regeln passen in die deklarative Form

Die Menge der Komparatoren wurde zuerst entworfen und danach gemessen, an zwei offenen Check-Korpora: den vier CIS-Profilen für Ubuntu 24.04 in ComplianceAsCode (510 Regeln) und den CIS-1.12-Checks von kube-bench (103 automatisiert, 28 manuell).

KlasseRegeln von 510
Passt23 davon nur, wenn der Kollektor effektive Werte auflöst und Modusbits als Flag-Mengen meldet481
Braucht ArithmetikZählungen, Eindeutigkeit, Zeit gegenüber jetzt12
Braucht einen Vergleich zwischen zwei Fakten9
Braucht ODER über mehrere Fakten6
Braucht eine Ordnung von Versionen2
Braucht eine Regex außerhalb von I-Regexp0

Was die Erhebung zeigt gemessen, Passung nach Einschätzung

  • Die Vergleichsseite ist klein, die Logik liegt auf der Sammelseite. In 126 handgeschriebenen OVAL-Definitionen vergleichen die States 99-mal auf Gleichheit, 23-mal mit einem Muster und 41-mal mit einer Ordnung.
  • Von 491 regulären Ausdrücken stehen 23 auf der Vergleichsseite. Alle 23 liegen innerhalb von I-Regexp oder lassen sich mechanisch umschreiben.
  • Von den 21 ODER-Checks in kube-bench lauten 16 „Flag fehlt oder Flag gleich Wert“. Ein Kollektor, der den effektiven Wert meldet, macht daraus einen einzigen Vergleich.

Was sie korrigiert hat

Die Menge im Entwurf hatte kein Ungleich. Die Erhebung fand es zweimal in den OVAL-States und 85-mal über alle Verzeichnisse von kube-bench, und bei einer Zahl lässt es sich auf keine andere Weise ausdrücken. Es wurde am 12. November als zwölfter Komparator ergänzt. Die 29 Regeln, die nicht passen, bleiben manuell.

Skripte der Erhebung und Rohzählungen

07 Stand

Für 2.0.0 angenommen, grün in beiden Validatoren

Am 12. November 2026 hat der Autor die offenen Punkte des Vorschlags entschieden. Check ist seit 2.0.0-rc.2 Teil des Release-Kandidaten und geht mit 2.0.0 live. Der Kandidat, jetzt rc.4, ist nicht getaggt.

Im Repository

gemessen
  • Schema und Regeln: die Form von Check, die Laufzeilen im Assessment, die Referenz im Finding, der Nachweisdatensatz, die Facette collector@1; CHECK-1 bis CHECK-15 und das Primitiv check-verdict, jeweils mit einer Begründung, die bei einem Fehlschlag ausgegeben wird.
  • 205 Konformitätsvektoren bestehen in der Python-Referenz, im PowerShell-Zwilling unter Windows PowerShell 5.1 und in der JavaScript-Portierung der App. Fünf absichtlich eingebaute Fehler in der Referenz färben jeweils einen Vektor rot.
  • Ein ausgearbeitetes Beispiel mit zwei Checks, zwei Läufen, einem Finding und sieben Nachweisdateien.
  • Die Grammatik von RFC 9485 in der veröffentlichten Fassung, abgeglichen am 12. November. Sie hält Surrogat-Codepoints aus Mustern heraus, was die Datei der Arbeitsgruppe nicht tat; die drei Engines wurden korrigiert, und fünf Vektoren schreiben es fest.
  • Text: Spezifikation D24, Handbuchkapitel 10 und das Validator-Kapitel, die Anhänge A, B und C sowie der Skill für Coding-Agenten.
  • Werkzeuge: Auf der Seite Prüfungen (Checks) der App schreiben Sie Checks von Hand oder lassen sie von einem Sprachmodell entwerfen, Regel für Regel oder für jede automatisierte Regel eines CIS-Imports. Der Reader als Einzeldatei zeigt Checks und aufgezeichnete Läufe.

Offen

offen
  • Kein Runner. Nichts im Repository führt einen Kollektor auf einem Zielsystem aus, und die App auch nicht. Ein HTTP-Kollektor hat noch kein deklariertes Anfrageformat.
  • Keine Cloud-Plattform gezählt. Die Erhebung umfasst Linux-Hosts und Kubernetes. Mit dem Tag wird die Form auf Grundlage dieser beiden festgeschrieben.
  • Eine offene Entscheidung: ob eine Unicode-Kategorie in einem Muster der Datenbank des Hosts folgt oder einer fixierten Tabelle.
Frage an den AutorEntscheidung vom 12. November 2026
Die Aufnahmeregel verlangt, dass zwei von drei Herausgebern der Erhebung einen Typ kodieren. Keiner kodiert einen Check.Die Regel erhielt eine Klausel für Typen, die Herausgeber von Katalogen nicht veröffentlichen: Ein anerkannter Standard verlangt den Datensatz, oder er ist etablierte Praxis, belegt durch zwei gezählte offene Implementierungen; die beiden anderen Tests gelten weiter; der Typ kommt mit einer Major-Version. Risk kommt über den ersten Zweig hinein, Check über den zweiten.
Laufzeilen: Kernfeld oder Facette?Kernfeld. Ein Urteil ist Berechnung, und Facetten definieren nie Berechnung.
Darf ein Check ohne die Anforderung ausgeliefert werden, auf die er verweist?Ja. Ein Check-Paket für einen Katalog, der nicht weitergegeben werden darf, validiert für sich allein.
Jetzt aufnehmen oder auf eine Erhebung von Cloud-APIs warten?Check geht mit 2.0.0 live.
Ein Quantor neben „jede Ressource“?Keiner. Jede Ressource wird ausgewertet und aufgezeichnet, der Anteil der Fehlschläge wird gemeldet, und der Check schlägt fehl.
Ein zwölfter Komparator not-equals?Ergänzt.

Der Vorschlag mit seiner Erhebung, der nicht gewählten Alternative (Kriterien in einer Facette, Aufnahme später) und dem Protokoll der Entscheidungen: drafts/CP-CHECK-1.md. Der normative Text: Spezifikation 2.0.0-rc.4, D24.

Prüfen Sie den Kandidaten, bevor das Tag die Form festschreibt

Für einen Kerntyp zahlt jeder Validator auf Dauer, und eine Korrektur nach dem Tag kostet eine Major-Version. Der Kandidat braucht Leser, die beruflich Scanner betreiben: Hält der Faktenvertrag für Ihre Plattform, und welcher Ihrer Checks fällt aus den zwölf Komparatoren heraus?