BOSS项目-SSO接入开发指南.doc

BOSS项目 SSO接入开发指南 拟制： 唐锋 日期： 2006-7-31 审核： 日期： 批准： 日期： 文档编号：BOSS-XX-SIM-0 创建日期：2006-MM-DD 最后修改日期：2006-8-28 版 本 号：1 电子版文件名：BOSS项目-SSO接入开发指南 文档修改记录 修改日期 修改人 修改说明 版本号 修改页 目 录 1 概述 4 1.1 SSO 应用接入 4 1.2 阅读对象 4 2 开发环境说明 4 2.1 系统要求 4 2.2 发布包目录结构及文件说明 4 2.2.1 api 4 2.2.2 conf 4 2.2.3 demo 4 2.2.4 lib 4 3 SSO Agent接入开发 5 3.1 应用插件加载器 5 3.1.1 实现接口 6 3.1.2 配置文件 7 3.2 操作员单点认证 8 3.2.1 实现接口 8 3.2.2 配置文件 9 3.3 操作员、组织数据消息同步接口 10 3.3.1 实现接口 10 3.4 应用认证接口 11 3.4.1 实现接口 11 3.4.2 应用认证配置 12 4 DEMO 12 5 使用SSO 客户端接口进行开发 13 5.1 创建SSO 客户端 13 5.2 操作员认证接口 13 5.3 数据访问接口 14 5.4 应用认证接口 15 5.5 JMS消息定义 15 5.5.1 操作员会话过期消息(SSOOperatorSessionEvent) 15 5.5.2 应用认证会话过期消息(SSOApplictionSessoinEvent) 16 5.5.3 操作员信息修改消息(SSOOperatorEvent) 16 5.5.4 组织信息修改消息(SSOOrgEvent) 16 5.5.5 应用权限更新消息(SSOAppPermEvent) 16 概述 SSO 应用接入 SSO 系统提供提供三个主要功能： 操作员单点登录。 应用系统互信认证。 操作员、组织信息的访问和维护功能。 应用接入SSO系统主要可以通过两种方式：Out-Application 及In-Application方式。 Out-Application模式： 这种方式通过SSO Agent 进行接入。SSO Agent 负责管理操作员的登录/退出流程，操作员在应用中的SSO 的Session管理，并具SSO Agent 负责收接应用发送过的操作员登录，退出等信息交给应用进行处理。这种方式对应用接入的开发来说，优点是开发工作量比较小，开发相对比较简单。缺点就是应用对SSO的控制比较弱。 In-Application模式： 这种方式由应用通过SSO Server 接供的基本接口来控制SSO 登录退出流程。负责自己接收SSO Server 发送给应用的消息。这种方式应用可以灵活的控制SSO流程。缺点对应用的开发量比较大。 阅读对象 SSO接入开发人员。 开发环境说明 系统要求 SSO Agent 是基于JDK1.4.2进行开发的，在tomcat4.1.30及BES6.5上测试通过 发布包目录结构及文件说明 SSOAgent ├─api ├─conf ├─demo ├─lib └─sso-agent-1.0.jar api 该目录下保存了SSO 的 javadoc文件 conf 配置的模板文件 demo SSO Agent 的DEMO程序 lib SSO Agent 所依赖的jar文件 activation-1.1.jar commons-codec-1.3.jar commons-httpclient-3.0-rc4.jar commons-lang-2.1.jar commons-logging.jar concurrent-1.3.2.jar jaxen-1.1-beta-9.jar jdom-1.0.jar log4j-1.2.11.jar mail-1.4.jar stax-1.2.0_rc2-dev.jar stax-api-1.0.1.jar wsdl4j-1.5.2.jar wstx-asl-2.9.3.jar xfire-all-1.1.2.jar SSO Agent接入开发(Out-Application) SSO Agent的结构 SSO Agent 是为了方便Web Base应用系统接入而提供的一套框架，他实现了三个主要的功能。 操作员认证 SSO单点登录。 向SSO 服务器汇报应用程序中的会话最后活动时间。 通过JMS接收操