TR069管理接口规范.docx

TR069管理接口规范.docx

《TR069管理接口规范.docx》由会员分享，可在线阅读，更多相关《TR069管理接口规范.docx（26页珍藏版）》请在冰豆网上搜索。

TR069管理接口规范

B.1　

保密等级：

公开发放

中国电信集团公司发布

中国电信IPPBXTR069管理接口规范

V0.8

附　录　A

附　录　B

Q/CT****-20**

中国电信集团公司技术标准

目　次

目　次ﻩI

中国电信IPＰBXTR06９管理接口规范ﻩ1

1范围１

2　规范性引用文件1

3　缩略语、术语和定义ﻩ1

3.1　缩略语１

3.2术语和定义２

４IPPBX在网络中的位置2

5功能要求ﻩ2

5．1终端管理ﻩ2

6接口要求ﻩ3

６.1初始流程3

６.1.１配置信息获取3

6．1.2　注册到IMS核心网3

6.2终端管理接口（Ｉ5）３

６.2.1IMＳ终端管理平台域名处理ﻩ3

６.2.2　上电业务发放４

６.2.２．1　业务发放流程5

6.２.２.2　配置文件格式ﻩ8

6.2.2.3RPC方法ﻩ9

6.2.3密码修改１7

6.2.3.１密码修改流程ﻩ17

6．2.3.２RPＣ方法ﻩ1８

1ﻬ前　　言

本标准按照GB／T1．１-2０09给出的规则起草。

本标准是中国电信ＩPPBｘ标准之一，该系列标准的结构及名称如下：

１）

2）

本标准由中国电信集团公司提出并归口。

本标准起草单位:

中国电信股份有限公司广州研究院

本标准主要起草人:

本标准于20*＊年*次发布，本次为首次发布。

中国电信IP　PＢXＴＲ０6９管理接口规范

1　范围

本规范规定了IMＳ核心网络下基于SIP协议的IP　PＢＸ在网络中的位置及接口等方面的要求。

本规范适用于中国电信IＰPBＸ。

2　规范性引用文件

下列文件中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。

凡是注日期的引用文件,其随后所有的修改单（不包括勘误的内容）或修改版均不适用于本标准，然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。

凡是不注日期的引用文件,其最新版本适用于本标准。

Q/CＴ　2094－2０１0IＭＳ网络SIP协议总体技术要求

Ｑ/ＣＴ　2460-2012　中国电信IMS　SIP硬终端技术要求

3　缩略语、术语和定义

缩略语

下列缩略语适用于本标准:

ＡＳ

AｐplicatioｎServer

应用服务器

CIF

CｏｍｍonＩｎtermeｄiateFｏrｍat　

公共中间格式352×2８8

ＣSCＦ

ＣallＳessionCｏｎtrolFunction　

呼叫会话控制功能

DNＳ

DomainNameServｅr

域名服务器

EＮUM

TｅlephoneNuｍbeｒMaｐｐｉｎｇ

电话号码映射

ＧMSC

ＧatewayＭobｉｌｅ　ＳwitｃhingCeｎter

网关移动交换中心

ＨLR

ＨomｅＬocatiｏnRegistｅr

归属位置寄存器

HSS

Ｈomｅ　SuｂscrｉbeｒServｅr

归属用户服务器

HTＴP

ＨｙperＴextTrａｎｓferProtｏcol

超文本传输协议

MIＭＥ

Mｕｌｔiｐuｒpose　InteｒｎeｔMailExtenｓｉｏｎs

多用途因特网邮件扩展

I－CSCF

Ｉｎtｅｒrｏgaｔing-CＳＣF

查询-CSCF

IMS

ＩP　MuｌｔimedｉａＣorｅNｅtwｏrkSubsystｅm

IＰ多媒体网络子系统

IMSＩ

ＩnｔernationalMoｂiｌe　SｕbscriｂeｒＩｄｅntifier

国际移动用户标识

ISＣ

IPmｕlｔiｍedｉａSubｓyｓtemSｅrvｉceContｒol

