@cdxgen/cdxgen 0.0.1 → 13.0.1

package/data/rules/host-topology.yaml

@@ -0,0 +1,165 @@
+# Host Topology Rules
+# Category: host-topology
+# Evaluates strict, evidence-backed insights derived from merged HBOM + OBOM inventories.
+
+- id: HMX-001
+  name: "Active wired interface with live runtime addresses is operating degraded"
+  description: "A wired interface that is actually carrying runtime addresses but is negotiated at low bandwidth or half duplex represents a higher-confidence performance issue than hardware inventory alone."
+  severity: medium
+  category: host-topology
+  dry-run-support: partial
+  condition: |
+    components[
+      $prop($, 'cdx:hbom:hardwareClass') = 'network-interface'
+      and $number($firstNonEmpty($prop($, 'cdx:hostview:interface_addresses:count'), '0')) > 0
+      and (
+        $lowercase($safeStr($prop($, 'cdx:hbom:duplex'))) = 'half'
+        or (
+          $hasProp($, 'cdx:hbom:speedMbps')
+          and $number($prop($, 'cdx:hbom:speedMbps')) > 0
+          and $number($prop($, 'cdx:hbom:speedMbps')) < 1000
+        )
+      )
+    ]
+  location: |
+    {
+      "bomRef": $firstNonEmpty($."bom-ref", bom.serialNumber)
+    }
+  message: "Interface '{{ name }}' has live runtime address evidence but negotiated degraded duplex or bandwidth characteristics"
+  mitigation: "Inspect cabling, switch policy, NIC firmware/driver, and negotiated link settings before treating the issue as application-only latency."
+  evidence: |
+    {
+      "runtimeAddressCount": $prop($, 'cdx:hostview:interface_addresses:count'),
+      "driver": $prop($, 'cdx:hbom:driver'),
+      "speedMbps": $prop($, 'cdx:hbom:speedMbps'),
+      "duplex": $prop($, 'cdx:hbom:duplex'),
+      "operState": $prop($, 'cdx:hbom:operState')
+    }
+
+- id: HMX-002
+  name: "Wireless interface with live runtime address uses weak or missing link security"
+  description: "Weak wireless security on an interface that also has runtime address evidence is a stronger exposure signal than hardware inventory alone."
+  severity: high
+  category: host-topology
+  dry-run-support: partial
+  condition: |
+    components[
+      (
+        $prop($, 'cdx:hbom:hardwareClass') = 'wireless-adapter'
+        or (
+          $prop($, 'cdx:hbom:hardwareClass') = 'network-interface'
+          and $hasProp($, 'cdx:hbom:securityMode')
+        )
+      )
+      and $number($firstNonEmpty($prop($, 'cdx:hostview:interface_addresses:count'), '0')) > 0
+      and (
+        $safeStr($prop($, 'cdx:hbom:securityMode')) = ''
+        or $contains($lowercase($safeStr($prop($, 'cdx:hbom:securityMode'))), 'open')
+        or $contains($lowercase($safeStr($prop($, 'cdx:hbom:securityMode'))), 'wep')
+        or $contains($lowercase($safeStr($prop($, 'cdx:hbom:securityMode'))), 'none')
+      )
+    ]
+  location: |
+    {
+      "bomRef": $firstNonEmpty($."bom-ref", bom.serialNumber)
+    }
+  message: "Wireless interface '{{ name }}' has live runtime address evidence while using weak or missing security mode '{{ $firstNonEmpty($prop($, 'cdx:hbom:securityMode'), 'unknown') }}'"
+  mitigation: "Move the interface to WPA2/WPA3-class protections, review SSID policy, and verify that actively routed wireless links meet enterprise security baselines."
+  evidence: |
+    {
+      "runtimeAddressCount": $prop($, 'cdx:hostview:interface_addresses:count'),
+      "securityMode": $prop($, 'cdx:hbom:securityMode'),
+      "channel": $prop($, 'cdx:hbom:channel'),
+      "phyMode": $prop($, 'cdx:hbom:phyMode')
+    }
+
+- id: HMX-003
+  name: "Merged host inventory lacks strict hardware/runtime topology links"
+  description: "When a merged HBOM+OBOM view contains no strict cross-domain topology links, reviewers should treat combined host conclusions cautiously and inspect collection coverage."
+  severity: medium
+  category: host-topology
+  dry-run-support: partial
+  condition: |
+    metadata.component[
+      type = 'device'
+      and $prop($, 'cdx:hostview:mode') = 'hbom-obom-merged'
+      and $number($firstNonEmpty($prop($, 'cdx:hostview:topologyLinkCount'), '0')) = 0
+    ]
+  location: |
+    {
+      "bomRef": $firstNonEmpty($."bom-ref", bom.serialNumber)
+    }
+  message: "Merged host inventory for '{{ name }}' contains no strict HBOM-to-OBOM topology links"
+  mitigation: "Review collector coverage, ensure runtime categories such as interface_addresses or kernel_modules are available, and prefer exact identifier-bearing probes over heuristic joins."
+  evidence: |
+    {
+      "hostViewMode": $prop($, 'cdx:hostview:mode'),
+      "hardwareComponentCount": $prop($, 'cdx:hostview:hardwareComponentCount'),
+      "runtimeComponentCount": $prop($, 'cdx:hostview:runtimeComponentCount'),
+      "topologyLinkCount": $prop($, 'cdx:hostview:topologyLinkCount')
+    }
+
+- id: HMX-004
+  name: "Mounted storage with explicit runtime evidence is reporting degraded health"
+  description: "Storage health issues become higher-confidence operational findings when the hardware component is also linked to an active runtime mount or logical drive using exact identifiers."
+  severity: high
+  category: host-topology
+  dry-run-support: partial
+  condition: |
+    components[
+      (
+        $prop($, 'cdx:hbom:hardwareClass') = 'storage'
+        or $prop($, 'cdx:hbom:hardwareClass') = 'storage-device'
+        or $prop($, 'cdx:hbom:hardwareClass') = 'storage-volume'
+      )
+      and (
+        $number($firstNonEmpty($prop($, 'cdx:hostview:mount_hardening:count'), '0')) > 0
+        or $number($firstNonEmpty($prop($, 'cdx:hostview:runtime-storage:count'), '0')) > 0
+      )
+      and (
+        $contains($lowercase($safeStr($prop($, 'cdx:hbom:smartStatus'))), 'fail')
+        or $contains($lowercase($safeStr($prop($, 'cdx:hbom:health'))), 'degrad')
+        or $number($firstNonEmpty($prop($, 'cdx:hbom:wearPercentageUsed'), '0')) >= 90
+      )
+    ]
+  location: |
+    {
+      "bomRef": $firstNonEmpty($."bom-ref", bom.serialNumber)
+    }
+  message: "Storage component '{{ name }}' is explicitly linked to a runtime mount or drive while reporting degraded health telemetry"
+  mitigation: "Prioritize remediation for the backing device because the linked runtime mount evidence shows the degraded storage is actively in use."
+  evidence: |
+    {
+      "mountCount": $prop($, 'cdx:hostview:mount_hardening:count'),
+      "runtimeStorageCount": $prop($, 'cdx:hostview:runtime-storage:count'),
+      "smartStatus": $prop($, 'cdx:hbom:smartStatus'),
+      "health": $prop($, 'cdx:hbom:health'),
+      "wearPercentageUsed": $prop($, 'cdx:hbom:wearPercentageUsed')
+    }
+
+- id: HMX-005
+  name: "Explicit HBOM secure-boot trust anchor matches a revoked runtime Secure Boot certificate"
+  description: "When HBOM metadata carries an explicit Secure Boot certificate identifier that strictly links to runtime secureboot_certificates data, revoked trust anchors indicate a higher-confidence firmware trust issue."
+  severity: high
+  category: host-topology
+  dry-run-support: partial
+  condition: |
+    components[
+      $prop($, 'cdx:osquery:category') = 'secureboot_certificates'
+      and $number($firstNonEmpty($prop($, 'revoked'), '0')) > 0
+      and $number($firstNonEmpty($prop($$.metadata.component, 'cdx:hostview:secureboot_certificates:count'), '0')) > 0
+    ]
+  location: |
+    {
+      "bomRef": $firstNonEmpty($."bom-ref", bom.serialNumber)
+    }
+  message: "Secure Boot certificate '{{ name }}' is revoked and the host also has an explicit HBOM trust-anchor link for this Secure Boot surface"
+  mitigation: "Review firmware trust policy, remove revoked Secure Boot entries from active trust sets, and verify that the expected db/dbx anchors on the host still match the approved platform state."
+  evidence: |
+    {
+      "linkedSecureBootCertificateCount": $prop($, 'cdx:hostview:secureboot_certificates:count'),
+      "revokedCertificateCount": $count(bom.components[
+        $prop($, 'cdx:osquery:category') = 'secureboot_certificates'
+        and $number($firstNonEmpty($prop($, 'revoked'), '0')) > 0
+      ])
+    }

