TR069 协议向导 1. 为什么需要 TR069随着 VoIP、IPTV 等越来越多 IP 终端设备的普及（尤其在家庭中的普及） ，大量设备的配置和维护变得越来越困难，大大提高了网络产品运营商的成本，传统的基于 SNMP 的网管系统面对众多的终端设备时显得力不从心，限制了宽带接入市场的发展速度和规模。TR069 定义了一套全新的网管体系结构，包括 “管理模型” ， “交互接口” ， “管理参数” ，在很大程度上减少了网络产品的运为成本。2. 什么是 TR069 协议TR069 是数字用户线（DSL）论坛（已改名为 Broadband Forum）制定的一个面向终端设备的网管协议，称为“用户终端设备广域网管理协议（CWMP） ”，DSL 论坛的文档编号为TR069。3. TR069 协议发展现状自 2004 年 5 月 DSL 论坛推出该协议以来，各大运营商纷纷部署基于 TR069 的终端设备。但从协议的发展情况看，TR069 仍然处于不断完善的过程中。 4. TR069 协议网络架构ACS 为自动配置服务器，负责对终端设备 CPE 进行管理。 ACS 与 CPE 间的接口为南向接口，ACS 与管理系统间的接口为北向接口。TR069 协议主要定义了南向接口。5. TR069 的实现（协议栈）1) TR069 协议基于 TCP/IP；2) 标准的 Internet 传输安全协议， SSL3.0 OR TLS1.0 ，使用 SSL/TLS 并不强制要求，确保 CPE 和 ACS 之间基于证书的鉴权3) ACS 与 CPE 间的消息传输使用 HTTP1.14) 消息的具体内容使用 SOAP 包进行封装，SOAP 包是一个包含 SOAP Head（SOAP 头）和 SOAP Body （SOAP 体）组成的 XML 文档 5) ACS 与 CPE 之间通过 TR069 协议特有的 RPC 方法进行互操作。ACS 远程调用 CPE 上的 RPC 函数，用来对 CPE 进行管理如：设置 CPE 参数、获取CPE 参数、硬件升级、重启设备等；因此需要向 CPE 传输要调用的函数名及参数，这些内容包含在 SOAP 体中。ACS 并不直接对设备本身的接口进行调用 ，ACS 所调用的函数为TR069 的标准函数（称作 TR-069 RPC Methods） ，CPE 需要通过一个设备上的中间层解析出 RPC 方法，再由这个中间层调用设备自身的接口，这个中间层就是 TR069 Agent。CPE 调用 ACS 的方法，用来向 ACS 上报状态信息，请求硬件镜像文件下载（用来升级硬件）等等。TR069 协议的 RPC 函数（或称 RPC 方法） ，如下表： 6. CPE 函数参数（TR069 协议的数据模型）网络架构上包含两种设备类型，因此包含两套数据模型：i. TR-106: Data Model Template for TR-069-Enabled Devices, 13ii. TR-098: Internet Gateway Device Data Model for TR-069, 24 iii. TR-104: Provisioning Parameters for VoIP CPE, 25Each Parameter consists of a name-value pair. The name identifies the particular Parameter, and has ahierarchical structure similar to files in a directory, with each level separated by a “.” (dot). The value of a Parameter may be one of several defined data types (see 13). 参数名 ：使用由类似树型的点分层关系组织起来。树干为需要配置的对象，树叶为具体的配置参数，所有配置参数都具有是否可读写属性。 如：InternetGatewayDevice.IPPingDiagnostics.Interface参数类型：基于 SOAP 的数据类型参数有只读、只写两种状态。且可扩展TR069 协议就是一个基于 TCP/IP,通过 HTTP 或者 HTTPS 发送 SOAP 消息来远程调用 CPE或者 ACS RPC 方法,从而可以达到获取配置和业务信息，监控状态，故障诊断等目的的一种协议。7. 详解 TR069 规则：CPE 和 ACS 都可以发起会话，ACS 发起的会话是异步的。Comment d1: CPE首次入网Comment d2: CPE加电或重启Comment d3: 定时任务Comment d4: the optional ScheduleInform method的指示Comment d5: CPE收到 ACS的连接请求Comment d6: ACS的 URL发生改变Comment d7: 某些参数发生了变更Comment d8: VALUECHANGE事件，所以 CPE必需发起连接Comment d9: 不正常的会话终结，导致会话重新发起时。Comment d10: 重建会话为了递交上次提交失败的事件。重试的次数必需通知 ACS【Inform 时已经提交】 。Comment d11: 必须使用 HTTP1.1 GET。获取只读的 CPE状态Comment d12: 不能使用 HTTPSComment d13: 不能带参数，CPE 应该忽略参数Comment d14: 摘要认证Comment d15: CPE接受任何正确鉴权的请求Comment d16: 鉴权成功后必选返回200或者 204，且长度必须为 0A. 建立连接CPE发起的连接： CPE必需满足如下任何一个条件的情况下向 ACS地址发起连接，并调用 ACS的 Inform方法。 The first time the CPE establishes a connection to the access network on initial installation On power-up or reset Once every PeriodicInformInterval (for example, every 24-hours) When so instructed by the optional ScheduleInform method Whenever the CPE receives a valid Connection Request from an ACS (see section 3.2.2) Whenever the URL of the ACS changes Whenever a parameter is modified that is required to initiate an Inform on change.Whenever the value of a parameter that the ACS has marked for “active notification” via theSetParameterAttributes method is modified by an external cause (a cause other than the ACSitself).Whenever an unsuccessfully terminated session is retried according to the session retry policyspecified in section 3.2.1.1.ACS发起的连接：满足如下条件 The Connection Request MUST use an HTTP 1.1 GET to a specific URL designated by the CPE. TheURL value is available as read-only Parameter on the CPE. The path of this URL value SHOULD be randomly generated by the CPE so that it is unique per CPE. The Connection Request MUST make use of HTTP, not HTTPS. The associated URL MUST be anHTTP URL. No data is conveyed in the Connection Request HTTP GET. Any data that might be containedSHOULD be ignored by the CPE. The CPE MUST use digest-authentication to authenticate the ACS before proceedingthe CPEMUST NOT initiate a connection to the ACS due to an unsuccessfully authenticated request. The CPE MUST accept Connection Requests from any source that has the correct authenticationparameters for the target CPE. The CPEs response to a successfully authenticated Connection Request MUST use either a “200(OK)” or a “204 (No Content)” HTTP status code. The CPE MUST send this response immediatelyupon successful authentication, prior to it initiating the resulting session. The length of the messagebody in the HTTP response MUST be zero.Comment d17: CPE需限制周期内ACS请求的次数，如果超出这个次数返回 503状态码，且忽略 Header中带的 Retry-AfterComment d18: 正确鉴权，并已经做出响应，但是会话超时，30s 内发起响应，即 Call ACS inform,EventCode=6 CONNECTION REQUESTComment d19: 上面会话建立仍然不成立，换 ACS重试Comment d20: CPE和 ACS在建立会话之前，收到了多个连接请求，CPE必需正常响应这些请求，但是不能建立会话。也就是说对于 CPE来说会话只能有一个。Comment d21: CPE和 ACS会话期间收到多个请求，CPE 不能立即能释放会话，处理的方式1、503 的响应，response header中不能包含 Retry-After2、会话完成，Call ACS inform,EventCode=6 CONNECTION REQUEST,因此需要 CPE记录在此期间的请求。Comment d22: CPE不能拒绝一个经过鉴权的请求。Comment d23: 当 ACS向 CPE发出一个 SOAP请求，则 CPE必需向ACS发出 SOAP响应Co