From 037947d2bc4051a6f1306aa532280961fc7c4225 Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Thu, 26 Jun 2025 05:08:29 +1000 Subject: [PATCH 1/8] docs: update provenance tutorial; add repo commit extraction for github attestation Signed-off-by: Ben Selwyn-Smith --- .../_static/images/tutorial_osi_toga.png | Bin 0 -> 37690 bytes ...t.png => tutorial_semver_7.7.2_report.png} | Bin .../_static/images/tutorial_toga_github.png | Bin 0 -> 42220 bytes .../_static/images/tutorial_toga_pypi.png | Bin 0 -> 61661 bytes docs/source/pages/tutorials/commit_finder.rst | 2 +- docs/source/pages/tutorials/index.rst | 2 +- .../{npm_provenance.rst => provenance.rst} | 115 ++++++++++++++---- .../provenance/provenance_extractor.py | 40 +++++- src/macaron/slsa_analyzer/analyzer.py | 7 ++ .../{policy_7_6_2.dl => policy_7_7_2.dl} | 4 +- .../{policy_7_6_x.dl => policy_7_x.dl} | 4 +- .../test.yaml | 12 +- 12 files changed, 148 insertions(+), 38 deletions(-) create mode 100644 docs/source/_static/images/tutorial_osi_toga.png rename docs/source/_static/images/{tutorial_semver_7.6.2_report.png => tutorial_semver_7.7.2_report.png} (100%) create mode 100644 docs/source/_static/images/tutorial_toga_github.png create mode 100644 docs/source/_static/images/tutorial_toga_pypi.png rename docs/source/pages/tutorials/{npm_provenance.rst => provenance.rst} (54%) rename tests/integration/cases/tutorial_npm_verify_provenance_semver/{policy_7_6_2.dl => policy_7_7_2.dl} (80%) rename tests/integration/cases/tutorial_npm_verify_provenance_semver/{policy_7_6_x.dl => policy_7_x.dl} (83%) diff --git a/docs/source/_static/images/tutorial_osi_toga.png b/docs/source/_static/images/tutorial_osi_toga.png new file mode 100644 index 0000000000000000000000000000000000000000..10f6a84a46b9d5955a34da69d023c9abcc3b6ffd GIT binary patch literal 37690 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μRKu1$;$(t*p!7H|)!x7_@)-!g#NtcKkfmBh?IZ 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 literal 0 HcmV?d00001 diff --git a/docs/source/_static/images/tutorial_semver_7.6.2_report.png b/docs/source/_static/images/tutorial_semver_7.7.2_report.png similarity index 100% rename from docs/source/_static/images/tutorial_semver_7.6.2_report.png rename to docs/source/_static/images/tutorial_semver_7.7.2_report.png diff --git a/docs/source/_static/images/tutorial_toga_github.png b/docs/source/_static/images/tutorial_toga_github.png new file mode 100644 index 0000000000000000000000000000000000000000..92129a93d979ea160667121004a6748e448b5242 GIT binary patch literal 42220 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%0D4C=_?&qcps{ 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 literal 0 HcmV?d00001 diff --git a/docs/source/pages/tutorials/commit_finder.rst b/docs/source/pages/tutorials/commit_finder.rst index f0338c7d2..23dc4e46a 100644 --- a/docs/source/pages/tutorials/commit_finder.rst +++ b/docs/source/pages/tutorials/commit_finder.rst @@ -164,4 +164,4 @@ Future Work Mapping artifact to commits within repositories is a challenging endeavour. Macron's Commit Finder feature relies on repositories having and using version tags in a sensible way (a tag is considered sensible if it closely matches the version it represents). An alternative, or complimentary, approach would be to make use of the information found within provenance files, where information such as the commit hash used to create the artifact can potentially be found. Additionally, it should be noted that the Commit Finder feature was modelled on the intentions of developers (in terms of tag usage) within a large quantity of Java projects. As tag formatting is "generally" language agnostic in the same way that versioning schemes are, this feature should work well for other languages. However, there may be some improvements to be made by further testing on a large number of non-Java projects. -.. note:: Macaron now supports extracting repository URLs and commit hashes from provenance files. This is demonstrated in a new tutorial: :doc:`npm_provenance `. +.. note:: Macaron now supports extracting repository URLs and commit hashes from provenance files. This is demonstrated in a new tutorial: :doc:`provenance `. diff --git a/docs/source/pages/tutorials/index.rst b/docs/source/pages/tutorials/index.rst index d16c56f70..bc6bfdb28 100644 --- a/docs/source/pages/tutorials/index.rst +++ b/docs/source/pages/tutorials/index.rst @@ -20,7 +20,7 @@ For the full list of supported technologies, such as CI services, registries, an commit_finder detect_malicious_package detect_vulnerable_github_actions - npm_provenance + provenance detect_malicious_java_dep generate_verification_summary_attestation use_verification_summary_attestation diff --git a/docs/source/pages/tutorials/npm_provenance.rst b/docs/source/pages/tutorials/provenance.rst similarity index 54% rename from docs/source/pages/tutorials/npm_provenance.rst rename to docs/source/pages/tutorials/provenance.rst index 6a591e716..8f6918010 100644 --- a/docs/source/pages/tutorials/npm_provenance.rst +++ b/docs/source/pages/tutorials/provenance.rst @@ -5,9 +5,9 @@ Provenance discovery, extraction, and verification -------------------------------------------------- -This tutorial demonstrates how Macaron can automatically retrieve provenance for npm artifacts, validate the contents, and verify the authenticity. Any artifact that can be analyzed and checked for these properties can then be trusted to a greater degree than would be otherwise possible, as provenance files provide verifiable information, such as the commit and build service pipeline that has triggered the release. +This tutorial demonstrates how Macaron can automatically retrieve provenance for artifacts, validate the contents, and verify the authenticity. Any artifact that can be analyzed and checked for these properties can then be trusted to a greater degree than would be otherwise possible, as provenance files provide verifiable information, such as the commit and build service pipeline that has triggered the release. -For npm artifacts, Macaron makes use of available features provided by `npm `_. Most importantly, npm allows developers to generate provenance files when publishing their artifacts. The `semver `_ package is chosen as an example for this tutorial. +Currently, Macaron supports discovery of attestation for: npm artifacts using features provided by `npm `_; PyPI artifacts using features provided by `Open Source Insights `_; and artifacts that have been published attestations to `GitHub `_. This tutorial uses two example packages to demonstrate these three discovery methods: The `semver `_ npm package, and the `toga `_ PyPI package. ****************************** Installation and Prerequisites @@ -34,46 +34,111 @@ Skip this section if you already know how to install Macaron. Now you should be good to run Macaron. For more details, see the documentation :ref:`here `. -******** -Analysis -******** +The analyses in this tutorial involve downloading the contents of a target repository to the configured, or default, ``output`` folder. Results from the analyses, including checks, are stored in the database found at ``output/macaron.db`` (See :ref:`Output Files Guide `). Once the analysis is complete, Macaron will also produce a report in the form of a HTML file. -To perform an analysis on the latest version of semver (when this tutorial was written), Macaron can be run with the following command: +.. note:: If you are unfamiliar with PackageURLs (purl), see this link: `PURLs `_. -.. code-block:: shell +************************************** +Attestation Discovery for semver (npm) +************************************** - ./run_macaron.sh analyze -purl pkg:npm/semver@7.6.2 --verify-provenance +To perform an analysis on the latest version of semver (when this tutorial was written), Macaron can be run with the following command: -The analysis involves Macaron downloading the contents of the target repository to the configured, or default, ``output`` folder. Results from the analysis, including checks, are stored in the database found at ``output/macaron.db`` (See :ref:`Output Files Guide `). Once the analysis is complete, Macaron will also produce a report in the form of a HTML file. +.. code-block:: shell -.. note:: If you are unfamiliar with PackageURLs (purl), see this link: `PURLs `_. + ./run_macaron.sh analyze -purl pkg:npm/semver@7.7.2 --verify-provenance During this analysis, Macaron will retrieve two provenance files from the npm registry. One is a :term:`SLSA` v1.0 provenance, while the other is a npm specific publication provenance. The SLSA provenance provides details of the artifact it relates to, the repository it was built from, and the build action used to build it. The npm specific publication provenance exists if the SLSA provenance has been verified before publication. -.. note:: Most of the details from the two provenance files can be found through the links provided on the artifacts page on the npm website. In particular: `Sigstore Rekor `_. The provenance file itself can be found at: `npm registry `_. +.. note:: Most of the details from the two provenance files can be found through the links provided on the artifacts page on the npm website. In particular: `Sigstore Rekor `_. The provenance file itself can be found at: `npm registry `_. Of course to reliably say the above does what is claimed here, proof is needed. For this we can rely on the check results produced from the analysis run. In particular, we want to know the results of three checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. The first two to ensure that the commit and the repository being analyzed match those found in the provenance file, and the last check to ensure that the provenance file has been verified. For the third check to succeed, you need to enable provenance verification in Macaron by using the ``--verify-provenance`` command-line argument, as demonstrated above. This verification is disabled by default because it can be slow in some cases due to I/O-bound operations. -.. _fig_semver_7.6.2_report: +.. _fig_semver_7.7.2_report: -.. figure:: ../../_static/images/tutorial_semver_7.6.2_report.png - :alt: HTML report for ``semver 7.6.2``, summary +.. figure:: ../../_static/images/tutorial_semver_7.7.2_report.png + :alt: HTML report for ``semver 7.7.2``, summary :align: center - This image shows that the report produced by the previous analysis has pass results for the three checks of interest. This can also be viewed directly by opening the report file: .. code-block:: shell open output/reports/npm/semver/semver.html -***************************** -Run ``verify-policy`` command -***************************** +The check results of this example (and others) can be automatically verified. A demonstration of verification for this case is provided later in this tutorial. + +************************************* +Attestation Discovery for toga (PyPI) +************************************* + +To perform an analysis on the latest version of toga (when this tutorial was written), Macaron can be run with the following command: + +.. code-block:: shell + + ./run_macaron.sh analyze -purl pkg:pypi/toga@0.5.1 + +During this analysis, Macaron will retrieve information from two sources to attempt to discover a PyPI attestation file. Firstly, Open Source Insights will be queried for an attestation URL that can be used to access the desired information. If found, this URL can be followed to its source on the PyPI package registry, which is where the actual attestation file is hosted. + +As an example of these internal steps, the attestation information can be seen via the `Open Source Insights API `_. From this information the PyPI attestation URL is extracted, revealing its location: `https://pypi.org/integrity/toga/0.5.1/toga-0.5.1-py3-none-any.whl/provenance `_. + +.. _fig_toga_osi_api: + +.. figure:: ../../_static/images/tutorial_osi_toga.png + :alt: Open Source Insight's API result for toga package + :align: center + +This image shows the attestation URL found in the Open Source Insight API result. + +By using the Open Source Insights API, Macaron can check that the discovered provenance is verified, as well as being a valid match of the user provided PURL. For this we can rely on the check results produced from the analysis run. In particular, we want to know the results of three checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. The first two to ensure that the commit and the repository being analyzed match those found in the provenance file, and the last check to ensure that the provenance file has been verified. + +.. _fig_toga_pypi_checks: + +.. figure:: ../../_static/images/tutorial_toga_pypi.png + :alt: HTML report for ``toga 0.5.1``, summary + :align: center + +All three checks show they have passed, meaning Macaron has discovered the correct provenance for the user provided PURL, and determined that it is verified. To access the full report use the following: + +.. code-block:: shell + + open output/reports/pypi/toga/toga.html + +*************************************** +Attestation Discovery for toga (GitHub) +*************************************** + +The toga library is interesting in that it has GitHub attestation or PyPI attestation depending on which particular version of it is analyzed. To discover a GitHub attestation, we can analyze version 0.4.8: + +.. code-block:: shell + + ./run_macaron.sh analyze -purl pkg:pypi/toga@0.4.8 + +During this analysis, Macaron will attempt to discover a GitHub attestation by computing the hash of the relevant artifact. This is a requirement of GitHub's API to view artifact attestation, see the `GitHub Attestation API `_. The hash is computed by downloading the artifact and analysing it with the SHA256 algorithm. With the hash, the GitHub API can be called to find the related attestation. + +In this particular case, the SHA256 hash of the toga 0.4.8 artifact is 0814a72abb0a9a5f22c32cc9479c55041ec30cdf4b12d73a0017aee58f9a1f00. A GitHub attestation can be found for this artifact `here `_. + +Attestation discovered through GitHub cannot be ascertained as verified at this time. However, we can still be sure that the repository URL and commit digest associated with the user provided PURL match what is found within the attestation. This is reported by Macaron in two checks: ``mcn_provenance_derived_repo_1`` and ``mcn_provenance_derived_commit_1``. + +.. _fig_toga_github_checks: + +.. figure:: ../../_static/images/tutorial_toga_github.png + :alt: HTML report for ``toga 0.4.8``, summary + :align: center + +This image shows that both checks have passed, confirming that the repository URL and commit digest from the provenance match those associated with the user provided PURL. To access the full report use the following: + +.. code-block:: shell + + open output/reports/pypi/toga/toga.html + +************************************** +Run ``verify-policy`` command (semver) +************************************** Another feature of Macaron is policy verification. This allows Macaron to report on whether an artifact meets the security requirements specified by the user. Policies are written using `Soufflé Datalog `_ , a language similar to SQL. Results collected by the ``analyze`` command can be checked via declarative queries in the created policy, which Macaron can then automatically check. -For this tutorial, we can create a policy that checks whether the three checks (as above) have passed. In this way we can be sure that the requirement is satisfied without having to dive into the reports directly. +For this tutorial, we can create a policy that checks whether the three checks relating to the semver npm example above have passed. E.g. ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. In this way we can be sure that the requirement is satisfied without having to dive into the reports directly. .. code-block:: prolog @@ -85,9 +150,9 @@ For this tutorial, we can create a policy that checks whether the three checks ( check_passed(component_id, "mcn_provenance_verified_1"). apply_policy_to("has-verified-provenance", component_id) :- - is_component(component_id, "pkg:npm/semver@7.6.2"). + is_component(component_id, "pkg:npm/semver@7.7.2"). -After including some helper rules, the above policy is defined as requiring all three of the checks to pass through the ``check_passed(, )`` mechanism. The target is then defined by the criteria applied to the policy. In this case, the artifact with a PURL that matches the version of ``semver`` used in this tutorial: ``pkg:npm/semver@7.6.2``. With this check saved to a file, say ``verified.dl``, we can run it against Macaron's local database to confirm that the analysis we performed earlier in this tutorial did indeed pass all three checks. +After including some helper rules, the above policy is defined as requiring all three of the checks to pass through the ``check_passed(, )`` mechanism. The target is then defined by the criteria applied to the policy. In this case, the artifact with a PURL that matches the version of ``semver`` used in this tutorial: ``pkg:npm/semver@7.7.2``. With this check saved to a file, say ``verified.dl``, we can run it against Macaron's local database to confirm that the analysis we performed earlier in this tutorial did indeed pass all three checks. .. code-block:: shell @@ -98,7 +163,7 @@ The result of this command should show that the policy we have written succeeds .. code-block:: javascript component_satisfies_policy - ['1', 'pkg:npm/semver@7.6.2', 'has-verified-provenance'] + ['1', 'pkg:npm/semver@7.7.2', 'has-verified-provenance'] component_violates_policy failed_policies passed_policies @@ -117,14 +182,14 @@ With this modification, all versions of ``semver`` previously analysed will show .. code-block:: javascript component_satisfies_policy - ['1', 'pkg:npm/semver@7.6.2', 'has-verified-provenance'] + ['1', 'pkg:npm/semver@7.7.2', 'has-verified-provenance'] ['2', 'pkg:npm/semver@7.6.0', 'has-verified-provenance'] component_violates_policy ['3', 'pkg:npm/semver@1.0.0', 'has-verified-provenance'] failed_policies ['has-verified-provenance'] -Here we can see that the newer versions, 7.6.2 and 7.6.0, passed the checks, meaning they have verified provenance. The much older version, 1.0.0, did not pass the checks, which is not surprising given that it was published 13 years before this tutorial was made. +Here we can see that the newer versions, 7.7.2 and 7.6.0, passed the checks, meaning they have verified provenance. The much older version, 1.0.0, did not pass the checks, which is not surprising given that it was published 13 years before this tutorial was made. However, if we wanted to acknowledge that earlier versions of the artifact do not have provenance, and accept that as part of the policy, we can do that too. For this to succeed we need to extend the policy with more complicated modifications. @@ -157,7 +222,7 @@ When run, this updated policy produces the following: .. code-block:: javascript component_satisfies_policy - ['1', 'pkg:npm/semver@7.6.2', 'has-verified-provenance-or-is-excluded'] + ['1', 'pkg:npm/semver@7.7.2', 'has-verified-provenance-or-is-excluded'] ['2', 'pkg:npm/semver@7.6.0', 'has-verified-provenance-or-is-excluded'] ['3', 'pkg:npm/semver@1.0.0', 'has-verified-provenance-or-is-excluded'] component_violates_policy diff --git a/src/macaron/provenance/provenance_extractor.py b/src/macaron/provenance/provenance_extractor.py index f2c54c607..b4b71d8b7 100644 --- a/src/macaron/provenance/provenance_extractor.py +++ b/src/macaron/provenance/provenance_extractor.py @@ -159,7 +159,7 @@ def _extract_from_slsa_v1(payload: InTotoV1Payload) -> tuple[str | None, str | N repo = json_extract(predicate, ["buildDefinition", "externalParameters", "sourceToBuild", "repository"], str) if not repo: repo = json_extract(predicate, ["buildDefinition", "externalParameters", "configSource", "repository"], str) - elif isinstance(build_def, SLSAGithubActionsBuildDefinitionV1): + elif isinstance(build_def, (SLSAGithubActionsBuildDefinitionV1, GitHubActionsBuildDefinition)): repo = json_extract(predicate, ["buildDefinition", "externalParameters", "workflow", "repository"], str) elif isinstance(build_def, SLSAOCIBuildDefinitionV1): repo = json_extract(predicate, ["buildDefinition", "externalParameters", "source"], str) @@ -684,6 +684,43 @@ def get_build_invocation(self, statement: InTotoV01Statement | InTotoV1Statement return gha_workflow, invocation_url +class GitHubActionsBuildDefinition(ProvenanceBuildDefinition): + """Class representing the GitHub Actions Build Definition (v1). + + This class implements the abstract methods defined in `ProvenanceBuildDefinition` + to extract build invocation details specific to the GitHub actions attestation build type. + """ + + #: Determines the expected ``buildType`` field in the provenance predicate. + expected_build_type = "https://actions.github.io/buildtypes/workflow/v1" + + def get_build_invocation(self, statement: InTotoV01Statement | InTotoV1Statement) -> tuple[str | None, str | None]: + """Retrieve the build invocation information from the given statement. + + Parameters + ---------- + statement : InTotoV1Statement | InTotoV01Statement + The provenance statement from which to extract the build invocation + details. This statement contains the metadata about the build process + and its associated artifacts. + + Returns + ------- + tuple[str | None, str | None] + A tuple containing two elements: + - The first element is the build invocation entry point (e.g., workflow name), or None if not found. + - The second element is the invocation URL or identifier (e.g., job URL), or None if not found. + """ + if statement["predicate"] is None: + return None, None + + gha_workflow = json_extract( + statement["predicate"], ["buildDefinition", "externalParameters", "workflow", "path"], str + ) + invocation_url = json_extract(statement["predicate"], ["runDetails", "metadata", "invocationId"], str) + return gha_workflow, invocation_url + + class ProvenancePredicate: """Class providing utility methods for handling provenance predicates. @@ -750,6 +787,7 @@ def find_build_def(statement: InTotoV01Statement | InTotoV1Statement) -> Provena SLSAOCIBuildDefinitionV1(), WitnessGitLabBuildDefinitionV01(), PyPICertificateDefinition(), + GitHubActionsBuildDefinition(), ] for build_def in build_defs: diff --git a/src/macaron/slsa_analyzer/analyzer.py b/src/macaron/slsa_analyzer/analyzer.py index 8c0faaad8..de3a80a1f 100644 --- a/src/macaron/slsa_analyzer/analyzer.py +++ b/src/macaron/slsa_analyzer/analyzer.py @@ -513,6 +513,13 @@ def run_single( artifact_hash = self.get_artifact_hash(parsed_purl, local_artifact_dirs, package_registries_info) if artifact_hash: provenance_payload = self.get_github_attestation_payload(analyze_ctx, git_service, artifact_hash) + if provenance_payload: + try: + provenance_repo_url, provenance_commit_digest = extract_repo_and_commit_from_provenance( + provenance_payload + ) + except ProvenanceError as error: + logger.debug("Failed to extract from provenance: %s", error) if parsed_purl is not None: self._verify_repository_link(parsed_purl, analyze_ctx) diff --git a/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_2.dl b/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_7_2.dl similarity index 80% rename from tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_2.dl rename to tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_7_2.dl index 60c4a4df2..5279c569e 100644 --- a/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_2.dl +++ b/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_7_2.dl @@ -1,4 +1,4 @@ -/* Copyright (c) 2024 - 2024, Oracle and/or its affiliates. All rights reserved. */ +/* Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. */ /* Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. */ #include "prelude.dl" @@ -9,4 +9,4 @@ Policy("has-verified-provenance", component_id, "Require a verified provenance f check_passed(component_id, "mcn_provenance_verified_1"). apply_policy_to("has-verified-provenance", component_id) :- - is_component(component_id, "pkg:npm/semver@7.6.2"). + is_component(component_id, "pkg:npm/semver@7.7.2"). diff --git a/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_x.dl b/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_x.dl similarity index 83% rename from tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_x.dl rename to tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_x.dl index bbfdf3db9..0a59f84d4 100644 --- a/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_6_x.dl +++ b/tests/integration/cases/tutorial_npm_verify_provenance_semver/policy_7_x.dl @@ -1,4 +1,4 @@ -/* Copyright (c) 2024 - 2024, Oracle and/or its affiliates. All rights reserved. */ +/* Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. */ /* Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. */ #include "prelude.dl" @@ -10,4 +10,4 @@ Policy("has-verified-provenance", component_id, "Require a verified provenance f apply_policy_to("has-verified-provenance", component_id) :- is_component(component_id, purl), - match("pkg:npm/semver@7.6.*", purl). + match("pkg:npm/semver@7.*", purl). diff --git a/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml b/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml index ac11642f4..6b1477cea 100644 --- a/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml +++ b/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml @@ -8,17 +8,17 @@ tags: - tutorial steps: -- name: Run macaron analyze semver@7.6.2 +- name: Run macaron analyze semver@7.7.2 kind: analyze options: command_args: - -purl - - pkg:npm/semver@7.6.2 + - pkg:npm/semver@7.7.2 - --verify-provenance -- name: Verify checks for semver@7.6.2 +- name: Verify checks for semver@7.7.2 kind: verify options: - policy: policy_7_6_2.dl + policy: policy_7_7_2.dl - name: Run macaron analyze@semver@7.6.0 kind: analyze options: @@ -26,10 +26,10 @@ steps: - -purl - pkg:npm/semver@7.6.0 - --verify-provenance -- name: Verify checks for all 7.6.x semver runs +- name: Verify checks for all 7.x semver runs kind: verify options: - policy: policy_7_6_x.dl + policy: policy_7_x.dl - name: Run macaron analyze semver@1.0.0 kind: analyze options: From 06ec7773ab739675e077d450ee5bb57ffebbd253 Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Thu, 26 Jun 2025 05:10:40 +1000 Subject: [PATCH 2/8] chore: add contents table to tutorial Signed-off-by: Ben Selwyn-Smith --- docs/source/pages/tutorials/provenance.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/source/pages/tutorials/provenance.rst b/docs/source/pages/tutorials/provenance.rst index 8f6918010..f43b946a9 100644 --- a/docs/source/pages/tutorials/provenance.rst +++ b/docs/source/pages/tutorials/provenance.rst @@ -9,6 +9,8 @@ This tutorial demonstrates how Macaron can automatically retrieve provenance for Currently, Macaron supports discovery of attestation for: npm artifacts using features provided by `npm `_; PyPI artifacts using features provided by `Open Source Insights `_; and artifacts that have been published attestations to `GitHub `_. This tutorial uses two example packages to demonstrate these three discovery methods: The `semver `_ npm package, and the `toga `_ PyPI package. +.. contents:: :local: + ****************************** Installation and Prerequisites ****************************** From 63db410d56186713d1a276e20f06fbe9bafdc4cb Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Thu, 3 Jul 2025 17:10:32 +1000 Subject: [PATCH 3/8] chore: add toga tutorial integration test; label urllib3 integration test as tutorial; update tutorial wording; include tutorial sections for CI and local provenance; add input attestation predicate and build types Signed-off-by: Ben Selwyn-Smith --- .../_static/images/tutorial_toga_github.png | Bin 42220 -> 62082 bytes .../_static/images/tutorial_toga_local.png | Bin 0 -> 60903 bytes .../images/tutorial_urllib3_github.png | Bin 0 -> 65773 bytes docs/source/pages/tutorials/provenance.rst | 103 +++++++++++++++++- .../provenance/provenance_extractor.py | 2 +- src/macaron/slsa_analyzer/analyzer.py | 2 + .../slsa_analyzer/provenance/loader.py | 3 + .../tutorial_toga_local_provenance/policy.dl | 12 ++ .../tutorial_toga_local_provenance/test.yaml | 30 +++++ .../cases/tutorial_toga_provenance/policy.dl | 13 +++ .../cases/tutorial_toga_provenance/test.yaml | 27 +++++ .../cases/urllib3_expectation_file/test.yaml | 1 + 12 files changed, 189 insertions(+), 4 deletions(-) create mode 100644 docs/source/_static/images/tutorial_toga_local.png create mode 100644 docs/source/_static/images/tutorial_urllib3_github.png create mode 100644 tests/integration/cases/tutorial_toga_local_provenance/policy.dl create mode 100644 tests/integration/cases/tutorial_toga_local_provenance/test.yaml create mode 100644 tests/integration/cases/tutorial_toga_provenance/policy.dl create mode 100644 tests/integration/cases/tutorial_toga_provenance/test.yaml diff --git a/docs/source/_static/images/tutorial_toga_github.png b/docs/source/_static/images/tutorial_toga_github.png index 92129a93d979ea160667121004a6748e448b5242..d2c567837be703c9e2cf011afdfe01e2a6154a1f 100644 GIT binary patch literal 62082 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

