Version: 1.2.0.4.dev0

stix.exploit_target Module

Overview

The stix.exploit_target module implements ExploitTarget.

This denotes the specific vulnerability, weakness, or software configuration that creates a security risk.

Classes

class stix.exploit_target.ExploitTarget(id_=None, idref=None, timestamp=None, title=None, description=None, short_description=None)

Bases: stix.base.BaseCoreComponent

Implementation of STIX Exploit Target.

Parameters:
  • id (optional) – An identifier. If None, a value will be generated via mixbox.idgen.create_id(). If set, this will unset the idref property.
  • idref (optional) – An identifier reference. If set this will unset the id_ property.
  • title (optional) – A string title.
  • timestamp (optional) – A timestamp value. Can be an instance of datetime.datetime or str.
  • description (optional) – A string description.
  • short_description (optional) – A string short description.
add_configuration(value)

Adds a configuration to the configurations list property.

Note

If None is passed in no value is added

Parameters:value – A configuration value.
Raises:ValueError – If the value param is of type Configuration
add_description(description)

Adds a description to the descriptions collection.

This is the same as calling “foo.descriptions.add(bar)”.

add_short_description(description)

Adds a description to the short_descriptions collection.

This is the same as calling “foo.short_descriptions.add(bar)”.

add_vulnerability(value)

Adds a vulnerability to the vulnerabilities list property.

Note

If None is passed in no value is added

Parameters:value – A Vulnerability object..
Raises:ValueError – if the value param is of type Vulnerability
add_weakness(value)

Adds a weakness to the weaknesses list property.

Note

If None is passed in no value is added

Parameters:value – A Weakness object.

Raises: ValueError if the value param is of type Weakness

description

A single description about the contents or purpose of this object.

Default Value: None

Note

If this object has more than one description set, this will return the description with the lowest ordinality value.

Returns:class:.StructuredText
Return type:An instance of
find(id_)

Searches the children of a Entity implementation for an object with an id_ property that matches id_.

short_description

A single short description about the contents or purpose of this object.

Default Value: None

Note

If this object has more than one short description set, this will return the description with the lowest ordinality value.

Returns:class:.StructuredText
Return type:An instance of
to_dict()

Convert to a dict

Subclasses can override this function.

Returns:Python dict with keys set from this Entity.
to_json()

Export an object as a JSON String.

to_obj(ns_info=None)

Convert to a GenerateDS binding object.

Subclasses can override this function.

Returns:An instance of this Entity’s _binding_class with properties set from this Entity.
class stix.exploit_target.PotentialCOAs(coas=None, scope=None)

Bases: stix.common.related.GenericRelationshipList

A list of Potential_COA objects, defaults to empty array

class stix.exploit_target.RelatedExploitTargets(related_exploit_targets=None, scope=None)

Bases: stix.common.related.GenericRelationshipList

A list of RelatedExploitTargets objects, defaults to empty array