package/data/rules/mcp-servers.yaml

@@ -0,0 +1,388 @@
+- id: MCP-001
+  name: "Unauthenticated MCP tool server endpoint"
+  description: "HTTP-based MCP servers that expose tools without authentication let unauthenticated clients invoke model-controlled actions directly."
+  severity: critical
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0001, TA0002]
+    techniques: [T1190, T1059]
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+      - "LLM08: Excessive Agency"
+      - "LLM06:2025 Excessive Agency"
+    owasp-agentic-top-10-2026:
+      - "Tool Misuse & Exploitation"
+      - "Identity & Privilege Abuse"
+    eu-ai-act:
+      - "Human oversight"
+      - "Accuracy, robustness and cybersecurity"
+    eu-cra:
+      - "Protection against unauthorized access"
+      - "Secure by default network exposure"
+    nist-ai-rmf:
+      - "Map"
+      - "Manage"
+    nist-ssdf:
+      - "Protect externally reachable AI control surfaces"
+  condition: |
+    $auditServices($)[
+      $contains($nullSafeProp($, 'cdx:mcp:transport'), 'streamable-http')
+      and authenticated != true
+      and (
+        $prop($, 'cdx:mcp:capabilities:tools') = 'true'
+        or $prop($, 'cdx:mcp:toolCount') != '0'
+      )
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile'),
+      "purl": endpoints[0]
+    }
+  message: "MCP server '{{ name }}' exposes tool endpoints without authentication"
+  mitigation: "Require bearer-token or equivalent authentication before exposing HTTP MCP tool endpoints."
+  evidence: |
+    {
+      "transport": $prop($, 'cdx:mcp:transport'),
+      "toolCount": $prop($, 'cdx:mcp:toolCount'),
+      "endpoints": endpoints,
+      "sdkImports": $prop($, 'cdx:mcp:sdkImports')
+    }
+- id: MCP-002
+  name: "Unauthenticated MCP HTTP server"
+  description: "Streamable HTTP MCP servers should authenticate incoming requests before serving prompts, resources, or tools."
+  severity: high
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0001]
+    techniques: [T1190]
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+    owasp-agentic-top-10-2026:
+      - "Identity & Privilege Abuse"
+      - "Tool Misuse & Exploitation"
+    eu-ai-act:
+      - "Accuracy, robustness and cybersecurity"
+    eu-cra:
+      - "Protection against unauthorized access"
+      - "Secure configuration of network-exposed services"
+    nist-ai-rmf:
+      - "Map"
+      - "Manage"
+    nist-ssdf:
+      - "Authenticate and authorize AI-facing service endpoints"
+  condition: |
+    $auditServices($)[
+      $contains($nullSafeProp($, 'cdx:mcp:transport'), 'streamable-http')
+      and authenticated != true
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile'),
+      "purl": endpoints[0]
+    }
+  message: "MCP HTTP endpoint '{{ endpoints[0] }}' is reachable without authentication"
+  mitigation: "Protect MCP HTTP endpoints with authentication and validate Origin/host binding for local deployments."
+  evidence: |
+    {
+      "officialSdk": $prop($, 'cdx:mcp:officialSdk'),
+      "transport": $prop($, 'cdx:mcp:transport'),
+      "promptCount": $prop($, 'cdx:mcp:promptCount'),
+      "resourceCount": $prop($, 'cdx:mcp:resourceCount'),
+      "toolCount": $prop($, 'cdx:mcp:toolCount')
+    }
+- id: MCP-003
+  name: "Network-exposed non-official MCP server"
+  description: "MCP servers built on non-official SDKs or wrappers deserve extra review before being exposed over HTTP, especially when they register tools."
+  severity: medium
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0001]
+    techniques: [T1195.001]
+  standards:
+    owasp-ai-top-10:
+      - "LLM05: Supply Chain Vulnerabilities"
+      - "LLM07: Insecure Plugin Design"
+      - "LLM03:2025 Supply Chain"
+    owasp-agentic-top-10-2026:
+      - "Agentic Supply Chain"
+      - "Tool Misuse & Exploitation"
+    eu-ai-act:
+      - "Technical documentation and traceability"
+      - "Accuracy, robustness and cybersecurity"
+    eu-cra:
+      - "Software supply chain visibility"
+      - "Secure configuration of network-exposed services"
+    nist-ai-rmf:
+      - "Govern"
+      - "Map"
+    nist-ssdf:
+      - "Verify provenance of AI and automation integrations"
+  condition: |
+    $auditServices($)[
+      $contains($nullSafeProp($, 'cdx:mcp:transport'), 'streamable-http')
+      and $prop($, 'cdx:mcp:officialSdk') = 'false'
+      and (
+        $prop($, 'cdx:mcp:capabilities:tools') = 'true'
+        or $prop($, 'cdx:mcp:toolCount') != '0'
+        or $count(endpoints) > 0
+      )
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile'),
+      "purl": endpoints[0]
+    }
+  message: "MCP server '{{ name }}' is network-accessible but relies on a non-official SDK or wrapper"
+  mitigation: "Review the SDK provenance, pin exact versions, and harden authentication/authorization before exposing the server."
+  evidence: |
+    {
+      "sdkImports": $prop($, 'cdx:mcp:sdkImports'),
+      "toolCount": $prop($, 'cdx:mcp:toolCount'),
+      "providerNames": $prop($, 'cdx:mcp:providerNames'),
+      "modelNames": $prop($, 'cdx:mcp:modelNames')
+    }
+
+- id: MCP-004
+  name: "Configured MCP endpoint lacks auth posture"
+  description: "MCP services discovered only from client configuration files still need explicit authentication or OAuth posture when they resolve to network-accessible HTTP endpoints."
+  severity: high
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0001]
+    techniques: [T1190]
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+      - "LLM08: Excessive Agency"
+      - "LLM06:2025 Excessive Agency"
+    owasp-agentic-top-10-2026:
+      - "Tool Misuse & Exploitation"
+      - "Identity & Privilege Abuse"
+    eu-ai-act:
+      - "Transparency and instructions for use"
+      - "Human oversight"
+    eu-cra:
+      - "Secure configuration of network-exposed services"
+      - "Technical documentation for software components"
+    nist-ai-rmf:
+      - "Map"
+      - "Manage"
+    nist-ssdf:
+      - "Review and harden configured external AI control surfaces"
+  condition: |
+    $auditServices($)[
+      $prop($, 'cdx:mcp:inventorySource') = 'config-file'
+      and $contains($nullSafeProp($, 'cdx:mcp:transport'), 'http')
+      and authenticated != true
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile'),
+      "purl": endpoints[0]
+    }
+  message: "Configured MCP endpoint '{{ endpoints[0] }}' lacks any discovered auth posture"
+  mitigation: "Document bearer or OAuth requirements for configured MCP endpoints before allowing clients to auto-connect."
+  evidence: |
+    {
+      "configFormat": $prop($, 'cdx:mcp:configFormat'),
+      "configKey": $prop($, 'cdx:mcp:configKey'),
+      "authPosture": $prop($, 'cdx:mcp:authPosture'),
+      "trustProfile": $prop($, 'cdx:mcp:trustProfile')
+    }
+
+- id: MCP-005
+  name: "MCP configuration exposes inline credentials"
+  description: "MCP configs that embed tokens, API keys, or other secrets directly in args, env values, or headers create immediate credential-handling and supply-chain review risk."
+  severity: critical
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0006]
+    techniques: [T1552]
+  standards:
+    owasp-ai-top-10:
+      - "LLM05: Supply Chain Vulnerabilities"
+      - "LLM07: Insecure Plugin Design"
+      - "LLM03:2025 Supply Chain"
+    owasp-agentic-top-10-2026:
+      - "Identity & Privilege Abuse"
+      - "Agentic Supply Chain"
+    eu-ai-act:
+      - "Technical documentation and traceability"
+      - "Accuracy, robustness and cybersecurity"
+    eu-cra:
+      - "Protection of sensitive authentication data"
+      - "Secure by default credential handling"
+    nist-ai-rmf:
+      - "Govern"
+      - "Manage"
+    nist-ssdf:
+      - "Protect secrets used by automation and AI integrations"
+  condition: |
+    $auditServices($)[
+      $prop($, 'cdx:mcp:inventorySource') = 'config-file'
+      and $prop($, 'cdx:mcp:credentialExposure') = 'true'
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile')
+    }
+  message: "MCP config entry '{{ name }}' exposes inline credentials"
+  mitigation: "Move secrets out of config files and command args into secret stores or environment references that can be managed separately."
+  evidence: |
+    {
+      "configFormat": $prop($, 'cdx:mcp:configFormat'),
+      "configKey": $prop($, 'cdx:mcp:configKey'),
+      "credentialExposureFieldCount": $prop($, 'cdx:mcp:credentialExposureFieldCount'),
+      "credentialIndicatorCount": $prop($, 'cdx:mcp:credentialIndicatorCount'),
+      "credentialReferenceCount": $prop($, 'cdx:mcp:credentialReferenceCount')
+    }
+
+- id: MCP-006
+  name: "MCP configuration suggests confused-deputy risk"
+  description: "Dynamic client registration combined with a static configured client ID can create confused-deputy style authorization risk in MCP deployments."
+  severity: high
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0006]
+    techniques: [T1528]
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+      - "LLM08: Excessive Agency"
+      - "LLM06:2025 Excessive Agency"
+    owasp-agentic-top-10-2026:
+      - "Identity & Privilege Abuse"
+    eu-ai-act:
+      - "Human oversight"
+      - "Technical documentation and traceability"
+    eu-cra:
+      - "Secure authorization delegation"
+      - "Technical documentation for software components"
+    nist-ai-rmf:
+      - "Govern"
+      - "Map"
+    nist-ssdf:
+      - "Review AI authorization delegation and client registration flows"
+  condition: |
+    $auditServices($)[
+      $prop($, 'cdx:mcp:inventorySource') = 'config-file'
+      and $prop($, 'cdx:mcp:security:confusedDeputyRisk') = 'high'
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile')
+    }
+  message: "MCP config entry '{{ name }}' combines dynamic client registration with a static client identity"
+  mitigation: "Avoid mixing DCR with shared static client identities; isolate delegated clients and validate downstream authorization assumptions."
+  evidence: |
+    {
+      "configFormat": $prop($, 'cdx:mcp:configFormat'),
+      "configKey": $prop($, 'cdx:mcp:configKey'),
+      "supportsDCR": $prop($, 'cdx:mcp:auth:supportsDCR'),
+      "authPosture": $prop($, 'cdx:mcp:authPosture')
+    }
+
+- id: MCP-007
+  name: "MCP configuration forwards bearer or access tokens"
+  description: "Token-forwarding and passthrough settings in MCP configs deserve review because they can propagate delegated credentials across trust boundaries."
+  severity: high
+  category: mcp-server
+  dry-run-support: full
+  attack:
+    tactics: [TA0006]
+    techniques: [T1528]
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+      - "LLM08: Excessive Agency"
+      - "LLM06:2025 Excessive Agency"
+    owasp-agentic-top-10-2026:
+      - "Identity & Privilege Abuse"
+      - "Insecure Inter-Agent Communication"
+    eu-ai-act:
+      - "Human oversight"
+      - "Technical documentation and traceability"
+    eu-cra:
+      - "Secure handling of delegated credentials"
+      - "Secure communication across trust boundaries"
+    nist-ai-rmf:
+      - "Govern"
+      - "Manage"
+    nist-ssdf:
+      - "Review delegated token forwarding and trust-boundary crossings"
+  condition: |
+    $auditServices($)[
+      $prop($, 'cdx:mcp:inventorySource') = 'config-file'
+      and $prop($, 'cdx:mcp:security:tokenPassthroughRisk') = 'high'
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile')
+    }
+  message: "MCP config entry '{{ name }}' forwards or passes through bearer-like credentials"
+  mitigation: "Prefer server-side credential exchange or scoped token minting instead of forwarding end-user tokens through MCP configs."
+  evidence: |
+    {
+      "configFormat": $prop($, 'cdx:mcp:configFormat'),
+      "configKey": $prop($, 'cdx:mcp:configKey'),
+      "trustProfile": $prop($, 'cdx:mcp:trustProfile'),
+      "authPosture": $prop($, 'cdx:mcp:authPosture')
+    }
+
+- id: MCP-008
+  name: "MCP configuration file is included in a build or post-build SBOM"
+  description: "Committed MCP client configuration files can carry trust, auth, and distribution sensitivity even when they are not actively used during the current scan."
+  severity: medium
+  category: mcp-server
+  dry-run-support: full
+  standards:
+    owasp-ai-top-10:
+      - "LLM07: Insecure Plugin Design"
+      - "LLM08: Excessive Agency"
+      - "LLM06:2025 Excessive Agency"
+    owasp-agentic-top-10-2026:
+      - "Agentic Supply Chain"
+      - "Tool Misuse & Exploitation"
+    eu-ai-act:
+      - "Technical documentation and traceability"
+      - "Transparency and instructions for use"
+    eu-cra:
+      - "Technical documentation for software components"
+    nist-ai-rmf:
+      - "Govern"
+      - "Map"
+    nist-ssdf:
+      - "Review configured AI control surfaces before release"
+  condition: |
+    components[
+      $prop($, 'cdx:file:kind') = 'mcp-config'
+      and $count($$.metadata.lifecycles[phase = 'build' or phase = 'post-build']) > 0
+    ]
+  location: |
+    {
+      "bomRef": $."bom-ref",
+      "file": $prop($, 'internal:SrcFile')
+    }
+  message: "MCP config file '{{ name }}' is included in a build/post-build SBOM"
+  mitigation: "Review the config with '--bom-audit --bom-audit-categories mcp-server', consider '--tlp-classification AMBER' before sharing the BOM broadly, or rerun with '--exclude-type mcp' if config artifacts should be omitted."
+  evidence: |
+    {
+      "configFormat": $prop($, 'cdx:mcp:configFormat'),
+      "configuredServiceCount": $prop($, 'cdx:mcp:configuredServiceCount'),
+      "configuredServiceNames": $prop($, 'cdx:mcp:configuredServiceNames')
+    }