背景：国家安全法发布，产品升级，安全策略进行调整，第三方系统登录授权安全性进行升级，需要控制某一条授权配置允许的登录用户信息，避免异常登录
支持补丁：2021年10月补丁
1.启用第三方系统登录授权
2 测试第三方系统单点登陆
允许全部用户登录：此应用ID、应用密钥 允许二开自定义登录链接，允许所有用户登录
指定用户登录：此应用ID、应用密钥 允许二开自定义登录链接，但只允许列表中用户进行登录
连接有效性：
链接仅供使用一次： 生成链接只允许登录一次
支持链接重复使用：生成的链接允许使用多次进行登录
3 在第三方系统中生成签名授权的URL
【参数格式】：ud=
{"dbid":"60a476ea609cb0","username":"0602ws","appid":"DataView","signeddata":"9c8dcf74e16912e58dc067cc9c405a76f56acff3","timestamp":"1632876418","lcid":"2052","origintype":"SimPas","entryrole":"","formid":"","formtype":"","pkid":"","otherargs":"|{'permitcount':'0'}","openmode":null}
【参数说明】：
dbid：数据中心的ID;
username：用户名称；
appid：应用程序ID，通过Administrator登录数据中心后，在【系统管理】分类的【第三方系统登录授权】功能里面进行新增维护；（云之家可以不填由querystring参数决定）
signeddata：参考文章【https://vip.kingdee.com/article/37406】;
timestamp：登录时间戳(Unix时间戳,定义为从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数)；
lcid（可选）：语言ID，中文2052（默认），英文1033，繁体3076;
origintype： XT=云之家集成（同时要求entryrole=XT）；SimPas=简单通行证集成;
entryrole：验证权限的入口角色;
formid： 登录后默认打开功能的表单id；
formtype：登录后默认打开功能的格式，目前有单据bill和列表list两种方式，没有列表的功能统一为bill；
pkid：formid对应表单的主键；formtype为list时忽略，formtype为bill时起作用，如果为空表示新增状态；
otherargs：作为用户自定义参数传入，使用于二开；
permitcount：允许登录次数，0 允许重复登录 ，1 只允许登录一次
具体内容和格式由二开人员确定，最终在指定表单的插件中通过GetCustomParameter(FormConst.StartAppArgs)获取,具体参考【https://vip.kingdee.com/article/37644 】
NET示例代码如下：
using Kingdee.BOS.Util;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Kingdee.BOS.BusinessEntity.Login;
namespace PassportLogin
{
class Program
{
static void Main(string[] args)
{
int lcId = 2052;
long timestamp = DateTimeFormatUtils.CurrentTimeMillis() / 1000;//时间戳
string dbId = "57b11d0f7a3b1a";//数据中心ID
string usserName = "ly";//用户名称
string appId = "SRMLightApp";//第三方系统应用Id
string appSecret = "7d9169bfbdc34e9cbd96069db5e72917";//第三方系统应用秘钥
string[] arr = new string[] { dbId, usserName, appId, appSecret, timestamp.ToString() ,permitcount.GetString()};
string sign = Kingdee.BOS.Util.SHA1Util.GetSignature(arr);//签名
SimplePassportLoginArg arg = new SimplePassportLoginArg();
arg.appid = appId;
arg.dbid = dbId;
arg.lcid = lcId.ToString();
arg.origintype = "SimPas";
arg.signeddata = sign;
arg.timestamp = timestamp.ToString();
arg.username = usserName;
arg.entryrole = string.Empty;
arg.formid = string.Empty;
arg.formtype = string.Empty;
arg.otherargs = string.Format("|{{\'permitcount\':'{0}'}}", permitcount);
arg.pkid = string.Empty;
string argJosn = Kingdee.BOS.JSON.KDObjectConverter.SerializeObject(arg);//json格式
string argJsonBase64 = System.Text.UTF8Encoding.UTF8.GetBytes(argJosn).ToBase64();//base64编码
string silverlightUrl = "http://localhost/K3Cloud/Silverlight/IndexSL.aspx?ud=" + argJsonBase64;// Silverlight入口链接
string html5Url = "http://localhost/K3Cloud/html5/IndexSL.aspx?ud=" + argJsonBase64;// html5入口链接
Console.WriteLine(silverlightUrl);
Console.WriteLine(html5Url);
Console.ReadLine();
}
}
}
注意：如果不传参数permitcount进行控制登录次数，在签名时就也不要添加参数permitcount
中文名的进不去只到登录界面，请配置
common.config配置 <!--默认为操作系统默认编码，例如简体服务器为GB2312编码器，如果需要制定，可以用下面参数制定utf-8-->
<add key ="StartAppPluginUDConfig" value="{encoding:'utf-8'}" />
然后 string argJsonBase64 = System.Text.UTF8Encoding.UTF8.GetBytes(argJosn).ToBase64();//base64编码
如果是21年3月以后补丁 在构建url时添加参数udencoding=utf-8也可以解决
对生成好的ud参数整体进行基于Utf-8的Base64的编码，并在url地址增加url参数 &udencoding=utf-8 即可。例如：https://xxx/k3cloud/html5/index.aspx?udencoding=utf-8&ud=### ；（PT-146869 [7.6.0.202103] 2021/3/25 7.6.2122.7 ）
注意：拷贝上面的配置数据时，把所有的空格去掉然后重新空格一下，直接拷贝的空格有问题
4 从第三方系统注销用户
接口地址：http://ip/K3Cloud/Kingdee.BOS.ServiceFacade.ServicesStub.User.UserService.LogoutByOtherSystem.common.kdsvc
请求类型：post
参数
参数名称：ap0
参数值：{"AcctID":"5ab22542230aaf","AppId":"hr","Username":"txt","SignedData":"4cdde33b74d55c328291a24f299cb745a50621bc","Timestamp":1525413177}
AcctID：数据中心ID
Username：为要注销的用户名称
AppId：应用ID
SignedData:签名数据，算法同上
Timestamp：时间戳
5、知识扩展链接
V1版本集成：https://vip.kingdee.com/article/1245
V2 版本集成：https://vip.kingdee.com/article/9788
利用启动插件校验机制实现免登录功能，实现跨系统无缝集成参考如下文章: https://vip.kingdee.com/article/34918
推荐阅读