分享：利用启动插件校验机制实现免登录功能，实现跨系...

栏目：云星空知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

分享：利用启动插件校验机制实现免登录功能，实现跨系统无缝集成（2015-08-20之后的5.0补丁或6.0的功能中）

【预告】：在2016-04的补丁中，我们增加一种简单通行证方式，可以通过注册公钥加密用户名数据中心信息实现登录。详情请参考下面帖子更新内容[启动插件校验机制实现免登录功能,【简单通行证】方式]

【特别敬告：本例子中采用的参数映射法，强烈推荐采用V2版本的参数协议，具有更强的扩展性。V2协议参看链接】 [V2协议]

1、背景
在一些第三方系统中希望集成K/3 Cloud系统，在第三方系统登录后能直接进入K/3 Cloud系统，而无须再次通过登录界面录入数据中心，用户名和密码，这时基于安全性需要，需要提供客制化的会话串来实现与第三方系统之间的映射校验。

2、实现
在K/3 Cloud客户端或者Web程序启动时，调用StartAppVerifyService服务进行校验，校验可配置用户定制逻辑组件接入进行校验。如果允许接入，则按用户定制组件逻辑实现K/3 Cloud登录校验，校验通过，则直接按指定用户进入K/3 Cloud系统主控界面。

3、客户定制逻辑组件编写（[i]详细代码参考6[/i]）
3.1、新建C#组件库工程，配置为NetFramework4.0支持。
3.2、引用K/3 Cloud WebSite/Bin目录下的如下4个组件：
Kingdee.BOS.dll,
Kingdee.BOS.DataEntity.dll,
Kingdee.BOS.ServiceFacade.ServicesStub.dll,
Kingdee.BOS.ServiceFacade.KDServiceFx.dll。
3.3、添加新类文件，命名为MacVerify（例如），并继承接口 Kingdee.BOS.ServiceFacade.ServicesStub.StartAppVerifyServiceBase抽象类，实现接口行数 StartAppResult Verify(KDServiceContext context, string ipmac)。其中ipmac数据会包含属性customArgs，该属性既是客制化参数，由第三方应用传入，传入方式如下三种方式，组件中的customArgs参数内容来源于下面定制参数的ud入口参数内容
/// 例如：
/// 【映射用户登入信息方式】
/// WEB的Silverlight: http://xxxx/k3cloud/silverlight/index.aspx?ud=TestAutoLoginWithDemo
/// WEB的HTML5：http://xxxx/k3cloud/html5/index.aspx?ud=TestAutoLoginWithDemo
/// 客户端命令行：Kingdee.BOS.XPF.App.exe ud=TestAutoLoginWithDemo

3.4、MacVerify中可定制客户逻辑，最终返回 StartAppReslut对象即可。如果ResultType==Success正常登录，如果ResultType==Failure，则提示Message中的文本内容。通过customArgs进行数据中心，用户匹配，再调用基类的DoLoginCore方法实现K/3 Cloud的登录校验，或获取返回值的UserToken到StartAppReslut对象中。返回不需处理该UserToken，直接返回StartAppReslut对象即可实现自动登录了。
3.5、需要特别注意的是，不要在插件中直接throw new Exception()，要用返回方式2提示退出，或者方式4提示重定向来显示错误的内容，包括 exception.Message + exception.StackTrace; 一旦插件throw异常，框架会忽略异常后进入登录界面。

3.6、更多其他信息参考下面文章
参考如下文章3: https://vip.kingdee.com/article/34918参考如下文章2: https://vip.kingdee.com/article/37406
参考如下文章1: https://vip.kingdee.com/article/25013自动登录后，实现自动打开某个单据的功能： https://vip.kingdee.com/article/37644第三方系统比如Cas的集成案例，参考：https://vip.kingdee.com/article/37406

4、部署
4.1、拷贝插件到WebSite/Bin目录下。
4.2、修改配置文件WebSite/App_Data/Common.config,在appsettings节点下增加如下项目：