IMＳ业务控制

NAT

Netｗｏrｋ　AddresｓTｒanslation

网络地址转换

P-ＣSCF

ProxyCSＣF

代理CSCF

Ｓ-ＣSＣF

Ｓerving-CSCＦ

服务-SCＳＣF

SＤＰ

SessioｎDescｒiｐtiｏｎProtocol

会话描述协议

SIP

SessionInitｉaｔｉonＰroｔocol

会话发起协议

SOＡP

SiｍpleObjｅctAｃcessＰroｔｏcoｌ

简单对象访问协议

ＳP

SｅrｖiceＰrovider

服务内容提供者

TCP

Ｔrａnsmｉsｓion　ContｒolProｔocol

传输控制协议

TMS

Ｔｅrminａｌ　Management　System

终端管理系统

OMS

Opｅratioｎaｌ　Maｎageｍent　System

操作管理系统

UＡ

UsｅｒAｇent

用户代理

UDP

Uｓer　DaｔagramProｔocol

用户数据报协议

UＲL

ＵnifoｒmResｏurcｅＬoｃａｔoｒ

统一资源定位

术语和定义

下列术语和定义适用于本文件。

4　ＩPＰＢX在网络中的位置

IＰPＢX通过BAＣ接入IMS核心网络，位于网络的接入层（见图1）。

ＩMS网络终端管理及业务发放能力平台（以下简称IＭＳ终端管理平台）实现IＰPBX的统一管理和业务发放功能。

ＩPＰBX上电后首先与ＩMS终端管理平台进行交互，认证鉴权通过后,ＩMS终端管理平台下发IPＰBX相关的配置参数和业务发放参数，包括BAC地址、用户注册到核心网的账号、密码及其他业务发放数据，IP　PBＸ根据下发的参数注册到ＩＭS核心网，实现相关的业务功能。

ＩＰPBＸ与核心网的连接包括SIP中继方式和用户注册方式。

本接口规范仅涉及到用户注册方式的用户注册信息的获取。

ＩPPBX用户注册方式包括逐用户注册、隐式注册集、通配注册等。

图１IP　PBＸ在网络中的位置

5　功能要求

终端管理

IPPＢX出厂需要预配置32位设备序列号以及IMS终端管理平台的域名或地址,序列号格式定义参见6.2终端管理接口章节。

IPPBX上电后,能够采用预配置的帐号+密码分别进行自动登录，不同用户采用不同的注册端口。

ＩＰＰBX先向IMS终端管理平台注册,认证鉴权通过后，下载相应的配置参数文件,获取终端登录核心网的配置参数，实现IPPＢX零配置运营。

IPPBＸ无法连接IMS终端管理平台，可以采用之前下载的相关参数向IＭS注册,为用户提供通信服务，在用户完成注册之后，终端周期性检测终端管理平台可达性，如果检测到可达,尝试与IMS终端管理平台连接，一旦IMS终端管理平台能够正常连接,通过终端管理平台下载配置信息,重新向IMS进行注册。

认证过程中如果密码错误,不向ＩＭS网络注册,不提供通信服务功能。

IＰＰBＸ获取配置参数后，采用下载的配置参数向核心网络注册，注册不成功,不能提供基本的通信功能。

终端提供密码修改功能。

6　接口要求

本章描述ＩPＰBＸ与终端管理平台之间的接口,采用TＲ０69协议。

初始流程

配置信息获取

ＩPＰBＸ上电后,通过TR０６9协议，与IMS终端管理平台交互，获取用户帐号、注册服务器等相关业务配置信息。

与IＭＳ终端管理平台之间采用HTTPS传输层加密方案实现用户信息的安全。

对于配置文件的下载要求采用HTTＰS方式。

具体流程6.2终端管理接口章节。

终端管理平台不需要通过证书对IＰPＢＸ的合法性进行认证。

IPＰBＸ应支持通过证书对终端管理平台合法性进行认证，或者忽略通过证书对终端管理平台的合法性进行认证两种方式。

（单向证书认证方式）

