# 企业微信(第三方应用)网页授权登录

此登录方式适用于在微信浏览器企业微信浏览器内使用,不适用于普通浏览器网页登录。

# 准备工作

你一共需要准备以下内容:

  1. 注册 Authing 开发者账号
  2. 申请一个企业微信服务商账号 (opens new window)
  3. 申请并配置一个企业微信网页应用 (opens new window)
  4. 在 Authing 控制台填入企业微信网页信息

请确保你的应用勾选了获取「头像」、「二维码」。

# 在 Authing 控制台找到「企业微信网页授权登录」

按照下图的指引找到「企业微信网页授权登录」配置。

企业微信网页授权登录

之后你需要将相关配置填入下面的表单:

企业微信网页授权相关配置

# 获取企业微信应用配置

你需要提供应用的 SuiteID、应用的 Secret 和微信企业的 CorpID:

获取 SuiteID 和 Secret :在 应用管理 - 网页应用 - 应用详情 (opens new window) 处可以获取到。

获取 CorpID :在 服务商信息 - 基本信息 (opens new window) 处可以获取到

之后请将这三个数据填入上文提到的表单。

# 添加 IP 白名单

请将下面这几个 IP 添加到白名单:

52.80.250.250 , 140.179.19.50

你可在 服务商信息 - 基本信息 (opens new window) 页面进行配置。

# 配置可信域名

core.authing.cn 设置为可信域名。

点击「检验可信域名归属」,在弹出的 Modal 中,你需要下载一个 Txt 文件:

并将 Txt 文件名Txt 文件内容填入上文显示的表单。

  • Txt Filename 一般为 WW_verify_ 开头,请注意保留 .txt 文件后缀
  • Txt Content: 文件内容,一般为 10-20 位随机字符串。

点击「确定」按钮:

你应该可以看到可信域名验证成功了:

如果你遇到任何问题,可以在这里联系到我们:https://gitter.im/authing-chat/community (opens new window)

# 配置企业微信回调链接

一共配置两个回调链接:

  • 数据回调 URL。链接格式为:
https://core.authing.cn/oauth/wechatwork/:userPoolId/redirect/data

假设你的用户池 ID 为 5e4cdd055df3df65dc58b97d,则数据回调链接为:

https://core.authing.cn/oauth/wechatwork/5e4cdd055df3df65dc58b97d/redirect/data
  • 指令回调 URL。链接格式为:
https://core.authing.cn/oauth/wechatwork/:userPoolId/redirect/command

假设你的用户池 ID 为 5e4cdd055df3df65dc58b97d,则指令回调链接为:

https://core.authing.cn/oauth/wechatwork/5e4cdd055df3df65dc58b97d/redirect/command

请将 Token 和 EncodingAESKey 填入上文提到的表单,之后点击申请检验:

你应该能够获取到成功提示。

# 配置业务回调链接 Redirect URL

业务回调链接和企业微信内配置的回调链接不一样,这是 Authing 将用户信息回调给你的回调链接。

如果你使用 Guard,可以留空填 「#」。

如果你需要手动接入企业微信扫码登录,需要填写你的业务回调链接,用户授权之后,Authing 将会把用户信息回调给你。

# 接下来

配置完成之后,接下来你可以开始正式将社会化登录集成到你的系统了,Authing 社会化登录共支持四种接入方式:使用 JavaScrit SDK、使用 Guard for Web 登录表单组件、 使用 Authing 在线登录页面 和 手动调用社会化登录接口,关于每种方式的适用场景和优劣势对比,请见:社会化登录接入指南