【YD通讯标准】 统一通信通讯录业务能力和相关接口技术要求

ICS33.030
中华人民共和国通信行业标准
YD/T3077-2016
统一通信通讯录业务能力和
相关接口技术要求
Technical requirements on service capability and related interfaces of thecommunicationdirectoryserviceforunifiedcommunications2016-04-05发布
2016-07-01实施免费标准下载网bzxz
中华人民共和国工业和信息化部发布前
1范围·
2规范性引用文件，
3术语、定义和缩略语·
3.1术语和定义
3.2缩略语·
4统一通信通讯录业务能力.
4.1统一通信通讯录业务概述
4.2企业通讯录业务能力
4.3个人通讯录业务能力·
4.4通讯录业务增强（可选）能力·5统一通信通讯录业务技术要求.5.1通讯录业务系统架构
5.2通讯录服务端和其他业务的交互及接口…5.3通讯录信息的元数据描述
5.4与传统目录信息的格式互通…6通讯录业务相关接口协议及参数设置·6.1If1接口
If2接口
If5接口·
If6接口
统一通信通讯录业务相关流程··7
鉴权流程
TLS建立流程·
XCAP操作流程·
7.4DS同步流程·
个人信息订阅流程
个人信息修改触发通知流程
个人通讯录信息分享流程
7.8个人通讯录服务端触发同步流程….7.9和其他企业的统一通信通讯录互通流程7.10统一通信通讯录和LDAP通讯录互通流程·附录A（资料性附录）企业通讯录schema附录B（资料性附录）个人通讯录相关schema次
附录C（资料性附录）统一通信通讯录和电子名片信息项的对应YD/T3077-2016
YD/T3077-2016
本标准是“统一通信”系列标准之一。该系列标准的名称和结构预计如下：YD/T2014-2009
统一通信业务需求；
YD/T2305-2011统一通信中即时通信及语音通信相关接口技术要求YD/T3077-2016统一通信通讯录业务能力和相关接口技术要求，本标准按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由中国通信标准化协会提出并归口。本标准起草单位：江苏省邮电规划设计院有限责任公司。本标准主要起草人：糜正琨、刘继明、范山岗、房磊、潘锐、朱晨鸣、戴源、袁源、王
欧伟新、张文健。
HiiKAoNniKAca
1范围
统一通信通讯录业务能力和
相关接口技术要求
本标准规定了统一通信中通讯录业务需求、架构、数据描述和接口要求。本标准适用于统一通信中通讯录业务。2规范性引用文件
YD/T3077-2016
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T19245-2003电子名片信息交换规范YD/T1522.1会话初始协议技术要求第1部分：基本的会话初始协议YD/T1522.4会话初始协议（SIP）技术要求第4部分：基于软交换网络呼叫控制的SIP协议XML配置接入协议(XCAP)技术要求YD/T2299
IETFRFC4511轻量级目录访问协议（LDAP）：协议(LightweightDirectoryAccessProtocol(LDAP)TheProtocol)
IETFRFC5246传输层安全（TLS）协议版本1.2(TheTransportLayerSecurity（TLS)ProtocolVersion1.2)
W3CRECXQuery1.0XML查询语言1.0(W3CXQuery1.0:AnXMLQueryLanguage(SecondEdition))
OMA-TS-DS-V2数据同步协议规范版本2.0（OMADataSynchronizationProtocolSpecifications）OMA-TS-CAB_XDMS-V1融合地址薄XML文档管理规范版本1.o(OMAConvergedAddressBookXDMSpecificationV1.0)
OMA-SUP-XSD_cab_address_book-V1_0Book document)
OMA-SUP-XSD_cab_pcc-V1_0
Card document)
融合地址薄V1.0地址本文档（OMACABV1.0Address融合地址薄V1.o个人联系卡文档(OMACABV1.0PersonalContactOMA-SUP-XSD_cab_feature_handler-V1_oHandler document)
3术语、定义和缩略语
3.1术语和定义
下列术语和定义适用于本文件。3.1.1
第三方应用ThirdPartyApplication融合地址薄V1.0特征处理文档(OMACABV1.0Feature统一通信系统以外的其他系统所提供的应用。第三方应用可以通过开放的接口调用统一通信系统的能力，例如查询企业通讯录内容。3.1.2
Enterprise Communication Directory企业通讯录日
HiiKAoNiKAca
YD/T3077-2016
统一通信通讯录中专门为企业用户提供的面向企业的通讯录服务，服务端按企业组织架构提供部门成员列表、联系方式、通信状态等信息及其授权管理，为企业中的通信提供支撑服务。3.1.3
个人通讯录PersonalCommunicationDirectory统一通信通讯录中为企业用户和个人用户提供的面向个人的通讯录服务。服务端提供个人通信名录的网络存储、分组管理、查询编辑、多终端同步等功能，为个人的通信提供支撑服务。3.1.4
即时通信InstantCommunication统一通信业务之一，包含即时消息和呈现两部分功能。3.2缩略语
下列缩略语适用于本文件。
Data Synchronization数据同步Hyper Text Transfer ProtocolDentity
Instant Message
LightweightDirectoryAccessProtocolOpen Mobile Alliance
Session Initiation Protocol
Transport Layer Security
Unified Communications
XMLConfigurationAccessProtocolXML Document Management
XML Document Management ServerExtensible Markup Language
4统一通信通讯录业务能力
4.1统一通信通讯录业务概述
超文本传输协议
身份标识号码
即时消息
轻量目录访问协议
开放移动联盟
会话初始协议
安全传输层协议
统一通信
XML配置访问协议
XML文档管理
XML文档管理服务器
可扩展标记语言
通讯录业务是统一通信的一种基本业务，其功能分为企业通讯录和个人通讯录两部分。面向企业用户时需要提供企业通讯录和个人通讯录两部分功能；面向非企业用户时服务提供者可以根据需要选择仅部署个人通讯录功能。
4.2企业通讯录业务能力
企业通讯录中的信息建模根据企业组织架构进行，使用XML语言进行描述。企业通讯录信息包含企业完整组织架构、所有部门及其成员的通讯信息，还可包含支持类信息如日志、策略、权限等，并支持按企业要求进行定制。通讯录信息存储于服务端，能根据客户端的权限和鉴权信息向客户端开放通讯录信息的子集。企业通讯录的业务提供方式为客户端提供操作界面，用户通过操作界面向服务端发送请求服务端负责逻辑处理和返回响应。具体业务能力描述如下：2
iiKAoNiKAca
YD/T3077-2016
a）企业通讯录业务支持权限设置，可为不同用户设置不同的接入权限。权限为基本操作权限（创建、查询、修改、删除等）和操作范围（部门、群组、某些通讯信息的子集）的组合。企业管理员对企业通讯录拥有所有的操作权限，对匿名用户提供最基本的操作权限。b）企业通讯录的服务端能够与传统格式的目录信息互通，支持从其他类型的通讯录或目录服务中读取通讯信息并转换为标准格式，也能够完成本标准中的XML格式的通讯信息和其他格式的通讯信息之间的导入和导出。c）企业通讯录业务支持用户通过企业通讯录客户端的如下操作：能根据需要便捷地增添、删除和修改企业中的部门：可以通过标准接口查询通讯信息，查询方式包括按企业名称、部门、姓名、号码、职务等信息查询，并能够将查询结果加入个人通讯录；可以通过标准接口在授权范围内对通讯录信息进行编辑，包括修改、创建和删除，服务端接收客户端的请求，处理后给予响应并存储处理结果。d）企业通讯录业务支持用户通过点击客户端显示的通讯录信息发起语音通信、电话会议、即时消息等业务功能。
e）企业通讯录业务支持用户通过点击客户端显示的部门及成员列表发起查询部门成员状态信息，系统根据用户权限向用户显示或拒绝显示状态信息。4.3个人通讯录业务能力
个人通讯录中的信息建模根据通讯对象的分组进行，使用XML语言进行描述。个人通讯录信息包含所有的分组及其成员的通讯信息，还可包含支持类信息如日志、策略、权限等。通讯录信息存储于服务端，可以通过通讯录客户端或Web服务访问。业务提供方式为客户端提供操作界面，用户通过操作界面向服务端发送请求，服务端负责逻辑处理和返回响应。具体业务能力描述如下：a）个人通讯录的服务端能够与传统格式的目录信息互通，支持从其他类型的通讯录或目录服务中读取通讯信息并转换为标准格式，也能够完成本标准中的要求格式的通讯信息和其他格式的通讯信息之间的导入和导出。b)
个人通讯录业务支持用户在个人通讯录中创建和管理分组，包括对分组成员的添加、删除以及对分组的重命名、删除及属性定义。c
个人通讯录业务支持用户对通讯录信息进行编辑，包括修改、创建和删除。d）个人通讯录业务支持个人通讯录信息的网络存储，并支持本地副本和网络存储信息的自动同步。
e）个人通讯录的使用者可以订阅其他用户的通讯信息，在被订阅用户的信息修改时能自动更新。对于其他人的订阅请求，被订阅者可选择接受或不接受。f)
个人通讯录业务支持用户通过点击客户端通讯录显示的通讯信息发起语音通信、电话会议、即时消息等业务功能。g）个人通讯录业务允许企业用户通过点击个人通讯录发起查询通讯录中本企业内部人员的状态信息，系统根据用户权限向用户显示或拒绝显示状态信息。4.4通讯录业务增强（可选）能力服务提供者可以根据应用场景和实现难度选择是否支持下列通讯录功能。客户端支持用户按指定通讯录信息子集或排列顺序存储、显示通讯录数据。a
iiiKAoNhikAca
YD/T3077-2016
客户端的通讯录显示支持缩略模式和细节模式，即针对每个通讯对象的信息用户可以选择仅显示标识和部分内容（缩略模式）或显示所有信息（细节模式）。c)
通讯录业务支持分享操作。用户可通过消息机制向其他用户分享其通讯录中的数据，收到消息的用户能直接把分享的内容添加进自已的个人通讯录。d)
或操作。
企业通讯录中部门、群组可以拥有统一通信帐号，支持对整个部门或群组触发业务通讯录业务向用户提供Web界面，便于对通讯录进行查询、编辑等操作。统一通信客户端可以通讯录信息为基础，融合用户其他业务或操作信息（如通信记录、操作记录、呈现信息、其他业务信息等），组成综合信息，作为统一通信业务的入口，供用户查看或触发其他应用，提升用户体验。g）用户可以通过点击企业或个人通讯录发起点到点视频通信、网络传真、数据协同，发送短消息或多媒体消息等统一通信业务5统一通信通讯录业务技术要求
5.1通讯录业务系统架构
统一通信中通讯录分为客户端和服务端，其中呈现、操作界面等在客户端，业务处理、消息存储等在服务端，基本架构如图1所示。Web服务器
人机交互功能
企业通讯录功能
本地通信录应用模
安全模块
SIP代理
通讯录客户端
客户端
客户端
个人通讯录功
图1统一通信通讯录业务系统功能结构企业通讯录XDMS
通讯录
互通网
个人通讯录XDMS
DS服务器
安全模块
通讯录服务端
SIP代
统一通信通讯录客户端装载在统一通信终端中。通讯录相关功能模块包括本地通讯录业务处理模块、安全模块、XDM客户端和DS客户端。其中，本地通讯录业务处理模块提供通讯录的图形化人机交互界面（GUI)，能够将用户的操作转换成XDM协议操作或DS协议操作，并能够将通讯录数据与呈现数据进行融合处理：安全模块通过TLS协议负责通讯录客户端数据的本地加密和安全传送：XDM客户端和DS客户端实现XCAP协议和DS协议的客户端功能。通讯录服务端是所有通讯录相关消息的出入口，负责消息的解析、分发、处理和响应消息的封装，包括三个功能模块：公共功能模块、企业通讯录服务模块和个人通讯录服务模块。4
iiiKAoNhikAca
YD/T3077-2016
公共功能模块由接入、安全、互通网关、SIP代理、Web服务器等组成。其中，接入模块负责用户身份确认，和安全模块配合负责数据加解密，同时根据消息协议类型、消息参数将消息分发给企业通讯录服务或个人通讯录服务模块。安全模块负责通讯录业务鉴权和数据安全处理（加密）。互通网关负责统一通信通讯录相关协议（XCAP、DS等）与其他通讯录访问协议（如LDAP）之间的协议转换。Web服务器向客户端提供Web形式的人机界面。企业通讯录服务和个人通讯录服务模块完成相关的业务流程控制、消息聚合、应用选择等功能。其中，企业通讯录XDMS负责存储、管理企业通讯录相关的XML文档，主要包含企业通讯录数据存取和管理以及企业通讯录访问权限的控制。个人通讯录XDMS负责网络存储、管理个人通讯录相关的XML文档，包含个人通讯录数据、个人信息数据、个人偏好数据、订阅列表、个人通讯录访问权限数据等。DS服务器负责实现DS服务端功能，主要用于个人通讯录信息的同步。5.2通讯录服务端和其他业务的交互及接口通讯录服务端和其他业务实体的交互关系5.2.1
在统一通信中通讯录业务可以作为其他统一通信业务的入口，并辅助其他业务获得通信相关的信息。图2示出通讯录业务服务端和统一通信其他业务、其他通讯录系统及第三方应用之间的交互接口，其中Ifl、If2、If3、If4是通讯录业务和统一通信其他业务间的接口。If5是通讯录业务对其他业务（内部或外部）开放的查询接口，If6是统一通信通讯录和其他通讯录的接口。图2中的即时通信功能包含IM和呈现两部分功能。
统一通信
其他业务
统一通信
统一通信终端
（包含通讯录
客户端功能）
通讯录服务端
第三方应用
外部统一通信通讯录系
统或LDAP系统
即时通信
图2统一通信通讯录业务服务端和其他业务系统的关系5.2.2Ifl接口
通讯录业务服务端和统一通信终端之间接口。其中通讯录客户端功能是统一通信终端的组成部分，并主要负责实现通讯录相关接口和功能。通过该接口的交互支持如下功能的实现：a）个人通讯录的同步。
HTiKAoNi KAca
YD/T3077-2016
b）个人通讯录的查询。经由该接口用户可以查询其他用户授权范围的通讯录内容，如好友列表、群组成员等。c）企业通讯录数据的查询和编辑。d）通讯录中个人偏好、分享列表等数据的查询和编辑。e）客户端鉴权和传输层加密，保证数据的安全f）发送DS的通告消息
g）个人通讯录服务端通过此接口接收客户端发来的订阅请求，并转发给被订阅用户。h）个人通讯录服务端通过此接口给客户端发送通知。本接口支持DS、XCAP、SIP、XQuery协议，传输层加密使用TLS协议。协议参数设置详见本标准6.1。5.2.3If2、If3接口
If2接口为通讯录业务服务端和呈现功能间的接口。通讯录业务通过此接口从呈现处获得用户的状态信息。本接口支持XCAP。协议参数设置详见本标准6.2。If3接口为通讯录服务端和即时消息之间的接口，使用标准SIP协议，具体参见YD/T1522.1和YD/T1522.4，本标准中不再描述。
5.2.4If4接口
通讯录业务服务端和鉴权功能之间的接口，本接口不在本标准定义范畴，5.2.5If5接口
通讯录业务服务端和统一通信中其他业务或外部第三方应用间的接口功能间的接口。主要供其他业务从通讯录业务查询企业通讯录信息。本接口采用XCAP协议。协议参数设置详见本标准6.3。5.2.6If6接口
通讯录业务服务端和其他通讯录或地址薄系统之间的接口。经由该接口通讯录业务对外部目录和通讯录系统进行查询和导入。
统一通信通讯录业务查询外部通讯录信息时根据对方系统的不同支持使用LDAP和XCAP协议。5.3通讯录信息的元数据描述
5.3.1数据元素描述
统一通信通讯录中通讯录数据描述和存储采用XML语言，根据企业需求和实现难度选择可使用中文或英文。表1~5别给出统一通信通讯录联系信息，通信类、标识类，互联网类和其他杂项数据元素的描述，包括信息项的中英文描述和基本属性。XML文档英文描述时使用UTF-8编码，中文采用GB2321或GBK编码。其中标识类中的统一通信账号为必选数据，其他都为可选。表1联系信息
信息项（英文）
contact-info
entity-type
address
internet-addr
数据类型
ContactInfoType
entity-typeList
IdType
urn:oma:xml:cab:pcc:AddressEntryTypeCommInfoType
InternetInfoType
xs:string
信息项说明
联系信息，对应实体的全部联系信息实体类型
标识类信息
地址类信息
数据类型见
oma-sup-xsd cabpcc-vl0
通信类
互联网类
-iiiKAoNniKAca
信息项(英文）
mobile
telephone
SIPURL
信息项（英文）
familyname
englishname
displayname
信息项（英文）
homepage
corporate website
micro-blog
信息项（英文）
IMname
SceneType
entity-typeList
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
xs:string
IMInfoType
xs:anyURI
xs:anyURI
Xs:anyURI
xs:anyURI
xs:anyURI
xs:string
xs:string
xs:string
表2通信类
数据类型
表3标识类
数据类型
数据类型
互联网通信类
5其他
数据类型
xs:enumeration
xs:enumeration
企业通讯录信息数据结构
移动电话
YD/T3077-2016
信息项说明
固定（PSTN）电话
SIP电话
电子邮件
信息项说明
统一通信账号
英文名
显示名字
用户自定义的联系人在地址簿中的显示名字信息项说明
即时消息
表示即时消息、呈现等即时通信类应用如：QQ、MSN
个人主页
企业网站
社交网站账号
信息项说明
即时通信产品名称
产品可执行文件/应用名称
即时通信号码/地址
场景类型，枚举类型
Home家庭/Work工作
Publie公共/Orher其他
实体类型，枚举类型
Organization行政组织
Group群组
Person个人
企业通讯录存储在企业通讯录XDMS中，包含企业通讯录信息和企业通讯录访问权限信息。7
YD/T3077-2016
按企业的需求，根据部门基本信息以及员工信息形成企业通讯录的树型结构。树的每个叶节点为员工或部门的详细联系信息，节点信息项的名称如图3所示，树的深度和宽度可以扩展。成员节点下有访问权限对应的规则ID。企业通讯录中应在企业信息树的基础上支持群组的设计，适应企业中项目或组群通信的需要。群组设计和企业信息树的结构相同，但是成员列表中仅需包含成员统一通信ID。客户端或第三方应用，根据统一通信ID从信息树中查询相关信息。详细描述参见附录A。企业
部门2
联系信息
成员2
联系信息
成员3
联系信息
联系信息
联系信息
联系信息
图3企业通讯录数据结构
5.3.3个人通讯录信息数据结构
个人通讯录数据存储在个人通讯录XDMS中，包含个人通讯录、个人信息、个人偏好、分享、访问权限等信息。图4示出个人通讯录信息的树型结构，其根节点下划分群组，每个群组下有联系人及其联系信息。我员
成员2
成员3
图4个人通讯录数据结构
5.3.4个人信息数据结构
定义个人相关信息数据，用XMIL语言描述，详见本标准附录B。5.3.5个人偏好数据结构
YD/T3077-2016
定义个人偏好数据存储格式和订阅个人通讯录相关数据存储格式，详见本标准附录B。5.3.6分享数据结构
定义信息数据分享时的消息格式和服务端存储分享请求的格式，详见本标准附录B。5.3.7企业通讯录权限列表数据结构权限列表只能由企业管理员设置，其他人员无权察看与修改。基本权限见表6。表6企业通讯录权限类型
权限类型
匿名用户权限（无用户名，或未通过鉴权）注册用户权限（已通过鉴权）
安全传输用户权限（已通过鉴权、已加密、可安全传输用户）角色权限
部门权限
自定义权限
组合权限
赋予人员
所有人员
已鉴权人员
已完成加密传输人员
对应角色
对应部门的所有人员
企业管理员设置
企业管理员设置
基本权限可以组合，形成新的权限授予用户，新权限对应的操作许可范围为所有子权限允许范围的并集。
5.4与传统目录信息的格式互通
5.4.1统一通信通讯录和CSV格式的转换因为CSV包含的信息列没有固定格式，要由用户指定CSV列和通讯录联系信息的数据项的对应关系，然后才能进行格式转换。其转换方法如下。a）企业通讯录转换成CSV格式：CSV以通讯录联系信息所包含的项设置列，所有通讯录下所有非联系信息的节点对应CSV的数据行，同时对于每一行增加所属部门列，以该节点父节点的名称为值。
b）CSV格式转换为企业通讯录：CSV的每一行作为一个成员，CSV的列作为联系信息节点由用户指定其到联系信息数据项的对应关系，无对应关系的作为扩充项。企业信息和部门信息由管理员设定。
c）个人通讯录转成CSV：每个成员作为CSV的数据行，根据通讯录联系信息所包含的项设置列，增加所属群组列，记录成员所属群组的名称。d）CSV转成个人通讯录：CSV的每一行作为一个成员，CSV的列作为联系信息节点由用户指定其到联系信息数据项的对应关系，无对应关系的作为扩充项，根据CSV所属群组列来决定成员归属的群组，无对应群组的，由用户指定或新建群组。5.4.2统一通信通讯录和电子名片的转换vCard数据格式是目前应用最为广泛的电子名片格式，本标准给出统一通信通讯录和vCard格式的转换方法。
a）统一通信通讯录转换成vCard格式：企业通讯录下所有非联系信息的节点生成一个vCard的对象，vCard中的条目对应节点的联系信息子节点内容，数据项的对应关系详见本标准附录C，没有对9
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。