IPPBＸ登录IMS终端管理平台的账号、密码由用户在开户时获得,并预置在IＰ　PBX中。

用户账号采用“区号+用户号码”的方式,长度24位，鉴权密码由数字０～9组成,长度为6-8位，开户时随机分配,用户可修改。

IP　PBX要求支持逐用户注册的方式,至少可以支持1００个用户帐号。

注册到IMS核心网

根据业务配置信息,按照ＩＭＳ注册流程注册到ＩMS核心网。

具体流程参见《ＩMＳ网络ＳIＰ协议总体技术要求》。

终端管理接口

IＭS终端管理平台域名处理

ＩPPBX出厂需要预置IMS终端管理平台域名,如:

https：

//tmｓ.cｔcims.ｃn;

IＰ　PBX需要判断IＭＳ终端管理平台采用IP地址还是域名，如果采用域名方式，需要在域名之前增加用户帐号（固话帐号）区号的前两位，如广州为20，深圳为7５等（海南为898，其他的省市均取区号前两位），形成如２０.域名的形式。

然后采用该域名与IMS终端管理平台进行注册流程。

对于采用移动号码作为帐号的用户,ＩＰ　PＢX可以提供方式设置用户所归属省，终端加插用户省会区号，形成域名与IMS终端管理平台交互注册。

上电业务发放

由ＩＭS终端管理平台实现终端管理和业务发放功能。

ＩPPＢX与IMＳ终端管理平台之间遵循TR06９协议规范。

IMS终端管理平台需要根据用户属性，下发制定的代理服务器地址（包括主用和备用的）。

设备信息包括:

　　　　表3终端设备信息表

名称

类型

描述

Manufａｃtureｒ

strｉng（32）

制造商名称

OUI

string（6）

设备制造商的组织唯一标识，6位字符或数字

ProducｔClａsｓ

ｓｔring（64）

产品类型标识

SerialNumｂｅr

ｓtring（６4）

指定产品类型和制造商，该标识可以唯一确定该设备

示例：

XXX

<ＯUI>0０1Ｅ１0＜／ＯUI>

<ＰroｄｕctClasｓ>MＴＨ1ＢAS＜/PrｏductClass>

<ＳｅｒｉalNumber>０010０300＊***0００000000

其中,SerｉaｌＮumｂeｒ格式如下：

根据TR-069定义，ＳeriａlNuｍber　可以是长度为64的字符串。

本规范仅规定低32个字符的结构，每个字符可用字符为“0”~“9”，“A”～“Z”是终端设备的唯一标识码；其余的字符由厂商自己定义，可为空。

比如为　1100000０　０001　00100000　0030００04C7Ｅ７

格式为　AA　ＢBBBBBCCＣCDDD　EＦFFＦＦFFFFＦFＦＦFＦF

AA（２）　表示整个字符串的校验码（用“00”表示未用）。

如果采用校验码,校验码采用低16位累加后模２56的余数。

ＢBBBBＢ（６）第1　个字符为运营商编号，“0”为未定义,“1”为中国电信;第2~4个字符为终端类型，“０03”7寸屏及以上视频终端；“０04”SＩP语音终端;“０05”为4．3寸屏视频终端；“０06”为软终端；“00７”为专用会议终端;“008”为IPPBＸ设备;最后2位预留，缺省为“00”。

CCCC（４）终端类型编号，入网认证通过后授予的编号。

每种终端在测试入网后分配一个编号。

对应每个编号,终端厂家需要提供终端的相关属性,包括屏幕大小、分辨率等信息。

DDＤ（3）表示终端类型或批次,如００１,厂商可以自行定义。

可用字符为“０”～“9”,“A”~“Z”。

E（１）E表示终端的硬件识别符类型，现未用,用“0”表示。

FFFＦFFFFFFFFFFＦF（16）

对于IPPBX,多个用户可共用一个IPＰBX设备识别符。

表示终端的硬件识别符,由生产厂家提供,相当于IPＰBX设备序列号，不允许重复，例如02000０30００0４C７E７，表示终端硬件识别符为０２０000300０04C7E7。

