单点登录-金蝶云星空

概述

本文档详细介绍如何配置专属集成平台与金蝶云星空系统之间的单点登录功能。通过此配置，企业用户可以使用专属集成平台的身份认证直接登录金蝶云星空系统，无需重复输入账号密码，显著提升用户体验和工作效率。

金蝶云星空是一款企业级云ERP系统，为企业提供财务管理、供应链管理、生产制造、人力资源等全面的业务管理解决方案。通过单点登录集成，可实现企业统一身份认证体系与金蝶云星空的无缝连接。

配置步骤

步骤 1：创建金蝶云星空应用

登录管理控制台

登录专属集成平台管理控制台

搜索应用

导航至「应用中心 → 应用管理 → 应用市场」，在搜索框中输入"金蝶云星空"

添加应用

点击「添加」按钮，将该应用添加到应用列表中

步骤 2：基本信息配置

在添加应用后，进入应用配置页面，设置基本信息：

基本信息参数	说明
自定义应用名称	根据企业需求自定义应用名称
应用分类	选择合适的应用分类，如"ERP系统"或"财务系统"
首页地址	个人门户中显示的应用访问地址
Client ID	应用的唯一标识，系统自动生成，不可编辑
Client Secret	应用的密钥，系统自动生成，不可编辑，但可以点击"重置"按钮重新生成

步骤 3：单点登录配置

切换到"登录配置"选项卡，填写金蝶云星空单点登录所需的参数：

单点配置参数	说明	获取方式
单点登录地址	金蝶云星空的登录URL	向金蝶客户方获取
数据中心ID	金蝶云星空的数据中心标识	向金蝶客户方获取
应用程序ID	金蝶系统分配的应用标识	向金蝶客户方获取
语言ID	系统语言设置，如"2052"代表中文	向金蝶客户方获取
集成类型	金蝶支持的集成方式	向金蝶客户方获取
应用密钥	与金蝶系统通信的安全密钥	向金蝶客户方获取
用户属性	用于匹配金蝶系统中用户的属性字段	通常为用户名或工号

重要提示：上述参数需要与金蝶客户方进行确认，确保信息准确无误，否则可能导致单点登录失败。

步骤 4：处理中文编码问题（如需）

在使用中文语言ID时，可能会遇到中文名无法正确传入系统的问题，只能到达登录界面而无法登录成功。这是由于字符编码问题导致的，解决方法如下：

方法一：修改金蝶系统配置文件

需要金蝶客户方协助在金蝶系统的 common.config 文件中添加以下配置：

<!-- 默认为操作系统默认编码，例如简体服务器为GB2312编码器，如果需要指定，可以用下面参数指定utf-8 -->
<add key="StartAppPluginUDConfig" value="{encoding:'utf-8'}" />

同时，在生成单点登录参数时，使用 UTF-8 编码并进行 Base64 转换：

方法二：使用URL参数指定编码（适用于2021年3月后的版本）

在构建URL时添加参数udencoding=utf-8：

将生成好的ud参数整体进行基于UTF-8的Base64编码

在URL地址中增加参数&udencoding=utf-8

示例 URL 格式：

https://xxx/k3cloud/html5/index.aspx?udencoding=utf-8&ud=###

参考资料：更多详细信息可参考金蝶云星空社区的集成文档

步骤 5：授权范围配置

配置可访问金蝶云星空应用的用户范围。专属集成平台支持以下三种授权方式：

在专属集成平台中，配置可访问金蝶应用的用户范围

在应用详情页，切换到「授权范围」选项卡

可通过以下方式进行授权：

基于组织架构和用户授权：授权特定部门或用户

基于角色授权（RBAC）：通过静态标签（角色）授权

基于用户属性授权（ABAC）：通过动态标签（用户属性）授权

根据企业需求选择合适的授权方式并配置授权范围

保存配置

根据企业实际需求，选择合适的授权方式，并配置相应的授权范围，确保只有授权用户才能访问金蝶云星空应用。

用户映射配置

