移动与视讯宽带融合业务管理平台ISMP规范
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
保密等级:公开发放中国电信集团公司技术标准
Q/CT****.01-****
移动与视讯/宽带融合业务管理平台ISMP
规范
-IPTV 集成方案
V1.2.3
2010- - 发布- - 实施
中国电信集团公司发布
内部资料,注意保密,未经同意,请勿翻印文档信息
修改过程
评审过程
分发范围
目录
目录................................................................................................................................................. I I 前言.. (IV)
1范围 (5)
2规范性引用文件 (5)
3名词术语和缩略语 (5)
3.1 术语 (5)
3.2 缩略语 (5)
3.3 约束 (5)
4系统结构 (7)
4.1ISMP在网络中的位置 (7)
4.2I SMP内部结构 (7)
4.3I SMP接口概述 (8)
5功能 (10)
5.1内容管理 (10)
5.1.1概述 (10)
5.1.2 EPG展现模型说明 (11)
5.1.3 内容导入 (11)
5.2内容/业务/产品/产品组合之间的关系 (12)
5.2.1 对应关系 (12)
5.3IPTV账号与终端绑定(暂定)............................................................................................
一三
5.4业务能力编号及类型...........................................................................................................
一三
5.5内容/产品/业务/套餐编号..................................................................................................
一三
6接口 (14)
6.1账户类型 (14)
6.2I SMA P接口 (14)
6.3统一配置接口 (14)
6.3.1概述 (14)
6.3.1.1全国ISM P到省I SMP统一配置接口 (14)
6.3.1.2省ISMP到业务系统统一配置接口 (14)
6.3.2全国ISM P到省I SMP统一配置接口 (14)
6.3.2.1文件命名规范 (14)
6.3.2.2回执文件命名规范................................................................................................... 一五
6.3.2.3其它说明................................................................................................................... 一五
6.3.2.4统一配置接口文件体定义....................................................................................... 一五
6.3.3省ISMP到业务系统统一配置接口...............................................................................
一五
6.3.3.1数据信息定义........................................................................................................... 一五
6.3.3.2内容信息同步接口................................................................................................... 一五
6.3.3.2.1内容同步通知接口 (17)
6.3.3.2.2 结果通知请求接口 (17)
6.3.3.2.3 同步XML格式...........................................................................................................
一八
6.3.3.2.3.1 ADI定义 (19)
6.3.3.2.3.2 Objects 定义 (19)
6.3.3.2.3.3 Program定义 (20)
6.3.3.2.3.4 Movie定义 (22)
6.3.3.2.3.5 Cast定义 (25)
6.3.3.2.3.6 CastRoleMap定义 (26)
6.3.3.2.3.7 Channel定义 (27)
6.3.3.2.3.8 PhysicalChannel定义 (29)
6.3.3.2.3.9 Schedule 定义 (30)
6.3.3.2.3.10 Picture 定义 (32)
6.3.3.2.3.11 Category 定义 (32)
6.3.3.2.3.12 Series 定义 (33)
6.3.3.2.3.一三 Package 定义 (35)
6.3.3.2.3.14 Mappings 定义 (36)
6.3.3.2.3.一五 Reply 定义 (39)
6.4与CRM接口 (39)
6.4.1用户信息同步接口 (39)
6.4.1.1用户基本信息同步接口 (39)
6.4.1.2用户状态更新接口 (42)
6.4.1.3用户付费类型切换接口 (42)
6.5I PTV接口 (42)
6.5.1IPTV开机认证接口 (42)
6.5.1.1认证请求 (43)
6.5.1.2认证请求响应 (43)
6.5.1.3获取use rTo ken请求 (44)
6.5.1.4获取use rTo ken响应 (46)
6.5.2注销 (47)
6.5.2.1注销请求 (47)
6.5.2.2注销响应 (47)
6.5.3EPG首页鉴权接口 (48)
6.5.4业务鉴权接口 (48)
6.5.5定购退定接口 (49)
6.5.6U ser Tok en更新接口 (49)
6.5.7用户基本信息同步接口(CreateUser) (50)
6.5.8订购关系通知接口 (54)
6.5.9用户与终端绑定接口 (55)
7数据 (57)
7.1账户类型 (57)
7.2内容 (57)
7.3个人用户 (57)
7.4用户与终端绑定 (59)
规范性附录A ISMP与业务系统接口错误代码表 (59)
规范性附录B ISMP与CRM接口错误代码表 (65)
前言
本标准主要依据中国电信集团公司的需求,结合中国电信企业技术标准的特点进行编写,随着中国电信企业技术标准管理系统的发展完善,还将制定后续的相关标准。
本规范规定了移动与视讯/宽带融合业务管理平台(I S M P)与交互式网络电视(I PT V)的集成方案。
本规范解释权属于中国电信集团公司。
本标准起草单位:中国电信股份有限公司上海研究院。
本标准主要起草人:王铮、毕家瑜、任华、方燕萍、杨迪、桂思思、游玉蓉、章璋
1范围
本规范适用于向中国电信提供移动与视讯/宽带融合业务管理平台ISMP 的设备提供商和与此相关的IPTV 设备提供商,为I SMP提供设备制造、工程设计和网络运行、管理和维护等方面的技术依据。
2规范性引用文件
下列文件中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修改版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
3名词术语和缩略语
3.1 术语
a) 定购:ISMP 系统需要产生定购关系,只有在定购关系存在的条件下,用户才可以使用
该业务。
与计费方式相关。
b) 点播:即一次使用,由用户发起的,一次业务使用。
ISMP 系统不产生永久性定购关系。
与计费方式相关。
c) 组合业务:在一次业务执行流程中,一个SP 使用了多种业务能力,或多次使用了同一
种业务能力。
d) 第三方付费:一种方式即赠送,另一种即集团为集团成员付费。
3.3 约束
下述需求约束适用于中国电信ISMP 规范体系所涉及的所有文档。
a) 不支持地市级电信公司开展地市级业务运营要求。
b) 点播类流媒体内容放在运营商网络;直播类流媒体内容可以放在SP 侧运营。
c) 对SP 的约束:对于用户在SP 网站使用业务的情况,要求SP 对不同产品提供不同
的链接。
d) 用户定购关系以ISMP 为准,SP 侧的定购关系必需与ISMP 侧的保持一致。
e) 对于一种业务能力,SP 仅能从一个业务系统接入。
f) 红名单用户不可以是测试用户。
g) 所有数据中,若没有明确定义,字符串的以NULL 代表无效,整型、枚举型的以-1
代表无效。
4系统结构
4.1ISMP 在网络中的位置
ISMP 在网络中的位置如图 4.1 所示:
图 4.1 网络系统架构示意图
a) ISMP:ISMP 提供业务网络统一管理、统一认证、统一鉴权、统一计费、统一数据
功能;
b) NMSC:NMSC 提供全国业务相关的统一管理、统一运营功能;
c) 综合业务接入网关(ISAG):提供对CP/SP 及业务接入鉴权控制,业务系统接口封
装的功能。
d) 用户门户(Portal):P ortal是面向用户的网元,主要提供业务展现、业务宣传、
用户自服务等功能。
门户分为省用户门户、全国用户门户;
e) 业务能力平台(SE):
1. CDMA 能力平台:提供CDMA 业务能力,负责业务执行、流程控制等功能;
2. IPTV 能力平台:提供IPTV 业务能力,负责业务执行、流程控制等功能;
3. 互联网能力平台:提供互联网业务能力,负责业务执行、流程控制等功能。
f) UDB 系统:用户数据库,负责用户账户信息的统一管理、统一认证;
g) 运营支撑系统:本文中的运营支撑系统涉及客户关系管理(CRM)、帐务系统
(B illi ng)、结算系统、客服系统;
h) 在线计费系统/智能网(OCS/IN):I SMP可以与智能网系统互联,由ISMP 完成预付
费批价,由智能网完成预扣费、扣费功能;ISMP 也可以与OCS 系统互联,由OCS
处理预付费计费,由ISMP 处理后付费计费;
i) 网管:本文中的网管系统主要指业务网络统一网管。
4.2IS MP内部结构
ISMP 提供面向移动与视讯/宽带业务网络的统一管理、统一认证、统一鉴权、统一计费、统一数据功能。
ISMP 系统可以分为管理部分、控制部分以及与其它系统接口部分。
管理部分主要包括用户管理、业务能力管理、业务能力开通管理、CP/SP 管理、CP/SP 业务能力签约管理、内容/业务/产品/产品组合管理、计费管理、结算规则管理、终端管理、号段管理、投诉、统计运营管理功能;控制部分主要包括认证、鉴权、计费及定购等功能;接口部分主要包括与
CP/SP、用户门户、SE、OCS/IN、运营支撑系统等接口,此外还包括省级ISMP 与I SMP之间的接口。
ISMP 各模块逻辑上独立并可拆分。
示意图如下:
用户/集团成员
集团管理员CP/SP 运营商管理员客服人员
门户
门户接口机集团管理门户CP/SP自服务界面运营商管理界面客服门户IN接口机IN(SCP)
OCS接口机OCS
用户管理内容/业务/产品/
套餐管理业务能力
开通管理终端管理统计投诉网管接口机网管
CP/SP管理CP/SP业务能力
签约管理结算管理计费管理号段管理
信息通
知中心SP接口机SP
CRM接口机CRM
Billing接口机Billing
认证鉴权计费定购
版权管理接口机
统一配置接口机
信息通知接口机
内容管理接口机
终端信息接口机
ISMAP接口机
业务系统/ISAG
DB NMSC接口机NMSC
图 4.2 中国电信I SMP系统结构
4.3IS MP接口概述
下图列出了ISMP 和周边系统之间所有接口:
图 4.3 ISMP 和周边系统接口
a) ISMP 与业务能力平台之间的接口
A1:ISMAP 接口,业务能力平台到ISMP 进行鉴权计费的接口;
A2:统一配置接口,ISMP 向业务能力平台进行 SP、业务相关信息的配置;
A3:内容管理接口,ISMP 中的内容管理模块向业务能力平台进行内容上载接口;
A4:订购退订接口,用户从业务能力平台到ISMP 完成订购、退订、订购关系查询的接口;
A5:统一认证接口,业务能力平台到ISMP 完成用户认证操作;
b) 省级ISMP 与NMSC 之间的接口
B1:数据同步接口:NMSC 向省级ISMP 同步全国 SP、业务等信息;
B2:订购退订接口:用户通过NMSC 到省级I SMP进行订购、退订、查询订购关系等信息;
B3:订购关系通知接口:省级ISMP 创建全国业务相关的订购关系后,通知到NMSC;c) ISMP 与用户门户之间的接口
C1:统一配置接口,ISMP 向用户门户进行 SP、业务相关信息的配置;
C2: 统一认证接口:用户门户到ISMP 完成用户认证操作;
C3:订购退订接口:用户通过用户门户到ISMP 进行订购、退订、查询订购关系等信息;
d) ISMP 与CP/SP 门户之间的接口
D1:目前采用CP/SP 门户集成在ISMP 中,不采用接口方式实现;
e) ISMP 与运营支撑系统之间的接口
E1:业务平台与IT 系统接口:ISMP 与CRM、计费、结算、10000 号等系统的接口;
a) ISMP 与UDB 系统之间的接口
F1:统一认证接口:ISMP 到UDB 进行用户统一认证;
参见《UDB 接口规范》
b) ISMP 与统一网管系统之间的接口
G1:SNMP 接口:ISMP 与统一网管之间的配置数据、监控、统计等操作;
参见《统一网管接口规范》
5功能
5.1内容管理
5.1.1概述
ISMP 对I PTV的内容管理主要完成内容的引入和内容分发。
内容模型的对应关系如下图:
1) 一个内容可以是频道,单集
2)一个连续剧由一个或者多个剧集(单集)组成
3)一个内容包可以由频道,单集,连续剧(连续剧是内容包的一种)组成,内容包之间可以嵌套(暂不要求)
5.1.2EPG 展现模型说明
EPG 内容模型对象包括
节目内容类对象:相当于内容,包括channel (频道),Prog ra m(单集),Ser ies(连
续剧)
内容元素类对象:相当于内容下的 Item,包括Movie(媒体内容),Picture(图片),Ph ys ic al Ch a nn el(物理频道),Schedul(节目单信息)
基础数据类对象:包括Cas t(演员信息),C a s t Rol eM a p(演员角色),Ca teg or y(栏目)
1 Category 下面的子节点必须属于同一种类型,例如可以都是Category,可以都属
于节目内容类对象(S e r i e s,P r og r a m,C h a nn e l)每一个层级都可以挂接内容元素类对象(P ic ture,C as tR ol eM ap)
2S e r i e s可以下挂节目内容类对象P r og r a m,也可以挂接内容元素类对象
(P ic ture,C as tR ol eM ap)
3 Program 可以下挂Movie 作为实体内容,也可以下挂Picture,CastRoleMap
4 Channel 可以下挂PhysicalChannel ,Picture 和S chedule
5 以上Category,Series,Program,Channel 的关系仅限于展示,和计费不相关
5.1.3内容导入
ISMP 支持内容批量导入功能,管理员可以把内容信息批量写入 Excel 中,在管理员页面把内容批量导入到ISMP-W 中,并且在内容导入功能中,管理员可以选择内容绑定的产品。
批量导入模板如下:
类型标上传内内容名文件名导演名导演名主要演演员索地区代描述
识容名字字索引字字字索引员引号
5.2内容/业务/产品/产品组合之间的关系
5.2.1对应关系
图1. 内容、业务、产品、产品组合关系图
I、内容:包括频道(channel)和节目(Program);
II、内容包:包括连续剧(Series)和内容包(Cpa),其中内容包可以将内容进行打包;
III、产品下可以绑定内容和/或内容包,一个产品可以包含零到多个内容/内容包
IV、一个内容/内容包可以放在不同的产品下销售,如果两个产品之间不是产品和产品组合的关系,则用户可以同时定购或者退定。
V、若产品和产品组合属于互斥关系。
用户已经定购了一个产品,如果需要定购本产品归属的产品组合,则ISMP 需要提示用户已经定购过该产品组合
下的产品,系统将退定产品的定购关系,并且生成产品组合的定购关系。
VI、如果用户定购了产品组合,如果需要定购产品组合中的产品,则要求用户先退定产品组合,再定购产品。
5.3IPTV 账号与终端绑定(暂定)
ISMP 提供两种方式供外部系统进行账号和终端绑定操作,一种方式由ISMP 提供账号与终端绑定接口供外部系统执行接口集成使用(具体见接口规范),另一种方式由ISMP 在管理员门户提供账号与终端绑定关系变更操作界面(可选)。
5.4业务能力编号及类型
增加:
46 IPTV
5.5内容/产品/业务/套餐编号
N1 增加:7 表示内容包,CpaID
6接口
说明:
要求所有接口中,NMSC-ISMP 的接口中,当可选字段为空,其字段名必须出现;NMSC/ISMP 和周边系统的接口中,当可选字段为空,其字段名必须不出现。
6.1账户类型
所有接口中涉及到账户类型的,都增加IPTV 等账号,具体如下:
1:MDN
2::PHS
3:固定电话
4:宽带账号
5:IPTV账号
6:VNET 账号:仅在此账号为付费账号时使用
6.2IS MA P接口
新增业务类型标识:4:PId+CId(产品ID+内容ID)
具体参见接口规范中ISMAP 协议部分。
6.3统一配置接口
6.3.1概述
6.3.1.1全国ISMP到省ISMP统一配置接口
全国ISMP 需要将新增/修改/注销的相关信息同步给省ISMP,省ISMP 不起工作流,自动入库,并自动将配置信息同步到各业务系统。
全国平台到省平台采用FTP 接口,同步数据包括CP\SP、业务、产品、产品组合、内容、内容与产品绑定关系信息配置,计费策略配置等。
分级负责,状态上报。
6.3.1.2省ISMP到业务系统统一配置接口
省I SMP到各业务系统的数据配置接口采用WebService 接口,数据包括CP\SP、业务、产品、产品组合、内容、内容与产品绑定关系信息配置等。
6.3.2全国ISMP到省ISMP统一配置接口
6.3.2.1文件命名规范
数据配置文件命名规范每
条数据一个文件。
所有SP/业务数据文件都存放在统一指定的目录下,如$HOME
文件目录采取规则:
<根目录>/UNICONF/<业务系统类型>/<业务系统ID>/<数据类型>/REQ
数据类型包括:SPINFO;SERVICEINFO;PRODUCTINFO;BINDINGINFO
业务系统类型定义如下:参见《中国电信综合业务管理平台ISMP 规范-总册》
编号规则:业务系统的编号,编号规则参见《中国电信综合业务管理平台ISMP 规范-总册》
通知机制:周期可配置
6.3.2.2回执文件命名规范
业务网关/系统在获取数据配置文件并进行处理后,需要将处理结果以回执文件的方式放在指定目录。
所有SP/业务数据配置回执文件都存放在统一指定的目录下,如$HOME
文件目录采取规则:
<根目录>/UNICONF/<业务系统类型>/<业务系统ID>/<数据类型>/RSP
文件命名规则
回执文件名与数据配置文件名完全一样,只是文件后缀名从REQ 改为RSP
6.3.2.3其它说明
1)本接口采用准实时方式,由业务系统每1小时(该时间可配置)获取一次数据配置文件,处理后返回回执文件。
回执文件需在2天(该时间可配置)之内返回,否则视为无效,作为配置失败处理;
2)
¾ 本协议大小写敏感
¾ 属性后面追加的是“#REQUIRED”则表明该属性为必选项,当消息中包含这个元素的时候,就必然包含该属性;
6.3.2.4统一配置接口文件体定义
同省I SMP到业务系统统一配置接口的数据信息定义
6.3.3省ISMP到业务系统统一配置接口
6.3.3.1数据信息定义
增加了用于IPTV 的内容信息同步接口,其他信息同步接口见《中国电信综合业务管理平台ISMP 接口规范-NMSC》
6.3.3.2内容信息同步接口
注:本接口为ISMP 下发给业务系统的内容同步接口,内容引入接口参照文广接口规范
内容同步接口采用SOAP 协议+XML 指令文档的方式。
其中,SOAP 消息是与具体指令内容无关的通用消息,仅仅用于表达命令请求。
而具体的命令及参数利用独立的XML 文档来描述。
采用与具体指令无关的通用SOAP 消息有利于指令扩展及在异步环境中实现通用的可靠消息传递机制。
内容同步流程:
注:
1.特殊CP 指的是需要通过接口向ISMP 上传内容信息和实体的CP,其余CP 在ISMP 上直接发布内容,无需红框以外的接口
2.红框外的流程只适合特殊CP 和ISMP-W 对接,红框内为通用的内容同步流程。
6.3.3.2.1内容同步通知接口
触发条件:内容更新审核通过后,调用该接口将内容信息同步到业务系统;
接口名:contentSyncNotify
输入参数:
输出参数:
6.3.3.2.2结果通知请求接口
接口名:contentSyncAck
输入参数:
参数名称可选输入/输出类型描述信息
输出参数:
6.3.3.2.3同步XM L格式
AD I/Ob je ct s/M ap pi ng s是接口XML 的通用基础框架,基于该通用框架定义不同的Object.ElementType 和不同的 来满足对不同对象的定义需求。
请注意本规范的描述中应用以下规则:
1. 各个实体上原有的Code 从P r o p e r t y变成A tt r i b u t e,为必填属性,和
O b j e c t.E l e m e n t T y p e 结合用于唯一标识一个对象;在多个对象作关联的时候,使用Code 来标识一个实体;
2. 对于任何符合Schema(见附件)的XML 文件,LSP 应该忽略那些不能识别的Property
或XML Tag 或属性。
3. 以下对象中标识为”必填项”的属性,仅仅是针对 REGIST 操作。
而UPDATE 操作进行的是
增量修改,缺少某必填项,仅为表示不需要对此项进行修改,而不能修改此项为空。
4. XML 文件内容的编码全部采用 UTF-8 格式。
以下章节描述了XML 的详细定义。
在其中
att 表示X M L属性, e l表示XM L元素, pn 表示 Property 节点的Na me)。
6.3.3.2.3.1AD I定义
AD I是XM L的根元素。
6.3.3.2.3.2Ob je ct s定义
O bjects是操作对象。
操作类型 REGIST 表示增加新对象,UPDATE 表示修改对象内容,DELETE 表示删除对象。
Ob jects.Eleme ntType定义:
ItemID Pn ISMP 统一编码
ItemID Pn ISMP 统一编码
i pti on
ItemID Pn ISMP 统一编码
ItemID Pn ISMP 统一编码
Pn
ISMP 统一分配编码对应的ParentID为‘0’
ParentType <=> ElementType 支持组合
6.3.3.2.3.一五 Reply 定义
R e p l y由多组R e s u l t i n f o组成,针对操作记录进行逐条回复(即多条回复),每组Resultinfo 的定义如下:
用户请求内容时,看到的是内容,门户根据用户的终端类型提供不同的 Item 实体对应
的U RL,提供给用户使用。
不同的 Item 是同一个内容的不同内容体。
6.4与CRM 接口
6.4.1用户信息同步接口
用户基本信息接口中增加了clientID 、userPwd 、certificateType 、certificatecode 、contactAddress、contactEmail、contactPhone、userTradeType、userGroupID、stbid,将userName 修改为clientName,具体见下节的接口定义。
修改了ISMP 与CRM 接口错误代码表,具体见附录B。
其他具体接口信息参见《中国电信CDMA 业务网络接口协议技术规范-管理接口协议
规范支撑系统分册》
6.4.1.1用户基本信息同步接口
触发条件:用户开户时,从CRM 同步到ISMP。
承载协议:Web Service(Document Style)。
方向:CRM->ISMP。
原型描述:CreateISMPUser()
输入参数:
说明:
1. 可以仅带客户号,此时userIDType 填0;
2. 当带账户号时,必须带客户号;
3. 当有多个账号时,需多次调用接口,且每次接口中必须带客户号;
4. CRM 调用此接口则默认客户号或者账号状态为正常。
5. 当CRM 调用ISMP 接口进行用户客户号或者账号开通时,ISMP 先
检测客户号或账号是否存在,如果不存在则进行新增操作;如果已
经存在则根据CRM 同步的数据进行更新操作。
6. 在ISMP 中还未通某clientID,当CRM 发起开通该客户号和账号时,
如果ISMP 检测到该客户号不存在,则ISMP 同时开通该客户号和账
号。
7. 在ISMP 中已开通某clientID,当CRM 发起开通与该客户号关联的
账号时,如果ISMP 检测到该帐号不存在,则ISMP 开通该账号。
8. 在ISMP 中已开通某clientID,当CRM 发起开通与该客户号关联的
账号时,如果ISMP 检测到该帐号已存在,则ISMP 更新该账号。
表1. 用户基本信息同步接口输入参数
返回参数:
表1. 用户基本信息同步接口返回参数
触发条件:CRM 中用户状态更新后。
承
载协议:Web Service(Document Style)。
方向:CRM->ISMP。
以下是ISMP 对CRM 在此接口调用上的使用约束:
1、当CRM 调用ISMP 接口进行用户客户号或者账号状态更新时,ISMP 先检测
客户号或账号是否存在,如果不存在则按照CRM 提供的数据进行操作还是向CRM 报错(暂定);
2、在ISMP 中已开通某clientID 或账号时,当CRM 发起更新该客户号或账号状
态时,如果ISMP 检测到该客户号存在,则ISMP 执行客户号或账号状态更新操作。
6.4.1.3用户付费类型切换接口触发条
件:CRM 受理付费类型切换请求成功后。
承载协
议:Web Service(Document Style)。
方向:CRM->ISMP。
以下是ISMP 对CRM 在此接口调用上的使用约束:
1、当CRM 调用ISMP 接口进行用户客户号或者账号付费类型变更时,
ISMP 先检测客户号或账号是否存在,如果不存在则按照CRM 提供的
数据进行操作还是向CRM 报错(暂定);
2、在ISMP 中已开通某clientID 或账号时,当CRM 发起变更该客户号
或账号付费类型时,如果ISMP 检测到该客户号存在,则ISMP 执行客户号或账号付费类型变更操作。
6.5IPTV 接口
修改了ISMP 与业务系统接口错误代码表,具体见附录A。
ISMP 和IPTV 增加如下接口:
6.5.1 IPTV开机认证接口
接口时序:
6.5.1.1认证请求
承载协议:HTTP GET
接口方向:IPTV 业务系统→ISMP 调用接口:
xIptvAuthDoma in/Authenti cationURL
接口功能:机顶盒开机请求i ptv 业务系统,iptv 业务系统进行解析并且转发请求到I SMP 进行获取挑战字
认证请求示例:
x Ip tvA ut hD om ai n/A ut he nt icati on UR L?Us erI D=12345678&Ac ti on=Lo g in
6.5.1.2认证请求响应
承载协议:HTTP Response
接口方向:ISMP→IPTV业务系统
接口功能:ISMP 返回挑战字给IPTV 业务系统,响应结果为字符串
取值范围0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ 认证响应示例:
public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException {
String text = EncryToken;
Writer out = null;
try {
out = response.getWriter();
out.write(text);
} catch (IOException ioe1) {
log.error("exception(...) + ioe1);
} finally {
if (out != null) {
try {
out.close();
} catch (IOException ioe2) {
log.error("exception(...) + ioe2);
}
}
}
}
6.5.1.3获取u se rT oke n请求
承载协议:HTTP(GET)
接口方向:IPTV 业务系统→ISMP
调用接口:xIptvAuthDomain/GetUserToken
接口功能:IPTV 业务系统转发认证信息到ISMP 进行认证
Authenticator 包含参数
【备注】:IPTV 终端首次安装激活时采用回填方式执行绑定操作,由ISMP 根据业务系统发起“获取userToken 请求”时携带的账号、终端以及密码信息执行绑定操作。
如果ISMP 检测到已经存在绑定关系时,则执行验证操作。
说明:
本附录规定了机顶盒浏览器需要支持的扩展javascript 集合,用于机顶盒与EPG 服务系统、业务管理平台之间接口中,基于HTML、Javascript的逻辑使用。
D.1 Authentication 对象
D.1.1 获取鉴权信息
a).函数名:CTCGetAuthInfo
b).参数:32 位长字符串EncryToken,ASCII 编码方式
c).返回值:string 型加密结果
d).函数过程:获取本地配置信息,使用password 对loginname、EncryToken 等信
息进行加密,并按要求格式返回结果字符串。
加密方法如下:Authenticator 表示函数返回值,具体为:
Authenticator=3DES(Random+“$”+Enc ryToken+”$”+UserID+”$”+STBID+”$”+I P+”$”+M AC+”$”+ Reserved+ ”$”+authenticationType+ ”$”+password+ ”$”+“CTC”)
e).在不采用机卡分离方式的情况下,使用用户的密码(由运营商统一分配,用户可通过机顶盒操作界面进行配置)作为3DES密钥进行加密;
f).在采用机卡分离方式的情况下,采用为机顶盒SIM 卡内保存的密钥ICKey 作为3DES 密钥;
g).密钥长度不足24 字节时,右补ASCII 字符“0”;
h).内容采用PKCS5Padding 方式填充,即长度以8 字节切分,不能被8 整除的末尾
部分,根据长度不足8 字节的部分,填充“0x01”—“0x08”,如不足1 字节,则填充1 个“0x01”,如不足2 字节,则填充2 个“0x02”,以此类推,如整除,则填充8 个“0x08”;
i).3DES 加密算法采用的鉴权算法,遵循中国电信IPTV 技术规范《IPTV SIM-
STB 接口规范V1.5》7.2 节中的规定,具体为:3DES(168 位,ECB 方式)
j).Random 为十进制表示的随机数字,范围为0~99999999返回结果使用ASCII 形
式的十六进制编码表示,采用大写“A B CDEF”,如加密结果为8 字节二进制字符串:
0x0123456789ABCDEF,则
Authenticator 为16 字节ASCII 字符串:”0123456789ABCDEF” 。
获取userToken 请求示例:
x Ip tvA ut hD om ai n/G et Us er To ken?U se rI D=12345678&Au the nt ic at o r=3D ES(R an do
m+“$”+E ncr yT ok en+”$”+U s e r I D+”$”+S TB ID+”$”+IP+”$”+M AC+”$”+
Reserved+ ”$”+“CT C”)
6.5.1.4获取userToken响应
承载协议:HTTP Response 接口方向:IPTV 业务系统
→ISMP接口功能:返回认证结果备注说明:认证成
功后,返回用户帐号和 userToken
userTkoen 规则:22 位随机数字+10 位时间戳MMddHHmmss
如:(012345678901234567890100408120000)
如认证失败,则直接返回HTTP 200,然后由IPTV 业务系统重定向到手工登录或修改用户名
密码的页面,并提示错误信息
获取userToken 响应示例:
public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException {
String text = userID&userToken;
Writer out = null;
try {
out = response.getWriter();
out.write(text);
} catch (IOException ioe1) {
log.error("exception(...) + ioe1);
} finally {
if (out != null) {
try {
out.close();
} catch (IOException ioe2) {
log.error("exception(...) + ioe2);
}
}
}
}
6.5.2注销
6.5.2.1注销请求
承载协议:HTTP GET
接口方向:IPTV 业务系统–〉ISMP 调用接口:
xIptvAuthDoma in/Authenti cationURL 接口功能:IPTV 业务系统转发
机顶盒调用页面请求进行用户注销请求备注说明:采用URL 参数传递
参数
xIptvAuthDomain/AuthenticationURL?UserID=12345678&Action=Logout
6.5.2.2注销响应
承载协议:HTTP Response
接口方向:ISMP –〉I PTV业务系统接
口功能:返回注销结果响应页面备
注说明:内容为空
注销响应示例:
public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException {
String text = “”;
Writer out = null;
try {
out = response.getWriter();
out.write(text);
} catch (IOException ioe1) {
log.error("exception(...) + ioe1);
} finally {
if (out != null) {
try {
out.close();
} catch (IOException ioe2) {
log.error("exception(...) + ioe2);
}
}
}
}
6.5.3 EPG首页鉴权接口
接口方向:IPTV 业务系统-> ISMP
触发条件:ISMP 向IPTV 业务系统返回查询用户已存在的订购关系
接口时序
具体接口信息见《中国电信综合业务管理平台ISMP 接口规范-门户》获取定购关系ge tS ub sc ri p ti on
6.5.4业务鉴权接口
具体接口信息见《中国电信CDMA 业务网络接口协议技术规范-管理接口协议规范ISMAP 分册》:鉴权批价接口。