チェック · カーネル 2.0.0、リリース候補

評価者が機械であるとき

終了コード 0 か 1 を返すだけのスキャナーは、しきい値を隠し、テーラリングを無視し、再検証できるものを何も残しません。Check は、コレクターが報告すべきファクトと、判定を下す比較を公開します。実行記録には観測された内容が含まれるため、誰でも記録から判定を再計算できます。

11 番目のカーネル型、2.0.0 候補 205 件のテストベクトルが 3 つの実装で合格 2.0.0 は未タグ付け

01 ギャップ

自動化は発行元に存在するが、途中で失われる

JASCON 1.0.0 では、要求事項が評価されたことと、評価者がどう結論付けたかは表現できます。しかし、機械がどう判定するかは表現できません。

312 件中 291 件

CIS Ubuntu 24.04 Benchmark のルールのうち、自動化対象と指定されたもの

そのすべてが、変換後のバンドルでは、文章中にシェルの抜粋を含む audit 文字列として届きます。合格条件は「verify the output is」のような文であり、人が読まなければなりません。

3 機関中 0

機械判定可能なチェックを符号化している、調査対象の発行機関

ISM、Grundschutz++、SP 800-53 は、手法(検査、インタビュー、テスト)と必要な文書を挙げています。FedRAMP CR26 は、主要なテストを文章で記載しています。いずれも、プログラムが評価できるチェックを規定していません。

件数の出典:CP-CHECK-1 の 2.1 節。変換済みコーパスのカバレッジレポートに基づく。

02 設計

コレクターは観測し、基準が判定する

境界線は、ツール同士の結果が一致しなければならない箇所に引かれています。仕様に適合する 2 つのツールに同じ Check と同じ観測値を与えれば、同じ判定が返ります。誠実なツールの間で異なっていても判定が変わらないものは、すべてカーネルの外に置かれます。

ファセット(カーネルの外)

コレクター

シェルスクリプト、Ansible タスク、または API 呼び出しです。Check に格納されるため、チェックのダイジェストがコードそのものを対象に含みます。観測値を 1 つ出力するだけで、何も判定しません。

カーネル:ファクト契約

観測値

sshd.maxauthtries(整数)のように、名前と型を持つファクトです。コレクターは、デフォルト値を解決した実効値を報告します。キーがないことは「調べたが見つからなかった」を意味します。

カーネル:12 個の比較演算子

基準

at-most {param} のようなフラットな論理積です。期待値はリテラルか要求事項のパラメータであるため、そのパラメータをバインドする Tailoring が合格基準を決めます。

カーネル:check-verdict

判定

充足、不充足、判定不能、該当なしのいずれかです。判定は、Check、観測値、バインドされたパラメータだけから決まる純粋関数です。バリデータは記録されたすべての判定を再計算します。

テーラリングしたパラメータがチェックを調整し直す

Tailoring で max-auth-tries を 6 から 4 に厳しくすると、昨日の観測値 5 は充足から不充足に変わります。コードは 1 行も変わらず、実装者が自分で合格基準を設定することもできません。

判定は信用せず、再計算する

Assessment の行は観測値そのものを保持します。別の当事者がその観測値で基準を評価し、比較します。記録された結果が計算結果と異なれば、検証エラーになります。

記録は観測された内容を示す

失敗した行には sshd.ciphers matches-not ".*-cbc" とあり、観測値は aes128-cbc を含むリストでした。終了コードなら 1 と示すだけだったでしょう。

03 試してみる

観測値を設定し、合格基準を動かす

リポジトリの作例です。2 つの条項を持つ 1 つの要求事項、本番ホスト向けの Tailoring、2 つの Check、そして踏み台ホストで記録された 2 回の日次実行からなります。コレクターが観測した値や、Tailoring がバインドする値を変えてみてください。

bastion-01 上の LNX-SSH-1 リポジトリの作例
要求事項

s1 SSH デーモンは、1 接続あたりの認証試行を最大 4 回まで許可する。

s2 SSH デーモンは、CBC モードの暗号方式を提供しない。

コレクターの観測値sshd.ciphers
記録された実行
評価の結果 …

アプリに移植された check-verdict によって、ブラウザ内で計算しています。これは 205 件のチェック用テストベクトルに合格するコードです。ここではコレクターは実行されず、観測値は入力した値です。

{
  "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" }
  ]
}
抜粋 · jascon/examples

サンプルバンドルが記録している内容

  • 11月3日:上限 4 回に対して認証試行 4 回で、充足。暗号方式のリストに aes128-cbc が含まれ、不充足。Assessment の結果は、その各行を集約したものです。
  • 条項 s2 に対する Finding は、それを提起したチェックを指しています。その対応措置は、当該暗号方式の削除です。
  • 11月10日:両方の行が充足。Finding はクローズされ、それを検証した実行と関連付けられています。

