Skip to main content

Converts OpenIOC documents into STIX/CybOX documents.

Project description

Generates STIX Indicator Output from an OpenIOC v1.0 XML File.

Source:

https://github.com/STIXProject/openioc-to-stix

Download:

https://pypi.python.org/pypi/openioc-to-stix

Build Status Code Health version badge

Overview

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.

Requirements

  • Python 2.6, 2.7, 3.4, 3.5, 3.6

  • mixbox >= v1.0.1

  • python-stix >= v1.2.0.2

  • python-cybox >= 2.1.0.13

NOTE Version 1.0.1 of openioc-to-stix requires python-stix < 1.2.0.0, python-cybox 2.1.0.12, and does not require mixbox.

Installation

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 site-packages and PATH by using pip:

$ cd /path/to/cloned/openioc-to-stix/repo/
$ pip install .

Usage

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.

Package Contents

  • 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.

  • LICENSE.txt: Terms of use for this script.

  • examples/*.xml: Sample input and output XML files.

TERMS

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

openioc_to_stix-1.4.0-py2.py3-none-any.whl (28.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page