前言:EAFC是我们公司的一个框架,一个项目上,客户的OA系统要调用我们推送过去的代办任务,希望能打开我们的代办处理界面,我们的代办处理界面是winform的。引出给出了以下的一个方案。在此备存。
--------------------------------------------------------
第三方系统打开EAFC的实现
借助ClickOnce来实现第三方系统打开本地eafc客户端,而无论第三方系统是网页版还是桌面版(比如在oa中点击待办事项,打开审批界面)。
一. 参数
打开eafc,要支持客户端参数。可以通过ClickOnce传递参数给客户端,以便客户端根据传入的参数做相应的动作。
1,外部系统 sysid。需要给每个要打开eafc的外部系统分配唯一的编号,用于识别可信任系统。使用该系统id,可以实现凭证的解密,用户的映射等等。
2,认证信息 credential。通过认证信息,客户端来确定请求用户的合法性。credential 的实现有多种,可以是 账号+密码+随机码(加密后),也可以是系统根据某种方式生成的token。
3,认证方式 auth_mode
可以是 1:账号密码明文方式;2,账号密码密文方式;3:内部通行证方式。默认 1。
4,应用 app
要打开的应用的编号。无默认值
5,要打开的功能编号 func
登录后,自动打开的功能,只能一个。
6,功能参数 func_param
7,其他参数:
(1)tm 树形菜单 0:隐藏,1打开,默认打开
(2)dm下拉菜单 0:隐藏,1打开,默认打开
(3)title:窗口标题,默认系统原标题
(4)sm:自启动模块,0:禁止,1:启用,默认启用
(5)size:窗口大小,w,h或者 max最大化,默认最大化。
二,接口功能与用户认证
1. 取任务列表
条码系统通过提供webservice,供外部系统(比如茂名OA系统)调用以获得某个用户的待办任务列表。
参数:系统id,用户凭据credential,时间范围。。。
根据系统id,来判断采用哪种用户验证方式(系统可以配置对每个外部系统的验证方法,验证链),验证通过后,转换为本地系统用户。
其中,用户凭据可以是账号密码,可以是明文或者加密,比如使用des或者rsa加密,推荐使用rsa非对称加密。如果使用des的话,最好不同外部系统使用不同的加密密钥。根据 “账号 + 密码 + 随机码”形成字符串,进行加密形成。加随机码的目的是:使即便是同一个人,每次形成的credential也不同,避免重放攻击。在登录时,将credential发送给服务端,解析出账号和密码进行验证。
2. 打开待办任务
通过客户端打开待办任务时,必须以某个账号登录到系统。因为登录信息通过ClickOnce参数传递,要考虑安全性,比如密码不要使用明文,还要避免重放攻击。
在形成代办事项列表时,将credential形成在待办任务的处理url中。代办列表的格式:
http:/[ip]/eafc.appliction?credential=<验证串>&auth_mode=2&func=<功能号>&......
credential 的形成有两种(参见一、参数 1.认证方式),如下:
(1)第1种方式,用户账号+密码方式
credential。加密方式和验证方式参见第一部分的说明。
(2)第2种方式
其中credential由系统随机生成,并存放在表中,表的格式:
凭据表名:ams_sys_credential
(1)credential char(100) -- 可以是guid,只要是随机的不重复,且很难猜出来就行。
(2)user_id number -- 对应的本系统用户
(3)create_time datetime -- 创建时间
(4)exp_time datetime -- 过期时间 过期后,该凭据无效。系统会自动删除过期的凭证。
打开待办任务时,eafc从参数中取得credential串,发送给服务器进行验证,验证程序在凭据表ams_sys_credential中查找该credential,如果存在且没有过期,验证通过,返回该credential对应的本地用户。否则验证失败。
三、外部系统的管理
外部系统打开eafc时,需要传递外部系统id。外部系统id由eafc统一分配和管理。对不同的外部系统,eafc可以使用不同的用户凭证验证方式;凭据加解密,用户映射。
1,凭证验证方式。不同的外部系统可能支持不同的用户验证方式,比如茂名oa可能是ad域用户验证,其他系统也可能是本系统自己验证(提供验证服务)。或者是多种验证方式的组合(验证链)。eafc可以根据不同的系统,配置不同的验证方式。
2,凭据加解密。根据不同的外部系统,配置不同的加解密方式,以及存放加解密密钥。
3,用户映射。有时候外部系统传入的用户账号是外部系统本地用户而不是eafc的用户信息。在通过外部系统账号登录时,验证通过后,需要转换成eafc本地系统用户。
除了外部系统需要登录eafc外,相对应的,eafc也可能需要登录外部系统,比如茂名的投资计划管理系统。也需要以上的3点信息。
外部系统管理的相关表:
1,外部系统注册表 ams_sys_trust_system
(1)系统id varchar(20)
(2)系统描述
(3)系统登录页面
2,外部系统详细信息表 ams_sys_trust_system_dtl
(4)对外部系统的加密方法 --提供给外部系的加解密方法 des或者rsa
(5)外部系统提供的加密方法 --满足外部系统要求的加解密方法,des或者rsa
(6)对外部系统的加密参数
(7)外部系统提供的加密参数
(8)对外部系统提供的加解密provider ;用来解密外部系统传过来的加密的凭据
(9)外部系统的加解密provider;用来将明文加密靠后传送给外部系统
(10)验证链 --外部系统登录本系统时的验证链
2,用户映射关系 ams_sys_user_mapping
(1)系统id
(2)内部用户id
(4)外部系统用户账号
(5)外部系统用户密码
(6)其他辅助列。