449 lines
21 KiB
Python
449 lines
21 KiB
Python
#!/usr/bin/env python3
|
||
"""
|
||
IwoooS Wazuh / 主機入侵 read-only 接入計畫產生器。
|
||
|
||
本工具只產生 repo 內 snapshot，將已建置的 Wazuh 平台、host-110 /
|
||
host-188 入侵跡象、外部 Agent 高風險操作宣稱與後續 containment /
|
||
recovery proof 轉成 IwoooS 可收件、可拒收、可補件的脫敏欄位。
|
||
|
||
它不連 Wazuh API、不讀主機、不 SSH、不啟動 Wazuh active response、
|
||
不隔離主機、不封鎖端口、不重啟服務、不收 secret / private key /
|
||
runner token / webhook secret，也不把外部 Agent 的口頭宣稱視為已修復。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import argparse
|
||
import json
|
||
import subprocess
|
||
import sys
|
||
from datetime import datetime, timedelta, timezone
|
||
from pathlib import Path
|
||
from typing import Any
|
||
|
||
|
||
TAIPEI = timezone(timedelta(hours=8))
|
||
|
||
READBACK_FIELDS = [
|
||
"readback_candidate_id",
|
||
"scope_alias",
|
||
"label",
|
||
"control_tier",
|
||
"priority",
|
||
"source_kind",
|
||
"wazuh_platform_reported_ready",
|
||
"requires_owner_evidence",
|
||
"requires_wazuh_event_refs",
|
||
"requires_host_forensics_refs",
|
||
"requires_cross_project_sync",
|
||
"wazuh_manager_health_ref",
|
||
"wazuh_agent_status_ref",
|
||
"wazuh_alert_rule_refs",
|
||
"wazuh_event_refs",
|
||
"host_auth_log_refs",
|
||
"process_tree_refs",
|
||
"network_connection_refs",
|
||
"file_integrity_refs",
|
||
"package_inventory_refs",
|
||
"persistence_mechanism_refs",
|
||
"runner_or_gateway_config_diff_refs",
|
||
"actor_attribution_ref",
|
||
"incident_time_window_ref",
|
||
"affected_scope",
|
||
"impact_summary_ref",
|
||
"containment_decision",
|
||
"containment_reason_ref",
|
||
"recovery_proof_refs",
|
||
"postcheck_readback_ref",
|
||
"recurrence_guard_ref",
|
||
"cross_project_sync_ref",
|
||
"rollback_owner",
|
||
"followup_owner",
|
||
"reviewer_outcome",
|
||
"not_authorization",
|
||
]
|
||
|
||
REQUIRED_READBACK_FIELDS = [
|
||
"wazuh_manager_health_ref",
|
||
"wazuh_agent_status_ref",
|
||
"wazuh_event_refs",
|
||
"host_auth_log_refs",
|
||
"process_tree_refs",
|
||
"network_connection_refs",
|
||
"file_integrity_refs",
|
||
"package_inventory_refs",
|
||
"persistence_mechanism_refs",
|
||
"actor_attribution_ref",
|
||
"incident_time_window_ref",
|
||
"affected_scope",
|
||
"impact_summary_ref",
|
||
"containment_decision",
|
||
"containment_reason_ref",
|
||
"recovery_proof_refs",
|
||
"postcheck_readback_ref",
|
||
"recurrence_guard_ref",
|
||
"cross_project_sync_ref",
|
||
"rollback_owner",
|
||
"followup_owner",
|
||
"redacted_evidence_refs",
|
||
"no_secret_value_attestation",
|
||
"no_raw_log_attestation",
|
||
"no_raw_wazuh_payload_attestation",
|
||
"no_private_key_or_runner_token_attestation",
|
||
"no_false_green_attestation",
|
||
"external_agent_claim_not_accepted_attestation",
|
||
"active_response_not_enabled_attestation",
|
||
"independent_reviewer_attestation",
|
||
]
|
||
|
||
REVIEWER_CHECKS = [
|
||
{"check_id": "wazuh_platform_ready_is_metadata_only", "instruction": "Wazuh 已建置只能當作平台存在訊號，不能直接視為 IwoooS 已完成事件接入。"},
|
||
{"check_id": "manager_health_ref_present", "instruction": "必須有脫敏 manager / indexer / dashboard / API health ref。"},
|
||
{"check_id": "agent_status_ref_present", "instruction": "host-110、host-188 或其他受影響 host 必須有 agent 狀態 ref。"},
|
||
{"check_id": "event_refs_present", "instruction": "必須有 Wazuh event / alert refs，不能只寫已發現或已阻擋。"},
|
||
{"check_id": "host_forensics_refs_present", "instruction": "需要 auth log、process tree、network connection、file integrity、package inventory 或 persistence refs。"},
|
||
{"check_id": "actor_attribution_present", "instruction": "需要 actor role / team / tool attribution；外部 Agent 操作不能匿名通過。"},
|
||
{"check_id": "time_window_present", "instruction": "需要 incident / operation / recovery time window，供事件與變更對齊。"},
|
||
{"check_id": "affected_scope_present", "instruction": "需列 host alias、服務 alias、產品 alias 與受影響配置類別，不顯示原始內部命名空間。"},
|
||
{"check_id": "containment_decision_present", "instruction": "需有 containment decision 與理由；未決定時維持 waiting_containment_decision。"},
|
||
{"check_id": "external_agent_claim_not_trusted", "instruction": "外部 Agent 宣稱已清除、已修復、已阻擋或已 Zero-Trust 不能直接 accepted。"},
|
||
{"check_id": "runner_gateway_change_reviewed", "instruction": "runner label、runner config、gateway、firewall、workflow 或 secret 相關事件需串到既有高價值配置 gate。"},
|
||
{"check_id": "secret_material_absent", "instruction": "不得收 private key、password、runner token、webhook secret、cookie、env dump、hash 或 partial token。"},
|
||
{"check_id": "raw_payload_absent", "instruction": "不得保存 raw Wazuh payload、raw syslog、raw journal、完整截圖或未脫敏 command output。"},
|
||
{"check_id": "hardcoded_wazuh_credential_rejected", "instruction": "硬編碼 Wazuh URL、使用者、密碼或關閉 TLS 驗證的程式碼必須拒收或隔離。"},
|
||
{"check_id": "readonly_api_disabled_by_default", "instruction": "IwoooS Wazuh API code path 必須預設關閉，沒有 owner gate 與 server-side env 時不得查詢。"},
|
||
{"check_id": "host_write_not_opened", "instruction": "不得因 Wazuh 告警就自動 SSH、kill process、封鎖端口、restart 或修改主機。"},
|
||
{"check_id": "active_response_not_opened", "instruction": "Wazuh active response、firewall drop、isolation 或 remediation 必須另有 break-glass 與人工批准。"},
|
||
{"check_id": "cross_project_sync_present", "instruction": "若事件影響 AWOOOI、AwoooP、IwoooS、任務媒合、股票研究、公開網站或監控，需有同步 ref。"},
|
||
{"check_id": "recovery_proof_present", "instruction": "需要 recovery proof refs；服務 route 200 或 dashboard 可見不能單獨當恢復證據。"},
|
||
{"check_id": "postcheck_independent", "instruction": "postcheck 必須獨立於操作人與外部 Agent。"},
|
||
{"check_id": "recurrence_guard_present", "instruction": "需要防再發 guard，例如 credential hygiene、runner config control、firewall diff control、Wazuh rule coverage。"},
|
||
{"check_id": "owner_response_not_auto_accepted", "instruction": "owner response received / accepted count 只能由 reviewer record 推進。"},
|
||
{"check_id": "no_false_green", "instruction": "Wazuh online、agent active、route 200、CD success、UI 可見都不能單獨當事件驗收。"},
|
||
{"check_id": "runtime_stays_zero", "instruction": "readback plan 不得打開 active response、host write、workflow change、secret rotation 或 action button。"},
|
||
]
|
||
|
||
OUTCOME_LANES = [
|
||
{"lane_id": "waiting_wazuh_owner_evidence", "meaning": "Wazuh 已建置但尚未收到 IwoooS 可接受的脫敏事件 refs。"},
|
||
{"lane_id": "request_manager_health_supplement", "meaning": "缺 Wazuh manager / indexer / dashboard / API health ref 時要求補件。"},
|
||
{"lane_id": "request_agent_status_supplement", "meaning": "缺 host agent 狀態、agent id 對照或 last seen ref 時要求補件。"},
|
||
{"lane_id": "request_host_forensics_supplement", "meaning": "缺 auth / process / network / FIM / package / persistence refs 時要求補件。"},
|
||
{"lane_id": "request_actor_or_time_supplement", "meaning": "缺 actor attribution、工具來源或事件時間窗時要求補件。"},
|
||
{"lane_id": "request_containment_decision", "meaning": "缺 containment decision、理由、owner 或 rollback owner 時要求補件。"},
|
||
{"lane_id": "quarantine_secret_or_raw_payload", "meaning": "收到 secret、private key、runner token、raw payload、raw log 或未脫敏截圖時隔離。"},
|
||
{"lane_id": "reject_external_agent_claim_only", "meaning": "只有外部 Agent 口頭宣稱已修復、已阻擋或已清除時拒收。"},
|
||
{"lane_id": "route_to_high_value_config_gate", "meaning": "涉及 runner、workflow、secret、gateway、firewall、systemd、Docker 或 K8s 時串到高價值配置 gate。"},
|
||
{"lane_id": "ready_for_intrusion_reviewer_review", "meaning": "metadata 合格後只能進 reviewer review，不自動執行。"},
|
||
{"lane_id": "recurrence_guard_backfill_required", "meaning": "需補 Wazuh rule coverage、runner/gateway/secret guard、credential hygiene 或 change freeze。"},
|
||
{"lane_id": "waiting_runtime_gate", "meaning": "即使事件 refs accepted，active response 與 host containment 仍需獨立人工批准。"},
|
||
]
|
||
|
||
BLOCKED_ACTIONS = [
|
||
"wazuh_active_response_enable",
|
||
"wazuh_agent_install",
|
||
"wazuh_agent_restart",
|
||
"wazuh_manager_restart",
|
||
"wazuh_rule_change",
|
||
"wazuh_decoder_change",
|
||
"wazuh_api_live_query_without_owner_gate",
|
||
"hardcode_wazuh_url",
|
||
"hardcode_wazuh_username",
|
||
"hardcode_wazuh_password",
|
||
"disable_tls_verification",
|
||
"store_raw_wazuh_payload",
|
||
"store_raw_syslog",
|
||
"store_raw_journal",
|
||
"store_raw_command_output",
|
||
"store_unredacted_screenshot",
|
||
"collect_password",
|
||
"collect_private_key",
|
||
"collect_runner_token",
|
||
"collect_webhook_secret",
|
||
"collect_cookie_or_session",
|
||
"collect_env_dump",
|
||
"ssh_read",
|
||
"ssh_write",
|
||
"sudo_action",
|
||
"host_file_write",
|
||
"kill_process",
|
||
"quarantine_host",
|
||
"firewall_drop",
|
||
"port_close",
|
||
"port_open",
|
||
"docker_restart",
|
||
"docker_kill",
|
||
"systemctl_restart",
|
||
"nginx_reload",
|
||
"workflow_modification",
|
||
"runner_label_change",
|
||
"runner_config_change",
|
||
"repo_secret_change",
|
||
"secret_rotation",
|
||
"active_scan",
|
||
"production_write",
|
||
"mark_malware_removed_without_evidence",
|
||
"mark_rce_fixed_without_evidence",
|
||
"accept_external_agent_claim_without_wazuh_refs",
|
||
"accept_route_200_as_recovery",
|
||
"accept_agent_active_as_incident_closed",
|
||
"open_runtime_gate",
|
||
"add_action_button",
|
||
]
|
||
|
||
READBACK_CANDIDATES = [
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:wazuh_control_plane",
|
||
"scope_alias": "wazuh-control-plane",
|
||
"label": "Wazuh manager / indexer / dashboard / API",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "wazuh_platform",
|
||
"requires_wazuh_event_refs": False,
|
||
"requires_host_forensics_refs": False,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:host110_intrusion_signal",
|
||
"scope_alias": "host-110",
|
||
"label": "host-110 入侵 / gateway / runner / service 異常訊號",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "host_intrusion",
|
||
"requires_wazuh_event_refs": True,
|
||
"requires_host_forensics_refs": True,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:host188_intrusion_signal",
|
||
"scope_alias": "host-188",
|
||
"label": "host-188 入侵 / 惡意程式 / RCE 宣稱回讀",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "host_intrusion",
|
||
"requires_wazuh_event_refs": True,
|
||
"requires_host_forensics_refs": True,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:external_agent_live_change_claim",
|
||
"scope_alias": "external-agent-handoff",
|
||
"label": "外部 Agent live 變更與修復宣稱驗證",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "external_agent_claim",
|
||
"requires_wazuh_event_refs": True,
|
||
"requires_host_forensics_refs": True,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:runner_secret_gateway_control",
|
||
"scope_alias": "runner-secret-gateway",
|
||
"label": "Runner / secret / gateway 高價值配置連動",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "high_value_config_link",
|
||
"requires_wazuh_event_refs": True,
|
||
"requires_host_forensics_refs": True,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
{
|
||
"readback_candidate_id": "wazuh_intrusion_readback:containment_recovery_postcheck",
|
||
"scope_alias": "containment-recovery",
|
||
"label": "Containment / recovery proof / postcheck",
|
||
"control_tier": "C0",
|
||
"priority": "P0",
|
||
"source_kind": "incident_response",
|
||
"requires_wazuh_event_refs": True,
|
||
"requires_host_forensics_refs": True,
|
||
"requires_cross_project_sync": True,
|
||
},
|
||
]
|
||
|
||
|
||
def git_short_sha(root: Path) -> str:
|
||
try:
|
||
result = subprocess.run(
|
||
["git", "rev-parse", "--short", "HEAD"],
|
||
cwd=root,
|
||
check=True,
|
||
capture_output=True,
|
||
text=True,
|
||
)
|
||
return result.stdout.strip()
|
||
except Exception:
|
||
return "unknown"
|
||
|
||
|
||
def build_candidate(source: dict[str, Any]) -> dict[str, Any]:
|
||
return {
|
||
**source,
|
||
"status": "waiting_wazuh_owner_evidence",
|
||
"wazuh_platform_reported_ready": True,
|
||
"requires_owner_evidence": True,
|
||
"wazuh_manager_health_ref": None,
|
||
"wazuh_agent_status_ref": None,
|
||
"wazuh_alert_rule_refs": [],
|
||
"wazuh_event_refs": [],
|
||
"host_auth_log_refs": [],
|
||
"process_tree_refs": [],
|
||
"network_connection_refs": [],
|
||
"file_integrity_refs": [],
|
||
"package_inventory_refs": [],
|
||
"persistence_mechanism_refs": [],
|
||
"runner_or_gateway_config_diff_refs": [],
|
||
"actor_attribution_ref": None,
|
||
"incident_time_window_ref": None,
|
||
"affected_scope": "pending_redacted_scope",
|
||
"impact_summary_ref": None,
|
||
"containment_decision": "waiting_containment_decision",
|
||
"containment_reason_ref": None,
|
||
"recovery_proof_refs": [],
|
||
"postcheck_readback_ref": None,
|
||
"recurrence_guard_ref": None,
|
||
"cross_project_sync_ref": None,
|
||
"rollback_owner": "pending_owner_response",
|
||
"followup_owner": "pending_owner_response",
|
||
"reviewer_outcome": "waiting_wazuh_intrusion_review",
|
||
"not_approval": True,
|
||
"runtime_gate": False,
|
||
"action_buttons_allowed": False,
|
||
"active_response_authorized": False,
|
||
"host_write_authorized": False,
|
||
"secret_value_collection_allowed": False,
|
||
"blocked_actions": BLOCKED_ACTIONS,
|
||
"readback_fields": READBACK_FIELDS,
|
||
"required_readback_fields": REQUIRED_READBACK_FIELDS,
|
||
"reviewer_checks": [item["check_id"] for item in REVIEWER_CHECKS],
|
||
"outcome_lanes": [item["lane_id"] for item in OUTCOME_LANES],
|
||
}
|
||
|
||
|
||
def build_report(root: Path, generated_at: str | None) -> dict[str, Any]:
|
||
report_time = generated_at or datetime.now(TAIPEI).isoformat(timespec="seconds")
|
||
candidates = [build_candidate(item) for item in READBACK_CANDIDATES]
|
||
return {
|
||
"schema_version": "wazuh_iwooos_intrusion_readback_plan_v1",
|
||
"generated_at": report_time,
|
||
"git_commit": git_short_sha(root),
|
||
"status": "wazuh_intrusion_readback_plan_ready_no_runtime_action",
|
||
"mode": "metadata_only_no_wazuh_api_no_host_read_no_active_response",
|
||
"source_context": {
|
||
"wazuh_platform_reported_ready": True,
|
||
"iwooos_runtime_ingestion_accepted": False,
|
||
"affected_host_aliases": ["host-110", "host-188"],
|
||
"external_agent_transcript_published_to_frontend": False,
|
||
"raw_secret_or_private_key_collection_allowed": False,
|
||
},
|
||
"summary": {
|
||
"wazuh_platform_reported_count": 1,
|
||
"readback_candidate_count": len(candidates),
|
||
"c0_readback_candidate_count": sum(1 for item in candidates if item["control_tier"] == "C0"),
|
||
"affected_host_alias_count": 2,
|
||
"wazuh_event_required_candidate_count": sum(1 for item in candidates if item["requires_wazuh_event_refs"]),
|
||
"host_forensics_required_candidate_count": sum(1 for item in candidates if item["requires_host_forensics_refs"]),
|
||
"cross_project_sync_required_candidate_count": sum(1 for item in candidates if item["requires_cross_project_sync"]),
|
||
"readback_field_count": len(READBACK_FIELDS),
|
||
"required_readback_field_count": len(REQUIRED_READBACK_FIELDS),
|
||
"reviewer_check_count": len(REVIEWER_CHECKS),
|
||
"outcome_lane_count": len(OUTCOME_LANES),
|
||
"blocked_action_count": len(BLOCKED_ACTIONS),
|
||
"wazuh_manager_health_ref_received_count": 0,
|
||
"wazuh_agent_status_ref_received_count": 0,
|
||
"wazuh_event_ref_received_count": 0,
|
||
"host_forensics_ref_received_count": 0,
|
||
"containment_decision_received_count": 0,
|
||
"recovery_proof_received_count": 0,
|
||
"postcheck_readback_received_count": 0,
|
||
"recurrence_guard_received_count": 0,
|
||
"cross_project_sync_received_count": 0,
|
||
"owner_response_received_count": 0,
|
||
"owner_response_accepted_count": 0,
|
||
"wazuh_event_accepted_count": 0,
|
||
"host_forensics_accepted_count": 0,
|
||
"containment_decision_accepted_count": 0,
|
||
"recovery_proof_accepted_count": 0,
|
||
"postcheck_readback_accepted_count": 0,
|
||
"recurrence_guard_accepted_count": 0,
|
||
"readonly_api_code_path_present_count": 1,
|
||
"readonly_api_enabled_count": 0,
|
||
"active_response_authorized_count": 0,
|
||
"host_write_authorized_count": 0,
|
||
"secret_value_collection_allowed_count": 0,
|
||
"runtime_gate_count": 0,
|
||
"action_button_count": 0,
|
||
"coverage_percent_after_readback_plan": 72,
|
||
},
|
||
"execution_boundaries": {
|
||
"runtime_execution_authorized": False,
|
||
"wazuh_api_live_query_authorized": False,
|
||
"wazuh_active_response_authorized": False,
|
||
"wazuh_rule_change_authorized": False,
|
||
"wazuh_agent_install_authorized": False,
|
||
"host_read_authorized": False,
|
||
"host_write_authorized": False,
|
||
"ssh_read_authorized": False,
|
||
"ssh_write_authorized": False,
|
||
"sudo_action_authorized": False,
|
||
"firewall_change_authorized": False,
|
||
"process_kill_authorized": False,
|
||
"host_isolation_authorized": False,
|
||
"runner_change_authorized": False,
|
||
"workflow_modification_authorized": False,
|
||
"repo_secret_change_authorized": False,
|
||
"secret_value_collection_allowed": False,
|
||
"raw_wazuh_payload_storage_allowed": False,
|
||
"raw_log_storage_allowed": False,
|
||
"private_key_collection_allowed": False,
|
||
"active_scan_authorized": False,
|
||
"production_write_authorized": False,
|
||
"frontend_raw_transcript_display_allowed": False,
|
||
"action_buttons_allowed": False,
|
||
"not_authorization": True,
|
||
},
|
||
"readback_candidates": candidates,
|
||
"reviewer_checks": REVIEWER_CHECKS,
|
||
"outcome_lanes": OUTCOME_LANES,
|
||
"blocked_actions": BLOCKED_ACTIONS,
|
||
"operator_interpretation": [
|
||
"Wazuh 已建置是偵測平台存在訊號，不代表 IwoooS 已驗收 110 / 188 入侵事件。",
|
||
"IwoooS 只能接收脫敏 refs、hash、ticket、artifact pointer 與 owner response，不收 secret、private key、runner token 或 raw payload。",
|
||
"外部 Agent 對木馬、RCE、Zero-Trust、清除或封鎖的宣稱必須用 Wazuh event refs 與 host forensic refs 交叉驗證。",
|
||
"active response、host containment、firewall drop、restart、runner change、secret rotation 與 production write 仍全部需要獨立人工批准。",
|
||
],
|
||
}
|
||
|
||
|
||
def main() -> int:
|
||
parser = argparse.ArgumentParser(description="IwoooS Wazuh / 主機入侵 read-only 接入計畫產生器")
|
||
parser.add_argument("--root", default=".", help="repo root")
|
||
parser.add_argument("--output", help="寫出 JSON 報告")
|
||
parser.add_argument("--generated-at", help="固定報告時間，供 committed snapshot 使用")
|
||
args = parser.parse_args()
|
||
|
||
root = Path(args.root).resolve()
|
||
report = build_report(root, args.generated_at)
|
||
payload = json.dumps(report, ensure_ascii=False, indent=2, sort_keys=True)
|
||
|
||
if args.output:
|
||
output = Path(args.output)
|
||
output.parent.mkdir(parents=True, exist_ok=True)
|
||
output.write_text(payload + "\n", encoding="utf-8")
|
||
else:
|
||
print(payload)
|
||
|
||
summary = report["summary"]
|
||
print(
|
||
"WAZUH_IWOOOS_INTRUSION_READBACK_PLAN_OK "
|
||
f"candidates={summary['readback_candidate_count']} "
|
||
f"hosts={summary['affected_host_alias_count']} "
|
||
f"checks={summary['reviewer_check_count']} "
|
||
f"blocked={summary['blocked_action_count']} "
|
||
f"runtime_gate={summary['runtime_gate_count']}",
|
||
file=sys.stderr,
|
||
)
|
||
return 0
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main())
|