この例では、実在のホストは評価していません。各実行では、Check の bash コレクターを変更せずに、固定の設定を出力するスタブの sshd に対して実行しており、すべての証跡記録にその旨が記載されています。

アプリの Checks ページで例を開く

04 比較演算子

12 個の演算子と、含めなかったもののリスト

この集合は、意図的に小さくしてあります。収まらないチェックは手動のまま残り、その件数が数えられます。

  • 基準は論理積です。OR も NOT も入れ子もありません。値の選択肢は one-of で表し、否定は演算子の対で表します。
  • 算術演算も、2 つのファクト間の比較もありません。数え上げや導出はコレクターの仕事です。
  • 結合は強クリーネ論理の AND です。確定した失敗が 1 つあれば結果が決まり、他の箇所にある不明値の陰に失敗が隠れることはありません。
  • バインドされていないパラメータは判定不能になります。デフォルト値で代用されることはありません。
  • at-most は、値を大きくするほど厳しくなるパラメータを決してバインドしません。これにより、パラメータを厳しくしてもチェックが緩むことはありません。
  • 多数のリソースを対象とするチェックは、該当するすべてのリソースが合格した場合にのみ合格します。すべてのリソースが評価され、最初の失敗の後もスキップされるものはなく、判定には件数と割合が付きます。例:「該当するバケットリソース 200 件中 12 件が不充足(6%)」。
演算子対象成立する条件
equals単一の値値が期待値と等しい。10 進数は値で比較
not-equals単一の値値が期待値と異なる。ファクトが欠けていれば判定不能
one-of単一の値値がリストに含まれる
at-least at-most整数、10 進数大小比較。10 進数を浮動小数点数として扱うことはない
present absent任意のファクトキーが観測値に含まれる、または含まれない
includes-allリスト列挙した値がすべて現れる
excludes-allリスト列挙した値がどれも現れない
subset-ofリスト観測されたすべての値が列挙されている
matches matches-not文字列、コード値全体が I-Regexp パターンに一致する、または一致しない

正規表現を認める理由

ハンドブックは式言語を採用していません。式言語では、仕様に適合する 2 つのツールが異なる 2 つの判定を返しうるからです。Python、.NET、JavaScript は、人がよく使う構文、つまり \d、\w、アンカー、フラグ、先読み・後読みで、まさに挙動が食い違います。そのため方言には、IETF が相互運用性のために策定し、JSONPath でも使われている I-Regexp (RFC 9485) を採用しています。

RFC に加えてカーネルが定めること

  • パターンは値全体に一致します。^ と $ は通常の文字です。
  • 上限:パターンあたり 256 文字、状態数 1,000、値あたり 4,096 文字。これを超えると、その行は判定不能になります。
  • ホストの正規表現エンジンは使いません。各実装は、RFC 9485 が公開している文法を自ら解析し、バックトラックなしでマッチングします。そのため、パターンによってバリデータが停止することはありません。
  • 依存が 1 つだけ残っており、それを明記しています。Unicode カテゴリ \p{..} は、ホストのデータベースから読み取られます(バックログ 59)。

05 証跡

連鎖のどの段もオフラインで検証できる

証跡は、コンテンツマニフェストの隣にあるディレクトリです。すべてのファイルは、そのバイト列の SHA-256 で命名されます。墨消しはハッシュ計算の前に行われ、生の出力は別ファイルになります。そのため、保存期間に基づいてファイルを削除しても記録は検証可能なままで、バリデータはそのファイルを「非開示」と報告します。

06 実測による適合度

510 ルール中 481 ルールが宣言的な形式に収まる

比較演算子の集合は先に起草し、その後で 2 つのオープンなチェックコーパスに対して実測しました。ComplianceAsCode にある Ubuntu 24.04 向けの 4 つの CIS プロファイル(510 ルール)と、kube-bench の CIS 1.12 チェック(自動 103 件、手動 28 件)です。

分類510 ルール中
収まるうち 23 件は、コレクターが実効値を解決し、モードビットをフラグの集合として報告する場合に限る481
算術演算が必要件数、一意性、現在時刻との比較12
2 つのファクト間の比較が必要9
ファクトをまたぐ OR が必要6
バージョンの順序付けが必要2
I-Regexp の範囲外の正規表現が必要0