整个设备信息在IPPＢＸ出厂前设置好,用户无法进行修改。

设备识别符可用字符为“０”～“9”，“Ａ”~“Z”。

最高三位作为区域标识,用区号进行标识,如广州用“０2０”，深圳用“75５”。

低13位由厂家自行定义。

业务发放流程

　　　　图3:

业务认证流程

图４：

下载配置文件流程

说明:

IＰPＢX首次开户时，序列号可以不绑定，终端管理平台默认为全0。

IＰＰBX注册，仅对用户账号及密码进行鉴权，鉴权通过后，IMＳ终端管理平台直接将登陆IＰPBX的序列号记录到数据库。

IMS终端管理平台需对终端上报的序列号进行检查，只有允许的终端类型序列号允许接入,否则,提示序列号错误。

如果IＰPBX登录的序列号与数据库记录的序列号不一致,提示序列号错误。

用户更换IP　ＰBX,需要通过网厅、1０000号或营业厅等方式取消序列号绑定,将IPPBＸ对应的所有帐号的序列号清0。

设备序列号不正确,用户名密码错时,需提示出错原因。

用户无法通过该帐号进行呼出和呼入,其他功能不受影响。

若IPＰＢＸ连接IMS终端管理及不成功,若登录帐号与之前成功下载配置文件的登录帐号一致，可以采用上次保存的参数到核心网注册认证。

若下载参数的登录帐号与当前的登录帐号不一致,用户无法使用上次保存参数到核心网注册，用户无法使用通信等与核心网相关的功能。

ＩＰ　PBX用户名密码正确,但无法下载到配置文件,或者配置文件部分下载，则先更新已下载的部分参数,采用设备存储的配置参数,提供服务。

主用代理服务器和备用代理服务器可以采用ＩＰ地址或域名方式下发。

如果仅下发主用代理服务器的域名,需要通过DＮS解析，获取代理服务器的IP地址，应至少能缓存优先级最高和次高的ＩP地址,优先级最高的作为主用代理服务器的IP地址，优先级次高的IP地址作为代理服务器的备用IＰ地址。

如果下发主用和备用不同的域名，分别用主用、备用的域名解析获取优先级最高的ＩＰ地址作为主备用的代理服务器的ＩＰ地址。

IPPBX先使用主用代理服务器的IP地址进行注册，注册不成功使用备用代理服务器的IP地址,若所有代理服务器都无法注册成功,需要重新查询DＮS获取新的返回结果,重新进行注册。

在终端未注册成功之前，可以启用逃生口的语音通信功能。

IＰ　PBＸ应支持代理服务器域名解析结果的缓存。

如果DＮＳ刷新返回的优先级最高的ＩP地址与当前使用的IP地址不相同时,在当前使用的IP地址可用的情况下，不应将业务切换到新的IP地址所在的代理服务器上，在当前使用的IP地址不可用的情况下，需将业务切换到新的ＩＰ地址所在的代理服务器上。

配置文件格式

认证服务器与终端之间认证并发送配置文件接口采用TR-069协议，服务器与设备接口之间发送的配置文件采用ｘml文件。

ＬAN接入方式下：

ＣoｎfigFｉle.xmｌ／/服务器与设备接口下发配置文件的xml样例

xmlversｉon=＂1.0"　eｎcoding="UＴF-8"?

>

＜CoｎfigFｉｌexｍlns:

xs="hｔtp：

//wｗw.w3.ｏｒg/2001/ＸMLSchema">

<ＳＩP_Account_Uｓernaｍｅ>88８８0０01@huaｗ

12345６7８＜/ＳIP_Acｃｏunt＿Paｓｓworｄ>

ctｃｉmｓ.ｇd

121.3３.232.99

５０６0<／Proｘy＿Ｐorｔ＞

<ＳIＰ_Backup_Proxy>121.３3．232.99＜/SＩＰ_Backｕp_Proxｙ>

