taxii2-client 0.5.0

CTI TAXII客户端< /H2>

注意：这是一张OASIS TC Open Repository。见 Governance部分了解更多信息。

为客户端2服务器提供了一个最小客户端实现。 它支持以下Taxii 2.0 API服务：

• 服务器发现
• 获取API根信息
• 获取状态
• 获取收藏
• 收藏
• 获取对象
• 添加对象
• 获取对象
• 获取对象清单

安装

安装taxii客户端的最简单方法是使用pip:

$ pip install taxii2-client

使用量

taxi客户机打算用作python库。没有 此时的命令行客户端。

taxii2-client提供四个类：

• Server
• ApiRoot
• Collection
• Status

每个都可以通过传递url，和（可选的）user和 password参数。授权信息存储在实例中， 所以在请求服务时不需要显式地提供它。

fromtaxii2clientimportServerserver=Server('https://example.com/taxii/',user='user_id',password='user_password')

一旦实例化了Server对象，就可以获取 其内容通过其属性：

print(server.title)

这将在实例中懒洋洋地加载和缓存服务器信息：

• api_roots
• title
• description
• default（即默认的api根）
• contact

您可以遵循对ApiRoot对象的引用， Collection对象，以及那些集合中的（stix）对象。

api_root=server.api_roots[0]collection=api_root.collections[0]collection.add_objects(stix_bundle)

每个ApiRoot都有与其元数据对应的属性

• title
• description
• max_content_length
• collections

每个Collection都有与其元数据对应的属性：

• id
• title
• description
• can_write
• can_read
• media_types

也可以直接实例化Collection：

fromtaxii2clientimportCollectioncollection=Collection('https://example.com/api1/collections/91a7b528-80eb-42ed-a74d-c6fbd5a26116')collection.get_object('indicator--252c7c11-daf2-42bd-843b-be65edca9f61')

除了对象特定的属性和方法之外，所有类都有 refresh()方法，它重新加载与该资源对应的url，以 确保属性具有最新的值。

治理

这个github公共存储库（ 在请求中创建了{STR 1 } $http://GITHUB.COM/OASIS OPEN/CTI TAXII客户端<强> > 将OASIS Cyber Threat Intelligence (CTI) TC作为OASIS TC Open Repository来支持 开发与技术委员会工作相关的开源资源。

虽然这个tc开放存储库仍然与发起tc相关联，但是 发展优先事项、领导、知识产权条款、参与 规则和其他治理事项是separate and distinct 从绿洲tc进程及相关政策。

对这个tc开放存储库的所有贡献都受开源的约束 在BSD-3-Clause License中表示的许可条款。 当 已创建TC打开存储库。

如“Public Participation Invited所述， 所有各方都邀请了对这个oasis tc开放存储库的贡献， 不管是否属于绿洲。参与者必须有一个github帐户， 但不需要任何费用或OASIS会员义务。参与是 应与OASIS TC Open Repository Guidelines and Procedures一致，打开 源LICENSE 指定用于此特定存储库，以及 Individual Contributor License Agreement 它支配着知识产权。

维护人员

tc打开存储库Maintainers 负责监督该项目的社区发展 活动，包括对githubpull requests的评估 以及preserving 公开和公平的开源原则。维修人员得到认可 为实现社区目标和共识设计服务的可信专家 偏好。

最初，相关的技术合作委员会成员已指定一名或多名人员 作为维护者；随后，参与社区成员可以选择 附加或替代维修容器，根据consensus agreements。

此TC开放存储库的当前维护者

• Chris Lenk；github id: https://github.com/clenk/；网址：MITRE Corporation
• Rich Piazza；github id: https://github.com/rpiazza/；www:MITRE Corporation
• Emmanuelle Vargas-Gonzalez；github id: https://github.com/emmanvg/；网址：MITRE Corporation

关于OASIS TC开放存储库

• TC Open Repositories: Overview and Resources
• Frequently Asked Questions
• Open Source Licenses
• Contributor License Agreements (CLAs)
• Maintainers’ Guidelines and Agreement

反馈

关于这个tc开放存储库的活动的问题或评论应该被组成 作为github问题或评论。如果无法使用问题/评论，或 适当的话，问题可以通过电子邮件发送给维护人员listed above。请发送有关open的一般问题 在repository-admin@oasis-open.org和 任何与repository-cla@oasis-open.org相关的特定cla问题。