Skip to content
attack

Class: StixRelationship

The Relationship object is used to link together two SDOs in order to describe how they are related to each other.

URI: attack:StixRelationship

 classDiagram
    class StixRelationship
    click StixRelationship href "../StixRelationship/"
      StixRelationshipObject <|-- StixRelationship
        click StixRelationshipObject href "../StixRelationshipObject/"
      

      StixRelationship <|-- AttackRelationship
        click AttackRelationship href "../AttackRelationship/"
      

      StixRelationship : confidence
        
      StixRelationship : created
        
      StixRelationship : created_by_ref
        
          
    
        
        
        StixRelationship --> "0..1" StixIdentity : created_by_ref
        click StixIdentity href "../StixIdentity/"
    

        
      StixRelationship : description
        
      StixRelationship : extensions
        
          
    
        
        
        StixRelationship --> "0..1" StixExtensions : extensions
        click StixExtensions href "../StixExtensions/"
    

        
      StixRelationship : external_references
        
          
    
        
        
        StixRelationship --> "1..*" StixExternalReference : external_references
        click StixExternalReference href "../StixExternalReference/"
    

        
      StixRelationship : granular_markings
        
          
    
        
        
        StixRelationship --> "1..*" StixGranularMarking : granular_markings
        click StixGranularMarking href "../StixGranularMarking/"
    

        
      StixRelationship : id
        
      StixRelationship : labels
        
      StixRelationship : lang
        
      StixRelationship : modified
        
      StixRelationship : object_marking_refs
        
          
    
        
        
        StixRelationship --> "1..*" StixMarkingDefinition : object_marking_refs
        click StixMarkingDefinition href "../StixMarkingDefinition/"
    

        
      StixRelationship : relationship_type
        
      StixRelationship : revoked
        
      StixRelationship : source_ref
        
          
    
        
        
        StixRelationship --> "1" StixObject : source_ref
        click StixObject href "../StixObject/"
    

        
      StixRelationship : spec_version
        
          
    
        
        
        StixRelationship --> "1" StixSpecVersion : spec_version
        click StixSpecVersion href "../StixSpecVersion/"
    

        
      StixRelationship : start_time
        
      StixRelationship : stop_time
        
      StixRelationship : target_ref
        
          
    
        
        
        StixRelationship --> "1" StixObject : target_ref
        click StixObject href "../StixObject/"
    

        
      StixRelationship : type

Inheritance

Section titled “Inheritance”

Slots

Section titled “Slots”
Name Cardinality and Range Description Inheritance
relationship_type 1
String		 The name used to identify the type of relationship direct
description 0..1
String		 A description of the object, which may be long direct
source_ref 1
StixObject or 
StixDomainObject or 
StixCyberObservableObject		 The ID of the source (from) object direct
target_ref 1
StixObject or 
StixDomainObject or 
StixCyberObservableObject		 The ID of the target (to) object direct
start_time 0..1
StixTimestamp		 This optional timestamp represents the earliest time at which the Relationshi… direct
stop_time 0..1
StixTimestamp		 The latest time at which the Relationship between the objects exists direct
created_by_ref 0..1
StixIdentity		 A reference to the identity of the object’s creator StixCommonObject
created 1
StixTimestampMillis		 The time at which the object, or its first version, was created StixCommonObject
modified 1
StixTimestampMillis		 The time at which this version of the object was modified StixCommonObject
revoked 0..1
Boolean		 The revoked property indicates whether the object has been revoked StixCommonObject
labels 1..*
String		 The labels property specifies a set of terms used to describe this object StixCommonObject
confidence 0..1
Integer		 Identifies the confidence that the creator has in the correctness of their da… StixCommonObject
lang 0..1
String		 The language of the text content, as an RFC 5646 language code StixCommonObject
external_references 1..*
StixExternalReference		 References to non-STIX information about the object StixCommonObject
id 1
StixIdentifier		 The identifier of the object: its STIX type, two hyphens and a UUID StixObject
type 1
String		 The STIX type name of the object, such as attack-pattern StixObject
spec_version 1
StixSpecVersion		 The version of the STIX specification used to represent the object StixObject
object_marking_refs 1..*
StixMarkingDefinition		 References to the marking definitions that apply to the object StixObject
granular_markings 1..*
StixGranularMarking		 The granular markings that apply to parts of the object StixObject
extensions 0..1
StixExtensions		 The object’s extensions, as a dictionary keyed by extension name StixObject

