kvasir的python api
KvasirA的Python项目详细描述
与Kvasir通信的python api。
目前只支持jsonrpc api。restful api正在进行中。
功能
- 允许第三方工具与多个kvasir实例通信
- 生成可用于报告的内容
- 扩展python脚本以访问或更新kvasir数据
安装
使用pip安装:
$ pip install KvasirAPI
或者使用github的出血边缘:
$ git clone https://github.com/KvasirSecurity/kvasirapi-python $ cd kvasirapi-python $ python setup.py install
用法
创建一个yaml配置文件:
customer: id: 11-ACME-01 full-name: ACME Widgets, Inc. short-name: ACME possessive: ACME Widget, Inc's short-capital: ACME possessive-capital: ACME's instances: test: url: "http://test:test@localhost:8000/kvasir/" name: Test Network test_type: internal start: May 2, 2011 end: May 6, 2011
加载API模块:
$ python >>> import KvasirAPI >>> kvasir = KvasirAPI.API('config.yml')
访问api函数:
>>> kvasir.configuration.customer_info() {'short-name': 'ACME', 'possessive': "ACME Widget, Inc's", 'full-name': 'ACME Widgets, Inc.', 'short-capital': 'ACME', 'id': '11-ACME-01', 'possessive-capital': "ACME's"} >>> kvasir.configuration.instances() {'test': {'end': 'May 6, 2011', 'name': 'Test Network', 'url': 'http://test:test@localhost:8000/kvasir/', 'test_type': 'internal', 'hostfilter': {}, 'start': 'May 2, 2011'}} >>> kvasir.call.test.hosts.list()
贡献
- 从github上的repository分叉
- 从master创建一个分支并将您的更改提交给它。
- 确保使用 格式Name <email@domain.com> (url),其中(url)部分是 可选。
- 向github上的主分支提交请求。