stix-validator 3.0.0

Validation

The STIX Document Validator (sdv) can perform the following forms of STIX document validation:

• STIX XML Schema: Validate STIX documents against bundled or external STIX schemas.

• STIX Profiles: Verify STIX Profile conformance (experimental)

• STIX Best Practices: Verify alignment with STIX Best Practices.

The following forms of CybOX document validation are also possible:

• CybOX XML Schema

Dependencies

The STIX Document Validator has the following dependencies:

• Python: Python interpreter

• lxml >= v3.2.0: XML processing library.

  • libxml2 >= v2.9.1: Required XML processing C library for lxml.

• xlrd >= v0.9.2: XLSX library for parsing STIX Profiles.

For a Windows installer of lxml, we recommend looking here: http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml

The STIX Document Validator supports Python 3.8+.

Installation

The recommended method for installing the STIX Document Validator is via pip.

$ pip install stix-validator

This will install the sdv package into your Python installation’s site-packages and four scripts found under sdv/scripts on your PATH.

How To Use

The STIX Document Validator bundles four scripts: stix_validator.py, profile_to_sch.py, profile_to_xslt.py, and cybox_validator.py,

$ stix-validator <stix_document.xml>

$ stix-validator --use-schemaloc <stix_document.xml>

$ stix-validator --schema-dir </path/to/schemas> <stix_document.xml>

$ stix-validator </path/to/stix_dir>

$ stix-validator <one.xml> <two.xml> <directory_of_files> ...

$ stix-validator --best-practices <stix_document.xml>

$ stix-validator --profile <stix_profile.xlsx> <stix_document.xml>

$ profile-to-sch <valid_stix_profile.xlsx>

$ profile-to-xslt <valid_stix_profile.xlsx>

$ cybox-validator <cybox_document.xml>

$ cybox-validator --use-schemaloc <cybox_document.xml>

$ cybox-validator --schema-dir </path/to/schemas> <cybox_document.xml>

$ cybox-validator </path/to/cybox_dir>

$ cybox-validator <one.xml> <two.xml> <directory_of_files> ...

All STIX and CybOX Documents?

The STIX Document Validator bundles XML schemas with it, which includes all STIX (v1.0 through v1.2.1) and CybOX (2.0 through v2.1) schema files. If a document includes instances of schematic constructs defined outside of the STIX or CybOX languages, a user must point the STIX Document Validator scripts at those schemas in order to validate.

To use schemas other than those bundled with the STIX Document Validator use the --schemas-dir flag to pass in a path to a schema directory.

Common Libxml2 Error

Users often report an error which looks something like the following:

Fatal error occurred: local union type: A type, derived by list or union, must have the
simple ur-type definition as base type, not '{http://cybox.mitre.org/common-2}(NULL)'., line 350

This error is caused by an insufficient version of libxml2 being installed on the system. The STIX Document Validator requires libxml2 v2.9.1 at a minimum and is not guaranteed to work properly with earlier versions.

To see what version of libxml2 you have installed, execute the xml2-config --version command and make sure you are running at least v2.9.1.

Terms

BY USING THE STIX DOCUMENT VALIDATOR, YOU SIGNIFY YOUR ACCEPTANCE OF THE TERMS AND CONDITIONS OF USE. IF YOU DO NOT AGREE TO THESE TERMS, DO NOT USE THE STIX DOCUMENT VALIDATOR.

For more information, please refer to the LICENSE.txt file