Generates STIX Indicator Output from an OpenIOC v1.0 XML File.
The openioc-to-stix script generates STIX Indicators from an OpenIOC v1.0 XML file.
- Compatible with OpenIOC v1.0
- Generates STIX v1.2 and CybOX v2.1 content.
Please refer to the following websites for more information about the Structured Threat Information Expression (STIX), Cyber Observable eXpression (CybOX), and OpenIOC efforts.
- STIX - https://stixproject.github.io/
- CybOX - https://cyboxproject.github.io/
- OpenIOC - http://www.openioc.org
- Python 2.6, 2.7, 3.4, 3.5, 3.6
- mixbox >= v1.0.1
- python-stix >= v126.96.36.199
- python-cybox >= 188.8.131.52
NOTE Version 1.0.1 of openioc-to-stix requires python-stix < 184.108.40.206, python-cybox 220.127.116.11, and does not require mixbox.
Extract included files into your directory of choice. Please refer to the
requirements.txt file for dependencies.
Install dependencies with pip:
$ pip install -r requirements.txt
You can also install openioc-to-stix into your
by using pip:
$ cd /path/to/cloned/openioc-to-stix/repo/ $ pip install .
There are two main command line parameters for this script:
-i: the path to the input OpenIOC XML file -o: the path to the output STIX XML file
To use the script, run the following command:
$ python openioc-to-stix.py -i <OpenIOC XML file> -o <STIX XML file>
Unsupported indicator items or those that error out during translation will be translated into an empty Observable with a description of the error in order to retain structural consistency between the input OpenIOC document and output STIX document.
README: This file.
openioc-to-stix.py: OpenIOC XML to STIX XML Python script.
openioc-to-cybox.py: OpenIOC XML to CybOX XML Python converter script which this script wraps.
openioc2stix/: Top-level API package.
examples/*.xml: Sample input and output XML files.
BY USING OPENIOC-TO-STIX YOU SIGNIFY YOUR ACCEPTANCE OF THE TERMS AND CONDITIONS OF USE. IF YOU DO NOT AGREE TO THESE TERMS, DO NOT USE OPENIOC-TO-STIX.
For more information, please refer to the LICENSE.txt file