Skip to main content
Version: latest

Group Schema

Group

Groups represent clusters of adversary activity with shared characteristics, tools, tactics, or infrastructure. They are defined as intrusion-set objects and strictly follow the STIX 2.1 specification without additional custom fields.

Object containing the following properties:

PropertyDescriptionType
id (*)string
type (*)'intrusion-set'
spec_version (*)The version of the STIX specification used to represent this object.'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.string (ISO 8601)
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.string (ISO 8601)
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 meta this object.Array<string (_min length: 1_)> (min: 1)
revokedThe revoked property indicates whether the object has been revoked.boolean
confidenceIdentifies the confidence that the creator has in the correctness of their data.number (int, ≥1, ≤99)
langIdentifies the language of the text content in this object.string (min length: 1)
external_references (*)A list of external references with the first containing a valid ATT&CK IDArray of at least 1 objects:
  • source_name (*): string (min length: 1)
  • description: string (min length: 1)
  • url: string (url)
  • external_id: string (min length: 1)
object_marking_refsThe list of marking-definition objects to be applied to this object.Array<string (_startsWith: marking-definition--_)>
granular_markingsThe set of granular markings that apply to this object.Array of objects:
  • lang: string (min length: 1) - The lang property identifies the language of the text identified by this marking. The value of the lang property, if present, MUST be an [RFC5646] language code. If the marking_ref property is not present, this property MUST be present. If the marking_ref property is present, this property MUST NOT be present.
  • marking_ref: string - The marking_ref property specifies the ID of the marking-definition object that describes the marking. If the lang property is not present, this property MUST be present. If the lang property is present, this property MUST NOT be present.
  • selectors (*): Array<string (_min length: 1_)> (min: 1) - The selectors property specifies a list of selectors for content contained within the STIX Object in which this property appears.
extensionsSpecifies any extensions of the object, as a dictionary where keys are extension definition UUIDsObject with dynamic keys of type string (min length: 1) and values of type Object with properties:
  • extension_type (*): 'new-sdo' | 'new-sco' | 'new-sro' | 'property-extension' | 'toplevel-property-extension'
or Object with dynamic keys of type string (min length: 1) and values of type unknown
name (*)The name of the object.string (min length: 1)
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 (min length: 1, regex: /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/)
x_mitre_version (*)Represents the version of the object in a 'major.minor' format, where both 'major' and 'minor' are integers between 0 and 99. This versioning follows semantic versioning principles but excludes the patch number. The version number is incremented by ATT&CK when the content of the object is updated. This property does not apply to relationship objects.string (min length: 1, regex: /^(\d{1,2})\.(\d{1,2})$/)
x_mitre_old_attack_idOld ATT&CK IDs that may have been associated with this objectstring (min length: 1)
x_mitre_deprecatedIndicates whether the object has been deprecated.boolean
descriptionA description that provides more details and context about the Intrusion Set, potentially including its purpose and its key characteristicsstring (min length: 1)
x_mitre_domains (*)The technology domains to which the ATT&CK object belongs.Array<'enterprise-attack' | 'mobile-attack' | 'ics-attack'> (min: 1)
x_mitre_contributorsPeople and organizations who have contributed to the object. Not found on objects of type relationship.Array<string (_min length: 1_)> (min: 1)
x_mitre_modified_by_refThe 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.'identity--c78cb6e5-0c4b-4611-8297-d1b8b55e40b5'
aliasesAlternative names used to identify this group. The first alias must match the object's nameArray<string (_min length: 1_)> (min: 1)
first_seenThe time that this Intrusion Set was first seenstring (ISO 8601)
last_seenThe time that this Intrusion Set was last seenstring (ISO 8601)
goalsThe high-level goals of this Intrusion Set, namely, what are they trying to doArray<string (_min length: 1_)> (min: 1)
resource_levelThis property specifies the organizational level at which this Intrusion Set typically works, which in turn determines the resources available to this Intrusion Set for use in an attack'individual' | 'club' | 'contest' | 'team' | 'organization' | 'government'
primary_motivationThe primary reason, motivation, or purpose behind this Intrusion Set'accidental' | 'coercion' | 'dominance' | 'ideology' | 'notoriety' | 'organizational-gain' | 'personal-gain' | 'personal-satisfaction' | 'revenge' | 'unpredictable'
secondary_motivationsThe secondary reasons, motivations, or purposes behind this Intrusion SetArray<'accidental' | 'coercion' | 'dominance' | 'ideology' | 'notoriety' | 'organizational-gain' | 'personal-gain' | 'personal-satisfaction' | 'revenge' | 'unpredictable'> (min: 1)

(*) Required.