Repository navigation
Releases: KRCUPRO/nix-k8s-sentinel
Releases · KRCUPRO/nix-k8s-sentinel
Release list
v0.14.0
Added
- Zero-Trust Microsegmentation & SPIFFE/SPIRE Workload Attestation Engine (
pkg/spiffe/scanner.go): Native security audit and attestation reconciler for SPIFFE/SPIRE workload identities and Cilium eBPF network microsegmentation in multi-tenant Kubernetes clusters. - Strict SPIFFE ID Parser & SVID Lifecycle / Cryptographic Auditor (
pkg/spiffe/validator.go): Deep security inspector for X.509 SVID records and SPIRE Registration Entry manifests:- Validates RFC-compliant SPIFFE ID format (
spiffe://<trust-domain>/<workload-path>) against trusted domain white-lists (SPIFFE-SVID-001). - Detects excessive SVID lifespans exceeding production bounds (> 24 hours) (
SPIFFE-SVID-002). - Identifies expiring or expired SVIDs within the renewal threshold (< 15 minutes remaining) triggering active workload disconnects (
SPIFFE-SVID-003, mapped to CVE-2026-67210). - Flags insecure wildcard selectors (
k8s:ns:*,k8s:pod-label:*) in SPIRE registration entries permitting unconstrained identity issuance (SPIFFE-SVID-004). - Identifies insecure or world-accessible SPIRE Agent Admin socket file modes (
chmod 0777or missing0660restrictions) (SPIFFE-SVID-005). - Enforces mandatory Cilium mTLS authentication mode (
authentication.mode: required) inCiliumNetworkPolicy(SPIFFE-SVID-006). - Flags missing SPIFFE ID label match expressions in ingress/egress endpoint rules (
SPIFFE-SVID-007). - Flags weak cryptographic key algorithms (
RSA-1024,RSA-2048) or non-ECC keys for SVID issuance (SPIFFE-SVID-008). - Detects missing Pod identity node attestation constraints (
k8s:node-name) in SPIRE registration entries (SPIFFE-SVID-009). - Identifies unencrypted SPIRE Agent-to-Server gTLS control planes without mutual attestation (
SPIFFE-SVID-010). - Flags missing SVID auto-renewal loop configurations in workload sidecars (
SPIFFE-SVID-011). - Intercepts default-allow network policies lacking microsegmentation ingress/egress boundaries (
SPIFFE-SVID-012).
- Validates RFC-compliant SPIFFE ID format (
- Autonomous Cilium Policy Synthesizer (
pkg/spiffe/cilium_synth.go): Generates zero-trustCiliumNetworkPolicy(cilium.io/v2) manifests enforcing mandatory SPIFFE-authenticated mTLS (authentication.mode: required) and workload isolation based on audited SPIFFE identities. - Canonical SPIFFE/SPIRE Threat Catalog (
pkg/spiffe/rules.go): Authoritative suite of 12 canonical rules with CVSS v3.1 scores, detailed technical impact analysis, and remediation playbooks. - Dedicated CLI SPIFFE Runner & Modularization (
cmd/sentinel/spiffe_runner.go): High-performance runner keepingcmd/sentinel/main.gounder 470 LOC and strictly adhering to the 300~500 LOC soft ceiling. Adds--spiffe=<path>,--spire=<path>,--svid-telemetry=<path>, and--spiffe-policy-out=<path>flags. - Threat Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-67210(SPIFFE/SPIRE Workload Attestation SVID Expiration Desync & Cilium Identity Spoofing, CVSS 9.3). - Unified Exporter Integration: SPIFFE findings, SVID audit tallies, and microsegmentation summaries seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Production Fixtures & Synthesized Policies: Added realistic declarative fixture (
fixtures/spiffe-manifests.yaml), runtime SVID telemetry payload (fixtures/spiffe-telemetry.json), and synthesized Cilium policies (policies/generated/cilium-spiffe-policies.yaml). - Comprehensive Unit Test Suites (
pkg/spiffe/spiffe_test.go,pkg/report/spiffe_report_test.go): 100% test coverage across rule catalog, SPIFFE ID parsing, SVID lifetime audits, wildcard selector detection, Cilium policy generation, telemetry reconciliation, SARIF/JSON/Briefing serialization, and defensive bounds checks.
Changed
- Bumped engine release to
v0.14.0. - Updated
SECURITY.mdestablishing Zero-Trust Microsegmentation & SPIFFE/SPIRE Workload Attestation security invariants (Invariant 16). - Updated
ROADMAP.mdmarking Milestone M14 as completed and scheduling M15 (Autonomous Remediation Operator & Drift Auto-Heal Reconciliation). - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new SPIFFE/SPIRE modules, synthesized policies, and O(1) symbols.
v0.13.0
Added
- Multi-Cluster Fleet Synchronization & OIDC Token Radar Engine (
pkg/fleet/scanner.go): Native audit engine designed for multi-tenant, geographically distributed Kubernetes clusters. Coordinates static manifest audits and runtime telemetry reconciliation across cluster fleets. - Multi-Tenant RBAC & Federated OIDC Identity Auditor (
pkg/fleet/rbac_oidc.go): Deep security inspector for Kubernetes RBAC resources (ClusterRole,Role,ClusterRoleBinding,RoleBinding) and federated OIDC authentication tokens:- Intercepts wildcard verbs, API groups, and resources (
*) granting uncontained cluster privileges (FLEET-RBAC-001). - Detects dangerous privilege escalation permissions (
bind,escalate) enabling non-admin service accounts to grant themselves higher roles (FLEET-RBAC-002). - Intercepts broad group bindings where
cluster-adminis bound tosystem:authenticated,system:unauthenticated, orsystem:anonymous(FLEET-RBAC-003, mapped to CVE-2026-60114). - Detects unrestricted user, group, and service account impersonation (
impersonate) lacking explicitresourceNameswhitelists (FLEET-RBAC-004). - Blocks cluster-wide reading of
secretsacross all namespaces without tenant partition boundaries (FLEET-RBAC-005). - Audits federated OIDC identity tokens, flagging insecure algorithms (
none, symmetric HMACHS256), excessive lifetimes (> 24 hours), missing audience/issuer claims, and stale signing keys (> 90 days) (FLEET-OIDC-001throughFLEET-OIDC-004).
- Intercepts wildcard verbs, API groups, and resources (
- Declarative GitOps Drift & Reconciler Engine (
pkg/fleet/gitops.go): Dedicated auditor for ArgoCD (Application,ApplicationSet) and Flux (Kustomization,GitRepository,OCIRepository,HelmRelease) resources:- Detects automated self-healing disabled (
syncPolicy.automated.selfHeal: falseorprune: false), permitting silent configuration drift (FLEET-GITOPS-001). - Detects unpinned GitOps source revisions tracking floating branches (
HEAD,main,master) without immutable commit hashes or signed tags (FLEET-GITOPS-002). - Identifies unauthenticated Git/OCI repositories lacking Kubernetes Secret references (
FLEET-GITOPS-003). - Flags wildcard destination cluster dispatch (
server: "*") permitting workload execution across untrusted fleet members (FLEET-GITOPS-004). - Identifies runtime cluster state desynchronization, revision divergences, and degraded application health across geographically distributed fleet members (
FLEET-DRIFT-001, mapped to CVE-2026-60114).
- Detects automated self-healing disabled (
- Canonical Fleet & OIDC Threat Catalog (
pkg/fleet/rules.go): Authoritative suite of 14 canonical rules with CVSS v3.1 scores, detailed technical impact analysis, and remediation playbooks. - Dedicated CLI Fleet Runner & Modularization (
cmd/sentinel/fleet_runner.go): High-performance runner keepingcmd/sentinel/main.gounder 400 LOC and strictly adhering to the 300~500 LOC soft ceiling. Adds--fleet=<path>,--gitops=<path>, and--fleet-telemetry=<path>flags. - Threat Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-60114(Multi-Cluster GitOps Reconciliation Drift & OIDC Token Replay in ArgoCD / Kubernetes RBAC, CVSS 9.4). - Unified Exporter Integration: Fleet findings, cluster synchronization summaries, and OIDC token audits seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Production Fixtures: Added realistic declarative fixture (
fixtures/fleet-manifests.yaml) and runtime multi-cluster telemetry payload (fixtures/fleet-telemetry.json). - Comprehensive Unit Test Suites (
pkg/fleet/fleet_test.go,pkg/report/fleet_report_test.go): 100% test coverage for rule catalog lookups, RBAC wildcard detection, broad subject group bindings, OIDC token algorithm/TTL checks, GitOps drift detection, report serialization, and defensive bounds checks.
Changed
- Bumped engine release to
v0.13.0. - Updated
SECURITY.mdestablishing Multi-Cluster Fleet Synchronization & OIDC Federated Token security invariants. - Updated
ROADMAP.mdmarking Milestone M13 as completed and scheduling M14 (Zero-Trust Microsegmentation & SPIFFE/SPIRE Workload Attestation). - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new fleet modules and O(1) symbols.
v0.12.0
Added
- Confidential Computing & Measured Boot Attestation Verifier (
pkg/attest/verifier.go): Native verification engine for TPM 2.0 PCR quotations and remote attestation tokens across bare-metal cluster worker nodes and confidential computing enclaves (AMD SEV-SNP, Intel TDX). - Declarative NixOS Measured Boot Configuration Scanner (
pkg/attest/nixos_scanner.go): Static parser inspecting NixOS configurations for AMD SEV-SNP (mem_encrypt=on kvm_amd.sev=1), Intel TDX (intel_iommu=on kvm_intel.tdx=1), systemd-boot measured boot integration, Lanzaboote / UKI signing, TPM 2.0 PKCS#11 configuration, and dangerous debug kernel command-line arguments. - Canonical Attestation & Measured Boot Ruleset (
pkg/attest/rules.go): Suite of 12 canonical rules (ATTEST-BOOT-001throughATTEST-BOOT-012) with CVSS v3.1 scoring, remediation guidance, and category classifications:ATTEST-BOOT-001: AMD SEV-SNP Memory Encryption Disabled or Unconfigured (Critical, CVSS 9.2, mapped to CVE-2026-51204).ATTEST-BOOT-002: Intel TDX Trust Domain Execution Disabled in Kernel Flags (Critical, CVSS 9.2, mapped to CVE-2026-51204).ATTEST-BOOT-003: TPM 2.0 PCR 7 Secure Boot Measurement Mismatch or Policy Drift (High, CVSS 8.5).ATTEST-BOOT-004: TPM 2.0 PCR 11 Unified Kernel Image (UKI) / NixOS System Closure Digest Desync (High, CVSS 8.7, mapped to CVE-2026-51204).ATTEST-BOOT-005: Confidential Computing Firmware Debug Mode Permitted in Remote Quote (Critical, CVSS 9.4).ATTEST-BOOT-006: Insecure or Missing NixOS Store Path Cryptographic Signature in Measured Boot (High, CVSS 7.9).ATTEST-BOOT-007: Unhardened Bootloader (Missing Systemd-Boot Measured Boot Integration) (Medium, CVSS 6.8).ATTEST-BOOT-008: Expired or Revoked Remote Attestation Token / VCEK Certificate (High, CVSS 8.1).ATTEST-BOOT-009: Missing TPM2 Resource Manager (tpm2-abrmd / in-kernel RM) in NixOS Config (Medium, CVSS 5.5).ATTEST-BOOT-010: TPM 2.0 PCR 8 Kernel Command Line Drift / Unsanitized Boot Parameters (High, CVSS 7.6).ATTEST-BOOT-011: Unenforced TCB Version Policy on Confidential Computing Nodes (Medium, CVSS 6.5).ATTEST-BOOT-012: Missing Measured Boot Stage for Initrd / Kernel Image in PCR 9 (High, CVSS 7.8).
- Dedicated CLI Attestation Runner & Architecture Modularization (
cmd/sentinel/attest_runner.go): Modular runner dispatch pattern keepingcmd/sentinel/main.gounder 380 LOC and adhering strictly to the 300~500 LOC soft ceiling. Adds--attest=<path>,--attest-telemetry=<path>, and--attest-quote=<path>flags. - Threat Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-51204(AMD SEV-SNP & Intel TDX Firmware Measurement Replay & TPM PCR Bypass, CVSS 9.4). - Unified Exporter Integration: Attestation findings, node verification tallies, and compliance summaries seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Production-Like Fixtures: Added realistic declarative fixture (
fixtures/nixos-measured-boot.nix) and multi-node cluster attestation telemetry (fixtures/attestation-telemetry.json) modeling verified and compromised worker nodes. - Comprehensive Unit Test Suites (
pkg/attest/attest_test.go,pkg/report/attest_report_test.go): 100% test coverage for rules catalog, compliant/vulnerable NixOS configs, TPM PCR quotes, report serialization, and defensive bounds checks.
Changed
- Bumped engine release to
v0.12.0. - Updated
SECURITY.mdestablishing Confidential Computing and Measured Boot security invariants. - Updated
ROADMAP.mdmarking Milestone M12 as completed. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new attest modules and O(1) symbols.
v0.11.0
Added
- Kubernetes Gateway API Threat Radar Engine (
pkg/gateway/radar.go): Native declarative scanner auditing Gateway API resources (Gateway,GatewayClass,HTTPRoute,GRPCRoute,TCPRoute,UDPRoute,TLSRoute,ReferenceGrant) against modern cloud-native routing vulnerabilities. - Cross-Namespace ReferenceGrant Security Enforcement (
pkg/gateway/radar.go): Multi-pass declarative validator that constructs an in-memory cross-namespace permission matrix fromReferenceGrantmanifests and verifies every cross-namespacebackendRefandparentRefacross tenant routes, stopping unauthorized cross-tenant backend access and service hijacking (CVE-2026-44219). - Istio EnvoyFilter Security Auditor (
pkg/gateway/envoy.go): Dedicated auditor forEnvoyFilterCRDs (networking.istio.io/v1alpha3) detecting arbitrary inline Lua code injections (os.execute,io.popen,loadstring,require os/io), filter chain order bypasses (INSERT_BEFORErelative tojwt_authn,istio.authn,rbac), unauthenticated listener exposures, and disabled client TLS verification (require_client_certificate: false). - Canonical Gateway API & EnvoyFilter Radar Ruleset (
pkg/gateway/rules.go): Suite of 12 canonical rules (GW-RADAR-001throughGW-RADAR-012) with CVSS v3.1 scoring, remediation playbooks, and category classifications:GW-RADAR-001: Unrestricted Cross-Namespace Backend Reference (Missing ReferenceGrant) (High, CVSS 7.8, mapped to CVE-2026-44219).GW-RADAR-002: Unsafe EnvoyFilter Inline Lua Script Injection (Critical, CVSS 9.3, mapped to CVE-2026-44219).GW-RADAR-003: EnvoyFilter Filter Chain Order Bypass (High, CVSS 8.2, mapped to CVE-2026-44219).GW-RADAR-004: Gateway Insecure Plaintext Listener Without TLS Termination (Medium, CVSS 6.5).GW-RADAR-005: HTTPRoute Unrestricted Wildcard Path & Open Routing (Medium, CVSS 5.8).GW-RADAR-006: HTTPRoute Unsafe Path Prefix Rewrite Traversal (High, CVSS 7.5).GW-RADAR-007: HTTPRoute Identity Header Spoofing via RequestHeaderModifier (High, CVSS 7.7).GW-RADAR-008: GRPCRoute Unrestricted Administrative Method Dispatch (Medium, CVSS 6.2).GW-RADAR-009: TCPRoute / UDPRoute Sensitive Infrastructure Port Forwarding (High, CVSS 8.0).GW-RADAR-010: EnvoyFilter Disabling Client TLS Verification (Critical, CVSS 9.1).GW-RADAR-011: Gateway AllowedRoutes Namespace Wildcard Violation (High, CVSS 7.4).GW-RADAR-012: EnvoyFilter Unrestricted Hop-by-Hop Header Mutation (Medium, CVSS 6.8).
- Dedicated CLI Gateway Runner & Architecture Modularization (
cmd/sentinel/gateway_runner.go): Modular runner dispatch pattern keepingcmd/sentinel/main.gounder 420 LOC and adhering strictly to the 300~500 LOC soft ceiling. Adds--gateway=<path>and--gw=<path>flags. - Threat Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-44219(Kubernetes Gateway API & EnvoyFilter Cross-Namespace Route Hijacking & Lua Remote Execution, CVSS 9.6). - Unified Exporter Integration: Gateway API and EnvoyFilter findings and compliance summaries seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Production-Like Fixtures: Added realistic declarative fixture (
fixtures/gateway-api-routes.yaml) modeling compliant and vulnerable Gateway, HTTPRoute, GRPCRoute, TCPRoute, ReferenceGrant, and EnvoyFilter resources. - Comprehensive Unit Test Suites (
pkg/gateway/gateway_test.go,pkg/report/gateway_report_test.go): 100% test coverage for rules catalog, cross-namespace ReferenceGrant authorization, path traversal detection, header spoofing, Lua injections, filter ordering, report serialization, and defensive bounds checks.
Changed
- Bumped engine release to
v0.11.0. - Updated
SECURITY.mdestablishing Gateway API and EnvoyFilter route threat radar security invariants. - Updated
ROADMAP.mdmarking Milestone M11 as completed. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new gateway modules and O(1) symbols.
v0.10.0
Added
- Kube-Bench & CIS Kubernetes Benchmark Declarative Validator (
pkg/bench/scanner.go): High-performance declarative scanner inspecting NixOS systemd unit definitions (services.kubernetes.*,services.etcd.*) and Kubernetes component configuration files (such asKubeletConfigurationYAML) against the official CIS Kubernetes Benchmark (v1.8 / v1.9). Evaluates Section 1.2 (Kube-APIServer), Section 1.3 (Controller Manager), Section 1.4 (Scheduler), Section 2 (etcd), and Section 4.2 (Kubelet). - Canonical CIS Kubernetes Benchmark Ruleset (
pkg/bench/rules.go): Canonical suite of 29 benchmark rules (CIS-1.2.1throughCIS-4.2.12) with CVSS severity scoring, flag definitions, expected values, and technical rationales:CIS-1.2.1: Ensure that the--anonymous-authargument is set tofalse(Critical, CVSS 9.1).CIS-1.2.2: Ensure that the--token-auth-fileparameter is not set (High, CVSS 7.5).CIS-1.2.3: Ensure that the--kubelet-httpsargument is set totrue(High, CVSS 7.2).CIS-1.2.4: Ensure that--kubelet-client-certificateand--kubelet-client-keyare set (High, CVSS 7.5).CIS-1.2.5: Ensure that--kubelet-certificate-authorityis set (High, CVSS 7.5).CIS-1.2.6: Ensure that--authorization-modeincludesNode,RBACand excludesAlwaysAllow(Critical, CVSS 8.9).CIS-1.2.14: Ensure that--profilingis set tofalse(Medium, CVSS 5.3).CIS-1.2.15: Ensure that--audit-log-pathis set (Medium, CVSS 6.0).CIS-1.2.25: Ensure that--etcd-cafile,--etcd-certfile, and--etcd-keyfileare set (High, CVSS 8.1).CIS-1.2.28: Ensure that--tls-cipher-suitesis set to strong ciphers (Medium, CVSS 6.2).CIS-1.3.1: Ensure that--terminated-pod-gc-thresholdis set (Low, CVSS 4.0).CIS-1.3.2: Ensure that--profilingis set tofalse(Medium, CVSS 5.3).CIS-1.3.3: Ensure that--use-service-account-credentialsis set totrue(High, CVSS 7.2).CIS-1.3.4: Ensure that--service-account-private-key-fileis set (High, CVSS 7.5).CIS-1.3.5: Ensure that--root-ca-fileis set (High, CVSS 7.5).CIS-1.3.7: Ensure that--bind-addressis set to127.0.0.1(Medium, CVSS 6.5).CIS-1.4.1: Ensure that--profilingis set tofalseon scheduler (Medium, CVSS 5.3).CIS-1.4.2: Ensure that--bind-addressis set to127.0.0.1on scheduler (Medium, CVSS 6.5).CIS-2.1: Ensure that--cert-fileand--key-fileare set on etcd (High, CVSS 8.0).CIS-2.2: Ensure that--client-cert-authis set totrueon etcd (High, CVSS 8.2).CIS-2.4: Ensure that--peer-cert-fileand--peer-key-fileare set on etcd (High, CVSS 8.0).CIS-2.7: Ensure that--auto-tlsis not set totrueon etcd (High, CVSS 7.5).CIS-4.2.1: Ensure that--anonymous-authis set tofalseon Kubelet (Critical, CVSS 9.8, mapped to CVE-2026-38102).CIS-4.2.2: Ensure that--authorization-modeis set toWebhook(Critical, CVSS 8.9, mapped to CVE-2026-38102).CIS-4.2.3: Ensure that--client-ca-fileis set on Kubelet (High, CVSS 7.5).CIS-4.2.4: Ensure that--read-only-portis set to0on Kubelet (High, CVSS 7.5, mapped to CVE-2026-38102).CIS-4.2.6: Ensure that--protect-kernel-defaultsis set totrue(Medium, CVSS 6.0).CIS-4.2.10: Ensure that--rotate-certificatesis set totrue(Medium, CVSS 5.5).CIS-4.2.12: Ensure that--tls-cipher-suitesis set to strong ciphers (Medium, CVSS 6.2).
- Automated Declarative Remediation Synthesizers (
pkg/bench/remediation.go): Synthesizes drop-in hardened NixOS modules (nixos-cis-hardening.nix) and hardened worker node Kubelet configurations (kubelet-config-hardened.yaml) directly from detected violations. - Dedicated CLI CIS Runner & Architecture Modularization (
cmd/sentinel/cis_runner.go,cmd/sentinel/storage_runner.go,cmd/sentinel/probe_runner.go): Modular runner dispatch pattern keepingcmd/sentinel/main.gounder 400 LOC. Adds--cis=<path>,--bench=<path>,--kube-bench=<path>, and--remediation-out=<path>. - Threat Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-38102(Kubernetes Kubelet Unauthenticated Remote Execution & Anonymous Access, CVSS 9.8). - Unified Exporter Integration: CIS benchmark violations and compliance statistics seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Production-Like Fixtures: Added realistic declarative NixOS configuration (
fixtures/nixos-kubernetes.nix) and Kubelet manifest (fixtures/kubelet-config.yaml) modeling compliant and unhardened control plane and worker options. - Comprehensive Unit Test Suite (
pkg/bench/bench_test.go,pkg/report/cis_report_test.go): 100% test coverage for CIS rules, nested Nix parsing, KubeletConfiguration, remediation generation, and bounds checks.
Changed
- Bumped engine release to
v0.10.0. - Updated
SECURITY.mdestablishing CIS Kubernetes Benchmark and control plane hardening invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new benchmark modules and sub-400 LOC modularity.
v0.9.0
Added
- WireGuard Mesh Network Cryptographic Key Rotation Engine (
pkg/wireguard/key_rotation.go): Cryptographic lifecycle auditor validating 32-byte Base64-encoded Curve25519 identity keys and Pre-Shared Keys (PSK). Detects invalid key lengths and degenerate all-zero/all-ones key material. Implements zero-leak key masking (MaskKey) to protect secrets in console logs, and enforces 60-day warning and 90-day hard expiration thresholds with automated rotation planning. - Declarative NixOS WireGuard Manifest Scanner (
pkg/wireguard/scanner.go): Native parser for NixOSnetworking.wireguard.interfaces.<name>declarations auditing interface parameters (IPs, listenPort, privateKey, privateKeyFile, mtu) and peer blocks (publicKey, presharedKey, presharedKeyFile, allowedIPs, endpoint, persistentKeepalive). Enforces strict bounds protection (MaxManifestBytes = 10MB). - Canonical WireGuard Security Ruleset (
pkg/wireguard/rules.go): Canonical rules catalog (WG-MESH-001throughWG-MESH-012):WG-MESH-001: Plaintext WireGuard Private Key Exposed in Nix Configuration (Critical, CVSS 9.2, mapped to CVE-2026-31048).WG-MESH-002: Missing Pre-Shared Key (PSK) for Post-Quantum Defense (Medium, CVSS 5.8).WG-MESH-003: Hardcoded Plaintext Pre-Shared Key in Nix Configuration (High, CVSS 8.4).WG-MESH-004: Overly Permissive AllowedIPs (0.0.0.0/0) Without Default-Deny Firewall (High, CVSS 7.8).WG-MESH-005: Peer AllowedIPs Subnet Routing Collision & Traffic Hijacking Risk (High, CVSS 7.5, mapped to CVE-2026-31048).WG-MESH-006: WireGuard Cryptographic Identity Key Exceeded 90-Day Lifetime (High, CVSS 8.1).WG-MESH-007: WireGuard Cryptographic Key Approaching Expiration (> 60 Days) (Medium, CVSS 6.0).WG-MESH-008: Stale / Abandoned WireGuard Peer Handshake Posture (> 24 Hours) (Medium, CVSS 6.3).WG-MESH-009: WireGuard Listening Port Exposed on Public Interface Without Rate-Limiting (Medium, CVSS 5.5).WG-MESH-010: Invalid or Weak WireGuard Cryptographic Key Encoding (Critical, CVSS 9.0).WG-MESH-011: Sub-optimal WireGuard MTU (> 1420) Triggering Overlay Fragmentation (Low, CVSS 4.2).WG-MESH-012: WireGuard Peer Endpoint / CIDR Threat Radar Correlation Match (High, CVSS 8.8).
- Runtime Mesh Telemetry Reconciler (
pkg/wireguard/reconciler.go): Cross-domain engine reconciling declarative NixOS configurations against livewg showruntime telemetry. Intercepts configuration drift, unmanaged ephemeral peers (WG-MESH-013), missing declarative peers (WG-MESH-014), dormant handshakes (> 24h), and correlates endpoints against live threat intelligence feeds. - Production-Like WireGuard Fixtures: Added realistic declarative NixOS configuration (
fixtures/nixos-wireguard.nix) and runtime mesh telemetry (fixtures/wireguard-telemetry.json) modeling control plane and worker peer postures, key ages, and unmanaged nodes. - Threat Intelligence Feed Expansion (
intel/cve-feed.json): AddedCVE-2026-31048(WireGuard Overlay Subnet Route Collision & World-Readable Key Disclosure, CVSS 8.5). - CLI WireGuard Audit Integration: Added
--wg=<path>,--wireguard=<path>, and--wg-telemetry=<path>flags incmd/sentinel/main.goandcmd/sentinel/wireguard_runner.go. - Unified Exporter Integration: WireGuard findings and mesh reconciliation metrics seamlessly exported to OASIS SARIF v2.1.0, structured JSON audit telemetry, and hourly Markdown threat briefings.
- Comprehensive Unit Test Suite (
pkg/wireguard/wireguard_test.go): 100% test coverage for key validation, masking, age calculation, declarative NixOS parsing, drift reconciliation, and bounds checks.
Changed
- Bumped engine release to
v0.9.0. - Updated
SECURITY.mdestablishing WireGuard mesh cryptographic key rotation, zero-leak key masking, and subnet collision invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new wireguard modules maintaining sub-370 LOC modularity.
v0.8.0
Added
- Rook Ceph Storage Cluster Integrity Ruleset (
pkg/storage/rules.go): Canonical integrity rules catalog (ROOK-CEPH-001throughROOK-CEPH-014) auditing insecure host network exposures (ports 6789, 3300, 6800-7300), disabled in-transit wire encryption (msgr2secure mode), unencrypted OSD storage disks (dm-crypt / KMS), sub-optimal pool replication (size < 3orfailureDomain: osd), fragile MON quorums (< 3 or even count), insecure cleartext dashboards (ssl: false), unconfined privileged daemon security contexts, and PVC volume postures. - Declarative Rook Ceph Manifest Scanner (
pkg/storage/crd_scanner.go): High-performance YAML/JSON manifest parser auditingCephCluster,CephBlockPool,CephFilesystem,StorageClass, andPersistentVolumeClaimwith streaming bounds safety (MaxManifestBytes = 10MB,MaxDocumentsPerStream = 1000). - Ceph OSD Peering & BlueStore Anomaly Detector (
pkg/storage/osd_detector.go): Runtime telemetry analyzer intercepting OSD down/out states, peering storms exceeding 30s, heartbeat ping latency spikes (> 1000ms), placement group degradation (degraded,undersized,inconsistent), storage pool capacity watermarks (nearfull>= 80%,backfillfull>= 85%,full>= 90%), hardware CRC32c/XXH64 BlueStore checksum corruptions, and Linux 6.12 async direct I/O metadata desync threats (CVE-2026-15509). - Storage Volume & Reclaim Policy Verifier (
pkg/storage/volume.go): Dedicated auditor preventing catastrophic filesystem corruption caused by unsafeReadWriteMany(RWX) multi-attach access modes on Ceph RBD block volumes, alongside reclaim policy checks (reclaimPolicy: Delete) on persistent database storage classes. - Production-Like Rook Ceph Fixtures: Added sample multi-resource declarative manifest (
fixtures/rook-ceph-cluster.yaml) and realistic Ceph cluster health telemetry (fixtures/ceph-health-telemetry.json) representing degraded PGs, BlueStore CRC corruption, and CVE-2026-15509 desync alerts. - CLI Storage Audit Flags: Integrated
--ceph=<path>,--storage=<path>, and--ceph-telemetry=<path>flags intocmd/sentinel/main.gosupporting single manifest files, recursive directory trees, and runtime telemetry JSON inspection. - Unified Reporting & Exporter Integration: Linked storage findings and Ceph cluster health reports directly into OASIS SARIF v2.1.0 code scanning results, structured JSON telemetry outputs, and hourly Markdown threat briefings.
- Comprehensive Unit Test Suite (
pkg/storage/storage_test.go): 100% test coverage across declarative rules, volume postures, anomaly detection vectors, bounds checks, and recursive directory walking.
Changed
- Bumped engine release to
v0.8.0. - Updated
SECURITY.mdestablishing Rook Ceph distributed storage integrity, BlueStore checksum verification, and PVC multi-attach invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new storage packages with sub-350 LOC modularity.
v0.7.0
Added
- Bare-Metal eBPF Kernel Telemetry Probe Interface (
pkg/probe/types.go): Abstract probe interfaces and typed telemetry events for kernel-level socket monitoring (connect,accept), process execution (execve), storage mutations (openat2), and privileged operations (ptrace,bpf). Includes node-level configuration abstractions (ProbeConfig) with default baselines for bare-metal Kubernetes and NixOS clusters. - Multi-Node eBPF Telemetry Orchestrator (
pkg/probe/ebpf.go): Thread-safe multi-node telemetry aggregator (EBPFManager) with asynchronous stream consumption, bounded ring-buffer snapshots (10,000 capacity ceiling), real-time severity counters, node and syscall distribution metrics, and graceful cancellation lifecycle. - Kernel-Level Runtime Anomaly & Threat Pattern Detector (
pkg/probe/detector.go): Multi-vector security evaluator detecting interactive shell reverse connections (nc,socat,sh,bash), sensitive control plane port sweeps (etcd 2379/2380, Kubelet 10250, Ceph 6789, API Server 6443), immutable/nix/storetampering attempts, container namespace boundary escapes via privileged syscalls, and automated correlation against normalized CVE feeds. - Multi-Node Cluster Simulation Engine & Telemetry Replay (
pkg/probe/mock.go): Configurable mock probes and file loader (LoadEventsFromFile) supporting offline bare-metal cluster testing with strict bounds checking (10MB ceiling, 10,000 events ceiling). - Production-Like Bare-Metal Telemetry Fixtures (
fixtures/probe-telemetry.json): Realistic multi-node kernel telemetry fixture representing reverse shell attacks from compromised ingress pods, unauthorized etcd probes, Nix store tamper attempts, container escapes, and normal health check baselines across control and worker nodes. - CLI Telemetry Flags: Added
--probe,--probe-fixture, and--probe-nodestocmd/sentinel/main.gofor one-command bare-metal cluster telemetry inspection and risk analysis. - Unified Reporting Integration: Seamlessly integrated captured eBPF findings into SARIF v2.1.0 code scanning results, structured JSON telemetry outputs, and hourly Markdown threat briefings.
- Comprehensive Probe Test Suite (
pkg/probe/probe_test.go): 100% test coverage across probe lifecycles, anomaly vectors, multi-node concurrency, fixture parsing, and cluster simulations.
Changed
- Bumped engine release to
v0.7.0. - Updated
SECURITY.mdestablishing bare-metal eBPF telemetry isolation, memory bounds, and drop-on-saturation invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new probe packages with sub-250 LOC modularity.
v0.6.0
Added
- OASIS SARIF v2.1.0 Exporter for GitHub Code Scanning (
pkg/report/sarif.go): Native implementation of the Static Analysis Results Interchange Format (SARIF v2.1.0) with zero external dependencies. Seamlessly maps declarative Kubernetes manifest violations, Nix flake input advisories, and CVE threat feed items to GitHub Code Scanning alerts. Includes rule descriptors with full markdown remediation guidance, security-severity CVSS properties, precise physical file URIs (%SRCROOT%), line numbers, and hierarchical logical locations. - High-Fidelity Structured JSON Audit Telemetry (
pkg/report/json_report.go): Consolidated JSON report exporter delivering complete audit telemetry, cross-domain CVSS distributions, monitored target architectures, and full lists of discovered violations with deterministic sorting. - Unified Report Options & Format Abstractions (
pkg/report/report_types.go): Formatter abstraction supportingconsole,json, andsarifoutput targets, alongside severity level translation utilities (SeverityToSARIFLevel), single-decimal CVSS normalizers, and PascalCase rule name formatters. - CLI Formatter & File Export Flags: Integrated
--format=<console|json|sarif>,--output=<path>, and-o <path>intocmd/sentinel/main.go. When--outputis omitted, structured formats emit clean, pipe-friendly JSON directly to stdout while routing progress logs cleanly. - Dedicated Exporter Test Suites: Added
pkg/report/sarif_test.goandpkg/report/json_test.goverifying schema conformity, rule indexing, CVSS severity translation, location formatting, empty findings handling, and disk persistence with path traversal defense.
Changed
- Bumped engine version to
v0.6.0. - Enriched
k8s.Violationandnix.FlakeVulnerabilityMatchmodels with optionalfile_pathandstart_linetracking. - Updated
SECURITY.mdwith SARIF and JSON security audit exporter integrity invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new reporting modules with sub-400 LOC modularity.
v0.5.0
Added
- CNCF Falco Runtime Policy Synthesis Engine (
pkg/policy/falco.go): Automated generation of active kernel syscall detection rules from normalized threat feeds (CVE-2026-21801, CVE-2026-20914, CVE-2026-19402, CVE-2026-15509) and Kubernetes manifest violations (K8S-ING-001,K8S-ING-003,K8S-CNI-002,K8S-CNI-003). Enforces deterministic rule naming, severity-to-priority translation, macro condition formatting, and tag deduplication. - OPA Gatekeeper Declarative Admission Controller (
pkg/policy/opa.go): Autonomous compilation of KubernetesConstraintTemplate(CRD v1beta1) andConstraintresources with clean, verified Rego policy definitions. Implements zero-trust admission guards rejecting custom snippet injections, unanchored path traversals, plaintext HTTP access, unrestricted0.0.0.0/0egress CIDRs, sensitive control plane port exposures, and unconstrained container memory allocations. - Multi-Engine Policy Synthesis Coordinator (
pkg/policy/synthesizer.go): Unified orchestration compiling policies across Falco and Gatekeeper targets with directory path sanitization (filepath.Clean), atomic file exports, and rule filtering options. - CLI Policy Export Integration: Added
--policy-out=<dir>,--policy-engine=<all|falco|gatekeeper>, and--enforce-action=<deny|dryrun|warn>flags tocmd/sentinel/main.go. - Policy Schema Verification Fixtures: Added
fixtures/policies/falco-rules-fixture.yamlandfixtures/policies/opa-gatekeeper-fixture.yamlfor structural schema and format verification. - Comprehensive Test Suite (
pkg/policy/policy_test.go): 100% test coverage across threat mapping, violation compilation, YAML serializations, Rego formatting, disk writes, and schema conformity.
Changed
- Bumped engine release to
v0.5.0. - Updated
SECURITY.mdwith declarative policy synthesis integrity and schema conformance invariants. - Updated
scripts/ARCHITECTURE_MAP.mddocumenting new policy modules with verified sub-500 LOC modularity.