TR069管理接口规范.docx
《TR069管理接口规范.docx》由会员分享,可在线阅读,更多相关《TR069管理接口规范.docx(26页珍藏版)》请在冰豆网上搜索。
![TR069管理接口规范.docx](https://file1.bdocx.com/fileroot1/2022-11/27/f09e529d-cc82-4e8d-a480-8b5f0fd22a09/f09e529d-cc82-4e8d-a480-8b5f0fd22a091.gif)
TR069管理接口规范
B.1
保密等级:
公开发放
中国电信集团公司发布
中国电信IPPBXTR069管理接口规范
V0.8
附 录 A
附 录 B
Q/CT****-20**
中国电信集团公司技术标准
目 次
目 次ﻩI
中国电信IPPBXTR069管理接口规范ﻩ1
1范围1
2 规范性引用文件1
3 缩略语、术语和定义ﻩ1
3.1 缩略语1
3.2术语和定义2
4IPPBX在网络中的位置2
5功能要求ﻩ2
5.1终端管理ﻩ2
6接口要求ﻩ3
6.1初始流程3
6.1.1配置信息获取3
6.1.2 注册到IMS核心网3
6.2终端管理接口(I5)3
6.2.1IMS终端管理平台域名处理ﻩ3
6.2.2 上电业务发放4
6.2.2.1 业务发放流程5
6.2.2.2 配置文件格式ﻩ8
6.2.2.3RPC方法ﻩ9
6.2.3密码修改17
6.2.3.1密码修改流程ﻩ17
6.2.3.2RPC方法ﻩ18
1ﻬ前 言
本标准按照GB/T1.1-2009给出的规则起草。
本标准是中国电信IPPBx标准之一,该系列标准的结构及名称如下:
1)
2)
本标准由中国电信集团公司提出并归口。
本标准起草单位:
中国电信股份有限公司广州研究院
本标准主要起草人:
本标准于20**年*次发布,本次为首次发布。
中国电信IP PBXTR069管理接口规范
1 范围
本规范规定了IMS核心网络下基于SIP协议的IP PBX在网络中的位置及接口等方面的要求。
本规范适用于中国电信IPPBX。
2 规范性引用文件
下列文件中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修改版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
Q/CT 2094-2010IMS网络SIP协议总体技术要求
Q/CT 2460-2012 中国电信IMS SIP硬终端技术要求
3 缩略语、术语和定义
缩略语
下列缩略语适用于本标准:
AS
ApplicationServer
应用服务器
CIF
CommonIntermediateFormat
公共中间格式352×288
CSCF
CallSessionControlFunction
呼叫会话控制功能
DNS
DomainNameServer
域名服务器
ENUM
TelephoneNumberMapping
电话号码映射
GMSC
GatewayMobile SwitchingCenter
网关移动交换中心
HLR
HomeLocationRegister
归属位置寄存器
HSS
Home SubscriberServer
归属用户服务器
HTTP
HyperTextTransferProtocol
超文本传输协议
MIME
Multipurpose InternetMailExtensions
多用途因特网邮件扩展
I-CSCF
Interrogating-CSCF
查询-CSCF
IMS
IP MultimediaCoreNetworkSubsystem
IP多媒体网络子系统
IMSI
InternationalMobile SubscriberIdentifier
国际移动用户标识
ISC
IPmultimediaSubsystemServiceControl
IMS业务控制
NAT
Network AddressTranslation
网络地址转换
P-CSCF
ProxyCSCF
代理CSCF
S-CSCF
Serving-CSCF
服务-SCSCF
SDP
SessionDescriptionProtocol
会话描述协议
SIP
SessionInitiationProtocol
会话发起协议
SOAP
SimpleObjectAccessProtocol
简单对象访问协议
SP
ServiceProvider
服务内容提供者
TCP
Transmission ControlProtocol
传输控制协议
TMS
Terminal Management System
终端管理系统
OMS
Operational Management System
操作管理系统
UA
UserAgent
用户代理
UDP
User DatagramProtocol
用户数据报协议
URL
UniformResourceLocator
统一资源定位
术语和定义
下列术语和定义适用于本文件。
4 IPPBX在网络中的位置
IPPBX通过BAC接入IMS核心网络,位于网络的接入层(见图1)。
IMS网络终端管理及业务发放能力平台(以下简称IMS终端管理平台)实现IPPBX的统一管理和业务发放功能。
IPPBX上电后首先与IMS终端管理平台进行交互,认证鉴权通过后,IMS终端管理平台下发IPPBX相关的配置参数和业务发放参数,包括BAC地址、用户注册到核心网的账号、密码及其他业务发放数据,IP PBX根据下发的参数注册到IMS核心网,实现相关的业务功能。
IPPBX与核心网的连接包括SIP中继方式和用户注册方式。
本接口规范仅涉及到用户注册方式的用户注册信息的获取。
IPPBX用户注册方式包括逐用户注册、隐式注册集、通配注册等。
图1IP PBX在网络中的位置
5 功能要求
终端管理
IPPBX出厂需要预配置32位设备序列号以及IMS终端管理平台的域名或地址,序列号格式定义参见6.2终端管理接口章节。
IPPBX上电后,能够采用预配置的帐号+密码分别进行自动登录,不同用户采用不同的注册端口。
IPPBX先向IMS终端管理平台注册,认证鉴权通过后,下载相应的配置参数文件,获取终端登录核心网的配置参数,实现IPPBX零配置运营。
IPPBX无法连接IMS终端管理平台,可以采用之前下载的相关参数向IMS注册,为用户提供通信服务,在用户完成注册之后,终端周期性检测终端管理平台可达性,如果检测到可达,尝试与IMS终端管理平台连接,一旦IMS终端管理平台能够正常连接,通过终端管理平台下载配置信息,重新向IMS进行注册。
认证过程中如果密码错误,不向IMS网络注册,不提供通信服务功能。
IPPBX获取配置参数后,采用下载的配置参数向核心网络注册,注册不成功,不能提供基本的通信功能。
终端提供密码修改功能。
6 接口要求
本章描述IPPBX与终端管理平台之间的接口,采用TR069协议。
初始流程
配置信息获取
IPPBX上电后,通过TR069协议,与IMS终端管理平台交互,获取用户帐号、注册服务器等相关业务配置信息。
与IMS终端管理平台之间采用HTTPS传输层加密方案实现用户信息的安全。
对于配置文件的下载要求采用HTTPS方式。
具体流程6.2终端管理接口章节。
终端管理平台不需要通过证书对IPPBX的合法性进行认证。
IPPBX应支持通过证书对终端管理平台合法性进行认证,或者忽略通过证书对终端管理平台的合法性进行认证两种方式。
(单向证书认证方式)
IPPBX登录IMS终端管理平台的账号、密码由用户在开户时获得,并预置在IP PBX中。
用户账号采用“区号+用户号码”的方式,长度24位,鉴权密码由数字0~9组成,长度为6-8位,开户时随机分配,用户可修改。
IP PBX要求支持逐用户注册的方式,至少可以支持100个用户帐号。
注册到IMS核心网
根据业务配置信息,按照IMS注册流程注册到IMS核心网。
具体流程参见《IMS网络SIP协议总体技术要求》。
终端管理接口
IMS终端管理平台域名处理
IPPBX出厂需要预置IMS终端管理平台域名,如:
https:
//tms.ctcims.cn;
IP PBX需要判断IMS终端管理平台采用IP地址还是域名,如果采用域名方式,需要在域名之前增加用户帐号(固话帐号)区号的前两位,如广州为20,深圳为75等(海南为898,其他的省市均取区号前两位),形成如20.域名的形式。
然后采用该域名与IMS终端管理平台进行注册流程。
对于采用移动号码作为帐号的用户,IP PBX可以提供方式设置用户所归属省,终端加插用户省会区号,形成域名与IMS终端管理平台交互注册。
上电业务发放
由IMS终端管理平台实现终端管理和业务发放功能。
IPPBX与IMS终端管理平台之间遵循TR069协议规范。
IMS终端管理平台需要根据用户属性,下发制定的代理服务器地址(包括主用和备用的)。
设备信息包括:
表3终端设备信息表
名称
类型
描述
Manufacturer
string(32)
制造商名称
OUI
string(6)
设备制造商的组织唯一标识,6位字符或数字
ProductClass
string(64)
产品类型标识
SerialNumber
string(64)
指定产品类型和制造商,该标识可以唯一确定该设备
示例:
XXX
<OUI>001E10</OUI>
<ProductClass>MTH1BAS</ProductClass>
<SerialNumber>00100300****000000000SerialNumber>
其中,SerialNumber格式如下:
根据TR-069定义,SerialNumber 可以是长度为64的字符串。
本规范仅规定低32个字符的结构,每个字符可用字符为“0”~“9”,“A”~“Z”是终端设备的唯一标识码;其余的字符由厂商自己定义,可为空。
比如为 11000000 0001 00100000 00300004C7E7
格式为 AA BBBBBBCCCCDDD EFFFFFFFFFFFFFFFF
AA(2) 表示整个字符串的校验码(用“00”表示未用)。
如果采用校验码,校验码采用低16位累加后模256的余数。
BBBBBB(6)第1 个字符为运营商编号,“0”为未定义,“1”为中国电信;第2~4个字符为终端类型,“003”7寸屏及以上视频终端;“004”SIP语音终端;“005”为4.3寸屏视频终端;“006”为软终端;“007”为专用会议终端;“008”为IPPBX设备;最后2位预留,缺省为“00”。
CCCC(4)终端类型编号,入网认证通过后授予的编号。
每种终端在测试入网后分配一个编号。
对应每个编号,终端厂家需要提供终端的相关属性,包括屏幕大小、分辨率等信息。
DDD(3)表示终端类型或批次,如001,厂商可以自行定义。
可用字符为“0”~“9”,“A”~“Z”。
E(1)E表示终端的硬件识别符类型,现未用,用“0”表示。
FFFFFFFFFFFFFFFF(16)
对于IPPBX,多个用户可共用一个IPPBX设备识别符。
表示终端的硬件识别符,由生产厂家提供,相当于IPPBX设备序列号,不允许重复,例如020000300004C7E7,表示终端硬件识别符为020000300004C7E7。
整个设备信息在IPPBX出厂前设置好,用户无法进行修改。
设备识别符可用字符为“0”~“9”,“A”~“Z”。
最高三位作为区域标识,用区号进行标识,如广州用“020”,深圳用“755”。
低13位由厂家自行定义。
业务发放流程
图3:
业务认证流程
图4:
下载配置文件流程
说明:
IPPBX首次开户时,序列号可以不绑定,终端管理平台默认为全0。
IPPBX注册,仅对用户账号及密码进行鉴权,鉴权通过后,IMS终端管理平台直接将登陆IPPBX的序列号记录到数据库。
IMS终端管理平台需对终端上报的序列号进行检查,只有允许的终端类型序列号允许接入,否则,提示序列号错误。
如果IPPBX登录的序列号与数据库记录的序列号不一致,提示序列号错误。
用户更换IP PBX,需要通过网厅、10000号或营业厅等方式取消序列号绑定,将IPPBX对应的所有帐号的序列号清0。
设备序列号不正确,用户名密码错时,需提示出错原因。
用户无法通过该帐号进行呼出和呼入,其他功能不受影响。
若IPPBX连接IMS终端管理及不成功,若登录帐号与之前成功下载配置文件的登录帐号一致,可以采用上次保存的参数到核心网注册认证。
若下载参数的登录帐号与当前的登录帐号不一致,用户无法使用上次保存参数到核心网注册,用户无法使用通信等与核心网相关的功能。
IP PBX用户名密码正确,但无法下载到配置文件,或者配置文件部分下载,则先更新已下载的部分参数,采用设备存储的配置参数,提供服务。
主用代理服务器和备用代理服务器可以采用IP地址或域名方式下发。
如果仅下发主用代理服务器的域名,需要通过DNS解析,获取代理服务器的IP地址,应至少能缓存优先级最高和次高的IP地址,优先级最高的作为主用代理服务器的IP地址,优先级次高的IP地址作为代理服务器的备用IP地址。
如果下发主用和备用不同的域名,分别用主用、备用的域名解析获取优先级最高的IP地址作为主备用的代理服务器的IP地址。
IPPBX先使用主用代理服务器的IP地址进行注册,注册不成功使用备用代理服务器的IP地址,若所有代理服务器都无法注册成功,需要重新查询DNS获取新的返回结果,重新进行注册。
在终端未注册成功之前,可以启用逃生口的语音通信功能。
IP PBX应支持代理服务器域名解析结果的缓存。
如果DNS刷新返回的优先级最高的IP地址与当前使用的IP地址不相同时,在当前使用的IP地址可用的情况下,不应将业务切换到新的IP地址所在的代理服务器上,在当前使用的IP地址不可用的情况下,需将业务切换到新的IP地址所在的代理服务器上。
配置文件格式
认证服务器与终端之间认证并发送配置文件接口采用TR-069协议,服务器与设备接口之间发送的配置文件采用xml文件。
LAN接入方式下:
ConfigFile.xml//服务器与设备接口下发配置文件的xml样例
xmlversion="1.0" encoding="UTF-8"?
>
<ConfigFilexmlns:
xs="http:
//www.w3.org/2001/XMLSchema">
<SIP_Account_Username>88880001@huawSIP_Account_Username>
12345678</SIP_Account_Password>
ctcims.gd
121.33.232.995060</Proxy_Port>
<SIP_Backup_Proxy>121.33.232.99</SIP_Backup_Proxy>
<Info_Portal>http:
//www.chinatelec/news/index.htmlInfo_Portal>
http:
//www.chinatelecom.com.cn/telephone.html
http:
//www.118114.cn</Best_Portal>
<Update_Server>http:
//www.update.com
http:
// /* 可选*/
isa.gd.ctc.com</HTTP_Proxy>
<HTTP_Proxy_Port>8080
<iTV_Portal>http:
//125.88.102.150:
8082/EPG/jsp/AuthenticationURL</iTV_Portal>
http:
//125.88.72.41:
8080/instantconference<Conf_Portal>
//125.88.72.41:
8080/instantconference<Conf_Web_Portal>
210.72.145.44</NTP_Server>
</ConfigFile>
配置文件随着后续业务功能的增加,相关参数也会有所增加,终端对于无法处理的参数可以忽略,不能报错,或者无法处理。
如App_Store参数的处理等。
表4配置文件参数说明
编号
参数
描述
1
SIP_Account_Username
登陆IMS网络帐号
2
SIP_Account_Password
登陆IMS网络密码
3
User_Domain
用户域名,例:
gd.ctcims.cn
4
SIP_Proxy
主用代理服务器地址或域名
5
Proxy_Port
主用代理服务器端口
6
SIP_Backup_Proxy
备用代理服务器地址或域名
7
Backup_Proxy_Port
备用代理服务器端口
8
Info_Portal
网页门户URL
9
TEL_Portal
呼叫门户URL
10
Best_Portal
号百应用门户URL
11
Update_Server
版本更新服务器(未用)
12
App_Store
应用软件下载网址
13
HTTP_Proxy
OA网代理服务器地址
14
HTTP_Proxy_Port
OA网代理服务器端口;端口为0表示不使用代理服务器
15
iTV_Portal
iTV业务Portal
16
Conf_Portal
多方通话业务Portal,要求IMS终端管理平台能够在标准的域名之后携带用户账号信息
17
Conf_Web_Portal
会议WEBPortal
18
Conf_AccessCode
会议接入码
19
NTP_Server
时间服务器地址或域名
RPC方法
表5 配置文件下载调用的RPC方法名
IMSSIP硬终端
IMS终端管理平台
Inform
InformResponse
GetParameterValuesResponse
GetParameterValues
SetParameterValuesResponse
SetParameterValues
DownloadResponse
Download
TransferComplete
TransferCompleteResponse
RPC方法Schema:
TR-069协议传输过程中包格式:
<!
--
SOAPHeaderElements
-->
elementname="ID">
complexType>
ﻩsimpleContent>ﻩ
ﻩﻩﻩ<xs:
extensionbase="xs:
string">
ﻩﻩﻩ<xs:
attributeref="soapenv:
mustUnderstand"use="required"fixed="1"/>
ﻩ
extension>
ﻩﻩ
simpleContent>
ﻩ</xs:
complexType>
element>
elementname="HoldRequests">
complexType>
ﻩ<xs:
simpleContent>
ﻩextensionbase="xs:
boolean">
ﻩﻩﻩﻩ<xs:
attribute ref="soapenv:
mustUnderstand"use="required"fixed="1"/>
ﻩ</xs:
extension>
simpleContent>
ﻩ
complexType>
</xs:
element>
--Inform --> //客户端向服务器发送的连接请求
elementname="Inform">
annotation>
ﻩdocumentation>Informmessage -AnnexA.3.3.1
documentation>
</xs:
annotation>
ﻩ<xs:
complexType>
sequence>
ﻩelementname="DeviceId"type="tns:
DeviceIdStruct"/>
ﻩﻩelementname="Event" type="tns:
EventList"/>
ﻩﻩ<xs:
elementname="MaxEnvelopes" type="xs:
unsignedInt"/>
ﻩﻩﻩelementname="CurrentTime" type="xs:
dateTime"/>
ﻩﻩelementname="RetryCount" type="xs:
unsignedInt"/>
ﻩﻩelementname="ParameterList"type="tns:
ParameterValueList"/>
ﻩ</xs:
sequence>
complexType>
xs:
element>
<!
--InformResponse -->// 服务器响应客户端的连接请求
<xs:
elementname="InformResponse">
ﻩ<xs:
annotation>
ﻩ<xs:
documentation>InformResponsemessage -AnnexA.3.3.1
documentation>
</xs:
annotation>
ﻩ<xs:
complexType>
ﻩsequence>
ﻩelement name="MaxEnvelopes"type="xs:
unsignedInt"/>
ﻩ</xs:
sequence>
xs:
complexType>
</xs:
element>
--GetParameterValues-->//服务器请求客户端发送用户名和密码
<xs:
elementname="GetParameterValues">
annotation>
documentation>GetP