feat(web): add IwoooS host intake preflight

This commit is contained in:
Your Name
2026-05-19 21:57:32 +08:00
parent 33e793bb76
commit 394a74908c
11 changed files with 508 additions and 6 deletions

View File

@@ -45,6 +45,7 @@ IwoooS 首版只讀取或對齊以下已提交 evidence
13. 6 個主機動作 gate itemsactive scan、credentialed scan、Kali `/execute`、SSH / host change、Kali update、runtime blocking control。
14. 7 個主機 evidence readiness itemsscope boundary、owner decision、credential handling、maintenance window、rollback plan、validation metrics、redacted ingestion。
15. 7 個主機 evidence collection order steps顯示收件順序與前置依賴。
16. 7 個主機 evidence intake preflight checks顯示未來 evidence 進人工 review 前的拒收 / 隔離規則。
## 3.1 既有前端資安頁面整合
@@ -176,6 +177,24 @@ S2.17 將 S2.16 的七個主機 evidence readiness items 排成建議收件順
這個順序是收件提示,不是工作佇列。不得因為某個 step 顯示為下一個候選,就啟動 scan、SSH、Kali update、raw payload ingestion、runtime blocking control或把對應 evidence 標成已收到 / 已接受。
## 3.9 主機 Evidence Intake Preflight
S2.18 將主機 evidence 進人工 review 前的預檢條件顯示成只讀規則。這一層只回答「未來 evidence 送進來前要先擋什麼」,不接收 payload、不驗收 evidence、不推進 counters。
| 順序 | 預檢項目 | 拒收 / 隔離條件 | 目前狀態 |
|------|----------|------------------|----------|
| 1 | Metadata pointer only | 缺 redacted metadata pointer | `preflight_ready_not_executed`received=0、accepted=0 |
| 2 | Collection order match | 跳過 S2.17 前置依賴 | `dependency_check_waiting_evidence`received=0、accepted=0 |
| 3 | Scope before scan | scan evidence 沒有 scope boundary | `waiting_scope_evidence`received=0、accepted=0 |
| 4 | Owner before host change | SSH / update / tuning / blocking evidence 缺 owner decision pointer | `waiting_owner_decision_pointer`received=0、accepted=0 |
| 5 | Credential plaintext blocked | 出現帳密、token、private key、session 或憑證明文 | `plaintext_credential_collection_forbidden`received=0、accepted=0 |
| 6 | Raw payload blocked | 出現完整掃描 raw output、未脫敏 finding、host dump 或 log bundle | `raw_payload_collection_forbidden`received=0、accepted=0 |
| 7 | Frontend counters frozen | 前端嘗試推進 received / accepted | `frontend_counter_transition_forbidden`received=0、accepted=0 |
每個 check 都固定 `display_mode=intake_preflight_only``raw_payload_allowed=false``secret_value_collection_allowed=false``runtime_execution_authorized=false``action_buttons_allowed=false``not_authorization=true`
這個 preflight board 不代表已收到任何主機 evidence也不代表已進人工 review。真正收件仍需要脫敏 evidence pointer、owner decision 與後續人工驗收。
## 4. 仍禁止
IwoooS 不得提供下列輸出:
@@ -189,7 +208,9 @@ IwoooS 不得提供下列輸出:
7. 套用 runtime blocking control。
8. 將主機 evidence 標記為 received / accepted或匯入 raw host evidence。
9. 推進 host collection state 或跳過 host evidence dependency。
10. 把 58% progress、contract count、mirror readiness 或前端可見狀態當成授權
10. 未通過 preflight 就接受 host evidence
11. 收集 host credential plaintext、ingest host raw payload或由前端推進 host evidence counters。
12. 把 58% progress、contract count、mirror readiness 或前端可見狀態當成授權。
## 5. 驗證

View File

