scality / sbom

Generate SBOM GitHub Action

A GitHub Action for creating a software bill of materials (SBOM) using Syft.

Basic Usage

- uses: scality/sbom@v1.2.2
  with:
    target: ./

This will create SBOM result files based on type, ex:

• repo_sbom_v1.1.0-4-gd6cdf1f.json
• repo_sbom_v1.2.2.json
• image_myiso.iso_nginx_latest.json
• iso_myiso.iso_128.json

If you want to scan a repository, you have to checkout it with fetch-tags. This is mandatory to get repo version for SBOM filename.

- uses: actions/checkout@v4  
  with:  
    fetch-depth: 0  
    fetch-tags: true  

Configuration

scality/sbom

The main SBOM action, responsible for generating SBOMs.

Parameter	Description	Default
grype-version	Grype version to use	0.77.3
sfyt-version	Syft version to use	1.3.0
trivy-version	Trivy version to use	0.51.1
target	A file/directory/iso on the filesystem to scan.	<current directory>
format	Format of SBOM file.	cyclonedx-json
name	Name of the target, if you need to overwrite the detected.
version	Version of the target, if you need to overwrite the detected. ISO have no version.
output_dir	Path to store generated SBOM files.	/tmp/sbom
exclude_mediatypes	Media types to exclude for images.
vuln_report	Generate vuln report using Grype.

Example Usage

Scan with a specific format

Use the path parameter, relative to the repository root:

- uses: scality/sbom@v1.2.2
  with:
    target: ./artifacts
    format: cyclonedx-json

Exclude mediatypes for container images

Images created with Oras for example have custom mediatype and are not usable by Skopeo, they have to be excluded.

- uses: scality/sbom@v1.2.2
  with:
    target: ./images
    exclude_mediatypes: "application/grafana-dashboard+json text/nginx-conf-template"

Full example

name: "Generate sbom"
on:
  workflow_dispatch:
  workflow_call:
jobs:
  generate-sbom:
    runs-on: ubuntu-22.04
    env:
      BASE_PATH: ${{ github.workspace }}/workdir
      SBOM_PATH: ${{ github.workspace }}/artifacts/sbom
    steps:
      - name: Create directories
        shell: bash
        run: |
          mkdir -p ${{ env.BASE_PATH }}/repo
          mkdir -p ${{ env.BASE_PATH }}/iso
          mkdir -p ${{ env.SBOM_PATH }}
      - name: Checkout repo for scanning
        uses: actions/checkout@v4  
        with:  
          fetch-depth: 0  
          fetch-tags: true
          path: ${{ env.BASE_PATH }}/repo/myrepo
      - name: Generate sbom for repository
        uses: scality/sbom@v1.2.2
        with:
          target: ${{ env.BASE_PATH }}/repo/myrepo
          output-dir: ${{ env.SBOM_PATH }}
      - name: Get artifacts URL
        uses: scality/action-artifacts@v4
        id: artifacts
        with:
          method: setup
          url: https://artifactmanager.net
          user: ${{ secrets.ARTIFACTS_USER }}
          password: ${{ secrets.ARTIFACTS_PASSWORD }}
      - name: Donwload artifacts
        shell: bash
        env:
          ARTIFACTS_URL: ${{ steps.artifacts.outputs.link }}
          ARTIFACTS_USER: ${{ secrets.ARTIFACTS_USER }}
          ARTIFACTS_PASSWORD: ${{ secrets.ARTIFACTS_PASSWORD }}
        run: |
          echo "Downloading my.iso from $ARTIFACTS_URL"
          curl -sSfL -o ${{ env.BASE_PATH }}/iso/my.iso -u $ARTIFACTS_USER:$ARTIFACTS_PASSWORD $ARTIFACTS_URL/my.iso
      - name: Generate sbom for ISO
        uses: scality/sbom@v1.2.2
        with:
          target: ${{ env.BASE_PATH }}/iso/my.iso
          version: "1.0.0"  # Make sure to replace this with the actual ISO version to avoid undefined in you SBOM
          output-dir: ${{ env.SBOM_PATH }}
      - name: Generate archive
        shell: bash
        run: |
          cd ${{ env.SBOM_PATH }}
          tar -czf sbom_myproject.tar.gz *.json
      - name: Clean up
        shell: bash
        run: |
          rm -rf ${{ env.BASE_PATH }}/repo
          rm -rf ${{ env.BASE_PATH }}/iso
          rm -f ${{ env.SBOM_PATH }}/*.json
      - name: Upload artifacts
        if: always()
        uses: scality/action-artifacts@v4
        with:
          method: upload
          url: https://artifactmanager.net
          user: ${{ secrets.USER }}
          password: ${{ secrets.PASSWORD }}
          source: artifacts

CycloneDX metadata

In generated SBOM you will find this metadata:

• for images contains in ISO:

{
    "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
    "bomFormat": "CycloneDX",
    "specVersion": "1.5",
    "serialNumber": "urn:uuid:984d102d-0992-4dae-be80-ba551bc2079a",
    "version": 1,
    "metadata": {
        "timestamp": "2024-05-07T09:43:34Z",
        "tools": {
            "components": [
                {
                    "type": "application",
                    "author": "anchore",
                    "name": "syft",
                    "version": "1.3.0"
                }
            ]
        },
        "component": {
            "bom-ref": "1b58496ca93cc57d",
            "type": "container",
            "name": "my.iso:alpine", // composed by iso_source_name:image_name
            "version": "1.1.1" // image_version
        }
    },
...

• for ISO:

{
    "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
    "bomFormat": "CycloneDX",
    "specVersion": "1.5",
    "serialNumber": "urn:uuid:db2bc22b-a5e5-49a9-9d02-61a18480ead4",
    "version": 1,
    "metadata": {
        "timestamp": "2024-05-07T09:41:46Z",
        "tools": {
            "components": [
                {
                    "type": "application",
                    "author": "anchore",
                    "name": "syft",
                    "version": "1.3.0"
                }
            ]
        },
        "component": {
            "bom-ref": "4a057776eee09e2f",
            "type": "file",
            "name": "my.iso", // ISO basename calculated by target var
            "version": "undefined" // for ISO if version is not provided, you will get undefined
        }
    }
}

Know issue

• scanning a repo present in /tmp will not work. Syft doesn't use right catalogers in this path. An issue is open here

References

HTML template for Grype results visualisation was slightly modified from Grype Contrib.