前言：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）其他辅助列。