<Ｉnfｏ＿Porｔａｌ＞hｔtp:

／/wｗw.chiｎａteleｃ／neｗs／ｉndex.ｈtml

htｔp：

//www．ｃhinatｅlｅｃoｍ.coｍ.cn/ｔelepｈｏnｅ.ｈｔml

ｈtｔｐ:

/／ｗｗｗ.1１８1１４.cn＜/Beｓt_Portａl>

＜Ｕpdaｔe_Server>hｔtp:

/／ｗww.uｐdａte.ｃoｍ

ｈttp:

／/　　　　　　/*　可选＊/

ｉｓa.ｇd．ctc.cｏm<／HTＴP_Ｐroxy>

＜ＨTTP_Ｐroxy_Pｏｒｔ>8080

<ｉTV＿Poｒｔal>hｔtｐ：

／／125.88．102.150:

80８２/ＥPG/jsp/AuｔｈenｔｉcatiｏnUＲL＜／iTＶ_Poｒtal>

ｈttp：

//１２５．88．７2.４1：

８08０/ｉnsｔａnｔｃonfeｒｅnce<Ｃｏnf_Ｐoｒtal>

//１２5.８8．72．４1:

８080/iｎｓtanｔcoｎfeｒｅｎce＜Ｃonf_Ｗeb_Porｔal＞

210.72.145.4４<／NTP＿Ｓervｅr>

＜/ＣonfiｇＦｉle>

配置文件随着后续业务功能的增加，相关参数也会有所增加,终端对于无法处理的参数可以忽略,不能报错,或者无法处理。

如App_Stoｒe参数的处理等。

表４配置文件参数说明

编号

参数

描述

1

ＳＩP_Accouｎt_Usernaｍe

登陆IＭS网络帐号

2

SIP_Aｃcｏunt_Pａssword

登陆IMS网络密码

３

Usｅｒ_Domａiｎ

用户域名，例:

gd.ctcｉｍs.ｃｎ

4

SIP_Proxy

主用代理服务器地址或域名

5

Pｒoxy_Poｒｔ

主用代理服务器端口

6

SIＰ＿Bacｋup＿Proｘy

备用代理服务器地址或域名

7

Backup_Ｐｒoxｙ＿Port

备用代理服务器端口

8

Iｎｆo＿Porｔal

网页门户URＬ

9

ＴEＬ_Ｐortal

呼叫门户URL

１０

Best＿Pｏrtal

号百应用门户URＬ

1１

Ｕpｄate_Sｅｒver

版本更新服务器（未用）

１2

Apｐ_Stｏre

应用软件下载网址

１３

HTTP＿Pｒoxｙ

ＯＡ网代理服务器地址

14

HTTP_Pｒｏxy_Ｐort

OA网代理服务器端口；端口为0表示不使用代理服务器

15

ｉTV_Portａｌ

iTV业务Poｒtａｌ

16

Conf_Pｏrｔal

多方通话业务Portal,要求IMS终端管理平台能够在标准的域名之后携带用户账号信息

１７

Cｏnf＿Web_Ｐortal

会议ＷEBＰｏrtal

18

Ｃｏnf_AccessCode

会议接入码

1９

NTP_Servｅr

时间服务器地址或域名

ＲPＣ方法

表5　配置文件下载调用的ＲPC方法名

IMSSＩP硬终端

IＭS终端管理平台

Inform

ＩnforｍReｓpoｎse

GetParａmeｔeｒVａlueｓResｐonｓｅ

GｅtPaｒａmｅterＶａlues

ＳeｔParameterVaｌuesResponse

SetParａｍetｅｒＶalｕes

DowｎｌｏａｄＲespoｎse

Downloａd

TｒａnsfｅrCompletｅ

TranｓfｅrComｐｌｅteRespｏｎse

ＲPC方法Scheｍa：

TR－０6９协议传输过程中包格式:

＜!

－-

ＳOAPＨeaｄerElements

-->

elｅmeｎtnａmｅ="ID">

complexＴyｐe>

ﻩ

simplｅＣontent>ﻩ

ﻩﻩﻩ＜xs:

ｅxｔensionｂａse="ｘs:

sｔriｎg＂>

ﻩﻩﻩ<ｘs:

attrｉbuteｒef＝"ｓoａｐeｎv:

mｕｓｔUnｄerstanｄ＂use＝＂reｑuirｅd"ｆｉxed="1＂/>

ﻩ

extenｓion>

ﻩﻩ

simplｅＣoｎtｅｎt>

ﻩ<／xs:

coｍplexＴｙpｅ>

eｌeｍenｔ>

elｅmentｎame="HolｄRequestｓ">

coｍplexType>

ﻩ<ｘs:

simpleContenｔ>

ﻩ

extｅnsioｎｂaｓe="xｓ:

boolｅan">

ﻩﻩﻩﻩ＜xｓ:

attrｉｂute　ｒｅf=＂ｓoapｅnｖ:

ｍustUnｄerstand＂ｕse=＂rｅquｉrｅｄ"fｉxｅd="1＂/>

ﻩ<／xs：

ｅxteｎsioｎ>

ｓｉmpｌeＣoｎtｅｎt＞

ﻩ

ｃｏmplexＴype＞

<／xs:

elｅｍent>

--Iｎfoｒm　－->　//客户端向服务器发送的连接请求

elｅmeｎtnａｍe＝＂Infｏｒm">

ａｎｎotａtiｏn＞

ﻩ

documentａtion＞Ｉｎｆｏrmmessage　-AｎnｅxA.3．３.1

ｄｏｃｕｍeｎｔatｉon>

<／xｓ:

annotａtｉｏn>

ﻩ<ｘs：

cｏmpｌexTｙpｅ>

ｓeｑuenｃｅ>

ﻩ

elemeｎtname="ＤｅviceId"tｙpe="tｎs:

DeviｃeIdＳｔruｃt"/＞

ﻩﻩ

elemｅntname＝"Eveｎt＂　tｙpe="ｔns：

EveｎｔList"／>

ﻩﻩ<ｘｓ:

elemeｎtｎamｅ="ＭａxEnvelopes＂　tyｐｅ＝"xｓ：

unｓignｅｄＩnｔ＂/>

ﻩﻩﻩ

elementnａｍe="CurrｅｎtTｉｍe"　typｅ＝＂ｘｓ:

dａｔeTime"/＞

ﻩﻩ

elementｎaｍe="ＲｅtryＣｏunt"　ｔype="xs：

unsiｇneｄInt"/＞

ﻩﻩ

elemenｔｎaｍe="ParaｍetｅｒLｉst"type＝"ｔns：

ParａmeteｒVaｌueＬist"/＞

ﻩ＜／ｘs：

sequｅncｅ>

coｍplｅxTyｐe>

ｅlement>

＜!

--ＩnｆoｒmＲesponse　--＞//　服务器响应客户端的连接请求

＜xs:

ｅlemｅｎｔnaｍe＝＂InfｏｒｍResponsｅ＂>

ﻩ＜ｘｓ:

annoｔatioｎ>

ﻩ<ｘs:

dｏcｕmｅntation>InｆormRｅsｐｏnsemｅｓsagｅ　-ＡnｎｅxA.3.3.1

documｅntaｔioｎ＞

＜/xｓ:

annotａｔiｏn>

ﻩ<ｘs：

complｅｘＴｙpe>

ﻩ

seqｕence>

ﻩ

element　nａｍe＝"ＭaxEｎｖelopes"ｔype＝"ｘs：

uｎｓiｇnedIｎｔ＂/＞

ﻩ<／xｓ:

sｅquｅncｅ>

cｏmpｌeｘTyｐｅ>

＜/xs:

ｅｌeｍeｎｔ＞

--GetPaｒameterValｕes-－>//服务器请求客户端发送用户名和密码

<ｘs:

elementname="GｅtＰaｒａｍｅｔerVａluｅs">

anｎotaｔｉoｎ>

doｃumentａtｉon＞GｅｔP