用于将 STIX 格式的结果和查询转换为不同的数据源格式并设置适当的连接字符串以在 openwhisk 中调用和触发操作的工具和界面
项目描述
加入我们的松弛!
单击此处并填写表格以接收开放网络安全联盟 slack 实例的邀请,然后加入#stix-shifter 频道,与团队会面并讨论使用情况。
介绍网络研讨会!
单击此处查看关于 STIX Shifter 的介绍网络研讨会及其解决的用例。
介绍
STIX-shifter 是一个开源 python 库,允许软件通过使用 STIX 模式连接到包含数据存储库的产品,并将结果作为 STIX 观察返回。
有关此项目的更多信息,请参阅STIX-shifter 概述
依赖项
此 stix-shifter 具有以下依赖项:
- stix2-模式==1.3.0
- stix2-validator==1.1.2
- stix2-matcher==1.0.0
- antlr4-python3-runtime==4.8
- python-dateutil==2.8.1
您的开发环境必须使用 Python 版本:3.6、3.7、3.8 或 3.9
安装
安装 STIX-shifter 的推荐方法是通过 pip。需要安装两个必备软件包,包括 stix-shifter 连接器模块的软件包,以完成 stix-shifter 连接器的安装。运行以下命令以安装所有软件包-
-
主要的 stix-shifter 包:
pip install stix-shifter
-
Stix-shifter 实用程序包:
pip install stix-shifter-utils
-
所需的 stix-shifter 连接器模块封装:
pip install stix-shifter-modules-<module name>
示例:pip install stix-shifter-modules-qradar
用法
作为命令行实用程序
STIX-Shifter 附带一个捆绑脚本,您可以使用该脚本将 STIX 模式转换为本地数据源查询。它还可用于将 JSON 数据源查询结果转换为可观察对象的 STIX 包。您还可以使用传输选项将查询发送到数据源。
$ stix-shifter translate <MODULE NAME> query "<STIX IDENTITY OBJECT>" "<STIX PATTERN>" "<OPTIONS>"
例子:
$ stix-shifter translate qradar query {} "[ipv4-addr:value = '127.0.0.1']" {}
为了stix-shifter
从源代码构建包,请遵循以下先决条件:
- 转到 stix-shifter 父目录
- 或者,您可以创建 Python 3 虚拟环境:
virtualenv -p python3 virtualenv && source virtualenv/bin/activate
- 运行安装程序:
python3 setup.py install
从源头运行
您也可以使用python3 main.py
脚本。所有选项都与上面的“作为命令行实用程序”用法相同。
例子:
python3 main.py translate qradar query {} "[ipv4-addr:value = '127.0.0.1']" {}
为了python3 main.py
从源代码运行,请遵循以下先决条件:
- 转到 stix-shifter 父目录
- 或者,您可以创建 Python 3 虚拟环境:
virtualenv -p python3 virtualenv && source virtualenv/bin/activate
- 运行安装程序以安装依赖项:
INSTALL_REQUIREMENTS_ONLY=1 python3 setup.py install
.
注意: setup.py 仅在使用 INSTALL_REQUIREMENTS_ONLY=1 指令时安装依赖项。此选项类似于python3 generate_requirements.py && pip install -r requirements.txt
作为图书馆
您还可以使用此库将 STIX Shifter 集成到您自己的工具中。您可以翻译 STIX 模式:
from stix_shifter.stix_translation import stix_translation
translation = stix_translation.StixTranslation()
response = translation.translate('<MODULE NAME>', 'query', '{}', '<STIX PATTERN>', '<OPTIONS>')
print(response)
贡献
我们很高兴您正在考虑做出贡献!我们欢迎所有贡献者。
请阅读我们的贡献指南。
开发者指南
如果您想为 STIX-shifter 创建新的连接器,请参阅开发人员指南
还有一些Jupyter Notebook 实验室涵盖了 CLI 命令和开发过程。
许可
根据 Apache 许可证 2.0 版(“许可证”)获得许可;除非遵守许可,否则您不得使用此文件。您可以在以下网址获取许可证的副本
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则根据许可分发的软件将按“原样”分发,没有任何明示或暗示的保证或条件。有关许可下的特定语言管理权限和限制,请参阅许可。
更多资源
项目详情
stix_shifter_modules_synchronous_template -4.3.1-py2.py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | f55e03596d2f7a799f79ec53beae5df52ba53e04e599ac628f49302a0a742a7d |
|
MD5 | 4373ee43d92e6d5ed7169c36bae87968 |
|
布莱克2-256 | 6ac5978c34a9bbbe7a5edef7487af859ea8e358baf1de6c909c11cafcfd0eb2e |