《中国联通综合终端远程管理系统技术规范-接口要求.pdf》由会员分享,可在线阅读,更多相关《中国联通综合终端远程管理系统技术规范-接口要求.pdf(47页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、 中国联通企业标准QB/CU 029-2008中国联通综合终端远程管理系统技术规范 接口要求 V1.0 2009-xx-xx 发布 2009-xx-xx 实施中国联通公司 发布 中国联通综合终端远程管理系统技术规范-接口要求 I 目 次 目 次.I 前 言.1 中国联通综合终端远程管理系统技术规范分册-接口要求.1 1 范围.1 2 规范性引用文件.1 3 缩略语.1 4 总体原则.1 5 网络架构.1 5.1 远程管理系统网络架构.1 5.2 远程管理系统功能实体.2 5.3 系统南向接口与协议要求.2 6 远程管理要求.9 7 管理流程.9 7.1 连接管理.9 7.2 参数查询与配置.1
2、3 7.3 设备维护与诊断.24 8 数据模型定义.37 附录 A 日志文件格式.38 附录 B 报警事件定义.39 附录 C 扩展 Inform 事件.41 附录 D 业务配置模板定义.41 附录 E 升级描述文件.42 中国联通综合终端远程管理系统技术规范-接口要求 1 前 言 本规范是中国联通综合终端远程管理系统技术规范系列之一。该系列规范包括:(1)中国联通综合终端远程管理系统技术规范系统要求(2)中国联通综合终端远程管理技术规范接口要求(3)中国联通综合终端远程管理测试规范 等,后续可根据被管理终端的增加,制定相应终端分册。本标准是其中的中国联通综合终端远程管理系统技术规范接口要求分
3、册。本分册定义了综合终端远程管理系统的接口技术、接口数据模型原型等。本标准由中国联通公司技术部提出并归口。本标准主要起草单位:中国联通公司技术部、国家工程实验室 本标准主要起草人:李兴新 本标准的修改和解释权属中国联通公司。中国联通拥有本协议的版权,任何厂家未经中国联通书面许可不得向第三方泄漏协议的内容。中国联通综合终端远程管理系统技术规范-接口要求 1 中国联通综合终端远程管理系统技术规范分册-接口要求 1 范围 本规范规定了中国联通综合终端远程管理系统的接口技术、接口数据模型等。本规范适用于中国联通各种终端和 RMS 服务器。2 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准
4、的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。TR069 CPE WAN Management Protocol TR106 Data Model Template for TR069-Enabled Devices TR196 Femto Access Point Service Data Model SOAP1.1 Simple Object Access Protocol(SOAP)1.1 SSL3.0 The SSL Pro
5、tocol,Version 3.0 RFC 2616 Hypertext Transfer Protocol-HTTP/1.1 RFC 2617 HTTP Authentication:Basic and Digest Access Authentication 3 缩略语 下列缩略语适用于本规范。HTTP Hypertext Transfer Protocol 超文本传输协议 IP Internet Protocol 互联网协议 RPC Remote Procedure Call 远程过程调用 RMS Remote Management Server 远程管理系统 SOAP Simple O
6、bject Access Protocol 简单对象访问协议 TCP Transmission Control Protocol 传输控制协议 URL Uniform Resource Locator 统一资源定位符 XML Extensible Markup Language 可扩展标记语言 XSD XML Schema Definition XML 数据定义文件 4 总体原则 中国联通各种终端与 RMS 之间的接口,遵循以下原则:远程管理接口遵循 Broadband Forum 制定的 TR069 标准,同时支持中国联通在此基础上进行的扩展定义。5 网络架构 5.1 远程管理系统网络架构
7、错误!未找到引用源。错误!未找到引用源。图 5.1 远程管理系统在网络中的位置 5.2 远程管理系统功能实体 综合终端网管逻辑功能可以划分为:自动配置服务器、应用服务器、文件服务器(主要进行设备版本、配置文件管理)、数据库系统等,根据终端规模,灵活选择网管组建构建终中国联通综合终端远程管理系统技术规范-接口要求 2 端网管组织形式。图 5.2 RMS 的逻辑功能划分示意 5.3 系统南向接口与协议要求 RMS 与终端之间的接口,称为 RMS 南向接口,南向接口遵循 Broadband Forum 制定的TR069 系列标准,中国联通在此基础上进行了必要的扩展。5.3.1 协议栈 RMS 南向接
8、口的协议栈如图 5.2 所示。图 5.3RMS 南向接口协议栈 5.3.2 协议栈各层要求 5.3.2.1 SSL/TLS、TCP 的要求 尽管可通过TCP连接直接承载本部分规定的管理协议,但推荐使用SSL/TLS来传送。如果不使用SSL/TLS,则安全性会受到一定损害。SSL/TLS可保证保密性和数据完整性,并允许使用基于证书的认证方式替代基于共享密钥的认证方式。使用SSL/TLS和TCP的限制如下:1、被管理设备应支持SSL3.0、TLS1.0或同时支持二者;2、如果被管理设备同时支持SSL3.0和TLS1.0,则建议被管理设备按照RFC 2246附录E通知RMS自己的能力,由RMS来选择
9、使用何种协议;3、如果RMS URL定义为HTTPS URL,则被管理设备应使用SSL/TLS和RMS建立连接;4、被管理设备应支持下列SSL/TLS密码组:1)RSA_WITH_3DES_EDE_CBC_SHA;2)RSA_WITH_RC4_128_SHA;中国联通综合终端远程管理系统技术规范-接口要求 3 5、被管理设备应能初始化和RMS的连接;6、RMS应能接纳由被管理设备发起的连接;7、如果使用SSL/TLS,则被管理设备应使用RMS提供的证书对RMS进行认证。RMS认证要求被管理设备必须根据根证书对证书进行验证,被管理设备必须确认证书Subject域的CN(Common Name)成
10、员值和被管理设备所知的RMS URL主机部分(即使RMS URL的主机部分是一个IP地址)相匹配。这通过直接比较CN和RMS URL主机部分的字符串来实现。如果CN或RMS URL采用主机名格式(不是IP地址),则二者的比较不应包括从主机名解析出来的IP地址。为了能够根据根证书进行验证,被管理设备应具有一个或多个可信任的根证书。可信任的根证书可通过预加载获得,或采用某种安全方式提供给被管理设备。如果HTTP重定向导致被管理设备尝试使用和预定义不同的URL访问RMS,则被管理设备应根据重定向后的RMS URL的主机部分验证RMS证书的CN成员,而不使用预定义的RMS URL进行验证。建议被管理设
11、备获得准确的绝对时间后,再和RMS建立连接。如果被管理设备选择在获得准确的绝对时间前(或被管理设备不支持绝对时间)和RMS建立连接,则被管理设备应忽略RMS证书中包含绝对时间的相关成员,例如not-valid-before和not-valid-after证书限制;8、被管理设备和RMS可选支持采用客户端证书进行被管理设备认证。客户端证书应通过适当的方式进行发放。当RMS使用客户端证书对被管理设备进行认证时,被管理设备证书中的CN域必须是下面两种类型之一:1)唯一的被管理设备客户证书。在这种方式下,每个被管理设备的CN域的值必须是唯一的。特别地,CN域应采用用户名/用户标识这种格式,例如:00D
12、09E-0123456789;012345-STB-0123456789;012345-Set%2DTop%2DBox-0123456789;2)通用被管理设备客户证书。在这种方式下,一组被管理设备具有相同的 CN 域值,CN 域的内容不做规定。如果使用通用被管理设备客户证书,则建议 RMS 额外使用 HTTP 基本或摘要认证来确认被管理设备的身份。5.3.2.2 HTTP 的要求 被管理设备和RMS之间的SOAP消息采用HTTP 1.1进行承载,其中被管理设备作为HTTP客户端,RMS作为HTTP服务器。注:发送连接请求时也采用 HTTP,此时 RMS 作为 HTTP 客户端,被管理设备作为
13、 HTTP服务器。一、HTTP 上的 SOAP 编码:HTTP上的SOAP编码是对HTTP SOAP绑定的扩展,具体方式如下:1、RMS发给被管理设备的SOAP请求用HTTP Response消息承载,而被管理设备对RMS请求的响应消息在随后的HTTP POST中承载。2、当HTTP Request消息承载了SOAP响应或SOAP错误响应时,HTTP Request消息中的SOAPAction帧头应为空(无引号),表示无信息提供。具体表现为:SOAPAction:3、当 HTTP Request 消 息 或Response消 息 包 含 了SOAP Envelope 时,HTTP Conten
14、t-Type帧头中的类型/子类型域值应为“text/xml”。4、空的HTTP POST不应包含SOAPAction帧头。5、空的HTTP POST不应包含Content-Type帧头。中国联通综合终端远程管理系统技术规范-接口要求 4 6、包含本部分规定的管理协议净荷(发给被管理设备的SOAP请求,发给被管理设备的成功SOAP响应,或包含Fault域的SOAP错误响应)的HTTP响应消息应使用HTTP状态码“200(OK)”。二、会话处理:由于一次会话由多项事务处理组成,建议被管理设备在整个会话期间维护一条TCP连接。然而,如果在一对HTTP请求/响应完成后TCP连接已经关闭,但在最后一个H
15、TTP响应发生时会话尚未终结(成功或不成功),则被管理设备应通过在新的TCP连接中发送下一个HTTP请求来继续会话。接收到认证请求后,除非RMS通过“Connection:close”HTTP帧头要求关闭连接,否则被管理设备应在同一TCP连接上发送下一个HTTP请求(包括“Authorization”HTTP帧头)。如果RMS要求关闭连接,则被管理设备应按照RMS的要求关闭TCP连接,并在新的TCP连接上发送下一个HTTP请求(包括“Authorization”HTTP帧头)。如果被管理设备因为某种原因导致TCP连接建立失败,或发送HTTP消息失败,或接收HTTP响应消息失败,则被管理设备应认
16、为会话异常终止。被管理设备应等待至少30秒后才能认为TCP连接建立失败或接收HTTP响应失败。建议RMS按照RFC 2965的规定使用会话cookie来维护会话状态。RMS可使用旧类型的“Netscape”cookie或RFC 2965中定义的新的cookie类型。建议RMS仅使用用于标记Discard的cookie,并且不认为被管理设备在会话周期外还维护cookie。为了保证RMS能使用会话cookie,被管理设备应支持使用RFC 2965规定的cookie,包括在HTTP POST中返回保存值,被管理设备无需保存会话周期以外的cookie的情况除外。特别地,因为RMS发送的cookie可能
17、是旧模式或新模式或新旧混合模式,所以被管理设备应支持RFC 2965规定的兼容性要求。被管理设备应支持RMS使用的多种cookie,并且应至少能提供512字节用以存储cookie。当会话处理成功完成或异常终止时,被管理设备应关闭到RMS的相关TCP连接并丢弃标记为Discard的所有cookie。被管理设备应支持RMS使用HTTP重定向。与使用HTTP重定向相关的被管理设备和RMS要求如下:1、被管理设备应支持HTTP状态码302(发现)和307(临时重定向);2、被管理设备可支持用于重定向的HTTP状态码301(永久转移);3、被管理设备应允许在会话过程中的任何时候进行重定向,并且RMS可在
18、会话过程中的任何时候发起重定向;4、如果被管理设备被重定向,则被管理设备应尝试使用HTTP重定向响应消息提供的URL继续会话。特别地,被管理设备应向位于重定向后的URL上的RMS重新发送引起重定向响应的HTTP POST消息,随后被管理设备应尝试继续进行会话;5、如果被管理设备被重定向,则重定向后的URL应仅应用于当前会话的剩余部分,或直到同一会话随后又发生重定向。被管理设备不应保存重定向后的URL(即不修改ManagementServer.URL)用于任何后续的会话和会话重试。即使重定向使用了HTTP状态码301(永久转移),也必须遵守以上规定;6、被管理设备应允许5次连续的重定向。如果连续
19、超过5次对被管理设备进行重定向,则被管理设备可认为会话异常终止;7、HTTP重定向提供的URL可能是HTTP或HTTPS URL。不管重定向前使用的是何种传输机制,对新目标应重新选择采用合适的传输机制(TCP或SSL/TLS);8、如果重定向会话使用SSL/TLS,则要求被管理设备对RMS进行认证,认证必须基于中国联通综合终端远程管理系统技术规范-接口要求 5 重定向后的URL来进行,不应使用预配置的RMS URL;9、在RMS发送的包含重定向状态码的HTTP响应消息中,HTTP消息体的长度必须为0。如果被管理设备接收到的HTTP重定向响应消息中的消息体非空,则被管理设备应忽略消息体的内容;1
20、0、当进行重定向时,被管理设备向重定向后的RMS发送HTTP请求时应包含所有和会话相关联的cookie。被管理设备应认为来自RMS的重定向是一个“可验证的处理”,因此被管理设备向重定向后的RMS发送cookie时无需对每个cookie进行域确认。三、文件传送:如果被管理设备根据RMS的Download或Upload请求进行文件传送,并且文件位置由主机名与RMS相同的HTTP URL指定,则被管理设备必须采用下列方式之一完成文件传送:1、被管理设备可在已经建立的连接上发送HTTP GET/PUT。文件传送后,被管理设备可继续维护连接并发送其它消息给RMS;2、被管理设备可打开第二条连接来传送文件
21、,这样被管理设备可在与RMS的会话中继续发送消息;3、被管理设备可终结与RMS的会话,然后进行文件传送。如果文件的位置不是一个HTTP URL,或者所在域和RMS不同,或者要求使用不同的端口,则只能使用后两种选项。被管理设备必须支持使用SSL/TLS来建立独立的TCP连接并使用HTTP来传送文件。当文件位置为HTTPS URL时,被管理设备必须使用SSL/TLS。被管理设备应同时支持HTTP基本认证和摘要认证文件传送,具体认证方式由文件服务器来选择。如果文件服务器采用认证方式,则RMS应使用用于初始化传送(即Download和Upload)的特定RPC方法来指定信任证书。四、认证:如果不使用S
22、SL/TLS对被管理设备进行认证,则RMS应使用HTTP对被管理设备进行认证。如果使用了SSL/TLS进行加密,RMS可选使用基本认证方式或摘要认证方式。如果不使用SSL/TLS,则RMS必须使用摘要认证方式。被管理设备应支持HTTP基本认证方式和摘要认证方式。当面临基本认证或摘要认证的选择时,RMS选择认证方式。如果被管理设备接收到来自RMS的认证要求(基本认证或摘要认证),则在TCP连接期间,建议被管理设备在后续的所有HTTP请求中发送认证帧头。不论被管理设备是否发送认证帧头,RMS均可在会话的任何阶段发送后续的认证要求,此时会话可以处于一个或多个TPC连接中。如果使用任何形式的HTTP认
23、证方式对被管理设备进行认证,建议被管理设备使用唯一的用户名/用户标识。被管理设备的用户名/用户标识推荐采用下面两种格式之一:1、-;2、-。如果使用了上面规定的用户名/用户标识格式,则、域必须和Inform消息的DeviceIdStruct的相应参数严格匹配。一个例外是,为了确保能从用户名/用户标识中提取参数值,必须使用RFC 3986规定的URI编码忽略和中的除数字字母和下划线外的字符。如果使用上面规定的用户名/用户标识格式,则应仅在ProductClass参数为空时使用第二种格式。例如:012345-0123456789;中国联通综合终端远程管理系统技术规范-接口要求 6 012345-S
24、TB-0123456789;012345-Set%2DTop%2DBox-0123456789。建议任一种形式的HTTP认证所使用的密码对每个被管理设备是唯一的。即不建议多个被管理设备共享相同的密码。这个密码是共享密钥,被管理设备和RMS均应知道。本部分对被管理设备和RMS在被管理设备初始配置阶段如何获得共享密钥不做规定。被管理设备和RMS都应采取一定措施阻止未经过认证就获得密码或RMS上的密码列表。五、摘要认证:本节规定了使用摘要认证的要求,这些要求应用于进行RPC交互和文件传送的连接的认证。对于不同类型的连接,RMS和被管理设备可以互换HTTP客户端和服务器角色。当发送连接请求时,RMS是
25、HTTP客户端。当初始化与RMS的连接时,被管理设备是HTTP客户端。被管理设备和RMS必须支持RFC 2671“qop”选项值为“auth”。根据RFC 2671的规定,当HTTP服务器提供该选项时,HTTP客户端必须使用新类型的摘要机制。当使用摘要认证时,对于每条新打开的TCP连接,建议RMS使用新的nonce值,被管理设备使用新的cnonce值。注:如果不使用SSL/TLS,RMS对用于HTTP认证的nonce值的重用策略会严重影响会话安全性。如果RMS在多个TCP连接上重认证时重复使用nonce值,则RMS容易受到重放攻击。然而,如果会话使用了SSL/TLS,则可在很大程度上降低这种风
26、险。被管理设备和RMS必须支持MD5摘要算法。被管理设备还应支持MD5-sess摘要算法。六、其它 HTTP 要求:与HTTP相关的其它要求如下:1、当RMS发送空的HTTP响应消息时,必须使用HTTP状态码“204(无内容)”;2、当被管理设备发送空的HTTP请求消息时,HTTP消息体的长度必须为0;3、被管理设备不应使用HTTP 1.1的管线(pipelining)。5.3.2.3 SOAP 的要求 RPC方法调用和响应使用SOAP 1.1编码后进行传输。RPC方法和SOAP编码之间的映射关系如下:1、应使用标准的SOAP 1.1信封和串行化命名空间来进行编码:1)信封命名空间标识符“ht
27、tp:/schemas.xmlsoap.org/soap/envelope/”;2)串行化命名空间标识符”http:/schemas.xmlsoap.org/soap/encoding/”。2、本部分规范的管理协议定义的所有元素和属性与下面命名标识符有关:“urn:dslforum-org:cwmp-1-0”;3、根据SOAP规范,定义为“anySimpleType”的元素应包括指示元素实际类型的类型属性;4、当且仅当元素为RPC方法XML大纲中命名的数据类型时,非“anySimpleType”类型的元素可包括类型属性。如果包含了类型属性,则类型属性值应和XML大纲已命名的数据类型严格匹配;对
28、于一个数组变量,变量名在定义数组的表中规定,并且必须作为整个数组元素名来使用。数组成员名必须是数组数据类型,并且符合定义数组的表的规定(除了括号和括号中的长度限制外)。数组成员名不应是合格的命名空间。5、对于规范中要求的RPC方法,方法调用中列出的每个变量表示一个in参数,而方法响应中列出的每个变量表示一个out参数。不存在in/out参数;6、RPC方法使用标准的SOAP命名规则,对应于某种方法的响应消息通过在方法名称后增加“Response”后缀来命名;中国联通综合终端远程管理系统技术规范-接口要求 7 7、SOAP信封应有且仅有一个的Body元素;8、被管理设备应能够接收信封长度至少为3
29、2kB(32768字节)的SOAP请求而不会产生“Resources Exceeded”响应;9、被管理设备应能够产生符合长度要求并且不会导致“Resources Exceeded”响应的SOAP响应,即被管理设备SOAP响应消息长度没有最大值;10、RMS应能够接收信封长度至少为32kB(32768字节)的SOAP请求而不会产生“Resources Exceeded”响应;11、RMS应能够产生符合长度要求并且不会导致“Resources Exceeded”响应的SOAP响应,即RMS SOAP响应消息长度没有最大值;12、错误响应必须使用SOAP Fault元素,使用规则如下:1)SOAP
30、 faultcode元素必须指明错误是在客户端还是服务器产生,其中客户端表示SOAP请求的发起者,服务器表示SOAP响应者。错误响应的接收端无需使用faultcode元素,并可以完全忽略SOAP faultcode元素;2)SOAP faultstring子元素必须包含字符串“CWMP fault”;3)SOAP detail元素必须包含“urn:dslforumorg:cwmp-1-0”命名空间中定义的Fault结构。RPC方法XML大纲定义了这个结构,包含下列元素:FaultCode元素,包含一个单独的数字型错误码;FaultString元素,包含一个可供阅读的错误描述;SetParame
31、terValuesFault元素,仅用于对SetParameterValues方法进行错误响应,包含一个或多个结构,用来指明与该错误相关的所有参数,此结构包含下列元素:ParameterName元素,包含错误参数的完整路径名;FaultCode元素,包含一个数字型错误码,指明了与该参数相关的错误;FaultString元素,包含一个可供阅读的针对该参数的错误描述。只应在响应SOAP请求时发送错误响应,在响应SOAP响应或其它错误响应时不应发送错误响应。如果错误响应未能满足上述各项要求,则应认为接收到的SOAP消息非法;13、在处理接收到的SOAP信封时,RMS和被管理设备可忽略:1)任何无法识
32、别的XML元素及其子元素或内容;2)任何无法识别的XML属性和属性值;3)任何嵌入的XML注释;4)任何XML处理指示。或者RMS和被管理设备可验证接收到的XML并拒绝包含无法识别元素的信封。根据该项要求,无法通过增加参数但不改变消息名称来对现有消息进行扩展;14、如果RPC方法要求引用XML SCHEMA命名空间(例如“type”属性或XML SCHEMA的 数 据 类 型),则 必 须 引 用 2001 版 的 命 名 空 间 定 义,即http:/www.w3.org/2001/XMLSchema-instance和http:/www.w3.org/2001/XMLSchema。接收者可
33、拒绝接收引用其它不同版本命名空间的RPC方法。本部分规定的管理协议定义了一系列的SOAP帧头元素,具体见下表。表 5.1 SOAP 帧头元素 标识名 描述 ID 该帧头元素可用于关联SOAP请求和响应。每个请求具有唯一的标识符,相应的响应消息包含与之匹配的标识符。标识符的值可是任意字符串,由请求端设置。中国联通综合终端远程管理系统技术规范-接口要求 8 如果SOAP请求中使用了该元素,则对应的响应消息中也应包含此ID帧头(无论是成功响应还是失败响应)。因为支持这个帧头是强制性的,所以mustUnderstand属性应置为“1”(true)。HoldRequests 该帧头可包含在RMS发给被管
34、理设备的信封中,用于控制来自被管理设备的请求的传送。该帧头不应出现在被管理设备发给RMS的封套中。该标识取值为布尔类型的“0”(false)或“1”(true)。如果没有该标识,则等价为该标识值为“0”。被管理设备必须支持HoldRequests帧头。因为必须支持这个帧头,所以mustUnderstand属性应置为“1”(true)。5.3.2.4 RPC 方法要求 表 5.2 RPC 方法要求 方法名 终端要求 RMS 要求 终端方法 响应 调用 GetRPCMethods 必选 可选 SetParameterValues 必选 必选 GetParameterValues 必选 必选 Get
35、ParameterNames 必选 必选 SetParameterAttributes 必选 必选 GetParameterAttributes 必选 必选 AddObject 必选 必选 DeleteObject 必选 必选 Reboot 必选 必选 Download 必选 必选 Upload 必选 必选 FactoryReset 必选 必选 GetQueuedTransfers 可选 可选 ScheduleInform 可选 可选 SetVouchers 不要求 不要求 GetOptions 不要求 不要求 RMS 方法 调用 响应 GetRPCMethods 可选 必选 Inform 必
36、选 必选 TransferComplete 必选 必选 RequestDownload 必选 可选 Kicked 不要求 不要求 6 远程管理要求 远程管理系统包括 RMS 系统管理和终端管理两部分。系统管理部分必须具有与 RMS 本身管理相关的功能,包括安全管理、日志管理、系统设备管理、报表统计管理等。终端管理部分实现终端管理操作,必须实现终端拓扑管理、性能和状态监控、终端配置管理、故障管理、软件版本/配置文件管理、终端日志管理等功能等。中国联通综合终端远程管理系统技术规范-接口要求 9 终端远程管理的要求,同中国联通综合终端远程管理系统技术规范-系统要求相关规则。7 管理流程 7.1 连接
37、管理 7.1.1 终端首次连接 RMS 该流程用于完成 RMS 系统终端管理模块中的设备认证功能。以下三种情况执行终端设备首次连接 RMS 流程,流程如图所示:1、终端设备出厂后首次连接时;2、执行恢复出厂设置后;3、RMS URL 发生改变时。7.1.1.1 流程描述 RMS 可采用 SSL/TLS 或是 HTTP 基本/摘要认证方式对终端进行认证。图 7.1 首次连接 RMS 流程 流程详细说明如下:1、终端发起 Inform 请求,Event code 为0 BOOTSTRAP,说明是首次连接到 RMS,上报请求中携带终端设备的 OUI、SerialNumber 等信息;2、RMS 对终
38、端设备进行设备认证,合法则返回 Inform Response;3、终端设备发起一条空的 Http Post 请求;4、RMS 发起 Get Parameter Values,要求终端设备上报上网账号/密码或终端的配置参数;5、终端回应 Get Parameter Values Response,携带账号密码或配置参数等信息,由 RMS实现对账号的合法性验证,或者检验终端的配置参数。6、验证通过后,RMS 根据任务计划的定制,选择 Download 或 SetParameterValues 或AddObject 的 RPC 方法并发起请求,要求终端设备下载初始化的配置文件或对参数进行配置或添加
39、新的实例,可根据具体的实现过程选择适当的 RPC 方法。中国联通综合终端远程管理系统技术规范-接口要求 10 7、步骤 6 完成后,当 RMS 没有其它请求时,就向终端设备发送一条空的 Http Post 响应。8、当终端也没有新的请求要发送给 RMS 时,终端设备断开连接,会话结束。7.1.1.2 调用的 RPC 方法 该流程中调用的 RPC 方法见下表。表 7.1 终端设备首次连接到 RMS 流程调用的 RPC 方法 终端设备 RMS Inform Inform Response GetParameterValues Response GetParameterValues Download
40、 Response(可选)SetParameterValues Response(可选)AddObject Response(可选)Download(可选)SetParameterValues(可选)AddObject(可选)TransferComplete TransferComplet Response 7.1.1.3 流程说明 Inform 消息的 Event 参数中 EventCode 为0 BOOTSTRAP。Inform 消息的 ParameterList参数见下表,这些参数应包含在每一个 Inform 消息中。以家庭网关为例:名称名称 InternetGatewayDevice.
41、DeviceSummary InternetGatewayDevice.DeviceInfo.SpecVersion HardwareVersion SoftwareVersion ProvisioningCode InternetGatewayDevice.ManagementServer.ConnectionRequestURL ParameterKey 首次连接验证通过后,RMS 根据任务计划的定制,选择 Download 或 SetParameterValues或 AddObject 的 RPC 方法并发起请求,启用相关处理流程。7.1.2 终端设备非首次连接 RMS(终端设备发起)终
42、端设备主动与RMS连接开始一个会话过程,且并非首次连接到RMS时(例如终端设备在首次上电连接之后的每次上电或复位),应执行此流程,流程如图所示。中国联通综合终端远程管理系统技术规范-接口要求 11 7.1.2.1 流程描述 终端设备主动发送 Inform 消息建立会话,RMS 对终端设备进行认证后,不再进行初始化参数配置,而根据预配置的任务调度策略对终端设备进行操作。RMS 可采用 SSL/TLS 或是 HTTP 基本/摘要认证方式对终端设备进行认证。图 7.2 终端设备非首次连接 RMS 流程(终端设备发起)流程详细说明如下:1、终端设备发起 Inform 请求,Event code 为1
43、BOOT,说明是非首次连接到 RMS;2、RMS 对终端设备进行设备认证,合法则返回 Inform Response;3、终端设备发起一条空的 Http Post 请求;4、根据 RMS 的计划任务,执行配置、Download 等计划任务,为可选步骤;5、步骤 4 完成后,当 RMS 没有其它请求时,向终端设备发送一条空的 Http Post 响应。6、终端设备断开连接,会话结束。7.1.2.2 调用的 RPC 方法 该流程中调用的 RPC 方法见下表。在后续配置过程中可能涉及的参数查询、参数配置、文件上传下载等操作涉及的 RPC 方法并未列出。表 7.2 终端设备非首次连接到 RMS 流程(
44、终端设备发起)调用的 RPC 方法 终端设备 RMS Inform Inform Response 7.1.2.3 流程说明 Inform 消息的 Event 参数中 EventCode 为1 BOOT,其他参数要求同 7.1.1.3。7.1.3 终端设备非首次连接到 RMS(RMS 发起)RMS要求终端设备建立连接开始一个会话过程,且终端设备并非首次连接到RMS时(例如终端设备在首次上电连接之后的每次上电或复位),应执行此流程,流程如下图所示。7.1.3.1 流程描述 在这种情况下,RMS 需要知道终端设备特定的 URL,并通过该 URL 要求终端设备建立与自己的连接。RMS 首先向终端设备
45、发起 HTTP Get 消息,连接请求 HTTP Get 消息不承载任何数据,在建立连接前,终端设备使用摘要认证对 RMS 进行认证,如果认证请求未成功,中国联通综合终端远程管理系统技术规范-接口要求 12 则终端设备不应初始化与 RMS 的连接;终端设备使用200(OK)或 204(No Content)HTTP 状态码来响应认证成功的连接请求。当认证成功后,终端设备应在初始化会话前立刻发送响应消息。HTTP 响应中的消息体长度为 0。RMS 根据任务调度的配置对终端设备进行相关操作。随后终端设备发送 Inform 消息建立会话,流程图如下:图 7.3 终端设备非首次连接 RMS 流程(RM
46、S 发起)流程详细说明:1、终端设备发起 Inform 请求,Event code 为6 CONNECTIONREQUEST,说明该会话是由 RMS 要求而建立的;2、RMS 返回 Inform Response;3、终端设备发起一条空的 Http Post 请求;4、RMS 根据任务调度的设置对终端设备进行相关操作;5、步骤 4 完成后,当 RMS 没有其它请求时,向终端设备发送一条空的 Http Post 响应。6、终端设备断开连接,会话结束。7.1.3.2 调用的 RPC 方法 该流程中调用的 RPC 方法见下表。在后续配置过程中可能涉及的参数查询、参数配置、文件上传下载等操作涉及的 R
47、PC 方法并未列出。表 7.3 终端设备非首次连接到 RMS(RMS 发起)流程调用的 RPC 方法 终端设备 RMS Inform Inform Response 7.1.3.3 流程说明 Inform 消息的 Event 参数中 EventCode 为6 CONNECTION REQUEST,其他参数要求同 7.1.1.3。7.2 参数查询与配置 中国联通综合终端远程管理系统技术规范-接口要求 13 通过参数查询,可以完成RMS系统终端管理模块中的设备基本信息的管理。7.2.1 查询终端设备的数据模型 该流程可以用于完成RMS系统终端管理模块中的参数配置和状态监视功能。不同类型、不同应用阶
48、段、不同场景的终端设备可能会对TR-069规范规定的数据模型作选择性的支持,所以,RMS系统有必要主动获取某一终端设备所能支持的TR-069数据模型,以便对终端设备作选择性的参数配置。7.2.1.1 流程描述 RMS 可对终端设备支持的数据模型进行查询,可以查询终端设备上可配置的所有对象和参数名称,也可只查询某一子对象(需要通过该流程已查知其名称)下的子对象和参数,流程如图所示。图 7.4 查询终端设备数据模型流程 流程详细说明如下:1、终端设备发起 Inform 请求,Event code 为6 CONNECTIONREQUEST,说明该会话是由 RMS 要求而建立的;2、RMS 返回 In
49、form Response;3、终端设备发起一条空的 Http Post 请求;4、RMS 发起 GetParameterNames 要求,查询终端设备上指定的数据模型对象和参数;5、终端设备响应 GetParameterNamesResponse,并携带被查询的对象和参数的名称。6、RMS 向终端设备发送一条空的 Http Post 响应;7、终端设备断开连接,该会话结束。RMS 可多次重复调用 GetParameterNames 方法,逐级获取终端设备的数据模型。也可进行其他管理操作。7.2.1.2 调用的 RPC 方法 该流程中调用的 RPC 方法见表 7.4。中国联通综合终端远程管理系
50、统技术规范-接口要求 14 表 7.4 终端设备非首次连接到 RMS(RMS 发起)流程调用的 RPC 方法 终端设备 RMS Inform Inform Response GetParameterNames Response GetParameterNames 7.2.1.3 流程说明 GetParameterNames 方法可通过设置 NextLevel 参数为 true 或 false 来获取指定参数路径的下一级参数名称或是指定参数路径下的所有各级参数名称。建议设置为 true 来逐级获取数据模型中的各级参数。7.2.2 参数值查询与设置 该流程可以用于完成RMS系统终端管理功能中的参数