单点登录-宜搭

概述

本文档详细介绍如何配置企业微信与宜搭平台之间的单点登录功能，通过专属集成平台实现用户身份的统一认证和无缝访问体验。通过此配置，用户可以从企业微信直接访问宜搭应用，无需重复登录，大幅提升用户体验和工作效率。

配置流程

配置企业微信单点登录宜搭主要分为以下几个步骤：

专属集成平台应用配置

宜搭平台单点登录设置

企业微信自建应用配置

用户关联设置

专属集成平台配置

创建应用

在专属集成平台创建应用，配置基本信息和登录方式。

登录配置

配置应用的基本登录信息和认证方式。

单点协议选择

重要提示：宜搭平台仅支持OIDC、OAUTH2、CAS单点协议，因此在专属集成平台中选择OIDC协议进行配置。

端点信息配置

配置Redirect URIs

配置OIDC协议所需的Redirect URIs，需要填写宜搭工作台和宜搭单点登录应用的地址

示例地址如下：

ID Token 签名设置

配置ID Token的签名方式和用户属性映射。

关键参数说明：

参数	说明
属性值	钉钉userid对应的属性：工号
声明名称	根据协议规范和宜搭要求：sub
多因子认证	通过企业认证源或本地方式认证通过后，会触发短信或邮箱的二次验证；不勾选视为不开启

特别注意：属性值和声明名称配置非常重要，直接影响返回给宜搭的sub值，进而影响单点登录是否成功。

配置示例：

授权范围

配置可以访问该应用的用户范围，可以选择授权给特定用户、角色或组织。

宜搭平台配置

单点登录设置

登录宜搭管理平台，导航至"设置 → 单点登录"进行配置：

参数说明：

参数	说明
Client ID	填写专属集成平台生成的Client ID
Client Secret	填写专属集成平台生成的Client Secret
Authorize URL	专属集成平台租户的域名:端口+/iam/authorize（注意：使用实际租户域名，不是代理域名）
Token URL	专属集成平台租户的域名:端口+/iam/token（注意：使用实际租户域名，不是代理域名）
Redirect URL	填写在专属集成平台中配置的宜搭工作台地址
Public Key	从OIDC服务发现端点获取的公钥信息

获取Public Key

获取jwks_uri

访问专属集成平台的服务发现地址，获取jwks_uri地址

获取Public Key

访问jwks地址，获取返回的结果，移除空格后填入Public Key输入框

企业微信单点登录宜搭

企业微信自建应用配置

参考文档：企业微信开放平台创建应用

应用首页设置

在企业微信自建应用中设置应用首页地址，使用如下格式：

https://<您的域名>/iam/authorize?response_type=code&tcode=【***】&client_id=【***】&scope=openid%20profile%20email%20address%20phone&redirect_uri=【****】

参数说明：

client_id：专属集成平台生成的Client ID

redirect_uri：专属集成平台中配置的宜搭应用地址

tcode：专属集成平台租户的名称，例如tcode=bit

您的域名：需要 Nginx 代理域名

配置示例：

专属集成平台应用首页配置

将企业微信自建应用中配置的首页地址，复制到专属集成平台应用的"基本信息"中的"首页地址"输入框，并保存：

用户关联配置

专属集成平台用户关联企业微信

使用企业微信扫码登录专属集成平台前，必须确保企业微信用户与专属集成平台中的用户已建立关联：

专属集成平台用户关联钉钉

如果涉及钉钉登录，也需确保用户关联了钉钉账号：

验证效果

配置完成后，用户可以在企业微信工作台打开自建应用，系统将自动完成认证并直接打开宜搭应用，无需再次登录：

常见问题

Q：单点登录失败，常见原因有哪些？

Q：配置注意事项有哪些？

附录

参数对照表

专属集成平台	宜搭平台	说明
Client ID	Client ID	应用唯一标识
Client Secret	Client Secret	应用密钥
/iam/authorize	Authorize URL	授权端点
/iam/token	Token URL	令牌端点
RedirectURIs	Redirect URL	回调地址

术语解释

OIDC：OpenID Connect，基于OAuth 2.0的身份认证协议

jwks_uri：JSON Web Key Set的URI，用于获取验证Token签名的公钥

sub：Subject的缩写，表示用户的唯一标识

tcode：租户代码，用于识别特定的租户实例

概述#

配置流程#

专属集成平台配置#

创建应用#

登录配置#

单点协议选择#

端点信息配置#

ID Token 签名设置#

授权范围#

宜搭平台配置#

单点登录设置#

获取Public Key#

企业微信单点登录宜搭#

企业微信自建应用配置#

应用首页设置#

专属集成平台应用首页配置#

用户关联配置#

专属集成平台用户关联企业微信#

专属集成平台用户关联钉钉#

验证效果#

常见问题#

附录#

参数对照表#

术语解释#

概述

配置流程

专属集成平台配置

创建应用

登录配置

单点协议选择

端点信息配置

ID Token 签名设置

授权范围

宜搭平台配置

单点登录设置

获取Public Key

企业微信单点登录宜搭

企业微信自建应用配置

应用首页设置

专属集成平台应用首页配置

用户关联配置

专属集成平台用户关联企业微信

专属集成平台用户关联钉钉

验证效果

常见问题

附录

参数对照表

术语解释