- 本程序为H3C交换机封装了一层北向接口, 用户可以通过RESTful的方式向接口提交JSON, 本程序会解析JSON内容,然后模拟登录交换机执行相应的命令。
- 本程序只演示向交换机写入和删除路由的操作。
- 已测试的设备有H3C S5120-48C-HI ,H3C S5500 ,H3C S6800-4C
- 更多参数设置查看帮助: SwitchConfigApi --help
启动接口服务
./server.sh
ListenPort:0.0.0.0:8083,AuthKey:admin:admin2,ClientAuthKey:YWRh-WsuYWRh-Wsm,LimitListener:1 // 默认监听8083端口,默认客户端使用YWRh-WsuYWRh-Wsm进行http头验证,默认限制并发为1
client 调用方法
$ curl -d@'setanddel.json' http://127.0.0.1:8083 -H "Authorization: Basic YWRh-WsuYWRh-Wsm" //提交JSON
200
[setanddel.json]
{
"switch_username": "yihf", // ssh登录交换机所用的用户名
"switch_password": "MTIzNDU2Nzg=", // 如果你的交换机密码为12345678,通过命令计算出base64转码的结果 : echo -n "12345678" | base64
"switch_Cmd_level": 2, //选择2为执行命令,选择其它对应的处理函数会有不同可自行开发
"switch_command": "ip route-static 10.201.88.0 255.255.255.0 10.10.88.129;undo ip route-static 10.201.88.0 255.255.255.0 10.10.88.129", //多条命令时,使用分号分割, 这里的举例是写入了一条路由又删了一条
"switch_ipandport": "10.10.100.20:22", // 交换机IP+port
"switch_timeout": 10 // 超时时间设置
}
1: 静态路由配置中包含查询的路由
0: 静态路由配置中不包含查询的路由
200: 命令没有报错。
400: 命令不识别
401: 操作的路由不存在
404 : body 或者认证头部不存在
511: 头部认证失败
300 : json串解析失败
301 : 命令不合规, 包含了level1 和level2 两种fail
302 : 未知的cmdlevel数值
303 : switch timeout , user or password fail!
304-309 : cmd_exec 函数执行过程中的错误。
1. 为了确保只有安全的命令才会被提交,checkCmd函数有严格的正则表达式过滤.
2. 本例只允许两种命令可以被执行
ip route-static 10.XXX.XXX.XXX 255.255.255.0 XXX.XXX.XXX.XXX 增加路由命令
undo ip route-static 10.XXX.XXX.XXX 255.255.255.0 XXX.XXX.XXX.XXX 删除路由命令
- 客户端需要有合法的Http头验证,这个验证字符串是在本程序启动的时候生产,客户端必须使用这个特定字符串才能正确调用接口,可通过参数自定义头验证。
- 客户端JSON中包含的交换机密码, 目前采用:base64(真实密码)加密, 如果你觉得不安全可以自行修改。
- 服务端启动接口的时候可以定义并发数量,控制同一时间操作交换机的client数量。
- 客户端提交的CLI命令,必须通过正则验证, 避免误操作。
vi /usr/lib/systemd/system/hongswitchapi.service
[Unit]
Description=api of switch
After=network.target
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/home/workspace/src/SwitchConfigApi/SwitchConfigApi -log_dir=/home/workspace/src/SwitchConfigApi/log //程序目录请自行修改
Restart=on-failure
[Install]
WantedBy=multi-user.target
systemctl start hongswitchapi.service
systemctl enable hongswitchapi.service
- 服务端可以对client的HOSTIP进行验证,防止非法ip调用。
golang 1.8
yihongfei QQ:413999317
CCIE 38649
为网络自动化运维尽绵薄之力,每一个网工都可以成为NetDevOps