owasp-depscan 6.0.0a2__tar.gz → 6.0.0a3__tar.gz

{owasp_depscan-6.0.0a2/owasp_depscan.egg-info → owasp_depscan-6.0.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: owasp-depscan
-Version: 6.0.0a2
+Version: 6.0.0a3
 Summary: Fully open-source security audit for project dependencies based on known vulnerabilities and advisories.
 Author-email: Team AppThreat <cloud@appthreat.com>
 License-Expression: MIT
@@ -28,7 +28,7 @@ Requires-Dist: rich>=14.0.0
 Requires-Dist: Jinja2>=3.1.6
 Requires-Dist: packageurl-python>=0.16.0
 Requires-Dist: cvss>=3.4
-Requires-Dist: tomli>=2.2.1
+Requires-Dist: tomli>=2.2.1; python_full_version <= "3.11"
 Requires-Dist: ds-xbom-lib
 Requires-Dist: ds-analysis-lib
 Provides-Extra: dev
@@ -147,8 +147,6 @@ Always stay a step ahead with advanced vulnerability and exploit prediction.
 - Chainguard
 - Wolfi OS
 
-Application vulnerabilities would be reported for all Linux distros and Windows. To download the full vulnerability database suitable for scanning OS, invoke dep-scan with `` for the first time. dep-scan would also download the appropriate database based on project type automatically.
-
 ## Quick Start
 
 dep-scan is ideal for use during continuous integration (CI) and as a local development tool.

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/README.md

@@ -91,8 +91,6 @@ Always stay a step ahead with advanced vulnerability and exploit prediction.
 - Chainguard
 - Wolfi OS
 
-Application vulnerabilities would be reported for all Linux distros and Windows. To download the full vulnerability database suitable for scanning OS, invoke dep-scan with `` for the first time. dep-scan would also download the appropriate database based on project type automatically.
-
 ## Quick Start
 
 dep-scan is ideal for use during continuous integration (CI) and as a local development tool.

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/depscan/cli.py

@@ -822,7 +822,7 @@ def run_depscan(args):
                     pkg_max_risk_score=pkg_max_risk_score,
                     risk_report_file=risk_report_file,
                 )
-                if not args.no_vuln_table and report_data:
+                if not args.no_vuln_table and report_data and rtable:
                     console.print(rtable)
             except Exception as e:
                 LOG.error(e)

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/depscan/lib/bom.py

@@ -6,7 +6,6 @@ from collections import defaultdict
 from datetime import datetime, timezone
 from urllib.parse import unquote_plus
 
-from blint.cyclonedx.spec import CycloneDX
 from custom_json_diff.lib.utils import json_load, json_dump
 from defusedxml.ElementTree import parse
 from xbom_lib.blint import BlintGenerator
@@ -15,7 +14,6 @@ from xbom_lib.cdxgen import (
     CdxgenImageBasedGenerator,
     CdxgenServerGenerator,
 )
-
 from depscan.lib.logger import LOG, SPINNER, console
 from depscan.lib.utils import cleanup_license_string
 from typing import Dict, Optional
@@ -327,13 +325,6 @@ def create_blint_bom(
             LOG.info(
                 "The blint invocation was unsuccessful. Try generating the BOM separately."
             )
-        # Empty SBOM is fine if there are no binaries in the project.
-        elif bom_result.bom_obj and isinstance(bom_result.bom_obj, CycloneDX):
-            if (
-                not bom_result.bom_obj.components
-                and not bom_result.bom_obj.dependencies
-            ):
-                LOG.debug("Empty SBOM received from blint.")
         return bom_result.success and os.path.exists(bom_file)
 
 
@@ -418,7 +409,12 @@ def create_lifecycle_boms(cdxgen_lib, src_dir, options):
             )
         status.update("Preparing blint for post-build BOM generation.")
     # post-build BOM with blint
-    coptions = {**options, "deep": False, "use_blintdb": False, "lifecycles": ["post-build"]}
+    coptions = {
+        **options,
+        "deep": False,
+        "use_blintdb": False,
+        "lifecycles": ["post-build"],
+    }
     # What if the build directory is different to the source
     build_dir = os.getenv("DEPSCAN_BUILD_DIR") or options.get("build_dir") or src_dir
     res = create_blint_bom(postbuild_bom_file, build_dir, options=coptions)

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/depscan/lib/explainer.py

