| 1 | package SBOM::CycloneDX::Enum::ExternalReferenceType; | ||
| 2 | |||
| 3 | 16 | ▶ | use 5.010001; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 4 | 16 | ▶ | use strict; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 5 | 16 | ▶ | use warnings; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 6 | 16 | ▶ | use utf8; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 7 | |||
| 8 | 16 | ▶ | use Exporter 'import'; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 9 | 16 | our (@EXPORT_OK, %EXPORT_TAGS, %ENUM); | |
| 10 | |||
| 11 | 16 | ▶ | BEGIN { |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 12 | |||
| 13 | 16 | %ENUM = ( | |
| 14 | VCS => 'vcs', | ||
| 15 | ISSUE_TRACKER => 'issue-tracker', | ||
| 16 | WEBSITE => 'website', | ||
| 17 | ADVISORIES => 'advisories', | ||
| 18 | BOM => 'bom', | ||
| 19 | MAILING_LIST => 'mailing-list', | ||
| 20 | SOCIAL => 'social', | ||
| 21 | CHAT => 'chat', | ||
| 22 | DOCUMENTATION => 'documentation', | ||
| 23 | SUPPORT => 'support', | ||
| 24 | SOURCE_DISTRIBUTION => 'source-distribution', | ||
| 25 | DISTRIBUTION => 'distribution', | ||
| 26 | DISTRIBUTION_INTAKE => 'distribution-intake', | ||
| 27 | LICENSE => 'license', | ||
| 28 | BUILD_META => 'build-meta', | ||
| 29 | BUILD_SYSTEM => 'build-system', | ||
| 30 | RELEASE_NOTES => 'release-notes', | ||
| 31 | SECURITY_CONTACT => 'security-contact', | ||
| 32 | MODEL_CARD => 'model-card', | ||
| 33 | LOG => 'log', | ||
| 34 | CONFIGURATION => 'configuration', | ||
| 35 | EVIDENCE => 'evidence', | ||
| 36 | FORMULATION => 'formulation', | ||
| 37 | ATTESTATION => 'attestation', | ||
| 38 | THREAT_MODEL => 'threat-model', | ||
| 39 | ADVERSARY_MODEL => 'adversary-model', | ||
| 40 | RISK_ASSESSMENT => 'risk-assessment', | ||
| 41 | VULNERABILITY_ASSERTION => 'vulnerability-assertion', | ||
| 42 | EXPLOITABILITY_STATEMENT => 'exploitability-statement', | ||
| 43 | PENTEST_REPORT => 'pentest-report', | ||
| 44 | STATIC_ANALYSIS_REPORT => 'static-analysis-report', | ||
| 45 | DYNAMIC_ANALYSIS_REPORT => 'dynamic-analysis-report', | ||
| 46 | RUNTIME_ANALYSIS_REPORT => 'runtime-analysis-report', | ||
| 47 | COMPONENT_ANALYSIS_REPORT => 'component-analysis-report', | ||
| 48 | MATURITY_REPORT => 'maturity-report', | ||
| 49 | CERTIFICATION_REPORT => 'certification-report', | ||
| 50 | CODIFIED_INFRASTRUCTURE => 'codified-infrastructure', | ||
| 51 | QUALITY_METRICS => 'quality-metrics', | ||
| 52 | POAM => 'poam', | ||
| 53 | ELECTRONIC_SIGNATURE => 'electronic-signature', | ||
| 54 | DIGITAL_SIGNATURE => 'digital-signature', | ||
| 55 | RFC_9116 => 'rfc-9116', | ||
| 56 | PATENT => 'patent', | ||
| 57 | PATENT_FAMILY => 'patent-family', | ||
| 58 | PATENT_ASSERTION => 'patent-assertion', | ||
| 59 | CITATION => 'citation', | ||
| 60 | OTHER => 'other', | ||
| 61 | ); | ||
| 62 | |||
| 63 | 16 | require constant; | |
| 64 | 16 | constant->import(\%ENUM); | |
| 65 | |||
| 66 | 16 | @EXPORT_OK = sort keys %ENUM; | |
| 67 | 16 | %EXPORT_TAGS = (all => \@EXPORT_OK); | |
| 68 | |||
| 69 | } | ||
| 70 | |||
| 71 | 17 | ▶ | sub values { sort values %ENUM } |
|
Subroutine
values: called CC=1 SCAR=0.0
Pod
undocumented
| |||
| 72 | |||
| 73 | |||
| 74 | 16 | 1; | |
| 75 | |||
| 76 | =encoding utf-8 | ||
| 77 | |||
| 78 | =head1 NAME | ||
| 79 | |||
| 80 | SBOM::CycloneDX::Enum::ExternalReferenceType - External Reference Type | ||
| 81 | |||
| 82 | =head1 SYNOPSIS | ||
| 83 | |||
| 84 | use SBOM::CycloneDX::Enum qw(EXTERNAL_REFERENCE_TYPE); | ||
| 85 | |||
| 86 | say EXTERNAL_REFERENCE_TYPE->ISSUE_TRACKER; | ||
| 87 | |||
| 88 | |||
| 89 | use SBOM::CycloneDX::Enum::ExternalReferenceType; | ||
| 90 | |||
| 91 | say SBOM::CycloneDX::Enum::ExternalReferenceType->DOCUMENTATION; | ||
| 92 | |||
| 93 | |||
| 94 | use SBOM::CycloneDX::Enum::ExternalReferenceType qw(:all); | ||
| 95 | |||
| 96 | say ADVISORIES; | ||
| 97 | |||
| 98 | |||
| 99 | =head1 DESCRIPTION | ||
| 100 | |||
| 101 | L<SBOM::CycloneDX::Enum::ExternalReferenceType> is ENUM package used by L<SBOM::CycloneDX::ExternalReference>. | ||
| 102 | |||
| 103 | Specifies the type of external reference. | ||
| 104 | |||
| 105 | |||
| 106 | =head1 CONSTANTS | ||
| 107 | |||
| 108 | =over | ||
| 109 | |||
| 110 | =item * C<VCS>, Version Control System | ||
| 111 | |||
| 112 | =item * C<ISSUE_TRACKER>, Issue or defect tracking system, or an | ||
| 113 | Application Lifecycle Management (ALM) system | ||
| 114 | |||
| 115 | =item * C<WEBSITE>, Website | ||
| 116 | |||
| 117 | =item * C<ADVISORIES>, Security advisories | ||
| 118 | |||
| 119 | =item * C<BOM>, Bill of Materials (SBOM, OBOM, HBOM, SaaSBOM, etc) | ||
| 120 | |||
| 121 | =item * C<MAILING_LIST>, Mailing list or discussion group | ||
| 122 | |||
| 123 | =item * C<SOCIAL>, Social media account | ||
| 124 | |||
| 125 | =item * C<CHAT>, Real-time chat platform | ||
| 126 | |||
| 127 | =item * C<DOCUMENTATION>, Documentation, guides, or how-to instructions | ||
| 128 | |||
| 129 | =item * C<SUPPORT>, Community or commercial support | ||
| 130 | |||
| 131 | =item * C<SOURCE_DISTRIBUTION>, The location where the source code | ||
| 132 | distributable can be obtained. This is often an archive format such as zip | ||
| 133 | or tgz. The source-distribution type complements use of the version control | ||
| 134 | (vcs) type. | ||
| 135 | |||
| 136 | =item * C<DISTRIBUTION>, Direct or repository download location | ||
| 137 | |||
| 138 | =item * C<DISTRIBUTION_INTAKE>, The location where a component was | ||
| 139 | published to. This is often the same as "distribution" but may also include | ||
| 140 | specialized publishing processes that act as an intermediary. | ||
| 141 | |||
| 142 | =item * C<LICENSE>, The reference to the license file. If a license URL has | ||
| 143 | been defined in the license node, it should also be defined as an external | ||
| 144 | reference for completeness. | ||
| 145 | |||
| 146 | =item * C<BUILD_META>, Build-system specific meta file (i.e. pom.xml, | ||
| 147 | package.json, .nuspec, etc) | ||
| 148 | |||
| 149 | =item * C<BUILD_SYSTEM>, Reference to an automated build system | ||
| 150 | |||
| 151 | =item * C<RELEASE_NOTES>, Reference to release notes | ||
| 152 | |||
| 153 | =item * C<SECURITY_CONTACT>, Specifies a way to contact the maintainer, | ||
| 154 | supplier, or provider in the event of a security incident. Common URIs | ||
| 155 | include links to a disclosure procedure, a mailto (RFC-2368) that specifies | ||
| 156 | an email address, a tel (RFC-3966) that specifies a phone number, or dns | ||
| 157 | (RFC-4501) that specifies the records containing DNS Security TXT. | ||
| 158 | |||
| 159 | =item * C<MODEL_CARD>, A model card describes the intended uses of a | ||
| 160 | machine learning model, potential limitations, biases, ethical | ||
| 161 | considerations, training parameters, datasets used to train the model, | ||
| 162 | performance metrics, and other relevant data useful for ML transparency. | ||
| 163 | |||
| 164 | =item * C<LOG>, A record of events that occurred in a computer system or | ||
| 165 | application, such as problems, errors, or information on current | ||
| 166 | operations. | ||
| 167 | |||
| 168 | =item * C<CONFIGURATION>, Parameters or settings that may be used by other | ||
| 169 | components or services. | ||
| 170 | |||
| 171 | =item * C<EVIDENCE>, Information used to substantiate a claim. | ||
| 172 | |||
| 173 | =item * C<FORMULATION>, Describes the formulation of any referencable | ||
| 174 | object within the BOM, including components, services, metadata, | ||
| 175 | declarations, or the BOM itself. | ||
| 176 | |||
| 177 | =item * C<ATTESTATION>, Human or machine-readable statements containing | ||
| 178 | facts, evidence, or testimony. | ||
| 179 | |||
| 180 | =item * C<THREAT_MODEL>, An enumeration of identified weaknesses, threats, | ||
| 181 | and countermeasures, dataflow diagram (DFD), attack tree, and other | ||
| 182 | supporting documentation in human-readable or machine-readable format. | ||
| 183 | |||
| 184 | =item * C<ADVERSARY_MODEL>, The defined assumptions, goals, and | ||
| 185 | capabilities of an adversary. | ||
| 186 | |||
| 187 | =item * C<RISK_ASSESSMENT>, Identifies and analyzes the potential of future | ||
| 188 | events that may negatively impact individuals, assets, and/or the | ||
| 189 | environment. Risk assessments may also include judgments on the | ||
| 190 | tolerability of each risk. | ||
| 191 | |||
| 192 | =item * C<VULNERABILITY_ASSERTION>, A Vulnerability Disclosure Report (VDR) | ||
| 193 | which asserts the known and previously unknown vulnerabilities that affect | ||
| 194 | a component, service, or product including the analysis and findings | ||
| 195 | describing the impact (or lack of impact) that the reported vulnerability | ||
| 196 | has on a component, service, or product. | ||
| 197 | |||
| 198 | =item * C<EXPLOITABILITY_STATEMENT>, A Vulnerability Exploitability | ||
| 199 | eXchange (VEX) which asserts the known vulnerabilities that do not affect a | ||
| 200 | product, product family, or organization, and optionally the ones that do. | ||
| 201 | The VEX should include the analysis and findings describing the impact (or | ||
| 202 | lack of impact) that the reported vulnerability has on the product, product | ||
| 203 | family, or organization. | ||
| 204 | |||
| 205 | =item * C<PENTEST_REPORT>, Results from an authorized simulated cyberattack | ||
| 206 | on a component or service, otherwise known as a penetration test. | ||
| 207 | |||
| 208 | =item * C<STATIC_ANALYSIS_REPORT>, SARIF or proprietary machine or | ||
| 209 | human-readable report for which static analysis has identified code | ||
| 210 | quality, security, and other potential issues with the source code. | ||
| 211 | |||
| 212 | =item * C<DYNAMIC_ANALYSIS_REPORT>, Dynamic analysis report that has | ||
| 213 | identified issues such as vulnerabilities and misconfigurations. | ||
| 214 | |||
| 215 | =item * C<RUNTIME_ANALYSIS_REPORT>, Report generated by analyzing the call | ||
| 216 | stack of a running application. | ||
| 217 | |||
| 218 | =item * C<COMPONENT_ANALYSIS_REPORT>, Report generated by Software | ||
| 219 | Composition Analysis (SCA), container analysis, or other forms of component | ||
| 220 | analysis. | ||
| 221 | |||
| 222 | =item * C<MATURITY_REPORT>, Report containing a formal assessment of an | ||
| 223 | organization, business unit, or team against a maturity model. | ||
| 224 | |||
| 225 | =item * C<CERTIFICATION_REPORT>, Industry, regulatory, or other | ||
| 226 | certification from an accredited (if applicable) certification body. | ||
| 227 | |||
| 228 | =item * C<CODIFIED_INFRASTRUCTURE>, Code or configuration that defines and | ||
| 229 | provisions virtualized infrastructure, commonly referred to as | ||
| 230 | Infrastructure as Code (IaC). | ||
| 231 | |||
| 232 | =item * C<QUALITY_METRICS>, Report or system in which quality metrics can | ||
| 233 | be obtained. | ||
| 234 | |||
| 235 | =item * C<POAM>, Plans of Action and Milestones (POA&M) complement an | ||
| 236 | "attestation" external reference. POA&M is defined by NIST as a "document | ||
| 237 | that identifies tasks needing to be accomplished. It details resources | ||
| 238 | required to accomplish the elements of the plan, any milestones in meeting | ||
| 239 | the tasks and scheduled completion dates for the milestones". | ||
| 240 | |||
| 241 | =item * C<ELECTRONIC_SIGNATURE>, An e-signature is commonly a scanned | ||
| 242 | representation of a written signature or a stylized script of the person's | ||
| 243 | name. | ||
| 244 | |||
| 245 | =item * C<DIGITAL_SIGNATURE>, A signature that leverages cryptography, | ||
| 246 | typically public/private key pairs, which provides strong authenticity | ||
| 247 | verification. | ||
| 248 | |||
| 249 | =item * C<RFC_9116>, Document that complies with L<RFC | ||
| 250 | 9116|https://www.ietf.org/rfc/rfc9116.html> (A File Format to Aid in | ||
| 251 | Security Vulnerability Disclosure) | ||
| 252 | |||
| 253 | =item * C<PATENT>, References information about patents which may be | ||
| 254 | defined in human-readable documents or in machine-readable formats such as | ||
| 255 | CycloneDX or ST.96. For detailed patent information or to reference the | ||
| 256 | information provided directly by patent offices, it is recommended to | ||
| 257 | leverage standards from the World Intellectual Property Organization (WIPO) | ||
| 258 | such as L<ST.96|https://www.wipo.int/standards/en/st96>. | ||
| 259 | |||
| 260 | =item * C<PATENT_FAMILY>, References information about a patent family | ||
| 261 | which may be defined in human-readable documents or in machine-readable | ||
| 262 | formats such as CycloneDX or ST.96. A patent family is a group of related | ||
| 263 | patent applications or granted patents that cover the same or similar | ||
| 264 | invention. For detailed patent family information or to reference the | ||
| 265 | information provided directly by patent offices, it is recommended to | ||
| 266 | leverage standards from the World Intellectual Property Organization (WIPO) | ||
| 267 | such as L<ST.96|https://www.wipo.int/standards/en/st96>. | ||
| 268 | |||
| 269 | =item * C<PATENT_ASSERTION>, References assertions made regarding patents | ||
| 270 | associated with a component or service. Assertions distinguish between | ||
| 271 | ownership, licensing, and other relevant interactions with patents. | ||
| 272 | |||
| 273 | =item * C<CITATION>, A reference to external citations applicable to the | ||
| 274 | object identified by this BOM entry or the BOM itself. When used with a | ||
| 275 | BOM-Link, this allows offloading citations into a separate CycloneDX BOM. | ||
| 276 | |||
| 277 | =item * C<OTHER>, Use this if no other types accurately describe the | ||
| 278 | purpose of the external reference. | ||
| 279 | |||
| 280 | =back | ||
| 281 | |||
| 282 | =head1 SUPPORT | ||
| 283 | |||
| 284 | =head2 Bugs / Feature Requests | ||
| 285 | |||
| 286 | Please report any bugs or feature requests through the issue tracker | ||
| 287 | at L<https://github.com/giterlizzi/perl-SBOM-CycloneDX/issues>. | ||
| 288 | You will be notified automatically of any progress on your issue. | ||
| 289 | |||
| 290 | =head2 Source Code | ||
| 291 | |||
| 292 | This is open source software. The code repository is available for | ||
| 293 | public review and contribution under the terms of the license. | ||
| 294 | |||
| 295 | L<https://github.com/giterlizzi/perl-SBOM-CycloneDX> | ||
| 296 | |||
| 297 | git clone https://github.com/giterlizzi/perl-SBOM-CycloneDX.git | ||
| 298 | |||
| 299 | |||
| 300 | =head1 AUTHOR | ||
| 301 | |||
| 302 | =over 4 | ||
| 303 | |||
| 304 | =item * Giuseppe Di Terlizzi <gdt@cpan.org> | ||
| 305 | |||
| 306 | =back | ||
| 307 | |||
| 308 | |||
| 309 | =head1 LICENSE AND COPYRIGHT | ||
| 310 | |||
| 311 | This software is copyright (c) 2025-2026 by Giuseppe Di Terlizzi. | ||
| 312 | |||
| 313 | This is free software; you can redistribute it and/or modify it under | ||
| 314 | the same terms as the Perl 5 programming language system itself. | ||
| 315 | |||
| 316 | =cut | ||