H3C CAMS CSI 30技术白皮书V110.docx
《H3C CAMS CSI 30技术白皮书V110.docx》由会员分享，可在线阅读，更多相关《H3C CAMS CSI 30技术白皮书V110.docx（11页珍藏版）》请在冰豆网上搜索。
H3CCAMSCSI30技术白皮书V110
H3CCAMSCSI3.0技术白皮书
关键词：
二次开发、接口、系统对接、CSI、CAMS
摘要：
H3CCAMSCSI3.0是杭州华三通信技术有限公司（以下简称H3C）为综合接入管理系统（CAMS）提供的用于进行产品二次开发的WebServices标准接口。
CAMSCSI3.0使用WebServices技术实现，支持外部软件系统通过SOAP协议调用CAMS提供的二次开发接口，实现与CAMS系统的无缝对接。
缩略语清单：
缩略语
英文全名
中文解释
CAMS
ComprehensiveAccessManagementServer
综合访问管理服务器
CSI
CustomizationServiceInterface
定制服务接口
SOAP
SimpleObjectAccessProtocol
简单对象访问协议
WSDL
WebServicesDescriptionLanguage
Web服务描述语言
目录
1概述3
2技术应用背景3
2.1技术优点3
2.2应用场合3
3特性介绍4
3.1WebServices介绍4
3.2WebServices的整体架构5
4CAMSCSI3.0实现的技术特色5
5典型组网案例6
5.1校园一卡通系统与CAMS对接6
5.2人力资源管理系统与CAMS融合8
6总结和展望10
7附录10
7.1CAMSCSI3.0规格列表10
1概述
CAMSCSI3.0是H3C开发的，用于对综合访问管理服务器（CAMS）产品进行二次开发的WebServices标准接口。
CAMSCSI的全称是CAMS定制服务接口（CustomizationServiceInterface），CAMSCSI3.0是CAMSCSI1.0的一个全新实现。
2技术应用背景
2.1技术优点
CAMSCSI3.0使用WebServices技术实现，支持外部软件系统通过SOAP协议调用CAMS提供的二次开发接口，实现与CAMS系统的无缝对接。
CAMSCSI3.0支持跨语言、跨软件系统、跨操作系统的互操作，支持标准的SOAP实现。
外部软件系统只要遵循标准SOAP协议就可以实现和CAMS系统进行对接。
H3C为用户提供了使用JAVA，C#，Delphi，VC这四种开发语言与CAMSCSI3.0进行对接的参考样例。
CAMSCSI3.0提供了标准、通用的基于WebServices二次开发接口，经过简单的二次开发工作，客户可以轻易将CAMS系统集成到现有运营管理系统中，如企业中的员工管理系统，学校中的学籍管理系统等。
目前大多数企业或学校都有一套核心的帐号管理系统，通过基于CAMSCSI3.0的二次开发，客户可以实现由现有的用户管理系统对CAMS系统进行功能调用，成功将CAMS的功能合入现有管理系统，极大的减轻了管理员学习和维护CAMS的工作量。
CAMSCSI3.0还提供了可配置的查询接口，将需要查询的条件信息写在配置文件中，提供给CAMSCSI3.0，客户就可查询到想要的信息。
由于不需要编码，所以能够快速响应客户个性化及临时性的信息查询需求。
2.2应用场合
CAMSCSI3.0是CAMS提供的基于WebServices的二次开发接口，主要为了满足各行业客户希望CAMS可以融合入当前网络管理系统，或是与某系统进行对接的需求。
客户或集成商可以在CAMS提供的二次开发接口上进行二次开发工作，满足客户的特定需求或是实现与另一系统对接。
H3C可以对使用二次开发接口开发的公司提供技术支持，但不会进行二次开发工作。
3WebServices特性介绍
3.1WebServices技术
WebServices是一种新的Web应用程序分支，是自包含、自描述、模块化的应用，可以发布、定位、通过Web调用。
WebServices可以执行从简单的请求到复杂商务处理的任何功能。
一旦部署以后，其他WebServices应用程序可以发现并调用它部署的服务。
WebServices是一种应用程序，它可以使用标准的互联网协议，像超文本传输协议（HTTP）和XML，将功能纲领性地体现在互联网和企业内部网上。
可将Web服务视作Web上的组件编程。
它为未来全球的电子商务发展提供了新的标准和架构。
WebServices是独立的、模块化的应用，能够通过因特网来描述、发布、定位以及调用。
在WebServices的体系架构中包括三个角色：
服务提供者（ServiceProvider）、服务请求者（ServiceRequestor）、服务注册器（ServiceRegister）。
角色间主要有三个操作：
发布（Publish）、查找（Find）、绑定（Bind）。
WebServices中涉及两个部分：
服务本身和对服务的描述。
典型的应用过程是：
服务提供者开发一个通过网络可以被访问的服务，然后将服务的描述注册到服务注册器或者发送给服务请求者；服务请求者通过查找动作在本地或服务注册器中检索服务描述，找到后，通过绑定就可以使用该项服务。
3.2WebServices整体架构
图1WebServices的整体架构
上图是从分层的角度来描述WebServices的整体架构。
和网络的分层结构相同，上一层需要下一层的支持。
而安全性、可管理性、服务质量则需要在各个层次都有所体现。
WebServices涉及到一些新的规范,如：
UDDI（统一描述、发现和集成）、WSDL（WebServices描述语言）、WSFL（WebServicesFlowLanguage）、SOAP（简单对象访问协议）等。
通过这样一个层次分明的架构，WebServices可以实现动态的应用集成，将电子商务推向更加智能、更加实用的阶段。
4使用CAMSCSI3.0的注意事项
CAMSCSI3.0作为CAMS的组件进行安装，若客户需要对CAMS系统进行二次开发，H3C可以向实施二次开发工作的公司提供详细的接口说明帮助文档，并同时提供WSDL文档方便二次开发使用。
在调用CAMSCSI3.0各功能接口前，需首先调用login接口作为管理员登录CAMS服务器，登录成功后才能进行其它功能的调用。
使用二次开发接登录的管理员和进行Web登录的管理员一样都可以对其操作权限进行设置，根据权限的不同登录管理员可以调用的二次开发接口也不同，保证了关键服务器管理的严格性和安全性。
5典型组网案例
5.1校园一卡通系统与CAMS对接
校园一卡通等计费系统与CAMS系统对接也是校园网发展的一大趋势，有了CAMSCSI3.0就能够轻易实现通过一卡通系统对CAMS进行开户、缴费等功能，满足校园财务统一的需求。
一卡通与CAMS系统对接主要在两个方面进行对接，一是学生上网帐号管理；二是学生使用一卡通缴纳上网费。
一般情况下校园网运营施行预付费管理，即上网用户需提前在其上网帐号中充入一定金额的上网费。
收费方式可以是计时、包月等，由计费服务器根据用户的使用情况进行扣费。
一卡通系统与CAMS对接也按此种方式进行缴费和扣费处理，这样当用户将一卡通中的费用充入网络帐号后，上网费用的结算由计费服务器（CAMS）进行管理，与一卡通系统没有关联。
双方系统的对接主要在用户缴费流程上进行配合、协作。
1.一卡通与CAMS对接实现网络帐号开户功能
一卡通系统可以在学期开始时，收集学生用户信息，在为学生用户注册的同时，一卡通系统调用CAMS提供的addAcctUser接口在CAMS系统中增加帐号用户（按接口要求提供开户所需的必要信息，包括帐号名、初始密码等），在CAMS中为学生用户进行开户。
这样可以大大减少学校网络中心在开学时为学生开户的工作量。
2.一卡通与CAMS对接实现通过一卡通缴纳网络使用费功能
一卡通系统通过调用CAMS提供的为指定的帐号缴费二次开发接口，可以实现学生使用一卡通系统缴纳网络使用费功能。
根据实际需要，可以有学生自行登录一卡通自助服务缴纳网络使用费，或是学生用户到网络中心使用专用POS机进行网络使用费缴费，两种缴费方式。
当学生用户通过一卡通缴纳了网络使用费后，网络使用费的结算由计费服务器（CAMS）进行管理，与一卡通系统没有关联。
双方系统的对接主要在用户缴费流程上进行配合和协作。
CAMS提供的是基于WebServices的二次开发接口，因此一卡通系统服务器只需可以和CAMS服务器保持网络连通即可。
两个系统的数据交互都是通过后台完成的，CAMS与POS机之间没有交互数据。
图1一卡通系统与CAMS对接示意图
一卡通与CAMS对接为用户缴纳上网费流程如下图所示。
图2一卡通系统与CAMS对接实现通过一卡通缴纳网络使用费流程示意图
（2）使用一卡通自助服务页面缴费
使用一卡通自助服务页面进行网络使用费缴费，学生需登录一卡通系统提供的自助界面，由一卡通收集指定的网络帐号、缴费金额等信息，然后调用CAMS二次开发接口对指定网络帐号进行缴费充值。
当一卡通系统收到CAMS返回的缴费“成功”信息后，相应扣除学生在一卡通系统中的帐户金额。
（3）使用专用POS机进行缴费
使用专用POS机缴纳网络使用费，需上网用户缴费时持自身一卡通到网络缴费专用POS机处进行网络缴费。
学校安排专人使用POS机对持卡人进行扣费。
一卡通系统接到扣费后，调用CAMS提供的用户缴费接口对用户进行缴费，收到缴费“成功”信息后，一卡通系统对用户进行扣款操作。
一卡通系统也可以根据一卡通卡号，对应出CAMS的用户帐号，直接调用CAMS接口进行对指定帐号的缴费，可以大大降低管理员的工作量。
5.2人力资源管理系统与CAMS融合
很多企业拥有自己的人力资源管理系统，对于网络管理中心来说，通常公司的人员调动是不会第一时间通知网络管理中心的。
这样就容易造成某员工已经调动了岗位，可是其网络访问权限还没有做相应改变，这就给企业的内网安全带来隐患（最主要的威胁是机密信息的泄漏）。
CAMS作为网络接入认证管理服务器，可以根据不同的用户身份为其下发不同的网络访问权限。
通过CAMS提供的基于WebServices的二次开发接口，企业可以轻松实现将现有的人力资源管理系统与CAMS融合，对员工的网络使用权限进行统一管理。
企业人力资源系统可以根据员工的调动情况，主动调用CAMS提供的相关接口，改变调动员工的网络访问权限，在大大降低网络管理员工作量的同时，保证了员工网络使用权限与其身份保持同步。
CAMS支持为不同网络管理员进行权限划分，企业可以将对员工进行权限设置和修改的管理权全部收归由人力资源系统管理，避免了人为操作时可能会出现的违规授权。
确保了员工的网络访问权限与其身份保持一致，增强了内网安全管理。
图1人力资源系统与CAMS融合示意图
人力资源系统与CAMS融合操作流程如下图所示。
图2人力资源系统与CAMS融合操作流程示意图
企业首先要明确各类员工的网络使用权限应该如何划分，并先期在CAMS中设置好相应的服务，拥有同样网络权限的员工，使用一种服务，这样对于员工的网络权限更改，只需更换其使用的网络服务即可。
CAMSCSI3.0提供了按帐号名申请指定服务（applyService）和按帐户名注销指定服务（cancelService）两个二次开发接口来实现对某帐号的服务更改。
人力资源系统首先调用cancelService，注销某帐号使用的服务，再调用applyService，为某帐号申请服务。
这样就通过后台操作，直接对某员工的网络访问权限进行了修改。
避免了认为操作时的漏洞和巨大的工作量。
同样的道理，人力资源系统可以调用CAMS二次开发接口为员工进行网络帐号开户、销户等操作，真正实现将网络接入管理系统融合入企业运营管理的大体系。
6总结和展望
网络接入认证管理已成为企业网络管理中的重要部分，企业IT管理部门都希望能够将用户接入认证管理纳入统一的网络管理平台。
CAMS二次开发接口能够为客户提供标准的WebServices开发接口，使得CAMS能够有效的与现有网络管理平台进行联动配合。
在教育行业，一卡通系统在CAMS提供的二次开发接口上进行二次开发，可以实现使用一卡通缴纳校园网使用费的功能，完成两大系统的对接，在教育行业具有广阔的前景。
7附录
7.1CAMSCSI3.0规格列表
目前CAMSCSI3.0提供的接口如下表所示。
接口名
功能描述
常用功能接口
addAcctUser
提供在CAMS系统中增加帐号用户功能
modifyAcctUser
提供修改CAMS系统中的帐号用户信息功能
applyService
提供按帐号名申请指定的服务
deleteAcctUser
提供按帐号名注销CAMS帐号功能
cancelService
提供按帐号名注销指定的服务
changeAcctPassword
提供按帐号名修改帐号用户密码
queryAcctByName
提供按帐号名查询帐号用户基本信息
queryAcctPassword
提供按帐号名查询帐号用户密码
queryAcctServiceInfo
提供按帐号名查询帐号用户申请的所有服务
queryAppendDefInfo
提供查询CAMS系统中当前所有的用户附加信息定义
queryLanService
查询LAN服务
addBlackList
增加黑名单
deleteBlackList
删除黑名单
queryBlackList
查询黑名单
pay
为指定的帐号缴费
queryUserBalance
查询用户余额
querySwitchDetail
查询上网明细
singleQuery
提供单条记录的简单查询功能
multiQuery
提供多条记录的简单查询功能
login
操作员登录CAMS服务器
logout
操作员注销
randomReq
从CAMS服务器获取本次会话的随机数
定制查询接口
FeeMng_queryBill_AcctName
提供按帐号名查询帐单信息
FeeMng_queryPaymentRecord
提供按付费方式及帐号名查询缴费记录
UserMng_queryBalance
提供按帐号余额的大小查询所有符合条件的帐号
FeeMng_queryPaymentRecord
提供按照操作员，缴费时间段等条件查询缴费记录明细
FeeMng_queryPaymentRecordTotal
提供按照操作员，缴费时间段等条件查询某个操作员的收费总金额
升级会员 