Nothing Special   »   [go: up one dir, main page]

Skip to content

为H3C交换机封装了一层北向接口, 以RESTful的方式提交JSON数据以操作交换机,像一个简易的SDN控制器

License

Notifications You must be signed in to change notification settings

hongfeioo/SwitchConfigApi

Repository files navigation

SwitchConfigApi

简介

  1. 本程序为H3C交换机封装了一层北向接口, 用户可以通过RESTful的方式向接口提交JSON, 本程序会解析JSON内容,然后模拟登录交换机执行相应的命令。
  2. 本程序只演示向交换机写入和删除路由的操作。
  3. 已测试的设备有H3C S5120-48C-HI ,H3C S5500 ,H3C S6800-4C
  4. 更多参数设置查看帮助: SwitchConfigApi --help

Fire Up

启动接口服务
 ./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

client提交的JSON举例


[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   删除路由命令

安全机制

  1. 客户端需要有合法的Http头验证,这个验证字符串是在本程序启动的时候生产,客户端必须使用这个特定字符串才能正确调用接口,可通过参数自定义头验证。
  2. 客户端JSON中包含的交换机密码, 目前采用:base64(真实密码)加密, 如果你觉得不安全可以自行修改。
  3. 服务端启动接口的时候可以定义并发数量,控制同一时间操作交换机的client数量。
  4. 客户端提交的CLI命令,必须通过正则验证, 避免误操作。

centos7创建服务

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

TODO

  1. 服务端可以对client的HOSTIP进行验证,防止非法ip调用。

开发环境

golang 1.8

作者介绍

yihongfei QQ:413999317

CCIE 38649

寄语

为网络自动化运维尽绵薄之力,每一个网工都可以成为NetDevOps

About

为H3C交换机封装了一层北向接口, 以RESTful的方式提交JSON数据以操作交换机,像一个简易的SDN控制器

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published