@@ -35,7 +35,7 @@
| Owner response validation | S4.13 已建立;四包 owner response 目前 received/accepted 皆為 04 條 missing response lanes、4 步 collection order、next collection candidate、6 條 evidence routing rules、8 個 display sections、7 條 state transition rules、9 個 reviewer checklist items、7 條 reviewer outcome lanes、4 個 reviewer audit event templates、5 個 reviewer audit display sections、6 個 reviewer audit collection checks、5 個 reviewer audit redaction examples、5 條 reviewer audit retention rules、6 個 reviewer audit retention checks、6 個 reviewer audit handoff packets、6 個 reviewer audit handoff checks、6 個 parallel session sync checks、6 條 parallel session conflict lanes、6 個 parallel session recovery checks 與 7 條 parallel session recovery outcome lanes 可供 AwoooP 直接顯示;下一個建議收件為 S4.9 Gitea owner attestationlatest local validation 為 `SOURCE_CONTROL_OWNER_RESPONSE_GUARD_OK`reviewer audit emitted 仍為 0不代表 owner response 已收到或任何執行授權 |
| Low-friction rollout policy | S1.3 已補 7 條 non-blocking escalation lanesLOW / MEDIUM、缺 owner response、partial mirror、source-control drift、Kali observe finding、workflow / secret name gap 與 headline holding 初期只能 observe / warn`owner_review_required_before_blocking=true``runtime_blocking_allowed=false` |
| IwoooS frontend posture | S2.8 已新增 `/iwooos` read-only Information Security 入口;顯示 Security Posture / Exposure、source-control supply chain、Kali 112 Mesh、approval boundary、non-blocking lanes 與 evidence refs不新增執行按鈕 |
| IwoooS posture projection | S2.9 已新增 `iwooos_posture_projection_v1`S2.10 已把 10 個既有前端資安相關頁面納入 projectionS2.11 已補 4 個 coverage groups 與 5 個 conflict controlsS2.12 已補 6 個只讀 operator journey stepsS2.13 已補 7 個 owner evidence readiness itemsS2.14 已補 3 個 host coverage itemsKali 112、開發主機 168、開發主機 111S2.15 已補 6 個 host action gate itemsS2.16 已補 7 個 host evidence readiness itemsS2.17 已補 7 個 host evidence collection order steps仍不新增 action button |
| IwoooS posture projection | S2.9 已新增 `iwooos_posture_projection_v1`S2.10 已把 10 個既有前端資安相關頁面納入 projectionS2.11 已補 4 個 coverage groups 與 5 個 conflict controlsS2.12 已補 6 個只讀 operator journey stepsS2.13 已補 7 個 owner evidence readiness itemsS2.14 已補 3 個 host coverage itemsKali 112、開發主機 168、開發主機 111S2.15 已補 6 個 host action gate itemsS2.16 已補 7 個 host evidence readiness itemsS2.17 已補 7 個 host evidence collection order stepsS2.18 已補 7 個 host evidence intake preflight checks仍不新增 action button |
| Dry-run | `contract_defined_not_executed`;已納入 `CHECK_PROGRESS_GUARD``CHECK_OWNER_RESPONSE_GUARD`latest local validation 為 `repo_snapshot_guard_pass`,仍不代表 production ingestion |
| Runtime actions | `false` |
| Payload ingestion | `false` |
@@ -101,6 +101,7 @@
| S2.15 IwoooS host action gate matrix | framework detail | 0 | 只把 active scan、credentialed scan、Kali `/execute`、SSH / host change、Kali update 與 runtime blocking control 拆成只讀 gate不代表任何主機動作或 runtime enforcement 已批准 |
| S2.16 IwoooS host evidence readiness board | framework detail | 0 | 只顯示主機動作前仍缺 scope、owner decision、credential handling、maintenance window、rollback、validation metrics 與 redacted ingestion evidencereceived / accepted 仍為 0不代表任何主機動作已批准 |
| S2.17 IwoooS host evidence collection order | framework detail | 0 | 只把七個主機 evidence readiness items 排成只讀收件順序與依賴關係received / accepted 仍為 0不代表 active scan、SSH、Kali update、raw evidence ingestion 或 runtime control 已批准 |
| S2.18 IwoooS host evidence intake preflight | framework detail | 0 | 只把主機 evidence 進人工 review 前的七個預檢規則顯示出來raw payload、secret value、runtime execution、action button 與 received / accepted counter 仍全部鎖住 |
headline 進度要再往上,至少需要下列任一高層 gate 有實質 evidence