Identifier and Mapping Information

Section titled “Identifier and Mapping Information”

Annotations

Section titled “Annotations”
property value
stix_type relationship

Schema Source

Section titled “Schema Source”

Mappings

Section titled “Mappings”
Mapping Type Mapped Value
self attack:StixRelationship
native attack:StixRelationship
close uco-core:Relationship

LinkML Source

Section titled “LinkML Source”

Direct

Section titled “Direct”
name: StixRelationship
annotations:
  stix_type:
    tag: stix_type
    value: relationship
description: The Relationship object is used to link together two SDOs in order to
  describe how they are related to each other.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- uco-core:Relationship
is_a: StixRelationshipObject
slots:
- relationship_type
- description
- source_ref
- target_ref
- start_time
- stop_time
slot_usage:
  id:
    name: id
    pattern: ^relationship--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
  type:
    name: type
    equals_string: relationship
  relationship_type:
    name: relationship_type
    required: true
  source_ref:
    name: source_ref
    required: true
  target_ref:
    name: target_ref
    required: true

Induced

Section titled “Induced”
name: StixRelationship
annotations:
  stix_type:
    tag: stix_type
    value: relationship
description: The Relationship object is used to link together two SDOs in order to
  describe how they are related to each other.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- uco-core:Relationship
is_a: StixRelationshipObject
slot_usage:
  id:
    name: id
    pattern: ^relationship--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
  type:
    name: type
    equals_string: relationship
  relationship_type:
    name: relationship_type
    required: true
  source_ref:
    name: source_ref
    required: true
  target_ref:
    name: target_ref
    required: true
