分享：利用启动插件校验机制实现免登录功能，实现跨系统无缝集成

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

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

3、客户定制逻辑组件编写（详细代码参考6）
     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异常，框架会忽略异常后进入登录界面。

4、部署
    4.1、拷贝插件到WebSite/Bin目录下。
    4.2、修改配置文件WebSite/App_Data/Common.config,在appsettings节点下增加如下项目：
<!--启动服务插件-->
<add key ="StartAppPlugin" value="Kingdee.BOS.ServiceFacade.StartApp.MacVerify,Kingdee.BOS.ServiceFacade.StartApp" />


特别注意：不要只写类名，组件名就不写了。上面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?[url=]ud=TestAutoLoginWithDemo[/url]
    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
    {
        /// <summary>
        /// 客制化参数映射到用户信息，或域签名串映射到用户信息存储池，也可以是数据库
        /// </summary>
        static ConcurrentDictionary<string, string> customArgsMapUser = new ConcurrentDictionary<string, string>();
        static MacVerify()
        {
            customArgsMapUser["testautologinwithdemo"] = "demo|888888|CPDEMOV5";
        }
        /// <summary>
        /// 随机测试标识，仅用于模拟各种启动校验结果的返回判定
        /// </summary>
        static int randomFlag = 0;
        /// <summary>
        /// 实现登录服务处理接口，在程序启动界面加入参数 "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
        /// </summary>
       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;
        }
        /// <summary>
        /// 实现登录校验的例子的私有函数
        /// </summary>
        private void VerifyLogin(KDServiceContext context, StartAppResult ret, JSONObject data)
        {
            //实现自动登录功能
            var customArgs = data.GetValue<string>("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，给客户端实现自动登录
                    DoLoginCore(context, ret, pluginLoginInfo);
//登录后的参数传入，具体使用参考【自动打开单据】
                    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;
                }
            }
        }
        
        /// <summary>
        /// 实现基类访问校验接口，如果没有该业务需求，可以不实现，使用基类的接口即可。
        /// </summary>
        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;
        }
         /// <summary>
        /// 构造返回结果
        /// </summary>
        /// <param name="fcbType">返回回调类型</param>
        /// <returns></returns>
        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;
        }
    }
}