View File

@@ -4,7 +4,7 @@
|------|------|
| 日期 | 2026-05-17 |
| 狀態 | S0/S1 read-only evidence 建置中 |
| 本階段完成 | 資安供應鏈 contract manifest + Source Control Approval Board + Draft Reconcile Plan + Ref Detail Diff + Ref Truth Classification + Source Control Ref Truth Owner Response 收件包 + GitHub Primary Readiness Gate + GitHub Primary Rollback ADR + GitHub Target Owner Decision Response 收件包 + Gitea 認證清冊匯出請求 + Gitea 認證清冊匯入驗收契約 + Gitea 清冊覆蓋 Owner Attestation + Gitea Owner Attestation Approval Lane 對齊 + Gitea Owner Attestation Response 收件包 + Workflow / Secret Name Inventory + Workflow / Secret Name Local Evidence + Workflow / Secret Name Redacted Export Request + Workflow / Secret Name Owner Response 收件包 + Source Control Owner Response Validation Rollup + Kali 112 live integration status + Security Finding contract + Kali scan scope approval package + Security Approval Queue + S3 人工批准 Gate + S3 人工決策紀錄 + S3 人工審查封包 + S3 人工決策狀態轉移 + S3 後續 runtime gate 準備契約 + 鏡像 readiness index + 鏡像接收計畫 + 鏡像事件信封 + 鏡像路由矩陣 + 鏡像驗收契約 + 鏡像隔離契約 + 鏡像 dry-run 報告契約 + 鏡像狀態彙整契約 + IwoooS 前端態勢入口 + IwoooS posture projection contract + IwoooS 既有前端資安頁面整合 + IwoooS 覆蓋與邊界矩陣 + IwoooS 只讀資安處理旅程 + IwoooS owner evidence readiness board + IwoooS host coverage view + IwoooS host action gate matrix + IwoooS host evidence readiness board + IwoooS host evidence collection order |
| 本階段完成 | 資安供應鏈 contract manifest + Source Control Approval Board + Draft Reconcile Plan + Ref Detail Diff + Ref Truth Classification + Source Control Ref Truth Owner Response 收件包 + GitHub Primary Readiness Gate + GitHub Primary Rollback ADR + GitHub Target Owner Decision Response 收件包 + Gitea 認證清冊匯出請求 + Gitea 認證清冊匯入驗收契約 + Gitea 清冊覆蓋 Owner Attestation + Gitea Owner Attestation Approval Lane 對齊 + Gitea Owner Attestation Response 收件包 + Workflow / Secret Name Inventory + Workflow / Secret Name Local Evidence + Workflow / Secret Name Redacted Export Request + Workflow / Secret Name Owner Response 收件包 + Source Control Owner Response Validation Rollup + Kali 112 live integration status + Security Finding contract + Kali scan scope approval package + Security Approval Queue + S3 人工批准 Gate + S3 人工決策紀錄 + S3 人工審查封包 + S3 人工決策狀態轉移 + S3 後續 runtime gate 準備契約 + 鏡像 readiness index + 鏡像接收計畫 + 鏡像事件信封 + 鏡像路由矩陣 + 鏡像驗收契約 + 鏡像隔離契約 + 鏡像 dry-run 報告契約 + 鏡像狀態彙整契約 + IwoooS 前端態勢入口 + IwoooS posture projection contract + IwoooS 既有前端資安頁面整合 + IwoooS 覆蓋與邊界矩陣 + IwoooS 只讀資安處理旅程 + IwoooS owner evidence readiness board + IwoooS host coverage view + IwoooS host action gate matrix + IwoooS host evidence readiness board + IwoooS host evidence collection order + IwoooS host evidence intake preflight |
| 原則 | 低摩擦分階段文件、schema、read-only evidence 優先;不做 runtime enforcement、不切 primary |
## 0. 本階段完成後整體進度
@@ -77,6 +77,7 @@ python3 scripts/security/security-mirror-progress-guard.py
| S2.15 IwoooS host action gate matrix | 已完成草案,將 active scan、credentialed scan、Kali `/execute`、SSH / host change、Kali update、runtime blocking control 固定為 6 個只讀 gate items | 0 |
| S2.16 IwoooS host evidence readiness board | 已完成草案,將 scope boundary、owner decision、credential handling、maintenance window、rollback plan、validation metrics、redacted ingestion 固定為 7 個只讀 readiness items | 0 |
| S2.17 IwoooS host evidence collection order | 已完成草案,將七個主機 evidence readiness items 排成只讀收件順序與依賴關係received / accepted 仍為 0 | 0 |
| S2.18 IwoooS host evidence intake preflight | 已完成草案,將主機 evidence 進人工 review 前的 metadata pointer、dependency、scope、owner decision、credential plaintext、raw payload 與 counter freeze 預檢顯示成只讀規則 | 0 |
headline 要再往上,需要 S4.9 / S4.10 / S4.11 / S4.12 任一 owner response 收到並通過脫敏驗收,或人工批准後出現 active runtime gate、redacted payload ingestion、GitHub primary readiness 這類落地 evidence。
@@ -113,6 +114,7 @@ headline 要再往上,需要 S4.9 / S4.10 / S4.11 / S4.12 任一 owner respons
| S2.15 IwoooS Host Action Gate Matrix | 完成草案 | `/iwooos` 新增主機動作 gate 矩陣,將 active scan、credentialed scan、Kali `/execute`、SSH / host change、Kali update 與 runtime blocking control 拆成只讀 gate | 使用者能看懂主機動作為什麼仍需人工批准;仍不新增任何主機操作或 runtime enforcement |
| S2.16 IwoooS Host Evidence Readiness | 完成草案 | `/iwooos` 新增主機 evidence readiness board顯示主機動作前仍缺 scope、owner decision、credential handling、maintenance window、rollback、validation metrics 與 redacted ingestion evidence | 使用者能看懂主機行動前置證據,不會把規劃誤認為已批准;仍不新增任何主機操作 |
| S2.17 IwoooS Host Evidence Collection Order | 完成草案 | `/iwooos` 新增主機 evidence 收件順序,將 scope、owner decision、credential handling、maintenance window、rollback、validation metrics 與 redacted ingestion 排成只讀依賴 | 使用者能知道下一步先收什麼;仍不把任何 evidence 標成 received / accepted也不啟動掃描、SSH、更新或 runtime control |
| S2.18 IwoooS Host Evidence Intake Preflight | 完成草案 | `/iwooos` 新增主機 evidence intake preflight顯示 metadata pointer、collection order、scope、owner decision、credential plaintext、raw payload 與 counter freeze 七個預檢 | 使用者能知道 evidence 送審前會先擋哪些風險;仍不收 raw payload、不收憑證明文、不推 received / accepted、不啟動 runtime |
| S3 approval gate | 進行中 | `security_approval_gate_v1` 已建立 8 個人工 gate items7 pending、1 block candidate、0 approved | 不得繞過人工批准;批准後仍需 follow-up runtime gate |
| S3.0 人工批准 Gate 契約 | 完成草案 | 定義批准範圍、決策選項、required reviewers、still forbidden 與 follow-up runtime gate | AwoooP 可記錄決策,不可執行 gate item |
| S3.1 人工決策紀錄契約 | 完成草案 | `security_approval_decision_record_v1` 已建立;目前 0 筆 decision records、0 個 runtime action 授權 | AwoooP 可稽核決策,不可把決策當執行 |