为确保单点登录成功，需要正确配置专属集成平台用户与金蝶云星空系统用户之间的映射关系：

确定映射字段：

通常使用用户名、工号或邮箱作为映射字段

确保两个系统中对应字段的值保持一致

用户数据准备：

确认金蝶云星空系统中已创建相应用户

确保专属集成平台中的用户属性值与金蝶系统匹配

特殊字符处理：

注意用户名中的特殊字符可能需要进行编码处理

对于中文用户名，参考前述编码解决方案

测试与验证

测试步骤

登录用户门户

登录专属集成平台用户门户

访问金蝶应用

在应用列表中找到并点击「金蝶云星空」应用图标

验证登录结果

系统应自动完成认证并跳转至金蝶云星空界面，验证是否成功进入系统且正确显示用户信息

常见问题与排障

无法跳转到金蝶系统

可能原因：

单点登录地址配置错误

网络连接问题

金蝶系统未正确配置单点登录

解决方案：

验证单点登录地址准确性

检查网络连接状况

联系金蝶技术支持确认系统配置

到达登录页但无法自动登录

可能原因：

用户属性映射不正确

应用程序ID或密钥错误

中文编码问题

解决方案：

检查用户属性映射配置

验证应用程序ID和密钥

根据前述方法解决中文编码问题

登录后权限不正确

可能原因：

金蝶系统中的用户权限配置问题

未正确传递角色或权限信息

解决方案：

检查金蝶系统中的用户权限设置

咨询金蝶技术支持如何通过单点登录传递权限信息

最佳实践

安全建议

定期更新密钥和认证凭证

限制只有必要的用户才能访问金蝶系统

考虑启用多因子认证增强安全性

监控和审计单点登录操作

性能优化

优化单点登录的参数传递方式

避免传递过多不必要的用户属性

定期清理会话数据，避免资源占用

用户体验提升

为用户提供详细的操作指引

设置合理的会话超时时间

在单点登录失败时提供明确的错误提示

附录

金蝶云星空参数说明

参数名称	说明	示例值
acctID	账套ID	"61436328kaxuec"
username	用户名称	"张三"
lcid	语言ID	"2052"(中文)
alwaysUseDataSrc	是否总是使用数据源	"1"
dbId	账套ID，同acctID	"61436328kaxuec"

常见错误码及处理方法

错误码	说明	解决方案
401	认证失败	检查用户名、密码或认证密钥
403	权限不足	确认用户在金蝶系统中拥有足够权限
500	服务器内部错误	联系金蝶技术支持

参考文档

钉钉工作台触发单点登录参考文档：钉钉工作台应用免登

IDP 发起单点登录拼接地址参考文档：单点登录（SSO）链接拼接指南

金蝶云星空 API 开发文档：金蝶云星空集成文档

概述#

配置步骤#

步骤 1：创建金蝶云星空应用#

步骤 2：基本信息配置#

步骤 3：单点登录配置#

步骤 4：处理中文编码问题（如需）#

方法一：修改金蝶系统配置文件#

方法二：使用URL参数指定编码（适用于2021年3月后的版本）#

步骤 5：授权范围配置#

用户映射配置#

测试与验证#

测试步骤#

常见问题与排障#

无法跳转到金蝶系统#

到达登录页但无法自动登录#

登录后权限不正确#

最佳实践#

安全建议#

性能优化#

用户体验提升#

附录#

金蝶云星空参数说明#

常见错误码及处理方法#

参考文档#

概述

配置步骤

步骤 1：创建金蝶云星空应用

步骤 2：基本信息配置

步骤 3：单点登录配置

步骤 4：处理中文编码问题（如需）

方法一：修改金蝶系统配置文件

方法二：使用URL参数指定编码（适用于2021年3月后的版本）

步骤 5：授权范围配置

用户映射配置

测试与验证

测试步骤

常见问题与排障

无法跳转到金蝶系统

到达登录页但无法自动登录

登录后权限不正确

最佳实践

安全建议

性能优化

用户体验提升

附录

金蝶云星空参数说明

常见错误码及处理方法

参考文档