TR069管理接口规范.docx

YD/T 200保密等级：公开发放中国电信集团公司 发布.1 20*-*实施20*-*发布中国电信IP PBX TR069管理接口规范V0.8附录A附录BQ/CT *-20*中国电信集团公司技术标准A.11Q/CT *-20*目 次目 次I前 言II中国电信IP PBX TR069管理接口规范11 范围12 规范性引用文件13 缩略语、术语和定义13.1 缩略语13.2 术语和定义24 IP PBX在网络中的位置25 功能要求25.1 终端管理26 接口要求36.1 初始流程36.1.1 配置信息获取36.1.2 注册到IMS核心网36.2 终端管理接口（I5）36.2.1 IMS终端管理平台域名处理36.2.2 上电业务发放 业务发放流程 配置文件格式 RPC方法96.2.3 密码修改 密码修改流程 RPC方法18前 言本标准按照GB/T 1.1-2009给出的规则起草。本标准是中国电信IP PBx标准之一，该系列标准的结构及名称如下：1）2）本标准由中国电信集团公司提出并归口。本标准起草单位： 中国电信股份有限公司广州研究院本标准主要起草人： 本标准于20*年*次发布，本次为首次发布。II中国电信IP PBX TR069管理接口规范1 范围本规范规定了IMS核心网络下基于SIP协议的IP PBX在网络中的位置及接口等方面的要求。本规范适用于中国电信IP PBX。2 规范性引用文件下列文件中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修改版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。Q/CT 2094-2010 IMS网络SIP协议总体技术要求Q/CT 2460-2012 中国电信IMS SIP硬终端技术要求3 缩略语、术语和定义3.1 缩略语下列缩略语适用于本标准：ASApplication Server应用服务器CIFCommon Intermediate Format 公共中间格式352288CSCFCall Session Control Function 呼叫会话控制功能DNSDomain Name Server域名服务器ENUMTelephone Number Mapping电话号码映射GMSCGateway Mobile Switching Center网关移动交换中心HLRHome Location Register归属位置寄存器HSSHome Subscriber Server归属用户服务器HTTPHyper Text Transfer Protocol超文本传输协议MIMEMultipurpose Internet Mail Extensions多用途因特网邮件扩展I-CSCFInterrogating-CSCF查询-CSCFIMSIP Multimedia Core Network SubsystemIP多媒体网络子系统IMSIInternational Mobile Subscriber Identifier国际移动用户标识ISCIP multimedia Subsystem Service ControlIMS业务控制NATNetwork Address Translation网络地址转换P-CSCFProxy CSCF代理CSCFS-CSCFServing-CSCF服务-SCSCFSDPSession Description Protocol会话描述协议SIPSession Initiation Protocol会话发起协议SOAPSimple Object Access Protocol简单对象访问协议SPService Provider服务内容提供者TCPTransmission Control Protocol传输控制协议TMSTerminal Management System终端管理系统OMSOperational Management System操作管理系统UAUser Agent用户代理UDPUser Datagram Protocol用户数据报协议URLUniform Resource Locator统一资源定位3.2 术语和定义下列术语和定义适用于本文件。4 IP PBX在网络中的位置IP PBX通过BAC接入IMS核心网络，位于网络的接入层（见图1）。IMS网络终端管理及业务发放能力平台（以下简称IMS终端管理平台）实现IP PBX的统一管理和业务发放功能。IP PBX上电后首先与IMS终端管理平台进行交互，认证鉴权通过后，IMS终端管理平台下发IP PBX相关的配置参数和业务发放参数，包括BAC地址、用户注册到核心网的账号、密码及其他业务发放数据，IP PBX根据下发的参数注册到IMS核心网，实现相关的业务功能。IP PBX与核心网的连接包括SIP中继方式和用户注册方式。本接口规范仅涉及到用户注册方式的用户注册信息的获取。IP PBX用户注册方式包括逐用户注册、隐式注册集、通配注册等。BACIP PBX IMS核心网 IMS终端管理平台 图1 IP PBX在网络中的位置5 功能要求5.1 终端管理IP PBX出厂需要预配置32位设备序列号以及IMS终端管理平台的域名或地址，序列号格式定义参见6.2终端管理接口章节。IP PBX上电后，能够采用预配置的帐号+密码分别进行自动登录，不同用户采用不同的注册端口。IP PBX先向IMS终端管理平台注册，认证鉴权通过后，下载相应的配置参数文件，获取终端登录核心网的配置参数，实现IP PBX零配置运营。IP PBX无法连接IMS终端管理平台，可以采用之前下载的相关参数向IMS注册，为用户提供通信服务，在用户完成注册之后，终端周期性检测终端管理平台可达性，如果检测到可达，尝试与IMS终端管理平台连接，一旦IMS终端管理平台能够正常连接，通过终端管理平台下载配置信息，重新向IMS进行注册。认证过程中如果密码错误，不向IMS网络注册，不提供通信服务功能。IP PBX获取配置参数后，采用下载的配置参数向核心网络注册，注册不成功，不能提供基本的通信功能。终端提供密码修改功能。6 接口要求本章描述IP PBX与终端管理平台之间的接口，采用TR069协议。6.1 初始流程6.1.1 配置信息获取IP PBX上电后，通过TR069协议，与IMS终端管理平台交互，获取用户帐号、注册服务器等相关业务配置信息。与IMS终端管理平台之间采用HTTPS传输层加密方案实现用户信息的安全。对于配置文件的下载要求采用HTTPS方式。具体流程6.2终端管理接口章节。终端管理平台不需要通过证书对IP PBX的合法性进行认证。IP PBX应支持通过证书对终端管理平台合法性进行认证，或者忽略通过证书对终端管理平台的合法性进行认证两种方式。（单向证书认证方式）IP PBX登录IMS终端管理平台的账号、密码由用户在开户时获得，并预置在IP PBX中。用户账号采用“区号+用户号码”的方式，长度24位，鉴权密码由数字09组成，长度为6-8位，开户时随机分配，用户可修改。IP PBX要求支持逐用户注册的方式，至少可以支持100个用户帐号。6.1.2 注册到IMS核心网根据业务配置信息，按照IMS注册流程注册到IMS核心网。具体流程参见IMS网络SIP协议总体技术要求。6.2 终端管理接口6.2.1 IMS终端管理平台域名处理IP PBX出厂需要预置IMS终端管理平台域名，如：;IP PBX需要判断IMS终端管理平台采用IP地址还是域名，如果采用域名方式，需要在域名之前增加用户帐号（固话帐号）区号的前两位，如广州为20，深圳为75等(海南为898，其他的省市均取区号前两位)，形成如20.域名的形式。然后采用该域名与IMS终端管理平台进行注册流程。对于采用移动号码作为帐号的用户，IP PBX可以提供方式设置用户所归属省，终端加插用户省会区号，形成域名与IMS终端管理平台交互注册。6.2.2 上电业务发放由IMS终端管理平台实现终端管理和业务发放功能。IP PBX与IMS终端管理平台之间遵循TR069协议规范。IMS终端管理平台需要根据用户属性，下发制定的代理服务器地址（包括主用和备用的）。 设备信息包括： 表3 终端设备信息表名称类型描述Manufacturerstring(32)制造商名称OUIstring(6)设备制造商的组织唯一标识，6位字符或数字ProductClassstring(64)产品类型标识SerialNumberstring(64)指定产品类型和制造商，该标识可以唯一确定该设备示例：XXX001E10MTH1BAS00100300*01000200000000000000其中，SerialNumber格式如下：根据TR-069 定义，SerialNumber 可以是长度为64 的字符串。本规范仅规定低32个字符的结构，每个字符可用字符为“0”“9”，“A”“Z”是终端设备的唯一标识码；其余的字符由厂商自己定义，可为空。比如为 11 000000 0001 001 0 0000 0030 0004 C7E7格式为 AA BBBBBB CCCC DDD E FFFFFFFFFFFFFFFFAA（2） 表示整个字符串的校验码(用“00”表示未用)。如果采用校验码，校验码采用低16位累加后模256的余数。BBBBBB（6） 第1 个字符为运营商编号，“0”为未定义，“1”为中国电信；第24 个字符为终端类型， “003” 7寸屏及以上视频终端；“004”SIP语音终端；“005”为4.3寸屏视频终端；“006”为软终端；“007”为专用会议终端；“008”为IP PBX设备；最后2位预留，缺省为“00”。CCCC（4） 终端类型编号，入网认证通过后授予的编号。每种终端在测试入网后分配一个编号。对应每个编号，终端厂家需要提供终端的相关属性，包括屏幕大小、分辨率等信息。DDD（3） 表示终端类型或批次，如001，厂商可以自行定义。可用字符为“0”“9”，“A”“Z”。E（1） E表示终端的硬件识别符类型，现未用，用“0”表示。FFFFFFFFFFFFFFFF（16） 对于IP PBX，多个用户可共用一个IP PBX设备识别符。表示终端的硬件识别符，由生产厂家提供，相当于IP PBX设备序列号，不允许重复，例如0200 0030 0004C7E7，表示终端硬件识别符为020000300004C7E7。整个设备信息在IP PBX出厂前设置好，用户无法进行修改。设备识别符可用字符为“0”“9”，“A”“Z”。最高三位作为区域标识，用区号进行标识，如广州用“020”，深圳用“755”。低13位由厂家自行定义。 业务发放流程 图3：业务认证流程开始终端发出Inform请求，携带参数EventCode ：TRANSFERCOMPLETE；服务器发出InformResponse终端发送TransferComplete，要求结束会话，并上报下载情况 服务器端发送TransferCompleteResponse 注册流程 图4：下载配置文件流程说明：IP PBX首次开户时，序列号可以不绑定，终端管理平台默认为全0。IP PBX注册，仅对用户账号及密码进行鉴权，鉴权通过后，IMS终端管理平台直接将登陆IP PBX的序列号记录到数据库。IMS终端管理平台需对终端上报的序列号进行检查，只有允许的终端类型序列号允许接入，否则，提示序列号错误。如果IP PBX登录的序列号与数据库记录的序列号不一致，提示序列号错误。用户更换IP PBX，需要通过网厅、10000号或营业厅等方式取消序列号绑定，将IP PBX对应的所有帐号的序列号清0。设备序列号不正确，用户名密码错时，需提示出错原因。用户无法通过该帐号进行呼出和呼入，其他功能不受影响。若IP PBX连接IMS终端管理及不成功，若登录帐号与之前成功下载配置文件的登录帐号一致，可以采用上次保存的参数到核心网注册认证。若下载参数的登录帐号与当前的登录帐号不一致，用户无法使用上次保存参数到核心网注册，用户无法使用通信等与核心网相关的功能。IP PBX用户名密码正确，但无法下载到配置文件，或者配置文件部分下载，则先更新已下载的部分参数，采用设备存储的配置参数，提供服务。主用代理服务器和备用代理服务器可以采用IP地址或域名方式下发。如果仅下发主用代理服务器的域名，需要通过DNS解析，获取代理服务器的IP地址，应至少能缓存优先级最高和次高的IP地址，优先级最高的作为主用代理服务器的IP地址，优先级次高的IP地址作为代理服务器的备用IP地址。如果下发主用和备用不同的域名，分别用主用、备用的域名解析获取优先级最高的IP地址作为主备用的代理服务器的IP地址。 IP PBX先使用主用代理服务器的IP地址进行注册，注册不成功使用备用代理服务器的IP地址，若所有代理服务器都无法注册成功，需要重新查询DNS获取新的返回结果，重新进行注册。在终端未注册成功之前，可以启用逃生口的语音通信功能。IP PBX应支持代理服务器域名解析结果的缓存。如果DNS刷新返回的优先级最高的IP地址与当前使用的IP地址不相同时，在当前使用的IP地址可用的情况下，不应将业务切换到新的IP地址所在的代理服务器上，在当前使用的IP地址不可用的情况下，需将业务切换到新的IP地址所在的代理服务器上。 配置文件格式认证服务器与终端之间认证并发送配置文件接口采用TR-069协议，服务器与设备接口之间发送的配置文件采用xml文件。LAN接入方式下：ConfigFile.xml/服务器与设备接口下发配置文件的xml样例8888000112345678ctcims.gd9506095060 /news/index.html /telephone.html http:/ /* 可选 */8080 50:8082/EPG/jsp/AuthenticationURL 1：8080/instantconference 1：8080/instantconference 1182664 配置文件随着后续业务功能的增加，相关参数也会有所增加，终端对于无法处理的参数可以忽略，不能报错，或者无法处理。如App_Store参数的处理等。表4 配置文件参数说明编号参数描述1SIP_Account_Username登陆IMS网络帐号2SIP_Account_Password登陆IMS网络密码3User_Domain用户域名，例：4SIP_Proxy主用代理服务器地址或域名5Proxy_Port主用代理服务器端口6SIP_Backup_Proxy备用代理服务器地址或域名7Backup_Proxy_Port备用代理服务器端口8Info_Portal网页门户URL9TEL_Portal呼叫门户URL10Best_Portal号百应用门户URL11Update_Server版本更新服务器（未用）12App_Store应用软件下载网址13HTTP_ProxyOA网代理服务器地址14HTTP_Proxy_PortOA网代理服务器端口；端口为0表示不使用代理服务器15iTV_PortaliTV业务Portal16Conf_Portal多方通话业务Portal,要求IMS终端管理平台能够在标准的域名之后携带用户账号信息17Conf_Web_Portal会议WEB Portal18Conf_AccessCode会议接入码19NTP_Server时间服务器地址或域名 RPC方法 表5 配置文件下载调用的RPC方法名IMS SIP硬终端IMS终端管理平台InformInformResponseGetParameterValuesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadTransferCompleteTransferCompleteResponseRPC方法Schema：TR-069协议传输过程中包格式: / 客户端向服务器发送的连接请求Inform message - Annex A.3.3.1 / 服务器响应客户端的连接请求InformResponse message - Annex A.3.3.1 / 服务器请求客户端发送用户名和密码GetParameterValues message - Annex A.3.2.2 / 客户端向服务器发送用户名和密码GetParameterValuesResponse message - Annex A.3.2.2/ 服务器端更改客户端相应参数 SetParameterValues message - Annex A.3.2.1 /客户端响应服务器的更改参数请求 SetParameterValuesResponse message - Annex A.3.2.1 All Parameter changes have been validated and applied All Parameter changes have been validated and committed, but some or all are not yet applied (for example, if a reboot is required before the new values are applied) / 服务器向客户端发送下载文件的URL并要求客户端开始下载文件Download message - Annex A.3.2.8 / 客户端下载完毕后响应服务器端的DOWNLOAD请求DownloadResponse message - Annex A.3.2.8 Download has completed and been applied Download has not yet been completed and applied / 客户端请求结束会话，并报告下载情况TransferComplete message - Annex A.3.3.2 / 服务器响应TransferComplete请求结束会话 TransferCompleteResponse message - Annex A.3.3.2关于soap消息格式，举例如下：InformInform message - Annex A.3.3.1TR-069参数：其中GetParameterValues/GetParameterValuesResponse中用户名、密码为Device.ManagementServer.Username, Device.Managem