テーラリングしたパラメータがチェックを調整し直す
Tailoring で max-auth-tries を 6 から 4 に厳しくすると、昨日の観測値 5 は充足から不充足に変わります。コードは 1 行も変わらず、実装者が自分で合格基準を設定することもできません。
チェック · カーネル 2.0.0、リリース候補
終了コード 0 か 1 を返すだけのスキャナーは、しきい値を隠し、テーラリングを無視し、再検証できるものを何も残しません。Check は、コレクターが報告すべきファクトと、判定を下す比較を公開します。実行記録には観測された内容が含まれるため、誰でも記録から判定を再計算できます。
01 ギャップ
JASCON 1.0.0 では、要求事項が評価されたことと、評価者がどう結論付けたかは表現できます。しかし、機械がどう判定するかは表現できません。
そのすべてが、変換後のバンドルでは、文章中にシェルの抜粋を含む audit 文字列として届きます。合格条件は「verify the output is」のような文であり、人が読まなければなりません。
ISM、Grundschutz++、SP 800-53 は、手法(検査、インタビュー、テスト)と必要な文書を挙げています。FedRAMP CR26 は、主要なテストを文章で記載しています。いずれも、プログラムが評価できるチェックを規定していません。
件数の出典:CP-CHECK-1 の 2.1 節。変換済みコーパスのカバレッジレポートに基づく。
02 設計
境界線は、ツール同士の結果が一致しなければならない箇所に引かれています。仕様に適合する 2 つのツールに同じ Check と同じ観測値を与えれば、同じ判定が返ります。誠実なツールの間で異なっていても判定が変わらないものは、すべてカーネルの外に置かれます。
シェルスクリプト、Ansible タスク、または API 呼び出しです。Check に格納されるため、チェックのダイジェストがコードそのものを対象に含みます。観測値を 1 つ出力するだけで、何も判定しません。
sshd.maxauthtries(整数)のように、名前と型を持つファクトです。コレクターは、デフォルト値を解決した実効値を報告します。キーがないことは「調べたが見つからなかった」を意味します。
at-most {param} のようなフラットな論理積です。期待値はリテラルか要求事項のパラメータであるため、そのパラメータをバインドする Tailoring が合格基準を決めます。
充足、不充足、判定不能、該当なしのいずれかです。判定は、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 がバインドする値を変えてみてください。
s1 SSH デーモンは、1 接続あたりの認証試行を最大 4 回まで許可する。
s2 SSH デーモンは、CBC モードの暗号方式を提供しない。
アプリに移植された 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" }
]
}
aes128-cbc が含まれ、不充足。Assessment の結果は、その各行を集約したものです。この例では、実在のホストは評価していません。各実行では、Check の bash コレクターを変更せずに、固定の設定を出力するスタブの sshd に対して実行しており、すべての証跡記録にその旨が記載されています。
04 比較演算子
この集合は、意図的に小さくしてあります。収まらないチェックは手動のまま残り、その件数が数えられます。
one-of で表し、否定は演算子の対で表します。at-most は、値を大きくするほど厳しくなるパラメータを決してバインドしません。これにより、パラメータを厳しくしてもチェックが緩むことはありません。| 演算子 | 対象 | 成立する条件 |
|---|---|---|
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) を採用しています。
^ と $ は通常の文字です。\p{..} は、ホストのデータベースから読み取られます(バックログ 59)。05 証跡
証跡は、コンテンツマニフェストの隣にあるディレクトリです。すべてのファイルは、そのバイト列の SHA-256 で命名されます。墨消しはハッシュ計算の前に行われ、生の出力は別ファイルになります。そのため、保存期間に基づいてファイルを削除しても記録は検証可能なままで、バリデータはそのファイルを「非開示」と報告します。
Assessment のセマンティックダイジェストを結び付けます。
観測値をインラインで保持するため、そのダイジェストが観測値を対象に含みます。Check を参照とダイジェストの両方で指定します。変更されたチェックは別のチェックです。
チェック、コレクター、対象、開始、終了、終了ステータスを示し、同じ観測値のダイジェストを保持します。
stdout や API レスポンスです。それぞれダイジェストで指定され、メディアタイプ、サイズ、墨消しフラグを伴います。
06 実測による適合度
比較演算子の集合は先に起草し、その後で 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 の state で 2 回、kube-bench の全ディレクトリで 85 回見つかり、数値については他のどの演算子でも表現できません。11月12日に、12 番目の比較演算子として追加されました。収まらない 29 ルールは手動のままです。
07 現状
2026年11月12日、作成者が提案の未決事項を決定しました。Check は 2.0.0-rc.2 からリリース候補に含まれており、2.0.0 で正式に導入されます。現在 rc.4 となっている候補は、まだタグ付けされていません。
collector@1。CHECK-1 から CHECK-15 までのルールと、プリミティブ check-verdict。いずれも、失敗時に出力される論拠を持ちます。| 作成者への質問 | 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 個の比較演算子に収まらないものはどれでしょうか。