特别注意：不要只写类名，组件名就不写了。上面value的格式是【类的全名,组件名】
Kingdee.BOS.ServiceFacade.StartApp这个组件和其中的类仅是功能测试和演示使用。二次开发的插件不要使用Kingdee, Kingdee.BOS，Kingdee.BOS.ServiceFacade， Kingdee.BOS.ServiceFacade.StartApp.MacVerify这些命名空间和类名。如果想直接使用这个演示组件内容，建议拷贝文章中的代码内容后，修改命名空间和类名为贵公司的命名规则，不用使用Kingdee命名空间，避免后续功能补丁升级时的覆盖影响。

5、第三方接入方式
实现插件启动登录逻辑（参考后面6的插件实现）后，即可用下面方式实现免登录直接进入K/3 Cloud系统主控。
实现登录服务处理接口，在程序启动界面加入参数ud=TestAutoLoginWithDemo即可实现自动用Demo用户登录CPDEMOV5数据中心
例如：
WEB的Silverlight: http://xxxx/k3cloud/silverlight/index.aspx?ud=TestAutoLoginWithDemo
WEB的HTML5：http://xxxx/k3cloud/html5/index.aspx?ud=TestAutoLoginWithDemo
客户端命令行：Kingdee.BOS.XPF.App.exe ud=TestAutoLoginWithDemo

6、第三方接入插件代码编写：

按【3、客户定制逻辑组件编写】完成插件工程配置后，修改启动插件，继承基类StartAppVerifyServiceBase，并实现StartAppResult Verify(KDServiceContext context, string ipmac)接口;

