build: add explicit timezone in CycloneDX SBOM
authorRoman Azarenko <roman.azarenko@iopsys.eu>
Tue, 4 Jun 2024 16:00:03 +0000 (18:00 +0200)
committerRobert Marko <robimarko@gmail.com>
Fri, 7 Jun 2024 10:05:49 +0000 (12:05 +0200)
The sender domain has a DMARC Reject/Quarantine policy which disallows
sending mailing list messages using the original "From" header.

To mitigate this problem, the original message has been wrapped
automatically by the mailing list software.
Per the CycloneDX 1.4 spec, the `metadata.timestamp` field contains
the date/time when the BOM was created [1].

Before the change, the value generated by the package-metadata.pl
script would look like this:

2024-06-03T15:51:10

CycloneDX 1.4 relies on the JSON Schema specification version draft-07,
which defines the `date-time` format [2] as derived from RFC 3339,
section 5.6 [3]. In this format, the `time-offset` component is required,
however in the original version of package-metadata.pl it is omitted.

This is causing problems with OWASP Dependency-Track version 4.11.0 or
newer, where it now validates submitted SBOMs against the JSON schema
by default [4]. SBOMs with incorrect timestamp values are rejected with
the following error:

{
    "detail": "Schema validation failed",
    "errors": [
        "$.metadata.timestamp: 2024-06-03T15:51:10 is an invalid date-time"
    ],
    "status": 400,
    "title": "The uploaded BOM is invalid"
}

Add explicit `Z` (UTC) timezone offset in the `timestamp` field
to satisfy the CycloneDX schema.

[1]: https://github.com/CycloneDX/specification/blob/1.4/schema/bom-1.4.schema.json#L116-L121
[2]: https://json-schema.org/draft-07/draft-handrews-json-schema-validation-01#rfc.section.7.3.1
[3]: https://datatracker.ietf.org/doc/html/rfc3339#section-5.6
[4]: https://github.com/DependencyTrack/dependency-track/pull/3522

Signed-off-by: Roman Azarenko <roman.azarenko@iopsys.eu>
scripts/package-metadata.pl

index 1e47052ba0286313f7755d684f3c0d1d8f51da9a..82bd4360f3bb9f0bf214a3fb10b68910e537c6e6 100755 (executable)
@@ -655,7 +655,7 @@ sub dump_cyclonedxsbom_json {
                serialNumber => "urn:uuid:$uuid",
                version => 1,
                metadata => {
-                       timestamp => gmtime->datetime,
+                       timestamp => gmtime->datetime . 'Z',
                },
                "components" => [@components],
        };