@@ -1,3 +1,4 @@
+import os
 import re
 import glob
 from collections import defaultdict
@@ -58,6 +59,12 @@ The following endpoints and code hotspots were identified by depscan. Verify tha
         else "Reachable Flows"
     )
     for sf in slices_files:
+        if len(slices_files) > 1:
+            fn = os.path.basename(sf)
+            section_label = f"# Explanations for {sf}"
+            if "-" in fn:
+                section_label = f"# Explanations for {fn.split('-')[0].upper()}"
+            console.print(Markdown(section_label))
         if (reachables_data := json_load(sf, log=LOG)) and reachables_data.get(
             "reachables"
         ):
@@ -176,11 +183,15 @@ def explain_reachables(
     sink_reachable_explanations = defaultdict(int)
     has_explanation = False
     header_shown = False
+    has_cpp_flow = False
     for areach in reachables.get("reachables", []):
+        cpp_flow = is_cpp_flow(areach.get("flows"))
+        if not has_cpp_flow and cpp_flow:
+            has_cpp_flow = True
         if (
             not areach.get("flows")
             or len(areach.get("flows")) < 2
-            or (not areach.get("purls") and not is_cpp_flow(areach.get("flows")))
+            or (not areach.get("purls") and not cpp_flow)
         ):
             continue
         # Focus only on the prioritized list if available
@@ -207,7 +218,7 @@ def explain_reachables(
             project_type,
             vdr_result,
         )
-        if not source_sink_desc or not flow_tree:
+        if not source_sink_desc or not flow_tree or len(flow_tree.children) < 5:
             continue
         # In non-reachables mode, we are not interested in reachable flows.
         if (
@@ -282,9 +293,15 @@ def explain_reachables(
 - Generate a Cryptographic BOM with cdxgen and monitor it in Dependency-Track.
 """
         elif checked_flows:
-            tips += """
+            if not has_cpp_flow:
+                tips += """
 - Review the validation and sanitization methods used in the application.
 - To enhance the security posture, implement a common validation middleware.
+"""
+            else:
+                tips += """
+- Continuously fuzz the parser and validation functions with diverse payloads.
+- Generate post-build SBOMs with OWASP blint by building this project for various architecture combinations. Re-run depscan with the `--bom-dir` argument to enhance the analysis.
 """
         elif purls_reachable_explanations:
             tips += """
@@ -348,7 +365,7 @@ def flow_to_source_sink(idx, flow, purls, project_type, vdr_result):
             source_sink_desc = f"Invocation: {method_full_name}"
     elif flow.get("label") == "RETURN" and flow.get("code"):
         source_sink_desc = flow.get("code").split("\n")[0]
-    elif project_type not in ("java") and flow.get("label") == "IDENTIFIER":
+    elif project_type not in ("java",) and flow.get("label") == "IDENTIFIER":
         source_sink_desc = flow.get("code").split("\n")[0]
         if source_sink_desc.endswith("("):
             source_sink_desc = f":diamond_suit: {source_sink_desc})"
@@ -411,19 +428,21 @@ def filter_tags(tags):
 
 
 def is_filterable_code(project_type, code):
-    match project_type:
-        case "js" | "ts" | "javascript" | "typescript" | "bom":
-            for c in (
-                "console.log",
-                "thoughtLog(",
-                "_tmp_",
-                "LOG.debug(",
-                "options.get(",
-                "RET",
-                "this.",
-            ):
-                if code and code.startswith(c):
-                    return True
+    if len(code) < 5:
+        return True
+    for c in (
+        "console.log",
+        "thoughtLog(",
+        "_tmp_",
+        "LOG.debug(",
+        "options.get(",
+        "RET",
+        "this.",
+        "NULL",
+        "!",
+    ):
+        if code and code.startswith(c):
+            return True
     return False
 
 
@@ -440,17 +459,21 @@ def flow_to_str(explanation_mode, flow, project_type):
     node_desc = flow.get("code").split("\n")[0]
     if node_desc.endswith("("):
         node_desc = f":diamond_suit: {node_desc})"
+    elif node_desc.startswith("return "):
+        node_desc = f":arrow_backward: [italic]{node_desc}[/italic]"
     tags = filter_tags(flow.get("tags"))
-    if flow.get("label") == "METHOD_PARAMETER_IN":
+    if flow.get("label") in ("METHOD_PARAMETER_IN",):
         param_name = flow.get("name")
         if param_name == "this":
             param_name = ""
         node_desc = f"{flow.get('parentMethodName')}([red]{param_name}[/red]) :right_arrow_curving_left:"
         if tags:
             node_desc = f"{node_desc}\n[bold]Tags:[/bold] [italic]{tags}[/italic]\n"
-    elif flow.get("label") == "IDENTIFIER":
+    elif flow.get("label") in ("IDENTIFIER", "CALL"):
         if node_desc.startswith("<"):
             node_desc = flow.get("name")
+        if flow.get("isExternal"):
+            node_desc = f"{node_desc} :right_arrow_curving_up:"
         if tags:
             node_desc = f"{node_desc}\n[bold]Tags:[/bold] [italic]{tags}[/italic]\n"
     if tags and not is_filterable_code(project_type, node_desc):
@@ -518,7 +541,7 @@ def explain_flows(explanation_mode, flows, purls, project_type, vdr_result):
         file_loc, flow_str, node_desc, has_check_tag_flow = flow_to_str(
             explanation_mode, aflow, project_type
         )
-        if last_file_loc and last_file_loc == file_loc:
+        if not flow_str or (last_file_loc and last_file_loc == file_loc):
             continue
         last_file_loc = file_loc
         if flow_str in added_flows or node_desc in added_node_desc:

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3/owasp_depscan.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: owasp-depscan
-Version: 6.0.0a2
+Version: 6.0.0a3
 Summary: Fully open-source security audit for project dependencies based on known vulnerabilities and advisories.
 Author-email: Team AppThreat <cloud@appthreat.com>
 License-Expression: MIT
@@ -28,7 +28,7 @@ Requires-Dist: rich>=14.0.0
 Requires-Dist: Jinja2>=3.1.6
 Requires-Dist: packageurl-python>=0.16.0
 Requires-Dist: cvss>=3.4
-Requires-Dist: tomli>=2.2.1
+Requires-Dist: tomli>=2.2.1; python_full_version <= "3.11"
 Requires-Dist: ds-xbom-lib
 Requires-Dist: ds-analysis-lib
 Provides-Extra: dev
@@ -147,8 +147,6 @@ Always stay a step ahead with advanced vulnerability and exploit prediction.
 - Chainguard
 - Wolfi OS
 
-Application vulnerabilities would be reported for all Linux distros and Windows. To download the full vulnerability database suitable for scanning OS, invoke dep-scan with `` for the first time. dep-scan would also download the appropriate database based on project type automatically.
-
 ## Quick Start
 
 dep-scan is ideal for use during continuous integration (CI) and as a local development tool.

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/owasp_depscan.egg-info/requires.txt

@@ -6,10 +6,12 @@ rich>=14.0.0
 Jinja2>=3.1.6
 packageurl-python>=0.16.0
 cvss>=3.4
-tomli>=2.2.1
 ds-xbom-lib
 ds-analysis-lib
 
+[:python_full_version <= "3.11"]
+tomli>=2.2.1
+
 [all]
 atom-tools>=0.7.8
 blint>=2.4.1

{owasp_depscan-6.0.0a2 → owasp_depscan-6.0.0a3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "owasp-depscan"
-version = "6.0.0a2"
+version = "6.0.0a3"
 description = "Fully open-source security audit for project dependencies based on known vulnerabilities and advisories."
 authors = [
     {name = "Team AppThreat", email = "cloud@appthreat.com"},
@@ -14,7 +14,7 @@ dependencies = [
     "Jinja2>=3.1.6",
     "packageurl-python>=0.16.0",
     "cvss>=3.4",
-    "tomli>=2.2.1",
+    "tomli>=2.2.1; python_full_version <= '3.11'",
     "ds-xbom-lib",
     "ds-analysis-lib"
 ]