ntia-conformance-checker

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #golang #machine-learning #deep-learning #docker #macos #windows #cli #security #ios #openai

ntia-conformance-checker

(★ 91)

Validate SPDX 2 and 3 SBOM against NTIA, CISA, and other minimum element requirements.

File Explorer

Download Latest Version (.zip)

- - apidoc.yml
  - bandit.yml
  - black.yml
  - build.yml
  - codeql.yml
  - pylint.yml
  - python-publish.yml
  - scorecard.yml
  - typecheck.yml
- copilot-instructions.md
- dependabot.yml
- - .gitkeep
- - .gitkeep
- conf.py
- index.rst
- Makefile
- __init__.py
- base_checker.py
- bsi_checker.py
- cli_utils.py
- constants.py
- fsct_checker.py
- graph_utils.py
- main.py
- ntia_checker.py
- py.typed
- report.py
- sbom_checker.py
- spdx3_utils.py
- __init__.py
- test_bsi_checker.py
- test_checker.py
- test_cli_options.py
- test_component_count.py
- test_get_components_without_identifiers.py
- test_graph_connectivity.py
- test_main.py
- test_real_world.py
.gitignore
AGENTS.md
bandit.yml
CHANGELOG.md
CITATION.cff
CONTRIBUTING.md
FAQ.md
LICENSE
Makefile
pyproject.toml
README.md
release.md
SECURITY.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# NTIA Conformance Checker

