Generated

from message cyclonedx.v1_5.Bom

Hierarchy

Constructors

Properties

annotations: cdx_15.Annotation[] = []

Comments made by people, organizations, or tools about any object with a bom-ref, such as components, services, vulnerabilities, or the BOM itself. Unlike inventory information, annotations may contain opinion or commentary from various stakeholders.

Generated

from field: repeated cyclonedx.v1_5.Annotation annotations = 11;

components: cdx_15.Component[] = []

Provides the ability to document a list of components.

Generated

from field: repeated cyclonedx.v1_5.Component components = 5;

compositions: cdx_15.Composition[] = []

Compositions describe constituent parts (including components, services, and dependency relationships) and their completeness. The completeness of vulnerabilities expressed in a BOM may also be described.

Generated

from field: repeated cyclonedx.v1_5.Composition compositions = 9;

dependencies: cdx_15.Dependency[] = []

Provides the ability to document dependency relationships.

Generated

from field: repeated cyclonedx.v1_5.Dependency dependencies = 8;

externalReferences: cdx_15.ExternalReference[] = []

Provides the ability to document external references related to the BOM or to the project the BOM describes.

Generated

from field: repeated cyclonedx.v1_5.ExternalReference external_references = 7;

formulation: cdx_15.Formula[] = []

Describes how a component or service was manufactured or deployed. This is achieved through the use of formulas, workflows, tasks, and steps, which declare the precise steps to reproduce along with the observed formulas describing the steps which transpired in the manufacturing process.

Generated

from field: repeated cyclonedx.v1_5.Formula formulation = 13;

metadata?: cdx_15.Metadata

Provides additional information about a BOM.

Generated

from field: optional cyclonedx.v1_5.Metadata metadata = 4;

properties: cdx_15.Property[] = []

Specifies optional, custom, properties

Generated

from field: repeated cyclonedx.v1_5.Property properties = 12;

serialNumber?: string

Every BOM generated should have a unique serial number, even if the contents of the BOM being generated have not changed over time. The process or tool responsible for creating the BOM should create random UUID's for every BOM generated.

Generated

from field: optional string serial_number = 3;

services: cdx_15.Service[] = []

Provides the ability to document a list of external services.

Generated

from field: repeated cyclonedx.v1_5.Service services = 6;

specVersion: string = ""

The version of the CycloneDX specification a BOM is written to (starting at version 1.3)

Generated

from field: string spec_version = 1;

version?: number

The version allows component publishers/authors to make changes to existing BOMs to update various aspects of the document such as description or licenses. When a system is presented with multiple BOMs for the same component, the system should use the most recent version of the BOM. The default version is '1' and should be incremented for each version of the BOM that is published. Each version of a component should have a unique BOM and if no changes are made to the BOMs, then each BOM will have a version of '1'.

Generated

from field: optional int32 version = 2;

vulnerabilities: cdx_15.Vulnerability[] = []

Vulnerabilities identified in components or services.

Generated

from field: repeated cyclonedx.v1_5.Vulnerability vulnerabilities = 10;

fields: FieldList = ...
runtime: ProtoRuntime = proto3
typeName: "cyclonedx.v1_5.Bom" = "cyclonedx.v1_5.Bom"

Methods

  • Create a deep copy.

    Returns cdx_15.Bom

  • Compare with a message of the same type.

    Parameters

    Returns boolean

  • Parse from binary data, merging fields.

    Repeated fields are appended. Map entries are added, overwriting existing keys.

    If a message field is already present, it will be merged with the new data.

    Parameters

    • bytes: Uint8Array
    • Optional options: Partial<BinaryReadOptions>

    Returns this

  • Parse a message from a JSON value.

    Parameters

    • jsonValue: JsonValue
    • Optional options: Partial<JsonReadOptions>

    Returns this

  • Parse a message from a JSON string.

    Parameters

    • jsonString: string
    • Optional options: Partial<JsonReadOptions>

    Returns this

  • Retrieve the MessageType of this message - a singleton that represents the protobuf message declaration and provides metadata for reflection- based operations.

    Returns MessageType<cdx_15.Bom>

  • Serialize the message to binary data.

    Parameters

    • Optional options: Partial<BinaryWriteOptions>

    Returns Uint8Array

  • Override for serialization behavior. This will be invoked when calling JSON.stringify on this message (i.e. JSON.stringify(msg)).

    Note that this will not serialize google.protobuf.Any with a packed message because the protobuf JSON format specifies that it needs to be unpacked, and this is only possible with a type registry to look up the message type. As a result, attempting to serialize a message with this type will throw an Error.

    This method is protected because you should not need to invoke it directly -- instead use JSON.stringify or toJsonString for stringified JSON. Alternatively, if actual JSON is desired, you should use toJson.

    Returns JsonValue

  • Serialize the message to a JSON value, a JavaScript value that can be passed to JSON.stringify().

    Parameters

    • Optional options: Partial<JsonWriteOptions>

    Returns JsonValue

  • Serialize the message to a JSON string.

    Parameters

    • Optional options: Partial<JsonWriteStringOptions>

    Returns string