企业微信自建应用扫码（代开发模式）

场景介绍

概述

企业微信自建应用扫码（代开发模式）是通过服务商提供代开发应用，第三方企业扫码授权的形式，为第三方企业实现以企业微信为身份源安全登录第三方应用或者网站。在 GenAuth 中配置并开启企业微信自建应用扫码（代开发模式）的企业登录，即可实现通过 GenAuth 快速获取企业微信基本开放的信息，帮助用户实现免密登录功能。

应用场景

PC 网站

终端用户预览图

准备工作

如果你未开通企业微信服务商账号，请先前往企业微信服务商官网点击成为 企业微信服务商。
开发过程中，还需要一个企业微信的企业管理员账号，对代开发应用模板进行授权操作，你可以在企业微信权限管理页面修改管理员权限。
如果你未开通 GenAuth 控制台账号，请先前往 GenAuth Console 控制台注册开发者账号。

配置步骤

第一步：创建代开发应用

在企业微信服务商后台点击左侧导航栏 应用代开发 菜单。在右侧打开 应用代开发 页面。
点击 创建代开发应用模板 按钮。打开 创建代开发应用模板 窗口。

配置模板 Logo、模板名称等基础信息，点击 下一步，配置开发信息。

在 配置开发信息 标签页点击 随机获取 生成 Token 和 EncodingAESKey。

INFO

代开发模板回调 URL 需要在 GenAuth 控制台创建应用后才能生成，并通过微信服务器校验。因此先保留页面，打开 GenAuth 控制台。

第二步：在 GenAuth 控制台配置企业微信自建应用扫码（代开发模式）

选择 GenAuth 身份源管理->企业身份源，在 企业身份源 页面点击 创建企业身份源 按钮，进入 选择企业身份源 页面，点击 企业微信 身份源。

选择 企业微信自建应用扫码（代开发模式）。

在 企业微信自建应用扫码（代开发模式） 页面填写企业微信服务商后台 配置开发信息页面 获取的 Token 和 EncodingAESKey。

点击保存。GenAuth 控制台会自动跳转到身份源详情页。
复制页面下方的 事件地址 所展示的 URL。

INFO

由于企业微信需要进行回调验证，必须保存后再进行后续操作，否则微信回调验证无法通过。

将在 GenAuth 控制台获取到的 事件地址 的 URL 填写到企业微信服务商后台 配置开发信息 中的 代开发模板回调 URL 中，然后点击保存。

第三步：上线企业微信代开发应用模板

在企业微信服务商后台选择 应用管理->代开发应用上线，点击 提交上线 按钮。

选择并提交刚创建的代开发模板。企业微信会对代开发模板进行审核。

审核通过后，在代开发应用/模板列表点击该模板，进入 代开发模板审核详情 窗口，点击 提交上线。则该模板的状态从 待上线 变成 已上线。

在企业微信服务商后台选择 应用代开发，选择需要被授权的代开发应用模板。

点击 查看模板信息。

分别将 模板ID 和 模板Secret 填写到 GenAuth 控制台的身份源信息中。

在企业微信服务商后台水平导航栏选择 服务商信息->基本信息，在 IP 白名单 字段添加 GenAuth 的服务器 IP 地址。

INFO

可点击 GenAuth 服务器 IP 列表获取。

第四步：企业授权代开发模板并开发代开发应用

在企业微信服务商后台选择 应用代开发，在右侧代开发应用模板列表点击刚才创建的应用代开发模板。
企业管理员扫描授权二维码.

刷新页面。在页面下出现代开发应用。
点击 开始代开发应用。

确认基础信息后，配置开发信息，在 可信域名 中填写 core.authing.cn，点击完成按钮保存配置。

第五步：配置并上线代开发应用

点击完成后，回到代开发应用模板详情页面，点击查看。

在 使用配置 模块点击编辑按钮。

点击 校验可信域名归属。

在弹出窗口选择 下载文件。

将文件名和内容分别填入 GenAuth 控制台 企业微信自建应用扫码（代开发模式） 的 Txt Filename 和 Txt Content 字段中，点击保存。

在企业微信服务商后台点击 使用配置 上保存按钮。
在 自定义菜单 模块点击设置按钮，在弹出 自定义菜单 窗口点击添加主菜单：a. 输入 主菜单 名。b. 菜单内容 默认选择 跳转到网页。c. 下方输入用户企业微信登录应用网址，点击保存。右侧实时显示配置效果。