調査からわかること 実測、適合は判断による

  • 比較側は小さく、ロジックは収集側にあります。手書きの OVAL 定義 126 件では、state による比較は、等値が 99 回、パターンが 23 回、大小比較が 41 回でした。
  • 491 個の正規表現のうち、比較側にあるのは 23 個です。23 個すべてが I-Regexp の範囲内にあるか、機械的に書き換えられます。
  • kube-bench の OR を含む 21 件のチェックのうち、16 件は「フラグがない、またはフラグが値と等しい」という内容です。実効値を報告するコレクターなら、これらを 1 つの比較にできます。

調査によって修正されたこと

起草時の集合には「等しくない」がありませんでした。調査では、OVAL の state で 2 回、kube-bench の全ディレクトリで 85 回見つかり、数値については他のどの演算子でも表現できません。11月12日に、12 番目の比較演算子として追加されました。収まらない 29 ルールは手動のままです。

調査スクリプトと集計の生データ

07 現状

2.0.0 への採用が決定し、両バリデータでグリーン

2026年11月12日、作成者が提案の未決事項を決定しました。Check は 2.0.0-rc.2 からリリース候補に含まれており、2.0.0 で正式に導入されます。現在 rc.4 となっている候補は、まだタグ付けされていません。

リポジトリにあるもの

実測
  • スキーマとルール:Check の構造、Assessment 上の実行の行、Finding 上の参照、証跡記録、ファセット collector@1。CHECK-1 から CHECK-15 までのルールと、プリミティブ check-verdict。いずれも、失敗時に出力される論拠を持ちます。
  • 205 件の適合性テストベクトルが、Python のリファレンス実装、Windows PowerShell 5.1 上の PowerShell 版姉妹実装、アプリの JavaScript 移植版で合格します。リファレンス実装に意図的な破損を 5 か所入れると、それぞれでいずれかのベクトルが赤になります。
  • 2 つの Check、2 回の実行、1 つの Finding、7 つの証跡ファイルからなる作例。
  • 公開されたとおりの RFC 9485 の文法。11月12日に照合しました。この文法はサロゲートコードポイントをパターンから除外しますが、ワーキンググループのファイルはそうなっていませんでした。3 つのエンジンを修正し、5 つのベクトルでこの挙動を固定しています。
  • テキスト:仕様書の D24、ハンドブックの第 10 章とバリデータの章、付録 A、B、C、そしてコーディングエージェント向けのスキル。
  • ツール:アプリの Checks ページでは、チェックを手で書くことも、言語モデルに下書きさせることもできます。下書きは 1 ルールずつでも、CIS からインポートしたすべての自動化ルールに対してでも可能です。単一ファイルのリーダーは、Check と記録された実行を表示します。

未解決

未解決
  • ランナーがない。リポジトリには、ターゲット上でコレクターを実行するものがなく、アプリも実行しません。HTTP コレクターには、宣言されたリクエスト形式がまだありません。
  • クラウドプラットフォームは未調査。調査対象は Linux ホストと Kubernetes です。構造は、この 2 つに基づいてタグ付けの時点で確定します。
  • 未決の選択が 1 つ:パターン中の Unicode カテゴリを、ホストのデータベースに従わせるか、固定されたテーブルに従わせるか。
作成者への質問2026年11月12日の決定
昇格ルールは、調査対象の 3 機関のうち 2 機関がその型を符号化していることを求める。チェックを符号化している機関はない。カタログの発行機関が公開しない型のための条項をルールに追加した。認知された標準がその記録を求めているか、数えられた 2 つのオープンな実装によって示される確立した慣行であること。他の 2 つのテストを満たすこと。メジャーバージョンで導入すること。Risk は 1 つ目の分岐で、Check は 2 つ目の分岐で採用される。
実行の行はカーネルのフィールドか、ファセットか?カーネルのフィールド。判定は計算であり、ファセットが計算を定義することはない。
Check は、参照先の要求事項なしで配布してよいか?よい。再配布できないカタログ向けのチェックパックも、単独で検証できる。
今すぐ取り込むか、クラウド API の調査を待つか?Check は 2.0.0 で正式に導入する。
「すべてのリソース」以外の量化子は必要か?設けない。すべてのリソースを評価して記録し、失敗の割合を報告したうえで、チェックは失敗とする。
12 番目の比較演算子 not-equals を加えるか?追加した。

調査を含む提案、採用されなかった代替案(基準をファセットに置き、昇格は後で行う案)、決定の記録:drafts/CP-CHECK-1.md。規範テキスト:仕様書 2.0.0-rc.4 の D24。

タグ付けで構造が確定する前にレビューを

カーネルの型は、すべてのバリデータが永久にそのコストを負担します。タグ付け後の修正には、メジャーバージョンが必要です。この候補には、スキャナーの運用を仕事にしている読み手が必要です。ファクト契約はお使いのプラットフォームで成り立つでしょうか。お手元のチェックのうち、12 個の比較演算子に収まらないものはどれでしょうか。