插件工具
该工具旨在用于开发新的或现有插件。
工具
您可以找到列表开源插件要引用，请添加新功能，或修复错误。我们欢迎并鼓励拉出请求！
图标插件
这是开发插件的主要工具。安装说明icon-plugin.可用入门文档。
建造
子命令建造构建插件开发的工件。
争论
图片用于将插件代码打包到Docker映像中，这使其可用于运行。这通常是您在现有插件上工作时要做的第一件事，以确保它成功构建。
1
$ CD Base64.
2
$ icon-plugin构建图像
3.
INFO [0000]构建图像BASE64：1.1.1
4.
info运行命令：docker build - pull -t stave7 / base64：1.1.1。
塔尔巴尔用于构建插件的滑球。这用于在InsightConnect中进行后退兼容的测试。
1
$ CD Base64.
2
$ icon-plugin构建tarball
3.
INFO [0000]建立Tarball Rapid7-Base64-1.1.1.tar.gz
产生
子命令产生创建插件骨架。
它可用于从插件规范生成新插件（插件规范）具有规范的路径作为论据。
icon-plugin生成--regenerate python plugin.spec.yaml
随时修改插件规范，使用子命令产生与之- 再生标志用新的架构重建骨架，而不会影响以前书面代码。这使得添加操作和更新插件规范简单快速。
icon-plugin生成--regenerate python plugin.spec.yaml
Help.md文件是插件中的一个关键部分。这为插件提供了基本信息和用法。在下面运行命令时，帮助将输出到stdout。如果help.md.缺少，使用重定向来帮助.md为帮助创建基础。
帮助例子
| 命令 | 描述 |
|---|---|
icon-plugin生成帮助 |
生成帮助 |
icon-plugin生成帮助> help.md |
帮助重定向 |
您需要样本来测试插件。生成样本时，它将创建一个包含插件所需参数的JSON文件。
样本示例
| 命令 | 描述 |
|---|---|
icon-plugin sample - sample动作或触发名称 |
生成一个样本 |
icon-plugin生成样本 |
生成所有样本 |
跑
子命令跑在版本3.3.0 = 制作。
看看运行插件更多详情请参阅第页。下面是一些例子。
运行示例
| 命令 | 描述 |
|---|---|
icon-plugin运行-c信息 |
显示插件信息 |
icon-plugin运行-r tests / submit.json -j |
在提交JSON测试上执行运行方法 |
icon-plugin运行-r tests / submit.json -a |
在提交JSOS测试文件上执行运行方法，以便在我们的PR中发布开源GitHub存储库 |
icon-plugin运行-t all -r所有-j |
为所有JSON测试执行测试和运行方法 |
HTTP服务器
您也可以在休息模式下与HTTP的插件交互：
icon-plugin运行-c http
然后，您可以使用包含JSON输入作为有效载荷的Web请求来击中其运行或测试端点：
1
curl -d @ tests / forward.json http://127.0.0.1:10001/10.Forward
2
curl -d @ tests / forward.json http://127.0.0.1:10001/127.0.0.1：100101/10/10/10
出口
子命令出口将码头图像导出为一个。柏油您可以导入InsightConnect的文件。此命令的输出是您将导入InsightConnect作为自定义插件以开始使用它。请注意，此命令将在导出之前先构建插件。
1
$ CD Base64.
2
$ icon-plugin导出
3.
info运行命令：docker build - pull -t stave7 / base64：1.1.1。
4.
......
5.
INFO [0010]建筑标签
6.
INFO [0010]运行命令：DOCKER标签RAPIT7 / BASE64：1.1.1 RAPIT7 / BASE64：最新
7.
信息[0010]建筑插件tarball rapt7_base64_1.1.tar
8.
Info Running命令：Docker保存Rapid7 / Base64：1.1.1 -O Rapid7_Base64_1.1.1.tar
杰森到规范
叫做脚本json_to_spec.py.将JSON对象转换为InsightConnect插件规范数据。它需要一个包含JSON作为参数的文件。它位于开源插件repo。
1
$ curl -s https://ifconfig.co/json> ifconfig.json
2
$工具/ json_to_spec.py ifconfig.json
3.
类型：{}
4.
5.
输出：
6.
城市：
7.
描述：输入说明
8.
标题：输入标题
9.
类型：字符串
10.
主机名：
11.
描述：输入说明
12.
标题：输入标题
13.
类型：字符串
14.
知识产权：
15.
描述：输入说明
16.
标题：输入标题
17.
类型：字符串
18.
country_iso：
19.
描述：输入说明
20.
标题：输入标题
21.
类型：字符串
22.
ip_decimal：
23.
描述：输入说明
24.
标题：输入标题
25.
类型：整数
26.
国家：
27.
描述：输入说明
28.
标题：输入标题
29.
类型：字符串
然后，您可以将输出复制并粘贴到插件规格中，而不是必须手动输入它。