【例子代码全文如下：】
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Collections.Concurrent;
using Kingdee.BOS.Authentication;
using Kingdee.BOS.JSON;
using Kingdee.BOS.ServiceFacade.KDServiceFx;
using Kingdee.BOS.ServiceFacade.ServicesStub;
using Kingdee.BOS.Resource;
namespace Kingdee.BOS.ServiceFacade.StartApp
{
public class MacVerify : StartAppVerifyServiceBase
{
///

/// 客制化参数映射到用户信息，或域签名串映射到用户信息存储池，也可以是数据库
///

static ConcurrentDictionary customArgsMapUser = new ConcurrentDictionary();
static MacVerify()
{
customArgsMapUser["testautologinwithdemo"] = "demo|888888|CPDEMOV5";
}
///

/// 随机测试标识，仅用于模拟各种启动校验结果的返回判定
///

static int randomFlag = 0;
///

/// 实现登录服务处理接口，在程序启动界面加入参数 "ud=TestAutoLoginWithDemo" 即可实现自动用Demo用户登录CPDEMOV5数据中心
/// 例如：
/// WEB的Silverlight: http://xxxx/k3cloud/silverlight/index.aspx?ud=TestAutoLoginWithDemo
/// WEB的HTML5：http://xxxx/k3cloud/html5/index.aspx?ud=TestAutoLoginWithDemo
/// 客户端命令行：Kingdee.BOS.XPF.App.exe ud=TestAutoLoginWithDemo
///

public override StartAppResult Verify(KDServiceContext context, string ipmac)
{
var ret = this.Verify(ipmac);
if (ret.ResultType == StartAppResultType.Success)
{
var data = JSONObject.Parse(ipmac);
VerifyLogin(context, ret, data);
}
return ret;
}
///

/// 实现登录校验的例子的私有函数
///

private void VerifyLogin(KDServiceContext context, StartAppResult ret, JSONObject data)
{
//实现自动登录功能
var customArgs = data.GetValue("customArgs", "");//ud用户定义参数将会传递到服务端插件的customArgs中
var isAutoLogin = !string.IsNullOrWhiteSpace(customArgs);
if (isAutoLogin && context != null)
{
try
{
//不一定非得从data中传进来这些信息，
//也可以通过Mac映射到数据库中的某个记录，从中读取登录信息，
//包括用户名、密码和数据库id,已经对应的语种id
//这里只是Demo而已
var userInfoStr = "";
var key = customArgs.ToLowerInvariant();
customArgsMapUser.TryGetValue(key, out userInfoStr);
if (string.IsNullOrWhiteSpace(userInfoStr))
userInfoStr = "";
var userInfo = userInfoStr.Split('|');
var un = userInfo.Length > 2 ? userInfo[0] : "";
var pw = userInfo.Length > 2 ? userInfo[1] : "";
var dbname = userInfo.Length > 2 ? userInfo[2] : "";
var pluginLoginInfo = new PluginLoginInfo()
{
//AcctID = "xxxxxx", //AcctID如果传递，将不再通过AcctName查找AcctID了。
//LoginType = PluginLoginType.Common, //默认为用户名密码的通用登录方式。 //PluginLoginInfo.AuthenticateType = Kingdee.BOS.Authentication.AuthenticationType.DynamicPwdAuthentication, // 动态密码验证方式
AcctName = dbname,
Username = un,
Password = pw,
ClientInfo = GetClientInfo(context, data) //基类静态工具方法
};
//调用基类静态工具方法实现登录验证，并返回ret.UserToken，给客户端实现自动登录
[i]DoLoginCore(context, ret, pluginLoginInfo);[/i]
//登录后的参数传入，具体使用参考【自动打开单据】
if (!string.IsNullOrWhiteSpace(ret.SessionId))
{
var isoKey = ret.SessionId + "_AutoLoginArgs";
//登陆成功后，加入自定义参数
HttpContext.Current.Application.Set(isoKey, "PUR_PurchaseOrder|100001");
}
}
catch (Exception ex)
{
ret.ResultType = StartAppResultType.Failure;
ret.FailureCallBackType = StartAppResultCallBackType.Message;
ret.Message = ex.Message + "\r\n" + ex.StackTrace;
}
}
}

///

/// 实现基类访问校验接口，如果没有该业务需求，可以不实现，使用基类的接口即可。
///

public override StartAppResult Verify(string ipmac)
{
randomFlag++;
StartAppResult ret = null;
var data = JSONObject.Parse(ipmac);
var flag = randomFlag % 5;
switch (flag)
{
case 4:
// 提示后退出并重定向到指定页面
ret = GetResult(StartAppResultCallBackType.ExitMsg_Redirect, ipmac);
break;
case 3:
// 退出并重定向到指定页面（不做任何提示）
ret = GetResult(StartAppResultCallBackType.Exit_Redirect, ipmac);
break;
case 2:
// 退出并提示
ret = GetResult(StartAppResultCallBackType.ExitMsg, ipmac);
break;
case 1:
// 提示信息（不退出程序）
ret = GetResult(StartAppResultCallBackType.Message, ipmac);
break;
default:
ret = new StartAppResult()
{
ResultType = StartAppResultType.Success
};
randomFlag = 0;
break;
}
return ret;
}
///

/// 构造返回结果
///

/// 返回回调类型
///
private static StartAppResult GetResult(StartAppResultCallBackType fcbType, string attMsg)
{
var ret = new StartAppResult()
{
FailureCallBackType = fcbType,
// 成功Sucess：正常登录
ResultType = StartAppResultType.Failure,

// 外部网址：RedirectUrl = "http://www.kingdee.com"
// 空白页：RedirectUrl = "about:blank"
// 针对WPF端，如果需要打开指定应用程序，可以这么返回 CMD://notepad.exe;
// 失败后重定向URL,可以是相对路径也可以是绝对路径，相对路径已K3Cloud为基地址，例如：http://xxxx/k3cloud/
RedirectUrl = "help/clienthelp.htm",
ExitType = StartAppResultExitType.Shutdown,

Title = ResManager.LoadKDString("温馨提示", "0022883030028663", SubSystemType.BOS),
Message = ResManager.LoadKDString("网站正在维护中 ... ...", "0022883030028642", SubSystemType.BOS) +
"\r\n" + attMsg
};
return ret;
}
}
}

姐妹篇1：【启动插件校验机制实现免登录功能,【简单通行证】方式】https://vip.kingdee.com/article/37406

姐妹篇2：【K/3 Cloud客户端 GUI和Silverlight启动时检查插件机制】http://club.kisdee.com/home.php?mod=space&uid=421257&do=blog&id=119356