View File

@@ -43,7 +43,8 @@
"host_coverage_item_count": 3,
"host_action_gate_item_count": 6,
"host_evidence_readiness_item_count": 7,
"host_evidence_collection_step_count": 7
"host_evidence_collection_step_count": 7,
"host_evidence_intake_preflight_check_count": 7
},
"progress": {
"overall_percent": 58,
@@ -123,7 +124,8 @@
"display_evidence_refs",
"display_next_gate",
"display_forbidden_actions",
"display_host_evidence_collection_order"
"display_host_evidence_collection_order",
"display_host_evidence_intake_preflight_checks"
],
"forbidden_frontend_outputs": [
"add_scan_button",
@@ -150,7 +152,11 @@
"production_deploy",
"treat_progress_as_authorization",
"advance_host_collection_state",
"skip_host_evidence_dependency"
"skip_host_evidence_dependency",
"accept_host_evidence_without_preflight",
"ingest_host_evidence_raw_payload",
"collect_host_credential_plaintext",
"advance_host_evidence_counters_from_frontend"
],
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
@@ -1029,5 +1035,138 @@
"action_buttons_allowed": false,
"not_authorization": true
}
],
"host_evidence_intake_preflight_checks": [
{
"check_id": "host_metadata_pointer_shape_check",
"display_order": 1,
"source_step_ids": [
"collect_scope_boundary_first"
],
"preflight_state": "preflight_ready_not_executed",
"rejection_lane": "reject_missing_redacted_metadata_pointer",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_collection_dependency_order_check",
"display_order": 2,
"source_step_ids": [
"collect_scope_boundary_first",
"collect_owner_decision_second",
"collect_credential_handling_third",
"collect_maintenance_window_fourth",
"collect_rollback_plan_fifth",
"collect_validation_metrics_sixth",
"collect_redacted_ingestion_seventh"
],
"preflight_state": "dependency_check_waiting_evidence",
"rejection_lane": "quarantine_dependency_skip",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_scope_boundary_before_scan_check",
"display_order": 3,
"source_step_ids": [
"collect_scope_boundary_first"
],
"preflight_state": "waiting_scope_evidence",
"rejection_lane": "reject_scan_without_scope",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_owner_decision_before_change_check",
"display_order": 4,
"source_step_ids": [
"collect_owner_decision_second"
],
"preflight_state": "waiting_owner_decision_pointer",
"rejection_lane": "reject_change_without_owner_decision",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_credential_plaintext_rejection_check",
"display_order": 5,
"source_step_ids": [
"collect_credential_handling_third"
],
"preflight_state": "plaintext_credential_collection_forbidden",
"rejection_lane": "reject_plaintext_credential_or_secret_value",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_raw_payload_rejection_check",
"display_order": 6,
"source_step_ids": [
"collect_redacted_ingestion_seventh"
],
"preflight_state": "raw_payload_collection_forbidden",
"rejection_lane": "reject_raw_payload_ingestion",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
},
{
"check_id": "host_counter_transition_freeze_check",
"display_order": 7,
"source_step_ids": [
"collect_scope_boundary_first",
"collect_owner_decision_second",
"collect_credential_handling_third",
"collect_maintenance_window_fourth",
"collect_rollback_plan_fifth",
"collect_validation_metrics_sixth",
"collect_redacted_ingestion_seventh"
],
"preflight_state": "frontend_counter_transition_forbidden",
"rejection_lane": "reject_frontend_counter_transition",
"display_mode": "intake_preflight_only",
"received_count": 0,
"accepted_count": 0,
"raw_payload_allowed": false,
"secret_value_collection_allowed": false,
"runtime_execution_authorized": false,
"action_buttons_allowed": false,
"not_authorization": true
}
]
}

View File

@@ -720,6 +720,18 @@
"runtime_delta": false,
"execution_authorized": false,
"not_authorization": true
},
{
"delta_id": "s2_18_iwooos_host_evidence_intake_preflight",
"display_order": 47,
"completed_stage": "S2.18 IwoooS host evidence intake preflight",
"progress_axis": "framework_detail",
"headline_percent_delta": 0,
"framework_delta_visible": true,
"why_headline_unchanged": "IwoooS host evidence intake preflight 只顯示主機 evidence 進人工 review 前的 metadata pointer、依賴順序、scope、owner decision、credential plaintext、raw payload 與 counter freeze 預檢received / accepted 仍為 0raw payload、secret value、runtime execution 與 action button 仍為 false。",
"runtime_delta": false,
"execution_authorized": false,
"not_authorization": true
}
],
"next_safe_actions": [