{ "info": { "author": "Rich Piazza", "author_email": "rpiazza@mitre.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "|Build_Status| |Coverage| |Version|\n\ncti-stix-elevator\n=================\n\nNOTE: This is an `OASIS TC Open\nRepository `_.\nSee the `Governance`_ section for more information.\n\nThe stix2-elevator is a software tool for converting STIX 1.x XML to\nSTIX\n2.0 or 2.1 JSON. Due to the differences between STIX 1.x and STIX 2.x, this\nconversion is best-effort only. During the conversion, stix2-\nelevator\nprovides information on the assumptions it needs to make to produce\nvalid STIX\n2.x JSON, and what information was not able to be converted.\n\nTo convert STIX 2.x JSON back to STIX 1.x XML use the `stix2-slider`\n\nThe stix2-elevator is a work-in-progress. It should be used to explore\nhow existing STIX 1.x would potentially be represented in STIX 2.x.\nUsing the current version of the elevator will provide insight to\nissues\nthat might need to be mitigated to convert your STIX 1.x content.\n\n**It should not be used in a production environment, and should not be\nconsidered final.**\n\n**STIX 1.x Composite Indicator Expressions and CybOX 2.x Composite\nObservable Expressions allow a level of flexibility not present in\nSTIX\n2 patterns. These composite expressions can frequently have ambiguous\ninterpretations, so STIX 2 Indicators created by the stix2-elevator\nfrom\nSTIX 1.x Indicators containing composite expressions should be\ninspected\nto ensure the STIX 2 Indicator has the intended meaning.**\n\nFor more information, see `the\ndocumentation `__ on\nReadTheDocs.\n\nPlease enter any comments on how to improve it into the issue tracker.\n\nRequirements\n------------\n\n- Python 2.7, or 3.4+\n- `python-stix `_ and its dependencies\n\n .. note::\n\n Make sure to use either the latest version of python-stix 1.1.1.x or\n 1.2.0.x, depending on whether you want to support STIX 1.1.1 or STIX 1.2.\n\n- `python-stix2 `_ >= 0.5.1\n- `stix2-validator `_ >= 2.0.0.dev1\n and its dependencies\n- `pycountry `_ >= 1.20\n- `stixmarx `_ >= 1.0.3\n\nInstallation\n------------\n\nInstall with pip::\n\n $ pip install stix2-elevator\n\nThis will install all necessary dependencies, including the latest\nversion of\npython-stix.\n\nIf you need to support older STIX 1.1.1 content, install python-stix\n1.1.1.x\nfirst::\n\n $ pip install 'stix<1.2'\n $ pip install stix2-elevator\n\nYou can also install the stix2-elevator from GitHub to get the latest\n(unstable)\nversion::\n\n $ pip install git+https://github.com/oasis-open/cti-stix-elevator.git\n\nUsage\n-----\n\nIt is recommended that you insure that the input STIX 1.x file is\nvalid before submitting it to the elevator.\nUse the `stix-validator `_.\n\nAs A Script\n~~~~~~~~~~~\n\nThe elevator comes with a bundled script which you can use to elevate\nSTIX 1.1.1 - 1.2.1 content to STIX 2.0 or 2.1 content::\n\n $ stix2_elevator\n usage: stix2_elevator [-h] [--incidents] [--no-squirrel-gaps]\n [--package-created-by-id PACKAGE_CREATED_BY_ID]\n [--default-timestamp DEFAULT_TIMESTAMP]\n [--validator-args VALIDATOR_ARGS] [-e ENABLE] [-d DISABLE] [-s]\n [--message-log-directory MESSAGE_LOG_DIRECTORY]\n [--log-level {DEBUG,INFO,WARN,ERROR,CRITICAL}]\n [-m MARKINGS_ALLOWED] [-p {no_policy,strict_policy}]\n [-v VERSION]\n file\n\nstix2-elevator v2.0.1\n\nThe stix2-elevator is a work-in-progress. It should be used to explore how\nexisting STIX 1.x would potentially be represented in STIX 2.x. Using the\ncurrent version of the stix2-elevator will provide insight to issues that might need\nto be mitigated to convert your STIX 1.x content.\n\npositional arguments:\n file The input STIX 1.x document to be elevated.\n\noptional arguments:\n -h, --help show this help message and exit\n\n --incidents Incidents will be included in the conversion.\n\n --no-squirrel-gaps Do not include STIX 1.x content that cannot be\n represented directly in STIX 2.x using the description\n property.\n\n --infrastructure Infrastructure will be included in the conversion.\n\n --package-created-by-id PACKAGE_CREATED_BY_ID\n Use provided identifier for \"created_by_ref\"\n properties. Example: --package-created-by-id \"identity\n --1234abcd-1a12-12a3-0ab4-1234abcd5678\"\n\n --default-timestamp DEFAULT_TIMESTAMP\n Use provided timestamp for properties that require a\n timestamp. Example: --default-timestamp\n \"2016-11-15T13:10:35.053000Z\"\n\n --validator-args VALIDATOR_ARGS\n Arguments to pass to stix-validator. Default:\n --strict-types Example: stix2_elevator.py \n --validator-args=\"-v --strict-types -d 212\"\n\n -e ENABLE, --enable ENABLE\n A comma-separated list of the stix2-elevator messages\n to enable. If the --disable option is not used, no\n other messages will be shown. Example:\n stix2_elevator.py --enable 250\n\n -d DISABLE, --disable DISABLE\n A comma-separated list of the stix2-elevator messages\n to disable. Example: stix2_elevator.py \n --disable 212,220\n\n -s, --silent If this flag is set, all stix2-elevator messages will\n be disabled.\n\n --message-log-directory MESSAGE_LOG_DIRECTORY\n If this flag is set, all stix2-elevator messages will\n be saved to file. The name of the file will be the\n input file with extension .log in the specified\n directory. Note, make sure the directory already\n exists. Example: stix2_elevator.py --message-\n log-directory \"..\\logs\"\n\n --log-level {DEBUG, INFO, WARN, ERROR, CRITICAL}\n The logging output level.\n\n -m MARKINGS_ALLOWED, --markings-allowed MARKINGS_ALLOWED\n Avoid error exit, if these markings are in the\n content, but not supported by the elevator. Specify as\n a comma-separated listExample: stix2_elevator.py <\n file > --markings-allowed\n \"ISAMarkingsAssertion,ISAMarkings\"\n\n -p, --policy {no_policy,strict_policy} The policy to deal with errors\n\n -v, --version VERSION\n The version of stix 2 to be produced\n\n Default: 2.0\n\nRefer to elevator_log_messages.rst for all stix2-elevator messages. Use the\nassociated code number to --enable or --disable a message. By default, the\nstix2-elevator displays all messages. Note: disabling the message does not\ndisable the functionality.\n\nAs A Library\n~~~~~~~~~~~~\n\nYou can also use this library to integrate STIX elevation into your\nown\ntools. You can elevate a STIX 1.x file::\n\n from stix2elevator import elevate_file\n from stix2elevator.options import initialize_options\n\n intialize_options()\n results = elevate_file(\"stix_file.xml\")\n print(results)\n\nAdditionally, a similar method exists to accept a string as an\nargument::\n\n from stix2elevator import elevate_string\n from stix2elevator.options import initialize_options\n\n intialize_options()\n results = elevate_string(\"...\")\n print(results)\n\nTo set options, use set_option_value, found in options.py\n\nUsing the stepper\n~~~~~~~~~~~~~~~~~\n\nThe stix-stepper is a simple script that will convert STIX 2.0 content to STIX 2.1 content.\n\nYou can invoke it as follows::\n\n $ stix_stepper <2.0 file>\n\nThe 2.1 content is printed to stdout\n\nGovernance\n----------\n\nThis GitHub public repository (\n**https://github.com/oasis-open/cti-stix-elevator** ) was\n`proposed `__\nand\n`approved `__\n[`bis `__] by the\n`OASIS Cyber Threat Intelligence (CTI)\nTC `__ as an `OASIS TC\nOpen Repository `__\nto support development of open source resources related to Technical\nCommittee work.\n\nWhile this TC Open Repository remains associated with the sponsor TC,\nits\ndevelopment priorities, leadership, intellectual property terms,\nparticipation rules, and other matters of governance are `separate and\ndistinct `__\nfrom the OASIS TC Process and related policies.\n\nAll contributions made to this TC Open Repository are subject to open\nsource license terms expressed in the `BSD-3-Clause\nLicense `__.\nThat license was selected as the declared `\"Applicable\nLicense\" `__\nwhen the TC Open Repository was created.\n\nAs documented in `\"Public Participation\nInvited `__\",\ncontributions to this OASIS TC Open Repository are invited from all\nparties, whether affiliated with OASIS or not. Participants must have\na\nGitHub account, but no fees or OASIS membership obligations are\nrequired. Participation is expected to be consistent with the `OASIS\nTC Open Repository Guidelines and\nProcedures `__,\nthe open source\n`LICENSE `__\ndesignated for this particular repository, and the requirement for an\n`Individual Contributor License\nAgreement `__\nthat governs intellectual property.\n\nMaintainers\n~~~~~~~~~~~\n\nTC Open Repository\n`Maintainers `__\nare responsible for oversight of this project's community development\nactivities, including evaluation of GitHub `pull\nrequests `__\nand\n`preserving `__\nopen source principles of openness and fairness. Maintainers are\nrecognized and trusted experts who serve to implement community goals\nand consensus design preferences.\n\nInitially, the associated TC members have designated one or more\npersons\nto serve as Maintainer(s); subsequently, participating community\nmembers\nmay select additional or substitute Maintainers, per `consensus\nagreements `__.\n\n**Current Maintainers of this TC Open Repository**\n\n- `Chris Lenk `__; GitHub ID:\n https://github.com/clenk/; WWW: `MITRE `__\n- `Rich Piazza `__; GitHub ID:\n https://github.com/rpiazza/; WWW: `MITRE\n `__\n\nAbout OASIS TC Open Repositories\n--------------------------------\n\n- `TC Open Repositories: Overview and\n Resources `__\n- `Frequently Asked\n Questions `__\n- `Open Source\n Licenses `__\n- `Contributor License Agreements\n (CLAs) `__\n- `Maintainers' Guidelines and\n Agreement `__\n\nFeedback\n--------\n\nQuestions or comments about this TC Open Repository's activities\nshould be\ncomposed as GitHub issues or comments. If use of an issue/comment is\nnot\npossible or appropriate, questions may be directed by email to the\nMaintainer(s) `listed above <#currentMaintainers>`__. Please send\ngeneral questions about TC Open Repository participation to OASIS\nStaff at\nrepository-admin@oasis-open.org and any specific CLA-related questions\nto repository-cla@oasis-open.org.\n\n.. |Build_Status| image:: https://travis-ci.org/oasis-open/cti-stix-elevator.svg?branch=master\n :target: https://travis-ci.org/oasis-open/cti-stix-elevator\n.. |Coverage| image:: https://codecov.io/gh/oasis-open/cti-stix-elevator/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/oasis-open/cti-stix-elevator\n.. |Version| image:: https://img.shields.io/pypi/v/stix2-elevator.svg?maxAge=3600\n :target: https://pypi.org/project/stix2-elevator/\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/oasis-open/cti-stix-elevator", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "stix2-elevator", "package_url": "https://pypi.org/project/stix2-elevator/", "platform": "", "project_url": "https://pypi.org/project/stix2-elevator/", "project_urls": { "Homepage": "https://github.com/oasis-open/cti-stix-elevator" }, "release_url": "https://pypi.org/project/stix2-elevator/2.0.1/", "requires_dist": [ "pycountry (>=1.17.8)", "stix (>=1.1.1.9,<1.2.1.0)", "stix2-validator (>=2.0.0.dev1)", "stixmarx (>=1.0.3)", "six (>=1.10.0)", "stix2", "bumpversion; extra == 'dev'", "pre-commit; extra == 'dev'", "sphinx; extra == 'docs'", "coverage; extra == 'test'", "pytest; extra == 'test'", "pytest-cov; extra == 'test'", "tox; extra == 'test'" ], "requires_python": "", "summary": "Utilities to upgrade STIX and CybOX content to 2.0", "version": "2.0.1" }, "last_serial": 4704671, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "3e0e07643023aaca2cac0e42f6b81846", "sha256": "a8cd947a54d4ce476cf6299796ae2e9c54778c90f4518fb26cda021e3994d26c" }, "downloads": -1, "filename": "stix2_elevator-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3e0e07643023aaca2cac0e42f6b81846", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 47480, "upload_time": "2017-02-03T19:56:20", "url": "https://files.pythonhosted.org/packages/06/5c/f1d3e67e185809992b96d25f36c6f54ce8bc3549596ee580e295088c5248/stix2_elevator-0.2.0-py2.py3-none-any.whl" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "c1c8d61abf3451373ee20a9e79df91e1", "sha256": "da2cf1d779b88340b18667a30d555db3adb568a3d63b297bdbc306bb22c54936" }, "downloads": -1, "filename": "stix2_elevator-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "c1c8d61abf3451373ee20a9e79df91e1", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 56124, "upload_time": "2017-05-30T15:50:20", "url": "https://files.pythonhosted.org/packages/01/07/2c274dd508c22e68d3fc715ca1bbf29d386e2862a00c1daafcf55232477f/stix2_elevator-1.0.0-py2.py3-none-any.whl" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "d908ad1f4c38c937636eaac2ca3e1ddf", "sha256": "ce8825724d70704ba84f7a0cf9a387a5775603aaefac4992d35e7738e1b00d8f" }, "downloads": -1, "filename": "stix2_elevator-1.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d908ad1f4c38c937636eaac2ca3e1ddf", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 59443, "upload_time": "2018-03-23T16:43:32", "url": "https://files.pythonhosted.org/packages/f1/2d/6e771a1f8d6773118a9c14d07edbaaf6cbab8b4433891f645f83c21a79d9/stix2_elevator-1.1.0-py2.py3-none-any.whl" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "f4caeaa87b279b80abc8a5bfe497b27c", "sha256": "c6bd486426f6983f6ddfed52cabd5c20fbc733bc92387dc6c2a1d0cae9bf8723" }, "downloads": -1, "filename": "stix2_elevator-1.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f4caeaa87b279b80abc8a5bfe497b27c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 60171, "upload_time": "2018-04-04T19:00:51", "url": "https://files.pythonhosted.org/packages/8c/df/29723ed9bcf5b581b2a113fcc9dd732fbed84eeda9fe7069b6a199ad965b/stix2_elevator-1.1.1-py2.py3-none-any.whl" } ], "1.1.2": [ { "comment_text": "", "digests": { "md5": "d802462a4f3c64efa5becf690137436b", "sha256": "0763f488daaddd07c798ac10a5f2ed8617b236a03d9e26a8fff677fc9f2a987f" }, "downloads": -1, "filename": "stix2_elevator-1.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d802462a4f3c64efa5becf690137436b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 60925, "upload_time": "2018-06-01T17:01:22", "url": "https://files.pythonhosted.org/packages/69/09/859b2d8d99cf7d2c2c130eedda654670062065b9791abc8f58f22578c45d/stix2_elevator-1.1.2-py2.py3-none-any.whl" } ], "1.1.3": [ { "comment_text": "", "digests": { "md5": "2d76e2564b953d86d7d11c4c652ef3cb", "sha256": "98804adeecb2243d68a1d5c5b10282386e657ecb5857dd42734e31d52a38fe28" }, "downloads": -1, "filename": "stix2_elevator-1.1.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "2d76e2564b953d86d7d11c4c652ef3cb", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 61367, "upload_time": "2018-06-15T16:16:58", "url": "https://files.pythonhosted.org/packages/55/dd/094280bc8cd4f54d5c829e732f922e6c872703fa5d0e4f78d920b3ed15bb/stix2_elevator-1.1.3-py2.py3-none-any.whl" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "472bfb0e641912977c0469b2a5fc8cee", "sha256": "903728cb638b5dbd2e69dae456562505728e2aea24dd85232bc63a7d3afa07f3" }, "downloads": -1, "filename": "stix2_elevator-1.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "472bfb0e641912977c0469b2a5fc8cee", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 66610, "upload_time": "2018-09-08T19:44:46", "url": "https://files.pythonhosted.org/packages/7c/c2/4e931e84b553cbd3c8d4e515d7b02be17e7458b3cdf4f061660003fba347/stix2_elevator-1.2.0-py2.py3-none-any.whl" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "4d6a4eaa02f80613b0aa8f378eeeb436", "sha256": "2932cbc3983d1916004b5fae53393096ebd09643a776476a8fdd35a0b2b5cc52" }, "downloads": -1, "filename": "stix2_elevator-2.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "4d6a4eaa02f80613b0aa8f378eeeb436", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 72736, "upload_time": "2019-01-04T20:21:53", "url": "https://files.pythonhosted.org/packages/e3/5b/e8452243234f6183f33ab19e096a9269244185bc25418fc94fc9e7734bc2/stix2_elevator-2.0.0-py2.py3-none-any.whl" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "82a01dc90bc93eb28b391a3e3e6c7fcf", "sha256": "54520514360c8d221e74ac9761b35873f7e33b3d3fe4c8695c54c32100d97492" }, "downloads": -1, "filename": "stix2_elevator-2.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "82a01dc90bc93eb28b391a3e3e6c7fcf", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 72773, "upload_time": "2019-01-16T18:32:19", "url": "https://files.pythonhosted.org/packages/a5/9d/426f50335e8a7155d1640fd4c4e85aa1fdf5f914ceb8c0b515c318bc094a/stix2_elevator-2.0.1-py2.py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "82a01dc90bc93eb28b391a3e3e6c7fcf", "sha256": "54520514360c8d221e74ac9761b35873f7e33b3d3fe4c8695c54c32100d97492" }, "downloads": -1, "filename": "stix2_elevator-2.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "82a01dc90bc93eb28b391a3e3e6c7fcf", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 72773, "upload_time": "2019-01-16T18:32:19", "url": "https://files.pythonhosted.org/packages/a5/9d/426f50335e8a7155d1640fd4c4e85aa1fdf5f914ceb8c0b515c318bc094a/stix2_elevator-2.0.1-py2.py3-none-any.whl" } ] }