[![Build Status](https://github.com/spdx/ntia-conformance-checker/workflows/build/badge.svg)](https://github.com/spdx/ntia-conformance-checker/actions)
![CodeQL](https://github.com/spdx/ntia-conformance-checker/actions/workflows/codeql.yml/badge.svg)
[![PyPI version](https://img.shields.io/pypi/v/ntia-conformance-checker.svg)](https://pypi.org/project/ntia-conformance-checker/)
[![Pylint Score](https://img.shields.io/badge/pylint-10/10-green)](https://github.com/spdx/ntia-conformance-checker)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/spdx/ntia-conformance-checker/badge)](https://scorecard.dev/viewer/?uri=github.com/spdx/ntia-conformance-checker)
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/10727/badge)](https://www.bestpractices.dev/projects/10727)
[![DOI](https://img.shields.io/badge/doi-10.5281%2Fzenodo.17068669-blue)](https://doi.org/10.5281/zenodo.17068669)

Validate the SPDX SBOM against NTIA, CISA, and other minimum element requirements.

This tool determines whether a [SPDX](https://spdx.dev/) software bill of
materials (SBOM) document contains informational items as required by a
certain specification.

It supports SPDX specification versions 2.2, 2.3, and 3.0.

> Note that while the SPDX 3.0 specification allows for multiple SBOMs
> within a single SPDX document, this tool currently limits support
> to one SBOM per document.

A web-based version of the tool is available (no installation needed) at:
<https://tools.spdx.org/app/ntia_checker/>

## Conformance

Currently, the supported specifications are:

- 2021 National Telecommunications and Information Administration (NTIA)
  ["minimum elements."][ntia]
- 2024 CISA Framing Software Component Transparency (FSCT3)
  ["minimum expected."][fsct3]
- BSI TR-03183-2 v2.1.0 Minimum Elements.
  ["SBOM requirements."][bsi]

The minimum elements include:

- Supplier Name
- Component Name
- Version of the Component
- Other Unique Identifiers
- Dependency Relationship
- Author of SBOM Data
- Timestamp

As defined by the NTIA, the minimum elements are
"the essential pieces that support basic SBOM functionality and will serve as
the foundation for an evolving approach to software transparency."

In addition to information similar to NTIA minimum elements,
FSCT3 requires these Baseline Attributes as part of its "minimum expected":

- License
- Copyright Holder (inside Copyright Notice)

BSI TR-03183-2 introduces stricter requirements for component files and relationships, including:
- SHA-512 Hashes for deployable components
- Structured component properties (e.g., container, firmware)
- Strict concluded licensing targets
- Explicit dependency completeness definitions

Mappings:

- The mapping of the NTIA elements required data fields to the SPDX 2.3
  specification can be found [here][ntia-spdx23].
- The mapping of FSCT3 Baseline Attributes to ISO/IEC 5962:2021 (SPDX 2.2.1)
  and SPDX 3.0 can be found at Section 2.5 of the FSCT3 document.
- More comparison of SBOM requirements and their mapping to SPDX can be found
  in [this slide][sbom-reqs] from Takashi Ninjouji of OpenChain Japan SBOM
  Sub-WG, presented at SPDX General Meeting 2024-12-05.

> [!NOTE]
> ### BSI TR-03183-2 Implementation Notes
> To ensure strict compatibility with the official SPDX 3.0.1 specification, this checker adapts two of the examples provided in the BSI TR-03183-2 v2.1.0 document:
> 
> * **Deployable URIs:** `binaryArtifact` is evaluated strictly as an `ExternalRefType` inside an `externalRef` array (rather than a direct property of `software_File`).
> * **Source Code URIs:** Artifacts must be defined using concrete subclasses (e.g., `software_File`, `software_Package`, `software_Snippet`) instead of the abstract `software_SoftwareArtifact` class.
> 
> For full technical details regarding these design decisions, please refer to [PR #428](https://github.com/spdx/ntia-conformance-checker/pull/428).

## Installation

This tool requires Python 3.10 or newer.
Its dependencies may require a more recent version of Python.

*Installation Method #1*:
Install from the [Python Package Index (PyPI)][pypi] with `pip`.

```bash
pip install ntia-conformance-checker
```

*Installation Method #2*: Install from local source.
Clone the repo and install dependencies using the following commands:

```bash
git clone https://github.com/spdx/ntia-conformance-checker.git
cd ntia-conformance-checker
pip install .
```

It is recommended to use a virtual environment, especially
if you work with multiple Python versions.
`virtualenv` is a tool for creating isolated Python environments;
it lets you keep a project's dependencies in a single environment
or create separate environments for testing with different Python versions.

## CLI usage

```text
usage: sbomcheck [OPTIONS] PATH

positional arguments:
  PATH                  Filepath for SBOM input

options:
  -h, --help            show this help message and exit
  -s, --sbom-spec {spdx2,spdx3}
                        SBOM specification of the input file; see below for details [default: spdx2]
  -c, --comply {bsi,fsct3-min,ntia}
                        Compliance standards to check against; see below for details [default: ntia]
  -k, --skip-validation
                        Skip validation
  -r, --output TYPE     Report output type; see below for details [default: print]
  -o, --output-file PATH
                        Filepath for report output; if omitted, prints to console
  -v, --verbose         Increase log verbosity to info
  -vv, --debug          Increase log verbosity to debug
  -q, --quiet           Quiet logs: show errors only
  -V, --version         Display version of sbomcheck

choices:
  SBOM specifications (for --sbom-spec):
    spdx2       Software Package Data Exchange (SPDX) 2.x
    spdx3       System Package Data Exchange (SPDX) 3.x

Compliance standards (for --comply):
    bsi         BSI TR-03183-2 v2.1.0 Minimum Elements
    fsct3-min   2024 CISA Framing Software Component Transparency (minimum expectation)
    ntia        2021 NTIA SBOM Minimum Elements

Report output types (for --output):
    html        Report in HTML format
    json        Report in JSON format
    none        No report
    print       Report in regular text format

Examples:
  sbomcheck sbom.spdx
  sbomcheck -s spdx3 -c fsct3-min -v sbom.json
  sbomcheck sbom.yaml --output json --output-file report.json
```

The user can then analyze a particular file:

```bash
sbomcheck sbom.json
```

To generate the output in machine-readable JSON, run:

```bash
sbomcheck sbom.spdx --output json
```

To analyze an SPDX 3 JSON file, run:

```bash
sbomcheck sbom.json --sbom-spec spdx3
```

Use `-h` for help:

```bash
sbomcheck -h
```

## Usage as a library

`ntia-conformance-checker` can also be imported as a library. For example:

```python
from ntia_conformance_checker import SbomChecker

sbom_checker = SbomChecker("SBOM_filepath")

print(sbom_checker.compliant)
```

See the API documentation at:
<https://spdx.github.io/ntia-conformance-checker/>

Additional properties and methods can be found in `BaseChecker` class
at [`base_checker.py`](ntia_conformance_checker/base_checker.py).
Specific properties and methods for a particular specification can be found
at the checker for that specification. For example, `NTIAChecker` class
at [`ntia_checker.py`](ntia_conformance_checker/ntia_checker.py).

## Online usage

With the SPDX Online Tool, you can check the SBOM conformance without the need
to install the Python package.

Go to this page: <https://tools.spdx.org/app/ntia_checker/>.

## HTML output

The HTML output is organized into four distinct div blocks,
each with a specific CSS class for easy styling and targeting:

- Errors (parsing, etc.): `<div class="conformance-err">`
- Conformance results: `<div class="conformance-res">`
- Components missing required information: `<div class="conformance-mis">`
- Detailed validation information: `<div class="conformance-val">`

## History

- The project is the result of an initial [Google Summer of Code (GSoC)][gsoc]
  [contribution in 2022][gsoc2022] by [@linynjosh][].
- SPDX 3 support and improved FSCT3 checker, available in [v4.0.0][],
  are [GSoC 2025 contribution][gsoc2025] by [@bact][].
- BSI TR-03183-2 conformance checker and structural graph validation architecture
  are [GSoC 2026 contribution][gsoc2026] by [@InduwaraGunasena][].
- The project is maintained by a community of SPDX adopters and enthusiasts.
- See SPDX's participation in Google Summer of Code (GSoC):
  <https://github.com/spdx/GSoC>.

[gsoc]: https://summerofcode.withgoogle.com/
[gsoc2022]: https://github.com/spdx/ntia-conformance-checker/wiki/Project-Origin
[@linynjosh]: https://github.com/linynjosh
[v4.0.0]: https://github.com/spdx/ntia-conformance-checker/blob/main/CHANGELOG.md#400---2025-09-05
[gsoc2025]: https://github.com/spdx/ntia-conformance-checker/wiki/Adding-SPDX-3.0-Support
[gsoc2026]: https://github.com/spdx/ntia-conformance-checker/wiki/BSI-TR%E2%80%9003183%E2%80%902-Conformance-and-Structural-Graph-Validation-for-SPDX-SBOMs
[@bact]: https://github.com/bact
[@InduwaraGunasena]: https://github.com/InduwaraGunasena

## License

[Apache-2.0](./LICENSE)

## Dependencies

- [spdx-tools](https://pypi.org/project/spdx-tools/)
  used for parsing the SPDX 2 SBOM.
- [spdx-python-model](https://pypi.org/project/spdx-python-model/)
  used for parsing the SPDX 3 SBOM.

## Support

- Submit issues, questions or feedback at
  <https://github.com/spdx/ntia-conformance-checker/issues>
- Join the discussion on <https://lists.spdx.org/g/spdx-tech> and
  <https://spdx.dev/participate/tech/>

## Contributing

Contributions are very welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md)
for instructions on how to contribute to the codebase.

## Further help

Check out the [frequently asked questions](./FAQ.md) document.

[ntia]: https://www.ntia.gov/report/2021/minimum-elements-software-bill-materials-sbom
[ntia-spdx23]: https://spdx.github.io/spdx-spec/v2.3/how-to-use/#k22-mapping-ntia-minimum-elements-to-spdx-fields
[fsct3]: https://www.cisa.gov/resources-tools/resources/framing-software-component-transparency-2024
[bsi]: https://www.bsi.bund.de/SharedDocs/Downloads/EN/BSI/Publications/TechGuidelines/TR03183/BSI-TR-03183-2_v2_1_0.html
[sbom-reqs]: https://drive.google.com/file/d/14HZGYD7pSSWEmtaHZzWrzPhxCXaCnloJ/view
[pypi]: https://pypi.org/project/ntia-conformance-checker/

ntia-conformance-checker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

ntia-conformance-checker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README