本篇目的是说明防火墙配置的采集方案,实际上适用于所有网络设备,并且具体举例时,也可能会用其他设备说明。
采集通过paramiko,采用invoke_shell模式
1,SSH登录设备采集数据场景分类
通过SSH登录设备,执行命令时,根据设备表现情况不同,分为“需要交互”和“无需交互”两类。
“无需交互”:采集机单向推送命令后,监听并接收对端设备发回的内容即可
“需要交互”:采集机推送命令后,需要等待对端设备发回的内容,收到特定内容后,再次发送其他命令
2,无需交互
所有思科设备,新版本华为防火墙,junper防火墙等均属于“无需交互”
即采集配置命令时,只需要单向无脑推送。
对于常见的“More”确认,可以通过“取消分屏” 的命令,避免交互。
例如:华为(screen-length 0),思科IOS交换机/路由器(terminal length 0),思科防火墙(terminal pager 0),天融信防火墙(show nostop),juniper防火墙(set cli screen-length 0 )
以思科设备为例,采集机单向推送如下命令(假设enable密码为cisco789),同时另起一个线程接收防火墙发回的信息,即可完成配置收集:
enable
cisco789
conf t
terminal pager 0
show run
exit
3,需要交互
需要交互的设备,根据交互的情况,又可以分为“简单交互”和“复杂交互”
“简单交互”: 推送某条命令后,需要等到对端回送某些特定字符串后,才能继续推送下一条命令,这个”特定字符串“是肯定会出现的
”复杂交互“: 推送某条命令后,需要等到对端回送某些特定字符串后,返回的字符串出现次数,和出现情况是不可预估的
3.1,简单交互
典型的“简单交互”场景,是有些设备在退出时,需要有个确认
例如老版本的天融信防火墙,输入exit后,需要等待如下字符串后再次输入y:
Save system config?[Y/N]:
新版本的天融信防火墙,输入exit后,需要等待如下字符串后再次输入y:
Save system config?[y/n]:
还有些设备,再保存save时,同样会有回显进行确认
3.2,复杂交互
复杂交互的典型场景,如:
1)不支持取消分屏的设备
老版本的华为防火墙,以及新版本的trx防火墙(没看错,trx墙更新后居然不支持show nostop)等
这些设备在采集时,会回送"---More----"之类的字符串,要求确认后,再回送后续配置,代码中发送一个"\n"即可,但是这个“---More---”出现的次数是不可预估的
2)输入命令后,回显的内容不确定
例如思科光纤交换机,enhance模式,做完配置,需要等待几秒再commit,如果等待时间不够,可能会出现"...in progress"(大致)字符串,commit失败
此时需要过几秒再次发起commit
4,采集脚本设计
脚本采用paramiko
主线程负责发送命令
子线程负责接收设备回收的内容,回收内容保存在全局变量中(有交互的场景,需要主线程去读取回收内容)
发送命令设计为字典列表,每个字典包含的key-value说明如下:
key:"cmd", value:需要推送的一组命令,多条命令以"\n"分割
key: "expect", value:需要等待对端设备回送的内容,如果等不到就不执行后续的命令
key: "sleep", value:等待时间,发送完本组命令后,sleep x秒后,再发送后一组命令
对于简单交互的场景,比如思科防火墙,不需要指定"expect"和“sleep”,直接无脑单向推送配置即可完成采集,例如
[{"cmd": "enable\ncisco789\nterminal pager 0\nshow run\nexit\n"}]
简单交互的场景,比如天融信防火墙,退出时需要指定expect:
[
{"cmd": "show nostop\nexit\n", "expect": "Save system config?[Y/N]: "},
{"cmd": "y\n"}
]
用到sleep参数的,即发送完命令后需要等待几秒再发下一条,映像中目前只有天融信防火墙(保存还是同步时),光交commit时
复杂交互的场景,单靠目前三个参数cmd, expect, sleep无法解决,只能在采集代码中根据实际情况定制
例如可以在发送的一组命令中添加"special_handle"标志,主线程中根据标志进行定制开发,以新版本天融信防火墙为例,由于不支持分屏的防火墙,发送一组命令时:
{"cmd": "show\n", "special_handle": "trx_more"}
主线程可以设置获取到"trx_more"时,去监听接收内容,收到"---More---"后发送"\n"
保存配置时,可以去掉"---More---"
5,其他
有些设备回送的内容会自动换行,表现为在不该换行的地方插入换行\n,例如一条acl策略被自动分割,这样做会影响后续解析。可以在invoke_shell中设置width避免。
但是新版本trx防火墙,不支持宽度设置(老版本支持),只能拿到配置后进行二次处理。
有时遇到过手动ssh登录正常,脚本登录报认证失败,通过在connect()中,设置allow_agent=False, look_for_keys=False,问题解决。