GEeZ;dblWyK8Gg1wM4FCw|C06LX-)G^cWrTH4(! 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%0ADbaxMg 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 z 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 literal 0 HcmV?d00001 diff --git a/docs/source/_static/images/tutorial_urllib3_github.png b/docs/source/_static/images/tutorial_urllib3_github.png new file mode 100644 index 0000000000000000000000000000000000000000..01065b776ebd2f247d1824db478f4685053d4431 GIT binary patch literal 65773 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 S)rKFH%r=;>AFaD$-~R#LgEO`O literal 0 HcmV?d00001 diff --git a/docs/source/pages/tutorials/provenance.rst b/docs/source/pages/tutorials/provenance.rst index f43b946a9..bef12d983 100644 --- a/docs/source/pages/tutorials/provenance.rst +++ b/docs/source/pages/tutorials/provenance.rst @@ -7,7 +7,14 @@ Provenance discovery, extraction, and verification This tutorial demonstrates how Macaron can automatically retrieve provenance for artifacts, validate the contents, and verify the authenticity. Any artifact that can be analyzed and checked for these properties can then be trusted to a greater degree than would be otherwise possible, as provenance files provide verifiable information, such as the commit and build service pipeline that has triggered the release. -Currently, Macaron supports discovery of attestation for: npm artifacts using features provided by `npm `_; PyPI artifacts using features provided by `Open Source Insights `_; and artifacts that have been published attestations to `GitHub `_. This tutorial uses two example packages to demonstrate these three discovery methods: The `semver `_ npm package, and the `toga `_ PyPI package. +Currently, Macaron supports discovery of attestation for: + + * npm artifacts using features provided by `npm `_ + * PyPI artifacts using features provided by `Open Source Insights `_ + * Artifacts that have published attestations to, or released as assets to `GitHub `_ + * Attestation provided by the user to Macaron via the CLI + +This tutorial uses example packages to demonstrate these discovery methods: The `semver `_ npm package, the `toga `_ PyPI package, and the `urllib3 `_ PyPI package. .. contents:: :local: @@ -120,7 +127,7 @@ During this analysis, Macaron will attempt to discover a GitHub attestation by c In this particular case, the SHA256 hash of the toga 0.4.8 artifact is 0814a72abb0a9a5f22c32cc9479c55041ec30cdf4b12d73a0017aee58f9a1f00. A GitHub attestation can be found for this artifact `here `_. -Attestation discovered through GitHub cannot be ascertained as verified at this time. However, we can still be sure that the repository URL and commit digest associated with the user provided PURL match what is found within the attestation. This is reported by Macaron in two checks: ``mcn_provenance_derived_repo_1`` and ``mcn_provenance_derived_commit_1``. +Attestation discovered through GitHub is signed with verified signatures. As long as the repository URL and commit digest associated with the user provided PURL match what is found within the attestation, Macaron can report it as verified. Therefore, we can examine the results of three checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. .. _fig_toga_github_checks: @@ -134,11 +141,101 @@ This image shows that both checks have passed, confirming that the repository UR open output/reports/pypi/toga/toga.html + +****************************************** +Attestation discovery for urllib3 (GitHub) +****************************************** + +To demonstrate GitHub attestation being found from released assets on the platform, we use the urllib3 library. + +.. code-block:: shell + + ./run_macaron.sh analyze -purl pkg:pypi/urllib3@2.0.0a1 --verify-provenance + +As part of this analysis, Macaron ends up downloading three different asset files: The `attestation asset `_, the artifact's Python wheel file, and the artifact's compressed archive. By examining the attestation, Macaron can verify the two other files. This analysis can then report that provenance exists, and is verified. + +If we look at the results of three of Macaron's checks we can validate this result: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. + +.. _fig_urllib3_github_checks: + +.. figure:: ../../_static/images/tutorial_urllib3_github.png + :alt: HTML report for ``urllib3 2.0.0a1``, summary + :align: center + +This image shows that all three checks have passed, confirming that the repository URL and commit digest from the provenance match those associated with the user provided PURL, and that the provenance is verified. To access the full report use the following: + +.. code-block:: shell + + open output/reports/pypi/urllib3/urllib3.html + +********************************** +Local attestation discovery (toga) +********************************** + +If an attestation file already exists in a local directory, it makes more sense to use it than download it again. For this example case we rely on the attestation URL found for ``toga@0.4.8`` earlier in the tutorial. To download this file in the current directory, use the following command: + +.. code-block:: shell + + curl https://api.github.com/repos/beeware/toga/attestations/sha256:0814a72abb0a9a5f22c32cc9479c55041ec30cdf4b12d73a0017aee58f9a1f00 -o toga_0.4.8_attestation.json + + +With the attestation downloaded, we can run the analysis and pass it in as an argument. Like so: + +.. code-block:: shell + + ./run_macaron.sh analyze -purl pkg:pypi/toga@0.4.8 -pf toga_0.4.8_attestation.json + +To then determine that the provenance was accepted and matched the analysis target, we can examine the results of Macaron's checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. + +.. note:: Because the provenance file was provided by the user, we expect the provenance verification check to fail. + +.. _fig_toga_local_checks: + +.. figure:: ../../_static/images/tutorial_toga_local.png + :alt: HTML report for ``toga 0.4.8`` local, summary + :align: center + +This image shows that the repository and commit validation checks have passed, confirming that the provenance matches the analysis target. The verification check fails as expected. To view the report directly, use this command: + +.. code-block:: shell + + open output/reports/pypi/toga/toga.html + +*************************** +Supported Attestation Types +*************************** + +When attestation is provided to Macaron as input, it must be of one of the support types in order to be accepted. Support is defined by the ``predicateType`` and ``buildType`` properties within an attestation. + +Predicate Types +~~~~~~~~~~~~~~~ + + * SLSA v0.1 + * SLSA v0.2 + * SLSA v1.0 + * Witness v0.1 + + +Build Types +~~~~~~~~~~~ + +.. csv-table:: + :header: "Name", "Build Type" + + "SLSA GitHub Generic v0.1", "https://github.com/slsa-framework/slsa-github-generator/generic@v1" + "SLSA GitHub Actions v1.0", "https://slsa-framework.github.io/github-actions-buildtypes/workflow/v1" + "SLSA npm CLI v2.0", "https://github.com/npm/cli/gha/v2" + "SLSA Google Cloud Build v1.0", "https://slsa-framework.github.io/gcb-buildtypes/triggered-build/v1" + "SLSA Oracle Cloud Infrastructure v1.0", "https://github.com/oracle/macaron/tree/main/src/macaron/resources/provenance-buildtypes/oci/v1" + "Witness GitLab v0.1", "https://witness.testifysec.com/attestation-collection/v0.1" + + + ************************************** Run ``verify-policy`` command (semver) ************************************** -Another feature of Macaron is policy verification. This allows Macaron to report on whether an artifact meets the security requirements specified by the user. Policies are written using `Soufflé Datalog `_ , a language similar to SQL. Results collected by the ``analyze`` command can be checked via declarative queries in the created policy, which Macaron can then automatically check. +Another feature of Macaron is policy verification, which allows it to assess whether an artifact meets user-defined security requirements. This feature can also be integrated into CI/CD pipelines to automatically check policy compliance by returning appropriate error codes based on pass or fail status. Policies are written using `Soufflé Datalog `_ , a language similar to SQL. Results collected by the ``analyze`` command can be checked via declarative queries in the created policy, which Macaron can then automatically check. For this tutorial, we can create a policy that checks whether the three checks relating to the semver npm example above have passed. E.g. ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. In this way we can be sure that the requirement is satisfied without having to dive into the reports directly. diff --git a/src/macaron/provenance/provenance_extractor.py b/src/macaron/provenance/provenance_extractor.py index b4b71d8b7..4366ab299 100644 --- a/src/macaron/provenance/provenance_extractor.py +++ b/src/macaron/provenance/provenance_extractor.py @@ -504,7 +504,7 @@ def get_build_invocation(self, statement: InTotoV01Statement | InTotoV1Statement class SLSANPMCLIBuildDefinitionV2(ProvenanceBuildDefinition): - """Class representing the SLSA NPM CLI Build Definition (v12). + """Class representing the SLSA NPM CLI Build Definition (v2). This class implements the abstract methods from the `ProvenanceBuildDefinition` to extract build invocation details specific to the GitHub Actions build type. diff --git a/src/macaron/slsa_analyzer/analyzer.py b/src/macaron/slsa_analyzer/analyzer.py index de3a80a1f..8fcebc381 100644 --- a/src/macaron/slsa_analyzer/analyzer.py +++ b/src/macaron/slsa_analyzer/analyzer.py @@ -518,6 +518,8 @@ def run_single( provenance_repo_url, provenance_commit_digest = extract_repo_and_commit_from_provenance( provenance_payload ) + # Attestations found from GitHub are signed and verified. + provenance_is_verified = True except ProvenanceError as error: logger.debug("Failed to extract from provenance: %s", error) diff --git a/src/macaron/slsa_analyzer/provenance/loader.py b/src/macaron/slsa_analyzer/provenance/loader.py index 106cc03b5..3e9d9b1b0 100644 --- a/src/macaron/slsa_analyzer/provenance/loader.py +++ b/src/macaron/slsa_analyzer/provenance/loader.py @@ -123,6 +123,9 @@ def decode_provenance(provenance: dict) -> dict[str, JsonType]: # GitHub Attestation. # TODO Check if old method (above) actually works. provenance_payload = json_extract(provenance, ["bundle", "dsseEnvelope", "payload"], str) + if not provenance_payload and "attestations" in provenance: + # Check for multiple attestation and return the first instance. + provenance_payload = json_extract(provenance, ["attestations", 0, "bundle", "dsseEnvelope", "payload"], str) if not provenance_payload: raise LoadIntotoAttestationError( 'Cannot find the "payload" field in the decoded provenance.', diff --git a/tests/integration/cases/tutorial_toga_local_provenance/policy.dl b/tests/integration/cases/tutorial_toga_local_provenance/policy.dl new file mode 100644 index 000000000..13aa5ab73 --- /dev/null +++ b/tests/integration/cases/tutorial_toga_local_provenance/policy.dl @@ -0,0 +1,12 @@ +/* Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. */ +/* Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. */ + +#include "prelude.dl" + +Policy("has-verified-provenance", component_id, "Require a verified provenance file.") :- + check_passed(component_id, "mcn_provenance_derived_repo_1"), + check_passed(component_id, "mcn_provenance_derived_commit_1"), + check_failed(component_id, "mcn_provenance_verified_1"). + +apply_policy_to("has-verified-provenance", component_id) :- + is_component(component_id, "pkg:pypi/toga@0.4.8"). diff --git a/tests/integration/cases/tutorial_toga_local_provenance/test.yaml b/tests/integration/cases/tutorial_toga_local_provenance/test.yaml new file mode 100644 index 000000000..092dacafa --- /dev/null +++ b/tests/integration/cases/tutorial_toga_local_provenance/test.yaml @@ -0,0 +1,30 @@ +# Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. +# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. + +description: | + Analysing the toga library at different versions to find PyPI and GitHub attestation. + +tags: +- tutorial + +steps: +- name: Download the GitHub attestation file + kind: shell + options: + cmd: curl https://api.github.com/repos/beeware/toga/attestations/sha256:0814a72abb0a9a5f22c32cc9479c55041ec30cdf4b12d73a0017aee58f9a1f00 -o toga_0.4.8_attestation.json +- name: Run macaron analyze toga with local attestation + kind: analyze + options: + command_args: + - -purl + - pkg:pypi/toga@0.4.8 + - -pf + - toga_0.4.8_attestation.json +- name: Cleanup local attestation + kind: shell + options: + cmd: rm toga_0.4.8_attestation.json +- name: Verify analysis results + kind: verify + options: + policy: policy.dl diff --git a/tests/integration/cases/tutorial_toga_provenance/policy.dl b/tests/integration/cases/tutorial_toga_provenance/policy.dl new file mode 100644 index 000000000..7e18aed36 --- /dev/null +++ b/tests/integration/cases/tutorial_toga_provenance/policy.dl @@ -0,0 +1,13 @@ +/* Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. */ +/* Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. */ + +#include "prelude.dl" + +Policy("has-verified-provenance", component_id, "Require a verified provenance file.") :- + check_passed(component_id, "mcn_provenance_derived_repo_1"), + check_passed(component_id, "mcn_provenance_derived_commit_1"), + check_passed(component_id, "mcn_provenance_verified_1"). + +apply_policy_to("has-verified-provenance", component_id) :- + is_component(component_id, purl), + match("pkg:pypi/toga@*", purl). diff --git a/tests/integration/cases/tutorial_toga_provenance/test.yaml b/tests/integration/cases/tutorial_toga_provenance/test.yaml new file mode 100644 index 000000000..2e54d5ce6 --- /dev/null +++ b/tests/integration/cases/tutorial_toga_provenance/test.yaml @@ -0,0 +1,27 @@ +# Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. +# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. + +description: | + Analysing the toga library at different versions to find PyPI and GitHub attestation. + +tags: +- tutorial + +steps: +- name: Run macaron analyze toga with PyPI attestation + kind: analyze + options: + command_args: + - -purl + - pkg:pypi/toga@0.5.1 +- name: Run macaron analyze toga with GitHub attestation + kind: analyze + options: + command_args: + - -purl + - pkg:pypi/toga@0.4.8 + - --verify-provenance +- name: Verify provenance exists for both analyses + kind: verify + options: + policy: policy.dl diff --git a/tests/integration/cases/urllib3_expectation_file/test.yaml b/tests/integration/cases/urllib3_expectation_file/test.yaml index 21441d0a5..eb267de5e 100644 --- a/tests/integration/cases/urllib3_expectation_file/test.yaml +++ b/tests/integration/cases/urllib3_expectation_file/test.yaml @@ -8,6 +8,7 @@ description: | tags: - macaron-python-package - macaron-docker-image +- tutorial steps: - name: Run macaron analyze with expectation file From f50a2960222977c06d19b10af7f4b1148b02a2ab Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Thu, 24 Jul 2025 14:02:24 +1000 Subject: [PATCH 4/8] chore: remove reference to latest version Signed-off-by: Ben Selwyn-Smith --- docs/source/pages/tutorials/provenance.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/pages/tutorials/provenance.rst b/docs/source/pages/tutorials/provenance.rst index bef12d983..cf39d9018 100644 --- a/docs/source/pages/tutorials/provenance.rst +++ b/docs/source/pages/tutorials/provenance.rst @@ -51,7 +51,7 @@ The analyses in this tutorial involve downloading the contents of a target repos Attestation Discovery for semver (npm) ************************************** -To perform an analysis on the latest version of semver (when this tutorial was written), Macaron can be run with the following command: +To analyze a specific version of the semver package, Macaron can be run with the following command: .. code-block:: shell @@ -81,7 +81,7 @@ The check results of this example (and others) can be automatically verified. A Attestation Discovery for toga (PyPI) ************************************* -To perform an analysis on the latest version of toga (when this tutorial was written), Macaron can be run with the following command: +To analyze a specific version of the toga package, Macaron can be run with the following command: .. code-block:: shell From 2b2a391ce122df5ee335020c6a0176ee42dc88e0 Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Tue, 29 Jul 2025 13:50:13 +1000 Subject: [PATCH 5/8] chore: restrict download sizes via streaming functionality; remove verify-provenance option Signed-off-by: Ben Selwyn-Smith --- docs/source/pages/tutorials/provenance.rst | 15 +- src/macaron/__main__.py | 8 - src/macaron/config/defaults.ini | 2 +- .../sourcecode/suspicious_setup.py | 28 +-- src/macaron/provenance/provenance_verifier.py | 2 +- src/macaron/slsa_analyzer/analyzer.py | 24 +-- .../slsa_analyzer/git_service/api_client.py | 33 ++-- .../maven_central_registry.py | 28 +-- .../package_registry/pypi_registry.py | 170 +++++++----------- src/macaron/util.py | 99 ++++++++++ 10 files changed, 206 insertions(+), 203 deletions(-) diff --git a/docs/source/pages/tutorials/provenance.rst b/docs/source/pages/tutorials/provenance.rst index cf39d9018..ed93045cf 100644 --- a/docs/source/pages/tutorials/provenance.rst +++ b/docs/source/pages/tutorials/provenance.rst @@ -16,6 +16,8 @@ Currently, Macaron supports discovery of attestation for: This tutorial uses example packages to demonstrate these discovery methods: The `semver `_ npm package, the `toga `_ PyPI package, and the `urllib3 `_ PyPI package. +.. note:: Macaron has a size limit imposed for downloads. For more information on this see Section :ref:`Download Limit`. + .. contents:: :local: ****************************** @@ -55,13 +57,13 @@ To analyze a specific version of the semver package, Macaron can be run with the .. code-block:: shell - ./run_macaron.sh analyze -purl pkg:npm/semver@7.7.2 --verify-provenance + ./run_macaron.sh analyze -purl pkg:npm/semver@7.7.2 During this analysis, Macaron will retrieve two provenance files from the npm registry. One is a :term:`SLSA` v1.0 provenance, while the other is a npm specific publication provenance. The SLSA provenance provides details of the artifact it relates to, the repository it was built from, and the build action used to build it. The npm specific publication provenance exists if the SLSA provenance has been verified before publication. .. note:: Most of the details from the two provenance files can be found through the links provided on the artifacts page on the npm website. In particular: `Sigstore Rekor `_. The provenance file itself can be found at: `npm registry `_. -Of course to reliably say the above does what is claimed here, proof is needed. For this we can rely on the check results produced from the analysis run. In particular, we want to know the results of three checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. The first two to ensure that the commit and the repository being analyzed match those found in the provenance file, and the last check to ensure that the provenance file has been verified. For the third check to succeed, you need to enable provenance verification in Macaron by using the ``--verify-provenance`` command-line argument, as demonstrated above. This verification is disabled by default because it can be slow in some cases due to I/O-bound operations. +Of course to reliably say the above does what is claimed here, proof is needed. For this we can rely on the check results produced from the analysis run. In particular, we want to know the results of three checks: ``mcn_provenance_derived_repo_1``, ``mcn_provenance_derived_commit_1``, and ``mcn_provenance_verified_1``. The first two to ensure that the commit and the repository being analyzed match those found in the provenance file, and the last check to ensure that the provenance file has been verified. .. _fig_semver_7.7.2_report: @@ -150,7 +152,7 @@ To demonstrate GitHub attestation being found from released assets on the platfo .. code-block:: shell - ./run_macaron.sh analyze -purl pkg:pypi/urllib3@2.0.0a1 --verify-provenance + ./run_macaron.sh analyze -purl pkg:pypi/urllib3@2.0.0a1 As part of this analysis, Macaron ends up downloading three different asset files: The `attestation asset `_, the artifact's Python wheel file, and the artifact's compressed archive. By examining the attestation, Macaron can verify the two other files. This analysis can then report that provenance exists, and is verified. @@ -215,7 +217,6 @@ Predicate Types * SLSA v1.0 * Witness v0.1 - Build Types ~~~~~~~~~~~ @@ -229,7 +230,13 @@ Build Types "SLSA Oracle Cloud Infrastructure v1.0", "https://github.com/oracle/macaron/tree/main/src/macaron/resources/provenance-buildtypes/oci/v1" "Witness GitLab v0.1", "https://witness.testifysec.com/attestation-collection/v0.1" +.. _Download Limit: + +******************* +File Download Limit +******************* +To prevent analyses from taking too long, Macaron imposes a configurable size limit for downloads. This includes files being downloaded for provenance verification. In cases where the limit is being reached and you wish to continue analysis regardless, you can specify a new download size in the default configuration file. This value can be found under the ``slsa.verifier`` section, listed as ``max_download_size`` with a default limit of 10 megabytes. See :ref:`How to change the default configuration ` for more details on configuring values like these. ************************************** Run ``verify-policy`` command (semver) diff --git a/src/macaron/__main__.py b/src/macaron/__main__.py index 9b746806e..afaabdbe5 100644 --- a/src/macaron/__main__.py +++ b/src/macaron/__main__.py @@ -172,7 +172,6 @@ def analyze_slsa_levels_single(analyzer_single_args: argparse.Namespace) -> None analyzer_single_args.sbom_path, deps_depth, provenance_payload=prov_payload, - verify_provenance=analyzer_single_args.verify_provenance, force_analyze_source=analyzer_single_args.force_analyze_source, ) sys.exit(status_code) @@ -483,13 +482,6 @@ def main(argv: list[str] | None = None) -> None: help=("Forces PyPI sourcecode analysis to run regardless of other heuristic results."), ) - single_analyze_parser.add_argument( - "--verify-provenance", - required=False, - action="store_true", - help=("Allow the analysis to attempt to verify provenance files as part of its normal operations."), - ) - # Dump the default values. sub_parser.add_parser(name="dump-defaults", description="Dumps the defaults.ini file to the output directory.") diff --git a/src/macaron/config/defaults.ini b/src/macaron/config/defaults.ini index 0c31aaca7..caaf1b120 100644 --- a/src/macaron/config/defaults.ini +++ b/src/macaron/config/defaults.ini @@ -482,7 +482,7 @@ provenance_extensions = intoto.jsonl.url intoto.jsonl.gz.url # This is the acceptable maximum size (in bytes) to download an asset. -max_download_size = 70000000 +max_download_size = 10000000 # This is the timeout (in seconds) to run the SLSA verifier. timeout = 120 # The allowed hostnames for URL file links for provenance download diff --git a/src/macaron/malware_analyzer/pypi_heuristics/sourcecode/suspicious_setup.py b/src/macaron/malware_analyzer/pypi_heuristics/sourcecode/suspicious_setup.py index ebde2a21f..537879c21 100644 --- a/src/macaron/malware_analyzer/pypi_heuristics/sourcecode/suspicious_setup.py +++ b/src/macaron/malware_analyzer/pypi_heuristics/sourcecode/suspicious_setup.py @@ -11,13 +11,12 @@ import tempfile import zipfile -import requests -from requests import RequestException - +from macaron.config.defaults import defaults from macaron.json_tools import JsonType from macaron.malware_analyzer.pypi_heuristics.base_analyzer import BaseHeuristicAnalyzer from macaron.malware_analyzer.pypi_heuristics.heuristics import HeuristicResult, Heuristics from macaron.slsa_analyzer.package_registry.pypi_registry import PyPIPackageJsonAsset +from macaron.util import download_file_with_size_limit logger: logging.Logger = logging.getLogger(__name__) @@ -55,26 +54,11 @@ def _get_setup_source_code(self, pypi_package_json: PyPIPackageJsonAsset) -> str # Create a temporary directory to store the downloaded source. with tempfile.TemporaryDirectory() as temp_dir: - try: - response = requests.get(sourcecode_url, stream=True, timeout=40) - response.raise_for_status() - except requests.exceptions.HTTPError as http_err: - logger.debug("HTTP error occurred when trying to download source: %s", http_err) - return None - - if response.status_code != 200: - return None - source_file = os.path.join(temp_dir, file_name) - with open(source_file, "wb") as file: - try: - for chunk in response.iter_content(): - file.write(chunk) - except RequestException as error: - # Something went wrong with the request, abort. - logger.debug("Error while streaming source file: %s", error) - response.close() - return None + timeout = defaults.getint("downloads", "timeout", fallback=120) + size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) + if not download_file_with_size_limit(sourcecode_url, {}, source_file, timeout, size_limit): + return None target_file = "setup.py" file_dir = file_name.removesuffix(".tar.gz").removesuffix(".zip") diff --git a/src/macaron/provenance/provenance_verifier.py b/src/macaron/provenance/provenance_verifier.py index f366fe127..48aa2c091 100644 --- a/src/macaron/provenance/provenance_verifier.py +++ b/src/macaron/provenance/provenance_verifier.py @@ -249,7 +249,7 @@ def _find_subject_asset( for item in all_assets: item_path = os.path.join(download_path, item["name"]) # Make sure to download an archive just once. - if not Path(item_path).is_file(): + if not Path(item_path).exists(): # TODO: check that it's not too large. if not ci_service.api_client.download_asset(item["url"], item_path): logger.info("Could not download artifact %s. Skip verifying...", os.path.basename(item_path)) diff --git a/src/macaron/slsa_analyzer/analyzer.py b/src/macaron/slsa_analyzer/analyzer.py index 8fcebc381..d3a22fd51 100644 --- a/src/macaron/slsa_analyzer/analyzer.py +++ b/src/macaron/slsa_analyzer/analyzer.py @@ -147,7 +147,6 @@ def run( sbom_path: str = "", deps_depth: int = 0, provenance_payload: InTotoPayload | None = None, - verify_provenance: bool = False, force_analyze_source: bool = False, ) -> int: """Run the analysis and write results to the output path. @@ -165,8 +164,6 @@ def run( The depth of dependency resolution. Default: 0. provenance_payload : InToToPayload | None The provenance intoto payload for the main software component. - verify_provenance: bool - Enable provenance verification if True. force_analyze_source : bool When true, enforces running source code analysis regardless of other heuristic results. Defaults to False. @@ -201,7 +198,6 @@ def run( main_config, analysis, provenance_payload=provenance_payload, - verify_provenance=verify_provenance, force_analyze_source=force_analyze_source, ) @@ -320,7 +316,6 @@ def run_single( analysis: Analysis, existing_records: dict[str, Record] | None = None, provenance_payload: InTotoPayload | None = None, - verify_provenance: bool = False, force_analyze_source: bool = False, ) -> Record: """Run the checks for a single repository target. @@ -338,8 +333,6 @@ def run_single( The mapping of existing records that the analysis has run successfully. provenance_payload : InToToPayload | None The provenance intoto payload for the analyzed software component. - verify_provenance: bool - Enable provenance verification if True. force_analyze_source : bool When true, enforces running source code analysis regardless of other heuristic results. Defaults to False. @@ -378,7 +371,7 @@ def run_single( provenance_payload = provenance_asset.payload if provenance_payload.verified: provenance_is_verified = True - if verify_provenance: + else: provenance_is_verified = provenance_verifier.verify_provenance(parsed_purl, provenances) # Try to extract the repository URL and commit digest from the Provenance, if it exists. @@ -555,14 +548,13 @@ def run_single( ) # Also try to verify CI provenance contents. - if verify_provenance: - verified = [] - for ci_info in analyze_ctx.dynamic_data["ci_services"]: - verified.append(verify_ci_provenance(analyze_ctx, ci_info, temp_dir)) - if not verified: - break - if verified and all(verified): - provenance_l3_verified = True + verified = [] + for ci_info in analyze_ctx.dynamic_data["ci_services"]: + verified.append(verify_ci_provenance(analyze_ctx, ci_info, temp_dir)) + if not verified: + break + if verified and all(verified): + provenance_l3_verified = True if provenance_payload: analyze_ctx.dynamic_data["is_inferred_prov"] = False diff --git a/src/macaron/slsa_analyzer/git_service/api_client.py b/src/macaron/slsa_analyzer/git_service/api_client.py index 681a1f4e0..49c3eaa0c 100644 --- a/src/macaron/slsa_analyzer/git_service/api_client.py +++ b/src/macaron/slsa_analyzer/git_service/api_client.py @@ -12,7 +12,12 @@ from macaron.config.defaults import defaults from macaron.slsa_analyzer.asset import AssetLocator -from macaron.util import construct_query, download_github_build_log, send_get_http, send_get_http_raw +from macaron.util import ( + construct_query, + download_file_with_size_limit, + download_github_build_log, + send_get_http, +) logger: logging.Logger = logging.getLogger(__name__) @@ -637,27 +642,11 @@ def download_asset(self, url: str, download_path: str) -> bool: """ logger.debug("Download assets from %s at %s.", url, download_path) - # Allow downloading binaries. - response = send_get_http_raw( - url, - { - "Accept": "application/octet-stream", - "Authorization": self.headers["Authorization"], - }, - timeout=defaults.getint("downloads", "timeout", fallback=120), - ) - if not response: - logger.error("Could not download the asset.") - return False - - try: - with open(download_path, "wb") as asset_file: - asset_file.write(response.content) - except OSError as error: - logger.error(error) - return False - - return True + timeout = defaults.getint("downloads", "timeout", fallback=120) + size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) + headers = {"Authorization": self.headers["Authorization"]} + + return download_file_with_size_limit(url, headers, download_path, timeout, size_limit) def get_attestation(self, full_name: str, artifact_hash: str) -> dict: """Download and return the attestation associated with the passed artifact hash, if any. diff --git a/src/macaron/slsa_analyzer/package_registry/maven_central_registry.py b/src/macaron/slsa_analyzer/package_registry/maven_central_registry.py index 2fe3c5cea..5efe4ef18 100644 --- a/src/macaron/slsa_analyzer/package_registry/maven_central_registry.py +++ b/src/macaron/slsa_analyzer/package_registry/maven_central_registry.py @@ -9,13 +9,12 @@ import requests from packageurl import PackageURL -from requests import RequestException from macaron.artifact.maven import construct_maven_repository_path, construct_primary_jar_file_name from macaron.config.defaults import defaults from macaron.errors import ConfigurationError, InvalidHTTPResponseError from macaron.slsa_analyzer.package_registry.package_registry import PackageRegistry -from macaron.util import send_get_http_raw +from macaron.util import send_get_http_raw, stream_file_with_size_limit logger: logging.Logger = logging.getLogger(__name__) @@ -285,35 +284,20 @@ def get_artifact_hash(self, purl: PackageURL) -> str | None: # As Maven hashes are user provided and not verified they serve as a reference only. logger.debug("Found hash of artifact: %s", retrieved_artifact_hash) - try: - response = requests.get(artifact_url, stream=True, timeout=40) - response.raise_for_status() - except requests.exceptions.HTTPError as http_err: - logger.debug("HTTP error occurred when trying to download artifact: %s", http_err) - return None - - if response.status_code != 200: - return None - - # Download file and compute hash as chunks are received. hash_algorithm = hashlib.sha256() - try: - for chunk in response.iter_content(): - hash_algorithm.update(chunk) - except RequestException as error: - # Something went wrong with the request, abort. - logger.debug("Error while streaming target file: %s", error) - response.close() + timeout = defaults.getint("downloads", "timeout", fallback=120) + size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) + if not stream_file_with_size_limit(artifact_url, {}, hash_algorithm.update, timeout, size_limit): return None computed_artifact_hash: str = hash_algorithm.hexdigest() + logger.debug("Computed hash of artifact: %s", computed_artifact_hash) if retrieved_artifact_hash and computed_artifact_hash != retrieved_artifact_hash: logger.debug( - "Artifact hash and discovered hash do not match: %s != %s", + "Computed artifact hash and discovered hash do not match: %s != %s", computed_artifact_hash, retrieved_artifact_hash, ) return None - logger.debug("Computed hash of artifact: %s", computed_artifact_hash) return computed_artifact_hash diff --git a/src/macaron/slsa_analyzer/package_registry/pypi_registry.py b/src/macaron/slsa_analyzer/package_registry/pypi_registry.py index f0cfcfbc3..44480704e 100644 --- a/src/macaron/slsa_analyzer/package_registry/pypi_registry.py +++ b/src/macaron/slsa_analyzer/package_registry/pypi_registry.py @@ -20,14 +20,13 @@ import requests from bs4 import BeautifulSoup, Tag -from requests import RequestException from macaron.config.defaults import defaults from macaron.errors import ConfigurationError, InvalidHTTPResponseError, SourceCodeError from macaron.json_tools import json_extract from macaron.malware_analyzer.datetime_parser import parse_datetime from macaron.slsa_analyzer.package_registry.package_registry import PackageRegistry -from macaron.util import send_get_http_raw +from macaron.util import download_file_with_size_limit, send_get_http_raw, stream_file_with_size_limit if TYPE_CHECKING: from macaron.slsa_analyzer.specs.package_registry_spec import PackageRegistryInfo @@ -172,6 +171,44 @@ def download_package_json(self, url: str) -> dict: return res_obj + @staticmethod + def cleanup_sourcecode_directory( + directory: str, error_message: str | None = None, error: Exception | None = None + ) -> None: + """Remove the target directory, and report the passed error if present. + + Parameters + ---------- + directory: str + The directory to remove. + error_message: str | None + The error message to report. + error: Exception | None + The error to inherit from. + + Raises + ------ + InvalidHTTPResponseError + If there was an error during the operation. + """ + if error_message: + logger.debug(error_message) + try: + shutil.rmtree(directory, onerror=_handle_temp_dir_clean) + except SourceCodeError as tempdir_exception: + tempdir_exception_msg = ( + f"Unable to cleanup temporary directory {directory} for source code: {tempdir_exception}" + ) + logger.debug(tempdir_exception_msg) + raise InvalidHTTPResponseError(error_message) from tempdir_exception + + if not error_message: + return + + if error: + raise InvalidHTTPResponseError(error_message) from error + raise InvalidHTTPResponseError(error_message) + def download_package_sourcecode(self, url: str) -> str: """Download the package source code from pypi registry. @@ -194,77 +231,29 @@ def download_package_sourcecode(self, url: str) -> str: _, _, file_name = url.rpartition("/") package_name = re.sub(r"\.tar\.gz$", "", file_name) - # temporary directory to unzip and read all source files + # Temporary directory to unzip and read all source files. temp_dir = tempfile.mkdtemp(prefix=f"{package_name}_") - response = send_get_http_raw(url, stream=True) - if response is None: - error_msg = f"Unable to find package source code using URL: {url}" - logger.debug(error_msg) - try: - shutil.rmtree(temp_dir, onerror=_handle_temp_dir_clean) - except SourceCodeError as tempdir_exception: - tempdir_exception_msg = ( - f"Unable to cleanup temporary directory {temp_dir} for source code: {tempdir_exception}" - ) - logger.debug(tempdir_exception_msg) - raise InvalidHTTPResponseError(error_msg) from tempdir_exception + source_file = os.path.join(temp_dir, file_name) + timeout = defaults.getint("downloads", "timeout", fallback=120) + size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) + if not download_file_with_size_limit(url, {}, source_file, timeout, size_limit): + self.cleanup_sourcecode_directory(temp_dir, "Could not download the file.") - raise InvalidHTTPResponseError(error_msg) + if not tarfile.is_tarfile(source_file): + self.cleanup_sourcecode_directory(temp_dir, f"Unable to extract source code from file {file_name}") - with tempfile.NamedTemporaryFile("+wb", delete=True) as source_file: - try: - for chunk in response.iter_content(): - source_file.write(chunk) - source_file.flush() - except RequestException as stream_error: - error_msg = f"Error while streaming source file: {stream_error}" - logger.debug(error_msg) - try: - shutil.rmtree(temp_dir, onerror=_handle_temp_dir_clean) - except SourceCodeError as tempdir_exception: - tempdir_exception_msg = ( - f"Unable to cleanup temporary directory {temp_dir} for source code: {tempdir_exception}" - ) - logger.debug(tempdir_exception_msg) - - raise InvalidHTTPResponseError(error_msg) from RequestException + try: + with tarfile.open(source_file, "r:gz") as sourcecode_tar: + sourcecode_tar.extractall(temp_dir, filter="data") + except tarfile.ReadError as read_error: + self.cleanup_sourcecode_directory(temp_dir, f"Error reading source code tar file: {read_error}", read_error) - if tarfile.is_tarfile(source_file.name): - try: - with tarfile.open(source_file.name, "r:gz") as sourcecode_tar: - sourcecode_tar.extractall(temp_dir, filter="data") - - except tarfile.ReadError as read_error: - error_msg = f"Error reading source code tar file: {read_error}" - logger.debug(error_msg) - try: - shutil.rmtree(temp_dir, onerror=_handle_temp_dir_clean) - except SourceCodeError as tempdir_exception: - tempdir_exception_msg = ( - f"Unable to cleanup temporary directory {temp_dir} for source code: {tempdir_exception}" - ) - logger.debug(tempdir_exception_msg) - - raise InvalidHTTPResponseError(error_msg) from read_error - - extracted_dir = os.listdir(temp_dir) - if len(extracted_dir) == 1 and package_name == extracted_dir[0]: - # structure used package name and version as top-level directory - temp_dir = os.path.join(temp_dir, extracted_dir[0]) - - else: - error_msg = f"Unable to extract source code from file {file_name}" - logger.debug(error_msg) - try: - shutil.rmtree(temp_dir, onerror=_handle_temp_dir_clean) - except SourceCodeError as tempdir_exception: - tempdir_exception_msg = ( - f"Unable to cleanup temporary directory {temp_dir} for source code: {tempdir_exception}" - ) - logger.debug(tempdir_exception_msg) - raise InvalidHTTPResponseError(error_msg) from tempdir_exception + os.remove(source_file) - raise InvalidHTTPResponseError(error_msg) + extracted_dir = os.listdir(temp_dir) + if len(extracted_dir) == 1 and extracted_dir[0] == package_name: + # Structure used package name and version as top-level directory. + temp_dir = os.path.join(temp_dir, extracted_dir[0]) logger.debug("Temporary download and unzip of %s stored in %s", file_name, temp_dir) return temp_dir @@ -282,25 +271,10 @@ def get_artifact_hash(self, artifact_url: str) -> str | None: str | None The hash of the artifact, or None if not found. """ - try: - response = requests.get(artifact_url, stream=True, timeout=40) - response.raise_for_status() - except requests.exceptions.HTTPError as http_err: - logger.debug("HTTP error occurred when trying to download artifact: %s", http_err) - return None - - if response.status_code != 200: - logger.debug("Invalid response: %s", response.status_code) - return None - hash_algorithm = hashlib.sha256() - try: - for chunk in response.iter_content(): - hash_algorithm.update(chunk) - except RequestException as error: - # Something went wrong with the request, abort. - logger.debug("Error while streaming source file: %s", error) - response.close() + timeout = defaults.getint("downloads", "timeout", fallback=120) + size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) + if not stream_file_with_size_limit(artifact_url, {}, hash_algorithm.update, timeout, size_limit): return None artifact_hash: str = hash_algorithm.hexdigest() @@ -609,7 +583,8 @@ def sourcecode(self) -> Generator[None]: if not self.download_sourcecode(): raise SourceCodeError("Unable to download package source code.") yield - self.cleanup_sourcecode() + if self.package_sourcecode_path: + PyPIRegistry.cleanup_sourcecode_directory(self.package_sourcecode_path) def download_sourcecode(self) -> bool: """Get the source code of the package and store it in a temporary directory. @@ -628,25 +603,6 @@ def download_sourcecode(self) -> bool: logger.debug(error) return False - def cleanup_sourcecode(self) -> None: - """ - Delete the temporary directory created when downloading the source code. - - The package source code is no longer accessible after this, and the package_sourcecode_path - attribute is set to an empty string. - """ - if self.package_sourcecode_path: - try: - shutil.rmtree(self.package_sourcecode_path, onerror=_handle_temp_dir_clean) - self.package_sourcecode_path = "" - except SourceCodeError as tempdir_exception: - tempdir_exception_msg = ( - f"Unable to cleanup temporary directory {self.package_sourcecode_path}" - f" for source code: {tempdir_exception}" - ) - logger.debug(tempdir_exception_msg) - raise tempdir_exception - def get_sourcecode_file_contents(self, path: str) -> bytes: """ Get the contents of a single source code file specified by the path. @@ -696,7 +652,7 @@ def iter_sourcecode(self) -> Iterator[tuple[str, bytes]]: Returns ------- tuple[str, bytes] - The source code file path, and the the raw contents of the source code file. + The source code file path, and the raw contents of the source code file. Raises ------ diff --git a/src/macaron/util.py b/src/macaron/util.py index 96af86991..95c03732a 100644 --- a/src/macaron/util.py +++ b/src/macaron/util.py @@ -8,7 +8,9 @@ import shutil import time import urllib.parse +from collections.abc import Callable from datetime import datetime +from typing import BinaryIO import requests from requests.models import Response @@ -272,6 +274,103 @@ def send_post_http_raw( return response +class StreamWriteDownloader: + """A class to handle writing a streamed download to a file.""" + + def __init__(self, file: BinaryIO) -> None: + """Initialise the class with the file path.""" + self.file = file + + def chunk_function(self, chunk: bytes) -> None: + """Write the chunk to the file.""" + self.file.write(chunk) + + +def download_file_with_size_limit( + url: str, headers: dict, file_path: str, timeout: int = 40, size_limit: int = 0 +) -> bool: + """Download a file with a size limit that will abort the operation if exceeded. + + Parameters + ---------- + url: str + The target of the request. + headers: dict + The headers to use in the request. + file_path: str + The path to download the file to. + timeout: int + The timeout in seconds for the request. + size_limit: int + The size limit in bytes of the downloaded file. + A download will terminate if it reaches beyond this amount. + + Returns + ------- + bool + True if the operation succeeded, False otherwise. + """ + try: + with open(file_path, "wb") as file: + downloader = StreamWriteDownloader(file) + return stream_file_with_size_limit(url, headers, downloader.chunk_function, timeout, size_limit) + except OSError as error: + logger.error(error) + return False + + +def stream_file_with_size_limit( + url: str, headers: dict, chunk_function: Callable[[bytes], None], timeout: int = 40, size_limit: int = 0 +) -> bool: + """Stream a file download and perform the passed function on the chunks of its data. + + If data in excess of the size limit is received, this operation will be aborted. + + Parameters + ---------- + url: str + The target of the request. + headers: dict + The headers to use in the request. + chunk_function: Callable[[bytes], None] + The function to use with each downloaded chunk. + timeout: int + The timeout in seconds for the request. + size_limit: int + The size limit in bytes of the downloaded file. + A download will terminate if it reaches beyond this amount. + + Returns + ------- + bool + True if the operation succeeded, False otherwise. + """ + try: + response = requests.get(url, headers=headers, stream=True, timeout=timeout) + response.raise_for_status() + except requests.exceptions.HTTPError as http_err: + logger.debug("HTTP error occurred when trying to stream source: %s", http_err) + return False + + if response.status_code != 200: + return False + + data_processed = 0 + for chunk in response.iter_content(chunk_size=1048576): + if data_processed >= size_limit > 0: + response.close() + logger.warning( + "The download of file '%s' has been unsuccessful due to the configured size limit." + "To be able to download this file, increase the size limit and try again." + ) + return False + + chunk_function(chunk) + data_processed += len(chunk) + + return True + + def check_rate_limit(response: Response) -> None: """Check the remaining calls limit to GitHub API and wait accordingly. From cf97722100b0bff94d90c050843d5239c68280d0 Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Tue, 29 Jul 2025 14:37:43 +1000 Subject: [PATCH 6/8] chore: update integration test cases Signed-off-by: Ben Selwyn-Smith --- .../cases/micronaut-projects_micronaut-test/test.yaml | 1 - tests/integration/cases/ossf_scorecard/test.yaml | 1 - tests/integration/cases/semver/test.yaml | 1 - tests/integration/cases/sigstore_mock/test.yaml | 1 - .../cases/tutorial_npm_verify_provenance_semver/test.yaml | 3 --- tests/integration/cases/tutorial_toga_provenance/test.yaml | 1 - tests/integration/cases/urllib3_expectation_dir/test.yaml | 1 - tests/integration/cases/urllib3_expectation_file/test.yaml | 1 - tests/integration/cases/urllib3_invalid_expectation/test.yaml | 1 - 9 files changed, 11 deletions(-) diff --git a/tests/integration/cases/micronaut-projects_micronaut-test/test.yaml b/tests/integration/cases/micronaut-projects_micronaut-test/test.yaml index 004958361..c7cda9fc2 100644 --- a/tests/integration/cases/micronaut-projects_micronaut-test/test.yaml +++ b/tests/integration/cases/micronaut-projects_micronaut-test/test.yaml @@ -15,7 +15,6 @@ steps: command_args: - -purl - pkg:maven/io.micronaut.test/micronaut-test-junit5@4.5.0 - - --verify-provenance - name: Validate JSON report schema kind: validate_schema options: diff --git a/tests/integration/cases/ossf_scorecard/test.yaml b/tests/integration/cases/ossf_scorecard/test.yaml index c3d64f980..653140505 100644 --- a/tests/integration/cases/ossf_scorecard/test.yaml +++ b/tests/integration/cases/ossf_scorecard/test.yaml @@ -17,7 +17,6 @@ steps: command_args: - --package-url - pkg:github/ossf/scorecard@v4.13.1 - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: diff --git a/tests/integration/cases/semver/test.yaml b/tests/integration/cases/semver/test.yaml index fa6a1b174..bd7fa464e 100644 --- a/tests/integration/cases/semver/test.yaml +++ b/tests/integration/cases/semver/test.yaml @@ -17,7 +17,6 @@ steps: command_args: - -purl - pkg:npm/semver@7.6.2 - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: diff --git a/tests/integration/cases/sigstore_mock/test.yaml b/tests/integration/cases/sigstore_mock/test.yaml index bd635febe..669224504 100644 --- a/tests/integration/cases/sigstore_mock/test.yaml +++ b/tests/integration/cases/sigstore_mock/test.yaml @@ -21,7 +21,6 @@ steps: - main - -d - ebdcfdfbdfeb9c9aeee6df53674ef230613629f5 - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: diff --git a/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml b/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml index 6b1477cea..a37e2b8bf 100644 --- a/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml +++ b/tests/integration/cases/tutorial_npm_verify_provenance_semver/test.yaml @@ -14,7 +14,6 @@ steps: command_args: - -purl - pkg:npm/semver@7.7.2 - - --verify-provenance - name: Verify checks for semver@7.7.2 kind: verify options: @@ -25,7 +24,6 @@ steps: command_args: - -purl - pkg:npm/semver@7.6.0 - - --verify-provenance - name: Verify checks for all 7.x semver runs kind: verify options: @@ -36,7 +34,6 @@ steps: command_args: - -purl - pkg:npm/semver@1.0.0 - - --verify-provenance - name: Verify checks for all semver runs kind: verify options: diff --git a/tests/integration/cases/tutorial_toga_provenance/test.yaml b/tests/integration/cases/tutorial_toga_provenance/test.yaml index 2e54d5ce6..fe4e0b42f 100644 --- a/tests/integration/cases/tutorial_toga_provenance/test.yaml +++ b/tests/integration/cases/tutorial_toga_provenance/test.yaml @@ -20,7 +20,6 @@ steps: command_args: - -purl - pkg:pypi/toga@0.4.8 - - --verify-provenance - name: Verify provenance exists for both analyses kind: verify options: diff --git a/tests/integration/cases/urllib3_expectation_dir/test.yaml b/tests/integration/cases/urllib3_expectation_dir/test.yaml index ec9e2739d..8646c8edd 100644 --- a/tests/integration/cases/urllib3_expectation_dir/test.yaml +++ b/tests/integration/cases/urllib3_expectation_dir/test.yaml @@ -18,7 +18,6 @@ steps: - pkg:pypi/urllib3@2.0.0a1 - --provenance-expectation - expectation - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: diff --git a/tests/integration/cases/urllib3_expectation_file/test.yaml b/tests/integration/cases/urllib3_expectation_file/test.yaml index eb267de5e..5b204387b 100644 --- a/tests/integration/cases/urllib3_expectation_file/test.yaml +++ b/tests/integration/cases/urllib3_expectation_file/test.yaml @@ -18,7 +18,6 @@ steps: command_args: - -purl - pkg:pypi/urllib3@2.0.0a1 - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: diff --git a/tests/integration/cases/urllib3_invalid_expectation/test.yaml b/tests/integration/cases/urllib3_invalid_expectation/test.yaml index f50aefebf..960e10ebe 100644 --- a/tests/integration/cases/urllib3_invalid_expectation/test.yaml +++ b/tests/integration/cases/urllib3_invalid_expectation/test.yaml @@ -17,7 +17,6 @@ steps: command_args: - -purl - pkg:pypi/urllib3@2.0.0a1 - - --verify-provenance - name: Run macaron verify-policy to verify passed/failed checks kind: verify options: From be8bce894fed6bb277f02165f1a193b7663b8fbb Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Tue, 29 Jul 2025 15:45:10 +1000 Subject: [PATCH 7/8] chore: minor fix Signed-off-by: Ben Selwyn-Smith --- src/macaron/provenance/provenance_verifier.py | 1 - src/macaron/slsa_analyzer/git_service/api_client.py | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/src/macaron/provenance/provenance_verifier.py b/src/macaron/provenance/provenance_verifier.py index 48aa2c091..b269997b1 100644 --- a/src/macaron/provenance/provenance_verifier.py +++ b/src/macaron/provenance/provenance_verifier.py @@ -250,7 +250,6 @@ def _find_subject_asset( item_path = os.path.join(download_path, item["name"]) # Make sure to download an archive just once. if not Path(item_path).exists(): - # TODO: check that it's not too large. if not ci_service.api_client.download_asset(item["url"], item_path): logger.info("Could not download artifact %s. Skip verifying...", os.path.basename(item_path)) break diff --git a/src/macaron/slsa_analyzer/git_service/api_client.py b/src/macaron/slsa_analyzer/git_service/api_client.py index 49c3eaa0c..05ca0858d 100644 --- a/src/macaron/slsa_analyzer/git_service/api_client.py +++ b/src/macaron/slsa_analyzer/git_service/api_client.py @@ -644,7 +644,7 @@ def download_asset(self, url: str, download_path: str) -> bool: timeout = defaults.getint("downloads", "timeout", fallback=120) size_limit = defaults.getint("slsa.verifier", "max_download_size", fallback=10000000) - headers = {"Authorization": self.headers["Authorization"]} + headers = {"Accept": "application/octet-stream", "Authorization": self.headers["Authorization"]} return download_file_with_size_limit(url, headers, download_path, timeout, size_limit) From 227a69d1d206a95c2a6dcdfb711d58635a1602cd Mon Sep 17 00:00:00 2001 From: Ben Selwyn-Smith Date: Tue, 29 Jul 2025 19:02:57 +1000 Subject: [PATCH 8/8] chore: increase download file size limit in tests Signed-off-by: Ben Selwyn-Smith --- src/macaron/util.py | 5 +++-- .../config.ini | 5 +++++ .../test.yaml | 3 +++ tests/integration/cases/ossf_scorecard/config.ini | 3 +++ 4 files changed, 14 insertions(+), 2 deletions(-) create mode 100644 tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/config.ini diff --git a/src/macaron/util.py b/src/macaron/util.py index 95c03732a..ba751c808 100644 --- a/src/macaron/util.py +++ b/src/macaron/util.py @@ -360,8 +360,9 @@ def stream_file_with_size_limit( if data_processed >= size_limit > 0: response.close() logger.warning( - "The download of file '%s' has been unsuccessful due to the configured size limit." - "To be able to download this file, increase the size limit and try again." + "The download of file '%s' has been unsuccessful due to the configured size limit. " + "To be able to download this file, increase the size limit and try again.", + url, ) return False diff --git a/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/config.ini b/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/config.ini new file mode 100644 index 000000000..5162fb14e --- /dev/null +++ b/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/config.ini @@ -0,0 +1,5 @@ +# Copyright (c) 2024 - 2025, Oracle and/or its affiliates. All rights reserved. +# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/. + +[slsa.verifier] +max_download_size = 15000000 diff --git a/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/test.yaml b/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/test.yaml index 52a821ff4..b871fd880 100644 --- a/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/test.yaml +++ b/tests/integration/cases/django_with_dep_resolution_virtual_env_as_input/test.yaml @@ -25,6 +25,7 @@ steps: - name: Run macaron analyze kind: analyze options: + ini: config.ini command_args: - -purl - pkg:pypi/django@5.0.6 @@ -48,6 +49,7 @@ steps: - name: Run macaron analyze on deps recursively kind: analyze options: + ini: config.ini command_args: - -purl - pkg:pypi/django@5.0.6 @@ -74,6 +76,7 @@ steps: - name: Run macaron analyze with forced sourcecode analysis kind: analyze options: + ini: config.ini command_args: - -purl - pkg:pypi/django@5.0.6 diff --git a/tests/integration/cases/ossf_scorecard/config.ini b/tests/integration/cases/ossf_scorecard/config.ini index ec1d945d4..7db45173b 100644 --- a/tests/integration/cases/ossf_scorecard/config.ini +++ b/tests/integration/cases/ossf_scorecard/config.ini @@ -7,3 +7,6 @@ include = mcn_provenance_expectation_1 mcn_provenance_verified_1 mcn_trusted_builder_level_three_1 + +[slsa.verifier] +max_download_size = 15000000