Skip to main content

Relationship Schema

Relationship

Object containing the following properties:

PropertyDescriptionType
id (*)string
type (*)string
spec_version (*)The version of the STIX specification used to represent this object.'2.0' | '2.1'
created (*)The created property represents the time at which the first version of this object was created. The timstamp value MUST be precise to the nearest millisecond.any
modified (*)The modified property represents the time that this particular version of the object was modified. The timstamp value MUST be precise to the nearest millisecond.any
created_by_refThe created_by_ref property specifies the id property of the identity object that describes the entity that created this object. If this attribute is omitted, the source of this information is undefined. This may be used by object creators who wish to remain anonymous.string
labelsThe labels property specifies a set of terms used to describe this object.Array<string>
revokedThe revoked property indicates whether the object has been revoked.boolean
confidencenumber (int, ≥1, ≤99)
langIdentifies the language of the text content in this object.string
external_referencesA list of external references which refers to non-STIX information.Array of at least 1 objects:
  • source_name (*): string
  • description: string
  • url: string (url)
  • external_id: string
object_marking_refs (*)The list of marking-definition objects to be applied to this object.Array<string>
granular_markingsThe set of granular markings that apply to this object.Array of objects:
  • marking_ref (*): string - Represents identifiers across the CTI specifications. The format consists of the name of the top-level object being identified, followed by two dashes (--), followed by a UUIDv4.
  • selectors (*): Array<string>
extensionsSpecifies any extensions of the object, as a dictionary.Object with dynamic keys of type string and values of type Object with properties:
  • extension_type (*): string
  • extension_properties (*): Object with dynamic keys of type string and values of type unknown (optional & nullable)
or Object with dynamic keys of type string and values of type unknown (optional & nullable)
x_mitre_attack_spec_version (*)The version of the ATT&CK spec used by the object. This field helps consuming software determine if the data format is supported. If the field is not present on an object, the spec version will be assumed to be 2.0.0. Refer to the ATT&CK CHANGELOG for all supported versions.string
x_mitre_old_attack_idOld ATT&CK IDs that may have been associated with this objectstring
x_mitre_deprecatedIndicates whether the object has been deprecated.boolean
relationship_type (*)The name used to identify the type of Relationship.RelationshipType
descriptionA description of the object.string
source_ref (*)The ID of the source (from) object.string
target_ref (*)The ID of the target (to) object.string
x_mitre_modified_by_ref (*)The STIX ID of the MITRE identity object. Used to track the identity of the MITRE organization, which created the current version of the object. Previous versions of the object may have been created by other individuals or organizations.string

(*) Required.

RelationshipType

The name used to identify the type of Relationship.

Enum string, one of the following possible values:

  • 'uses'
  • 'mitigates'
  • 'subtechnique-of'
  • 'detects'
  • 'attributed-to'
  • 'targets'
  • 'revoked-by'