华为北向网管NCE开发教程(1)闭坑选接口协议
华为北向网管NCE开发教程(2)REST接口开发
华为北向网管NCE开发教程(3)CORBA协议开发
华为北向网管NCE开发教程(4)(源代码+接口文档+jacorb)
假设你现在要开始华为北向接口REST协议之前,需要准备如环境
1准备工作
1.1环境准备
IP: 北向网管NCE的IP地址
端口: 31943
31945
26335
地址:
https://<IP>:31943 NCE管理系统
https://<IP>:31945 NCE运维系统
https://<IP>:26335 REST服务接口
1.2文档准备
准备如下一系列文档,以下文档不必齐全,其中《用户指南》、《REST API参考》为必须有
版本说明
首先得确定你对接的网管是那个版本,文档版本和NEC的版本最好保持一致,不保持一致,无法保证实际调用接口和接口版本一致
例如通过:登录:https://:31943,可以在NCE管理系统系统中查看你的接口文档版本和实际的NCE系统的版本是否一致。
1.3API测试工具
测试工具就比较简单了,比如postMan等接口测试工具就可以了,假设如果你们的开发电脑不能直接访问北向NCE的话(事实证明,很多情况下,确实不允许你们的开发电脑访问NCE的),只要REST接口也不怕,可以写一个程序,部署到服务器,然后服务器转发HTTP请求到NCE系统。
针对不能直接访问网管NCE的流程如下:
例如我是这样做的:
编写一个SpringBoot程序,集成了swagger,将改程序部署到服务器,然后找一台能访问服务器的电脑,打开我们的wagger接口测试页面。然后我们在这里组织我们请求网管NCE的参数
例如:请求网管NCE的地址、请求方式、请求参数、token。
服务器接收到请求以后,根据swagger提交的参数向网管NCE发起请求。
2配置工作
再次还是提一下,前提条件,能保证REST接口能用起来,否则,我建议你终止,换其他接口
参考《北向REST接口 用户指南》配置REST接口。
2.1检查license
- 访问地址:https://运维面IP地址:31943
- 选择“系统设置”App后,在主菜单中选择“系统设置 > License管理”
- 然后查看License选项中,看license是否可用
- 部分版本的NCE,选择License管理管理,发现只有纯文本介绍,没有license相关的具体内容,可以在右上角的搜索框里面搜索License,那儿可以进去。
- 具体页面的最终效果如下,因为我在写这篇文章的时候,我也没办法访问网管NCE了。
License 要想可用,必须保证 消耗量 / 容量,不能超过百分之20,容量超限百分之20以后,直接不能使用,得加钱!得加钱!得加钱!重要的事说三遍。
消耗量/容量 > 120% ,license将直接不能用
消耗量/容量 < 100% ,license一直可用
100% <消耗量/容量 < 120% ,license只可以在用三个月
2.2配置REST接口
如图所示,在这里可以看到你当前使用的这个版本的NCE在配置NCE的时候,是否有哪些必须配置的
我这个版本中,可以看到除了3.2以外,都是非必选
备注: 3.2也可以非必选,在调用的时候,禁用SSL认证即可。后面会说
备注: 3.6需要注意,某些版本在配置3.6版本时,会弹框提示你,需要启动某某服务,则按照下面的《启动REST接口服务》操作中,去启动该服务即可。
2.3启动REST接口服务
具体操作,我就不多说了,看指南里面操作即可。
2.3创建REST接口服务的用户
详情见操作指南3.9,这一步不是必须,如果已经有这样的用户了,就不用创建,没有的话,还是需要创建
3调试工作
3.1API测试工具调试
3.1.1登录接口
通过接口文档找到登录接口,在该接口中,找到请求方式、请求地址、请求参数、
打开PostMan,设置请求参数为PUT,请求数据为Json,填入请求地址,填入请求参数
重点:由于在配置REST的时候,我们没有配置证书,因此我们需要在设置中,禁用SSL证书验证
由于楼主写文章的时候,我已经离开机房,或者客户现场了,总之就是我现在没办法访问网管NCE了,只能给你们以前我访问拿到的一些数据了,例如这是我之前调试拿到的返回报文。
{
"accessSession": "x-lc1gjug9lglijvvv7tvsip3whhsbka0anzoapg7yhi04apc76l9cg6tgft7z1d9darpeqp2qhdo9qn89sbfzanqpurbxqlhdmp89irc9tdjsliqmakqkrxo8hc2oelc5",
"roaRand": "ae136e1468ea024e3a61731c99947f5ea27e7d13005d6579",
"expires": 1800,
"additionalInfo": null
}
通过登录接口,我们就可以拿到token信息了
3.1.2查询所有机房
找到我们需要的接口,找到请求参数,请求地址,请求方式等
按照接口填写地址,请求方式,然后把上面我们的登录接口中获取到accessSession复制下来,在postMan的headers中,添加X-Auth-Token,即可发起请求
3.2代码调试
当我们使用代码调试(无法直接用postMan访问网管NCE),或者开始开始编写代码访问NCE采集数据的时候,其实就是我们用代码模拟postMan请求。
3.2.1登录接口
登录太简单了,就不说了。直接看代码
@Data
public class LoginReq {
private String url;
private String grantType;
private String userName;
private String value;
}
@Data
public class LoginRes {
private String accessSession;//": "x-yyyyyyy",
private String roaRand;//": "xxxxxxx",
private int expires;//": 1800,
}
public String loginNce() {
ResponseEntity<LoginRes> res = restTemplate.postForEntity(loginReq.getUrl(), loginReq, LoginRes.class);
return res.getBody().getAccessSession();
}
3.2.2查询所有机房
除登录以外的接口,就稍微复杂点,因为在postman测试的时候,我们添加了X-Auth-Token并且禁用了SSL证书,因此,我们用代码请求的时候,也需要这样做
如下这个代码是我用来调试网管NCE接口,在部署服务器上转发的代码,主要是把wagger传过来的token,地址,url,请求方式,请求地址拿过来,构建一个http请求。你可以理解为,我在服务器上构建了一个类似postman的功能,,然后我把参数给服务器,服务器给我发起请求到网管NCE
@Data
public class ReqTest {
@NotEmpty
@ApiModelProperty("请求方式")
private String method;
@NotEmpty
@ApiModelProperty("请求地址")
private String url;
private String token;
@ApiModelProperty("请求参数")
private Map<String, Object> body;
}
public Object restHuaweiNce(ReqTest req) {
HttpHeaders headers = new HttpHeaders();
headers.add("X-Auth-Token", req.getToken());
headers.setContentType(MediaType.APPLICATION_JSON);
HttpEntity<Object> reqEntity = new HttpEntity<>(req.getBody(), headers);
HttpMethod method = HttpMethod.resolve(req.getMethod().toUpperCase());
ResponseEntity<Object> res = restTemplate.exchange(req.getUrl(), method, reqEntity, Object.class);
return res.getBody();
}
如果你能直接连网管NCE,或者正式开发,就不需要我这么麻烦了,直接用put、get、post即可,不过你也需求像上面一样,在headers 里面,添加X-Auth-Token
restTemplate.put(null, req);
restTemplate.getForEntity(null, null);
restTemplate.postForEntity(null, req, null);
到这里还不够,因为我们还没有禁用SSL
/**
* @description:Rest配置
* @author:hutao
* @date:2022年3月5日
*/
@SpringBootConfiguration
public class RestTemplateConfig {
/*
@Bean
public RestTemplate restTemplate() {
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setConnectTimeout(10000);
factory.setReadTimeout(10000);
return new RestTemplate(factory);
}*/
/**
* @description:关闭SLL验证
* @author:hutao
* @date:2024年2月29日 下午3:46:19
*/
@Bean
public RestTemplate restTemplate() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException {
TrustStrategy acceptingTrustStrategy = (X509Certificate[] chain, String authType) -> true;
SSLContext sslContext = org.apache.http.ssl.SSLContexts.custom().loadTrustMaterial(null, acceptingTrustStrategy).build();
SSLConnectionSocketFactory csf = new SSLConnectionSocketFactory(sslContext);
CloseableHttpClient httpClient = HttpClients.custom().setSSLSocketFactory(csf).build();
HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
factory.setHttpClient(httpClient);
factory.setConnectTimeout(10000);
factory.setReadTimeout(10000);
RestTemplate restTemplate = new RestTemplate(factory);
return restTemplate;
}
}
至此,华为北向网管NCE REST接口开发就到这里了,剩下的具体要调用哪个接口,我就没招了,毕竟那么多个接口,我也不能挨个调用,只能选一两个示例了。后面我还会讲CORBA,那个会超级恶心。