attributes:
  relationship_type:
    name: relationship_type
    description: The name used to identify the type of relationship.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:kindOfRelationship
    rank: 1000
    slot_uri: stix:relationship_type
    owner: StixRelationship
    domain_of:
    - StixRelationship
    range: string
    required: true
    pattern: ^[a-z0-9\-]+$
  description:
    name: description
    description: A description of the object, which may be long.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:description
    rank: 1000
    slot_uri: stix:description
    owner: StixRelationship
    domain_of:
    - AttackTactic
    - AttackMatrix
    - AttackCollection
    - AttackAsset
    - AttackDataSource
    - AttackDataComponent
    - AttackAnalytic
    - AttackRelatedAsset
    - AttackMutableElement
    - StixIdentity
    - StixExtensionDefinition
    - StixExternalReference
    - StixAttackPattern
    - StixCampaign
    - StixCourseOfAction
    - StixGrouping
    - StixIncident
    - StixIndicator
    - StixInfrastructure
    - StixIntrusionSet
    - StixLocation
    - StixMalware
    - StixReport
    - StixThreatActor
    - StixTool
    - StixVulnerability
    - StixRelationship
    - StixSighting
    range: string
  source_ref:
    name: source_ref
    description: The ID of the source (from) object.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:source
    rank: 1000
    slot_uri: stix:source_ref
    owner: StixRelationship
    domain_of:
    - StixRelationship
    range: StixObject
    required: true
    pattern: ^(?!(relationship|sighting|bundle|marking-definition|language-content)--)[a-z][a-z0-9-]+[a-z0-9]--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
    any_of:
    - range: StixDomainObject
    - range: StixCyberObservableObject
  target_ref:
    name: target_ref
    description: The ID of the target (to) object.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:target
    rank: 1000
    slot_uri: stix:target_ref
    owner: StixRelationship
    domain_of:
    - StixRelationship
    range: StixObject
    required: true
    pattern: ^(?!(relationship|sighting|bundle|marking-definition|language-content)--)[a-z][a-z0-9-]+[a-z0-9]--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
    any_of:
    - range: StixDomainObject
    - range: StixCyberObservableObject
  start_time:
    name: start_time
    description: This optional timestamp represents the earliest time at which the
      Relationship between the objects exists. If this property is a future timestamp,
      at the time the updated property is defined, then this represents an estimate
      by the producer of the intelligence of the earliest time at which relationship
      will be asserted to be true.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:startTime
    rank: 1000
    slot_uri: stix:start_time
    owner: StixRelationship
    domain_of:
    - StixRelationship
    range: stix_timestamp
  stop_time:
    name: stop_time
    description: The latest time at which the Relationship between the objects exists.
      If this property is a future timestamp, at the time the updated property is
      defined, then this represents an estimate by the producer of the intelligence
      of the latest time at which relationship will be asserted to be true.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:endTime
    rank: 1000
    slot_uri: stix:stop_time
    owner: StixRelationship
    domain_of:
    - StixRelationship
    range: stix_timestamp
  created_by_ref:
    name: created_by_ref
    description: A reference to the identity of the object's creator.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:createdBy
    rank: 1000
    slot_uri: stix:created_by_ref
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    - StixMarkingDefinition
    range: StixIdentity
    pattern: ^identity--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
  created:
    name: created
    description: The time at which the object, or its first version, was created.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:objectCreatedTime
    rank: 1000
    slot_uri: stix:created
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    - StixMarkingDefinition
    range: stix_timestamp_millis
    required: true
  modified:
    name: modified
    description: The time at which this version of the object was modified.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:modifiedTime
    rank: 1000
    slot_uri: stix:modified
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    range: stix_timestamp_millis
    required: true
  revoked:
    name: revoked
    description: The revoked property indicates whether the object has been revoked.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:revoked
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    range: boolean
  labels:
    name: labels
    description: The labels property specifies a set of terms used to describe this
      object.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:tag
    rank: 1000
    slot_uri: stix:labels
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    range: string
    multivalued: true
    minimum_cardinality: 1
  confidence:
    name: confidence
    description: Identifies the confidence that the creator has in the correctness
      of their data.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:confidence
    rank: 1000
    slot_uri: stix:confidence
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    range: integer
    minimum_value: 0
    maximum_value: 100
  lang:
    name: lang
    description: The language of the text content, as an RFC 5646 language code.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:lang
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    - StixGranularMarking
    range: string
  external_references:
    name: external_references
    description: References to non-STIX information about the object.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:externalReference
    rank: 1000
    slot_uri: stix:external_references
    owner: StixRelationship
    domain_of:
    - StixCommonObject
    - StixMarkingDefinition
    range: StixExternalReference
    multivalued: true
    inlined: true
    inlined_as_list: true
    minimum_cardinality: 1
  id:
    name: id
    description: 'The identifier of the object: its STIX type, two hyphens and a UUID.
      Each class narrows the type.'
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:id
    identifier: true
    owner: StixRelationship
    domain_of:
    - StixObject
    - StixBundle
    range: stix_identifier
    required: true
    pattern: ^relationship--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
  type:
    name: type
    description: The STIX type name of the object, such as attack-pattern. Each class
      pins its own.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:type
    owner: StixRelationship
    domain_of:
    - StixObject
    - StixBundle
    range: string
    required: true
    pattern: ^([a-z][a-z0-9]*)+(-[a-z0-9]+)*\-?$
    equals_string: relationship
  spec_version:
    name: spec_version
    description: The version of the STIX specification used to represent the object.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:spec_version
    owner: StixRelationship
    domain_of:
    - StixObject
    range: StixSpecVersion
    required: true
  object_marking_refs:
    name: object_marking_refs
    description: References to the marking definitions that apply to the object.
    from_schema: https://w3id.org/lmodel/attack
    close_mappings:
    - uco-core:objectMarking
    rank: 1000
    slot_uri: stix:object_marking_refs
    owner: StixRelationship
    domain_of:
    - StixObject
    range: StixMarkingDefinition
    multivalued: true
    pattern: ^marking-definition--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
    minimum_cardinality: 1
  granular_markings:
    name: granular_markings
    description: The granular markings that apply to parts of the object.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:granular_markings
    owner: StixRelationship
    domain_of:
    - StixObject
    range: StixGranularMarking
    multivalued: true
    inlined: true
    inlined_as_list: true
    minimum_cardinality: 1
  extensions:
    name: extensions
    description: The object's extensions, as a dictionary keyed by extension name.
    from_schema: https://w3id.org/lmodel/attack
    rank: 1000
    slot_uri: stix:extensions
    owner: StixRelationship
    domain_of:
    - StixObject
    range: StixExtensions
    inlined: true