golang-github-gocsaf-csaf 3.6.0+dfsg-2
Package Information
| Description | Go library for CSAF 2.0 security advisories (library) The Common Security Advisory Framework (CSAF) 2.0 is the OASIS standard for machine-readable security advisories and VEX documents. This package provides the Go packages of the csaf project, which implements a CSAF trusted provider, checker, aggregator and downloader: * csaf: data types for CSAF advisories, provider metadata, aggregator documents and ROLIE feeds, validation against the CSAF 2.0 JSON schemas, which Debian reads from disk instead of compiling in because OASIS does not license them freely, and an optional remote validation service client with a local result cache; * util: helpers used by the tools, among them JSONPath evaluation on decoded JSON documents, file name and URL checks, and hashing. Upstream states that library use is not officially supported and that the API may change. The command-line tools are in csaf-tools. |
|---|---|
| Maintainer | Debian Go Packaging Team <team+pkg-go@tracker.debian.org> |
| Changed By | Juan Manuel Méndez Rey <juan.mendezr@proton.me> |
| Sponsor | tsimonq2@debian.org |
| Distribution | unstable |
| Architecture | any all |
| VCS | git: https://salsa.debian.org/go-team/packages/golang-github-gocsaf-csaf.git (browse) |
| Popcon Installs | 1 |
| Tracker | https://tracker.debian.org/pkg/golang-github-gocsaf-csaf |
| Uploaded | 1 day ago |
New Package Report
.changes
| Changed-By | Juan Manuel Méndez Rey <juan.mendezr@proton.me> |
|---|---|
| Architecture | source amd64 all |
| Distribution | unstable |
| Date | Sat, 14 Nov 2026 04:21:40 +0100 |
| Source | golang-github-gocsaf-csaf |
| Version | 3.6.0+dfsg-2 |
Changelog
golang-github-gocsaf-csaf (3.6.0+dfsg-2) unstable; urgency=medium
.
* csaf_validator: report a failed schema check, not a pass, when the
schemas cannot be loaded..dsc
| Package-List | csaf-tools deb contrib/utils optional arch=any golang-github-gocsaf-csaf-v3-dev deb golang optional arch=all |
|---|---|
| Section | contrib/utils |
| Priority | optional |
| Component | main |
debian/copyright
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: csaf
Files-Excluded: csaf/schema/csaf_json_schema.json
csaf/schema/provider_json_schema.json
csaf/schema/aggregator_json_schema.json
csaf/schema/ROLIE_feed_json_schema.json
Comment: The four OASIS CSAF 2.0 JSON schemas carry no licence of their own.
The CSAF 2.0 OASIS Standard notice that covers them says the document "may not
be modified in any way", which is not DFSG free, and debian-legal agreed
(https://lists.debian.org/debian-legal/2026/09/msg00019.html). They are
removed from the tarball and read from /usr/share/csaf/schemas at run time
instead, so validation works as soon as a user installs them. See
debian/README.source.
Upstream-Contact: Sascha L. Teichmann <sascha.teichmann@intevation.de>
Source: https://github.com/gocsaf/csaf
Files: *
Copyright: 2021-2026 German Federal Office for Information Security (BSI) <https://www.bsi.bund.de>
License: Apache-2.0
Comment: Nearly every source file carries an SPDX header naming the BSI as
the copyright holder ("SPDX-FileCopyrightText") and, on a separate line,
"Software-Engineering: <year> Intevation GmbH <https://intevation.de>",
which credits the contractor that wrote the code for the BSI; it is not a
copyright statement. Files without a header (documentation, test data,
CI configuration, and the five code files csaf/advisory_test.go,
examples/product_lister/main.go, examples/purls_searcher/main.go,
docs/scripts/signing_tool.sh and
docs/scripts/prepareUbuntuInstanceForITests.sh) fall under the project
licence stated in README.md.
LICENSES/ holds the licence texts that the SPDX headers refer to, as
REUSE lays out, not copies of dependency licences; 3rdpartylicenses.md
only lists the licences of dependencies.
Files: cmd/csaf_aggregator/client_test.go
Copyright: 2022 German Federal Office for Information Security (BSI) <https://www.bsi.bund.de>
License: Expat
Files: csaf/cvss20enums.go
csaf/cvss3enums.go
csaf/schema/cvss-v2.0.json
csaf/schema/cvss-v2.0.json.license
csaf/schema/cvss-v3.0.json
csaf/schema/cvss-v3.0.json.license
Copyright: 2017 FIRST.ORG, INC.
License: BSD-3-clause
Comment: The CVSS v2.0 and v3.0 JSON schemas published by FIRST, which carry
their licence in a "license" member. The two Go files are generated from
them by csaf/generate_cvss_enums.go (see the go:generate lines in
csaf/doc.go) and keep FIRST's notice. The generator itself is Apache-2.0
(BSI); the BSD-3-Clause identifier and FIRST.ORG notice that licensecheck
finds in it are the header it writes into its output.
Files: csaf/schema/cvss-v3.1.json
csaf/schema/cvss-v3.1.json.license
Copyright: 2021 FIRST.ORG, INC.
License: BSD-3-clause
Comment: The CVSS v3.1 JSON schema published by FIRST, which carries its
licence in a "license" member.
Files: debian/*
Copyright: 2026 Juan Manuel Méndez Rey <juan.mendezr@proton.me>
License: Apache-2.0
Comment: Debian packaging is licensed under the same terms as upstream
License: Apache-2.0
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
.
http://www.apache.org/licenses/LICENSE-2.0
.
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
.
On Debian systems, the complete text of the Apache License, Version 2.0
can be found in "/usr/share/common-licenses/Apache-2.0".
License: BSD-3-clause
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
License: Expat
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
.
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
DFSG Assistant LLM REVIEW 0 blocker, 0 important, 1 minor
This is an LLM based review using a Debian Inference based workflow. It was not written by a member of the DFSG team and has not been checked by one. It is not a decision on the package: it may be wrong, and it may have missed things.
Reviewed 1 day ago.
Report
DFSG NEW review for golang-github-gocsaf-csaf version 3.6.0+dfsg-2
Summary
- Licensing is DFSG-compliant and
debian/copyrightis accurate: Yes - Packaging is of good quality: Yes
- Issues: 0 blocker, 0 important, 1 minor
- debian/watch: version 5
- debian/copyright: machine-readable
- Scan before the review: nothing found
Licensing
Every file in the tree is free. Most carry an SPDX header (Apache-2.0, copyright BSI); the one MIT file, the FIRST CVSS schemas and the two Go files generated from them (BSD-3-Clause) have their own stanzas with the full licence text, and Apache-2.0 refers to /usr/share/common-licenses. The four OASIS CSAF schemas, which carry no licence and are covered by a no-modification standard notice, are excluded from the tarball by Files-Excluded and replaced at run time by a patch that reads csaf-oasis-schemas from /usr/share/csaf/schemas; none of them is present or embedded. The Intevation GmbH lines the scan flagged are 'Software-Engineering:' credit lines, not copyright notices, and the FIRST text at csaf/generate_cvss_enums.go:149 is a format string the generator writes into its output, not a holder of that file.
Packaging
The packaging is careful and well documented: debhelper compat 14 with dh-go, a README.source that explains the repack, the contrib placement and the skipped tests, DEP-3 patches with forwarding status, six man pages, Vcs-*, upstream metadata and a current Standards-Version. The -dev package depends on exactly the Go libraries the installed packages import (the cmd-only ones are correctly left out because debian/rules removes cmd from the installed tree), and every Build-Depends named exists in the archive. The only fault found is that the csaf_checker documentation claims text and Markdown output, which the program rejects.
Issues
minor packaging 1. csaf_checker is documented as writing text and Markdown reports, but only JSON and HTML are accepted ◂
- Files:
debian/man/csaf_checker.1:13,debian/control:73,cmd/csaf_checker/config.go:33,cmd/csaf_checker/config.go:65-72 - Basis: checked, in the package or with a reference tool
- Evidence: Man page:
the result as text, JSON, HTML or Markdown.; control:meets, as text, JSON, HTML or Markdown;; code:Format outputFormatshort:"f" long:"format" choice:"json" choice:"html"`` andreturn fmt.Errorf(%q is neither "html" nor "json", s) - Problem: The shipped man page and the binary package description advertise two output formats the tool does not have:
csaf_checker -f markdown(or-f text) is rejected by go-flags and by UnmarshalText. The package's own docs/csaf_checker.md correctly says-f, --format=[json|html], so the user reads contradictory documentation. - Fix: Drop "text" and "Markdown" from debian/man/csaf_checker.1:13 and debian/control:73, leaving JSON and HTML.
Verified ◂
- debian/copyright is DEP-5 with the exact Format line; it has Files: * (BSI, Apache-2.0), a stanza for the MIT file cmd/csaf_aggregator/client_test.go, stanzas for the FIRST.ORG CVSS v2.0/v3.0/v3.1 schemas and the two generated Go enum files (BSD-3-Clause), and Files: debian/* (Juan Manuel Méndez Rey); the later stanzas correctly override Files: *, and the full Expat and BSD-3-clause texts are included, Apache-2.0 pointing at /usr/share/common-licenses.
- Prescan holder 'Intevation GmbH https://intevation.de' (Makefile:6, cmd/, csaf/, internal/, util/, docs/scripts/*, 105 files): every occurrence is a
Software-Engineering: <year> Intevation GmbH <https://intevation.de>line in the header besideSPDX-FileCopyrightText:; e.g. Makefile:6-7 and cmd/csaf_checker/main.go:6-7. That is a credit line, not a copyright statement, so it is not a missing holder. - Prescan entry
%s FIRST.ORG, INC.", m[1])at csaf/generate_cvss_enums.go:149: a fmt.Sprintf format string that the generator writes into csaf/cvss20enums.go and csaf/cvss3enums.go; the file itself is Apache-2.0/BSI and correctly falls under Files: *. The FIRST copyright in those generated files is matched by the FIRST stanzas. - Full-tree grep for copyright/©/All rights reserved/Licensed under found only BSI SPDX headers, the 2017/2021 FIRST.ORG notices in csaf/cvssenums.go and csaf/schema/cvss-v.json(+.license), and the standard BSD-3 text inside those JSON schemas; no other holder and no non-free wording (non-commercial, no-modification, field-of-use) outside the removed OASIS schemas mentioned in debian/copyright and README.source.
- Files-Excluded correctly names csaf/schema/{csaf,provider,aggregator,ROLIE_feed}_json_schema.json; none of them is in the tree, and no go:embed of them remains (patch 0001 replaces the embeds with reads of /usr/share/csaf/schemas or $CSAF_SCHEMA_DIR). Only the three BSD-3 FIRST CVSS schemas stay, with their .license stubs.
- LICENSES/{Apache-2.0,BSD-3-Clause,MIT}.txt are the SPDX/REUSE licence texts whose Copyright lines are the unfilled
<year> <owner>templates; they are not third-party works and need no holder. debian/lrc.config records exactly that. - No vendored third-party code: 3rdpartylicenses.md lists only module dependencies, all of which come from separate Debian -dev packages; go.mod/go.sum carry no copyright.
- testdata/ holds auto-generated ACME sample advisories (testdata/csaf-documents/valid/avendor-advisory-0004.json), provider metadata and OpenPGP fixtures; docs/test-keys/*.asc are throwaway test key-pairs whose Readme says so. Neither is a licence problem.
- Build-Depends all resolve in the archive: dh-go 1.71 (provides the golang addon, Conflicts: dh-golang, so debian/source/lintian-overrides is right), dpkg-build-api (= 1) provided by dpkg-dev 1.23.12, and the gval, jsonpath, bbolt, flock, jsonschema 6.0.2, gopenpgp and x-* packages. Only cmd/ imports gopenpgp, goquery, x/crypto, x/term and flock, and cmd/ is removed before dh_install, so their absence from the -dev Depends is correct; the library's imports (jsonschema, x/time, gval, jsonpath, bbolt, toml, go-flags, homedir) are all in Depends.
- debian/rules excludes examples/ from build and install with an anchored pattern, keeps the five go:embed data directories via DH_GOLANG_INSTALL_EXTRA (all present), removes cmd/ from the installed gocode tree after dh_auto_install, and skips only the three cmd tests that need the non-free schemas; at compat 14 dh itself skips that override under nocheck.
- Patches have DEP-3 headers with Author, Forwarded and Last-Update; 0002 is forwarded to upstream PR #828. Man pages for csaf_aggregator, csaf_downloader, csaf_provider, csaf_uploader and csaf_validator match the option tags and default config paths in cmd/*/config.go, and csaf_validator.1 matches the exit-code bits in cmd/csaf_validator/main.go.
- Standards-Version 4.7.4 is current against Policy 4.7.4.1; Vcs-Git/Vcs-Browser, Homepage, upstream/metadata and gbp.conf (dist = DEP14) are fine; the changelog is in unstable, the initial upload closes #1148988, and 3.6.0+dfsg matches the orig tarball name.
- Test coverage in the tree was read directory by directory (203 files): csaf/, util/, internal/, cmd/, docs/, examples/, testdata/, LICENSES/ and the top-level files; .pc/ and debian/cargo-checksum.json were skipped.
- uscan found upstream releases with
debian/watch; a newer upstream version is available (upstream5.0.0-pre.1+20261105, packaged3.6.0+dfsg), which is not a fault of the package. - Every pointer of
debian/copyrightto /usr/share/common-licenses names a file that is there (Apache-2.0).
Not confirmed ◂
- csaf-tools Depends on csaf-oasis-schemas for its schema validation, and debian/README.source says that package is in non-free; the archive lists behind the apt-cache tool do not include non-free (nor does it hold unrar), so I could not confirm that the dependency exists, which decides whether csaf-tools will be installable.
- I could not build the package or run its tests, so the contrib placement and the claim that the schema-reading patch behaves as upstream could only be judged from the source, the patches and README.source.
Proposed changes ◂
None.
Uploader's response to the LLM review
Thanks for accepting it.
It is a Debian man page error, nothing else is affected. I will fix it in the next revision. Please accept 3.6.0+dfsg-2.
— Juan Manuel Méndez Rey (mendezr), 1 day ago
Other Reviews of this Package
| Version | Hash | Allocated | Completed | Reviewer | Status | Details |
|---|---|---|---|---|---|---|
| 3.6.0+dfsg-1 | 0be5efc1… | 2026-10-28 04:36 | 2026-10-28 04:36 | awm | accepted | VIEW |