概述

企业微信支持开发者使用以下方式来进行Web登录

• 系统浏览器（桌面端）
  • 使用 @wecom/jssdk 初始化企业微信登录组件
  • 构造登录链接
• 企业微信内置 Webview（桌面端&移动端）
  • OAuth授权登录

1. 使用 @wecom/jssdk 初始化企业微信登录组件

为了满足网站定制化的需求，我们支持将企业微信登录组件内嵌到开发者的网站中。用户使用企业微信登录授权后，登录组件将 auth code 返回给网站。

企业微信登录组件主要用途：网站希望用户在网站内就能完成登录，无需跳转到企业微信域下登录后再返回，提升登录的流畅性与成功率。

开始使用

使用企业微信 JS-SDK：@wecom/jssdk >=1.3.1

API接口

ww.createWWLoginPanel

2. 构造企业微信登录链接

同时支持通过构造链接的方式，在新窗口中打开企业微信登录页面，用户使用企业微信登录授权后通过将携带 auth code 跳转至指定的 redirect_uri 。

链接格式

开发者需要构造如下的链接来获取 code 参数

https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=LOGIN_TYPE&appid=APPID&redirect_uri=REDIRECT_URI&state=STATE

参数说明

redirect_uri域名说明
redirect_uri的域名必须配置为可信域名，不同应用类型的配置方法不同，具体如下

返回说明
用户允许授权后，将会重定向到 redirect_uri 的网址上，并且带上 code 和 state 参数

redirect_uri?code=CODE&state=STATE

示例1：自建应用

企业CorpID：WWCorpId
开启授权登录的应用ID：1000000
登录跳转链接：http://work.weixin.qq.com
state设置为：WWLogin
需要配置应用授权回调域名为：work.weixin.qq.com

根据URL规范，将上述参数分别进行UrlEncode，得到拼接的登录链接为：
https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=CorpApp&appid=WWCorpId&agentid=1000000&redirect_uri=http%3A%2F%2Fwork.weixin.qq.com&state=WWLogin

示例2：代开发应用

企业CorpID：WWCorpId
开启授权登录的应用ID：1000000
登录跳转链接：http://work.weixin.qq.com
state设置为：WWLogin
需要配置应用可信域名为：work.weixin.qq.com

根据URL规范，将上述参数分别进行UrlEncode，得到拼接的登录链接为：
https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=CorpApp&appid=WWCorpId&agentid=1000000&redirect_uri=http%3A%2F%2Fwork.weixin.qq.com&state=WWLogin

示例3：服务商

登录授权SuiteId：SuiteID
登录跳转链接：http://work.weixin.qq.com
state设置为：WWLogin
需要配置登录授权回调域为：work.weixin.qq.com

根据URL规范，将上述参数分别进行UrlEncode，得到拼接的登录链接为：
https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=ServiceApp&appid=WWCorpId&redirect_uri=http%3A%2F%2Fwork.weixin.qq.com&state=WWLogin

登录FAQ

• 1. 企业微信登录面板为什么没显示快速登录？
  企业微信Web登录组件，默认会显示二维码登录，当满足以下条件时，会显示快速登录面板：
  • 用户的企业微信桌面端（Win & Mac）版本大于 3.1.23，运行并登录企业微信
  • 使用 @wecom/jssdk 初始化企业微信登录组件时，开发者网页域名需使用 HTTPS 协议
  • 在自建/代开发应用的登录场景中（login_type=CorpApp），当前企业微信桌面端登录用户，在所登录应用的可见范围内
  • 登录网页在桌面端系统浏览器中打开。如果需要在企业微信内置 Webview 进行登录，请使用OAuth授权登录
    
    
    
• 2. 如何判断用户是否已登录企业微信桌面端？
  登录组件在初始化成功后，开发者可以通过 onCheckWeComLogin 回调中的isWeComLogin参数，判断企业微信的桌面端登录状态。
  建议使用场景：如开发者在知道当前用户已登录企业微信后，直接显示企业微信快速登录面板，用户一键点击快速登录，提升用户体验。
  
  
  
• 3. 扫码提示无权限
  在自建/代开发应用登录场景，若用户不在 Agentid 所指应用的可见范围，扫码时会提示无权限。
  
  
• 4. 登录组件支持自定义样式吗？
  不支持自定义登录组件样式，可通过 panel_size 参数定义登录组件面板大小
  
  
• 5. 提示“页面域名与登录授权域名不一致”
  当指定参数redirect_type=callback时，需检查业务页面域名与redirect_uri域名的一致性

附录

1. 登录相关错误码
登录组件将用户在登录成功前遇到的错误通过 onLoginFail 函数回调，便于开发者排查问题。

2. 企业微信登录组件UI规范
默认情况下，登录组件的宽高为480x416px

可通过panel_size字段指定为更小的面板 320x380px

注：建议使用“旧版扫码登录”的开发者按该文档切换为新的方式，该方式后续将支持更多功能