Installing

Requirements

  • Python 3.6+

  • python-stix and its dependencies

    Note

    Make sure to use either the latest version of python-stix 1.1.1.x or 1.2.0.x, depending on whether you want to support STIX 1.1.1 or STIX 1.2.

  • python-stix2 >= 3.0.0

  • stix2-validator >= 3.0.0 and its dependencies

  • pycountry >= 20.7.0

  • stixmarx >= 1.0.8

Installation Steps

Install with pip

$ pip install stix2-elevator

This will install all necessary dependencies, including the latest version of python-stix.

If you need to support older STIX 1.1.1 content, install python-stix 1.1.1.x first

$ pip install 'stix<1.2'
$ pip install stix2-elevator

You can also install the stix2-elevator from GitHub to get the latest (unstable) version

$ pip install git+https://github.com/oasis-open/cti-stix-elevator.git

Installation Steps for ACS Data Marking Support

ACS data markings correspond to the common marking scheme used by the U.S. government (e.g., U, C, S, TS). To elevate STIX 1.x content that contains ACS data markings, it is necessary to install an additional python package called ‘stix_edh’.

Install with pip

$ pip install stix2-elevator[acs]

Installation Steps for Ignoring Data Markings Not Defined in the STIX Specification

The elevator uses the -m option to declare data marking python classes that support data markings not defined within the STIX specification. See the Command Line Interface section for an example.

However, the elevator must import those class definitions. The suggested way is to create a small python wrapper script that imports the needed package.

import <data marking package>
from stix2elevator import elevate

elevate(...)