Vulnerability reference ¶

Known limitations and alternatives ¶

Due to Trivy, you'll receive a simplified dependency graph, as Trivy doesn't support Gradle or Maven's dependency resolution.

Dependency-track integrates with Trivy at runtime, ensuring that vulnerabilities from the Docker container are still detected.

Trivy directly parses the .jar files without access to full dependency resolution details.

Gradle and Maven plugins provide a deeper graph of nested transitive dependencies.

Gradle Plugin ¶

Add the following plugin to your build.gradle* file.

groovy

    id("org.cyclonedx.bom") version "1.x.x"

In your workflow you can generate a SBOM with the following gradle task command:

yaml

    - name: Generate and output SBOM
      run: ./gradlew cyclonedxBom

The SBOM will be default located at build/reports/bom.json. Pass the SBOM to the nais/docker-build-push action with the following input:

yaml

    uses: nais/docker-build-push@v0 # Should be pinned1
    with:
      byosbom: build/reports/bom.json

GitHub actions should be pinned to a SHA for better security. Read more in GitHub Secure use reference.

For nais/attest-sign action:

yaml

    uses: nais/attest-sign@v1 # Should be pinned
    with:
        sbom: build/reports/bom.json

For more info about settings check out the CycloneDx Gradle Plugin

Maven Plugin ¶

Add the following to your pom.xml file.

xml

    <plugins>
        <plugin>
            <groupId>org.cyclonedx</groupId>
            <artifactId>cyclonedx-maven-plugin</artifactId>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>makeAggregateBom</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>

In your workflow you can generate a SBOM with the following maven command:

yaml

    - name: Generate and output SBOM
      run: ./mvnw package

The SBOM will be default located at target/bom.json. Pass the SBOM to the nais/docker-build-push action with the following input:

yaml

    uses: nais/docker-build-push@v0 # Should be pinned1
    with:
      byosbom: target/bom.json

GitHub actions should be pinned to a SHA for better security. Read more in GitHub Secure use reference.

For nais/attest-sign action:

yaml

    uses: nais/attest-sign@v1 # Should be pinned
    with:
        sbom: target/bom.json

For more info about settings check out the CycloneDx Maven Plugin