External References
Components described in SBOMs generated by the CycloneDX Maven Plugin contain a few fields and external references that are extracted from Maven effective POMs:
- of the current built
pom.xml
(with inheritance) for SBOMmetadata.component
= the component that the BOM describes, - of the Maven dependencies for SBOM
components
.
SBOM Fields extracted from POM
3 SBOM fields are deducted from effective POM (= after POM inheritance from parents):
component.publisher
is filled with POM'sproject.organisation.name
,component.description
is filled with POM'sproject.description
,component.licenses[]
is filled with POM'sproject.licenses[]
.
External References extracted from POM
POM field | External Reference type |
---|---|
project.url |
website |
project.scm.url |
vcs |
project.ciManagement.url |
build-system |
project.issueManagement.url |
issue-tracker |
project.mailingLists[].archive or subscribe |
mailing-list |
project.distributionManagement.repository.url |
distribution |
Additional External References for metadata.component
You can add more external references the component that the BOM describes by plugin configuration:
<plugin>
<groupId>org.cyclonedx</groupId>
<artifactId>cyclonedx-maven-plugin</artifactId>
<configuration>
<externalReferences>
<externalReference>
<type>... external-reference-type ...</type>
<url>... value ...</url>
<comment>(optional) comment</comment>
</externalReference>
</externalReferences>
</configuration>
</plugin>
See valid CycloneDX external reference types.