中国电信NB网关2.0正式环境指导手册.pdf

中国电信NB网关2.0

（标准版+高级版）

正式环境指导手册

（V1.1）

天翼物联科技有限公司

二〇二二年十月

编制单位：

编写单位：天翼物联科技有限公司

参与编写人员刘奇峰

修订记录

版本号日期描述

1.0初稿

编制说明

本文档由中国电信物联网公司组织编写，主要针对NB客户使用中国电信NB

网关，本文档主要针对客户对接、使用NB网关的操作指引。

目录

一、申请正式环境账号4

二、快速入门4

3.1新建应用5

3.2应用下导入产品8

3.3命令下发方式设置13

3.4终端注册14

3.5调用北向API订阅数据16

三、基本操作17

3.1系统管理17

3.2设备管理21

四、典型问题30

4.1APN配置不正确导致命令终端无法实时接收下行命令30

5.2平台设置不正确，导致命令缓存下发30

5.3注册单个设备进行测试时参数填写有误，导致数据上报失败31

5.4终端上报数据了，但是平台没有收到。31

5.5命令下发显示“超时”32

5.6命令下发显示“已发送”32

5.7终端上报数据，数据已经推送到客户服务器，但是NB网关上没有记录32

一、申请正式环境账号

联系客户经理通过CRM受理。

二、快速入门

一个应用成功接入正式环境主要包括以下5个基本步骤：

1）新建一个应用

2）在应用下“产品模型”中导入产品（应用—产品模型—新增产

品模型—从产品中心导入）

3）命令下发方式配置

4）注册终端

5）通过北向API订阅相关数据

3.1新建应用

新建应用

点击左侧导航栏“应用列表”-创建应用,在刷新后的页面中填

写应用的相关信息。

3.1.1基本信息：

填写应用名称，其中“所属行业”已经默认选择“公用事业”，

消息跟踪数据授权，建议客户打开，后期客户可在设备列表页面针对

设备单独开启数据跟踪能力。

3.1.2消息推送：

1）选择协议

NB网关给客户服务器推送订阅的数据，可以采用两种协议：

https和http。采用https方式，需要客户上传自己应用服务器的

CA证书，平台上已经内置CA-Baltimore、GeoTrust、Verisign、

DigiCert、GlobalSign、Entrust、Thawte这7种应用服务器证

书，请确认您的应用服务器所使用的CA证书是否已经包含在上述证

书中，如果没有，请上传CA证书。采用http方式，NB网关将会采

用http的方式给客户服务器推送数据，但是http方式是不安全

的，此方式会存在平台与应用服务器之间通信信息泄露，中间人攻

击等风险。建议客户选择https的推送方式。

2）选择方式

NB网关给客户提供了两种消息推送方式：消息缓存和消息不缓

存。消息不缓存方式，平台给应用服务器推送订阅消息失败后，不

会重新推送消息。消息缓存方式平台给应用服务器推送订阅消息失

败后，会重新推送消息，订阅消息缓存天数可配置（1-3天）。

3.1.3高级配置

主要包括平台服务相关的配置，您可以选择使用默认设置，也

可以根据需要调整设置。

邮件服务器：已经默认配置为“中国电信物联网开放平台”，客

户无需更改。

短信服务器：目前平台短信发送能力正在建设中，暂不支持客户

配置，无需更改。

平台能力：透传模式、存储模式

透传模式，网关不会缓存客户终端上报的数据，平台会