> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/generate-reports/built-in-reports/sbom-reports.md).

# SBOM Reports

You can use SBOM reports to review and share your software bill of materials. There are two views:

* [**Detailed SBOM Report – Internal**](#detailed-sbom-report-internal)**:** Intended for AppSec engineers to inspect component health, license status, and vulnerability metrics.
* [**SBOM Report:**](#sbom-report) Intended for managers and customers to verify your security posture using a detailed component list.

You can [filter ](#filtering-report-info)and [export ](#exporting-info)the report info.

## Detailed SBOM Report - Internal

Detailed SBOM Report – Internal shows the health and risk of every component in your software bill of materials.

It displays hygiene metrics, license approval breakdowns, vulnerability severity summaries, and a detailed list of all components.

You can use filters, export data, or start a scan to focus on the items you need.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-d8a41efc8e9eb41070fc0daf5ed1578fd088f586%2FSBOM-Internal.png?alt=media" alt=""><figcaption></figcaption></figure>

You can view the following information:

| Section                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **SBOM Issues Hygiene**              | Displays counts of SBOM items by their hygiene status, such as Deprecated, Unapproved license, Has vulnerabilities and so on.                                                                                                                                                                                                                                                                                                               |
| **Unapproved Licenses**              | Shows breakdown of SBOM items according to license type for unapproved licenses.                                                                                                                                                                                                                                                                                                                                                            |
| **Vulnerable Libraries by Severity** | Shows breakdown of vulnerable libraries according to severity.                                                                                                                                                                                                                                                                                                                                                                              |
| **SBOM Items**                       | <p>Lists all SBOM components with details such as license, CVE status, source, application and so on.<br><br>You can click <img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-dc15af6c699447a10d3deefccdc39302a17f3b31%2Fcustom_columns_icon.png?alt=media" alt=""> above the SBOM Items table and select which columns to present in the table.</p> |

## SBOM Report

SBOM Report provides an inventory of your software components in your software bill of materials, mainly third party and open sources.

You can share this view with managers and customers to demonstrate license compliance by showing whether each component meets its legal obligations..

The SBOM items table lists all SBOM components with details such as library name, license status, source, application, and so on. You can click ![](https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-dc15af6c699447a10d3deefccdc39302a17f3b31%2Fcustom_columns_icon.png?alt=media) above the SBOM Items table and select which columns to present in the table.

To focus on the items you need, you can use [filters](#filtering-report-info).

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-5b7327c3c204bece1f6ca781090983272cc615a4%2FSBOM_report.png?alt=media" alt=""><figcaption></figcaption></figure>

## Filtering report info

The following filter options are available in both reports:

| Filter name                | Description                                       |
| -------------------------- | ------------------------------------------------- |
| **Application**            | Filters components by application                 |
| **App Tag**                | Filters components by app tag                     |
| **Library Name**           | Filters components by library name                |
| **Library Version**        | Filters components by library version             |
| **Dependency**             | Filters components by dependency type             |
| **Issues**                 | Filters components by SBOM issue status           |
| **License**                | Filters components by license status              |
| **Source**                 | Filters components by source                      |
| **Code-to-Cloud Exposure** | Filters components by exposure path to cloud code |

## Exporting info

The following export options are available in both reports:

| Option                  | Description                                                         |
| ----------------------- | ------------------------------------------------------------------- |
| **Export as PDF**       | Generates a PDF file of the report, including charts and tables.    |
| **Export as CSV**       | Generates a CSV file containing raw SBOM data for further analysis. |
| **Export as CycloneDX** | Generates an SBOM in CycloneDX format for import into other tools.  |
| **Export as SPDX**      | Generates an SBOM in SPDX format for import into other tools.       |

Application-specific CycloneDX JSON exports include VEX assessments for vulnerabilities in the context of the selected application. A flattened export of unique libraries does not include VEX information because it does not preserve the application context required for an exploitability assessment.

> **Note:** By default, the exported report includes all columns from the SBOM Items table. If you hide any columns in your custom view, the export reflects those changes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ox.security/generate-reports/built-in-reports/sbom-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
