认证源-企业微信
概述
前提条件
| 序号 | 条件 | 说明 |
|---|---|---|
| 1 | 平台管理员权限 | 拥有专属集成平台的管理员账号 |
| 2 | 企业微信管理员账号 | 拥有企业微信管理后台的管理权限 |
| 3 | CorpID | 企业微信的企业唯一标识，在企业微信管理后台 我的企业 → 企业信息 中获取 |
| 4 | AgentID | 自建应用的 AgentID，在企业微信管理后台 应用管理 → 自建应用 中获取 |
| 5 | Secret | 自建应用的 Secret，在企业微信管理后台 应用管理 → 自建应用 中获取 |
| 6 | 回调地址 | 专属集成平台的回调地址，需在企业微信可信域名中配置 |
注意：创建企业微信自建应用的详细步骤请参考 企业微信开放平台创建应用。自建应用需设置 可见范围，确保目标用户在该范围内。
操作步骤
添加企业微信认证源
添加认证源
1.
2.
3.
4.
配置基本信息
在认证源配置表单中填写以下参数：
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 认证源名称 | 是 | 在登录页显示的认证源名称 | 企业微信登录 |
| 企业选择 | 是 | 选择已授权的企业微信企业，或点击 新建企业 填写企业信息 | — |
| CorpID | 是 | 企业微信的企业唯一标识 | ww1234567890abcdef |
| AgentID | 是 | 企业微信自建应用的 AgentID | 1000001 |
| Secret | 是 | 企业微信自建应用的 Secret，用于 API 鉴权 | ******** |
| 认证源图标 | 否 | 上传图标文件，支持 PNG/JPG，建议 64×64px | — |
重要：CorpID、AgentID 和 Secret 需在企业微信管理后台（ https://work.weixin.qq.com）获取。CorpID 位于 我的企业 → 企业信息，AgentID 和 Secret 位于 应用管理 → 自建应用 → 应用详情。请妥善保管 Secret，不要泄露给未授权人员。
配置回调地址
1.
{平台域名}/api/auth/callback/wecom）。2.
3.
4.
5.
警告：企业微信要求可信域名必须已通过 ICP 备案，且需在企业微信管理后台完成域名归属验证。域名验证不通过将导致授权失败。
配置属性映射
将企业微信返回的用户属性映射到平台用户模型：
| 企业微信属性 | 平台字段 | 映射方式 | 说明 |
|---|---|---|---|
UserID | username | 创建且更新 | 企业微信用户唯一标识，建议设置唯一字段匹配 |
name | display_name | 创建且更新 | 用户姓名 |
mobile | phone_number | 创建且更新 | 用户手机号 |
email | email | 创建且更新 | 用户邮箱（需自建应用拥有获取邮箱权限） |
department | department | 创建且更新 | 用户所属部门路径 |
重要：至少需要配置一个唯一字段匹配规则（UserID → username），这是系统识别已有用户的依据。
提示：如需获取
配置 JIT
JIT（Just-In-Time）指用户首次通过企业微信认证源登录时，平台自动创建用户账号的功能。
| 参数 | 说明 |
|---|---|
| 启用 JIT | 开启后，首次通过企业微信认证的用户将自动在平台创建账号。若关闭，不在平台中的用户将认证不通过 |
| 更新策略 | 关闭：用户首次创建后，后续登录不更新任何属性；开启：每次登录时根据映射规则更新用户属性 |
| 指定部门 | 通过 JIT 创建的 用户自动归属的部门。不指定则创建在默认部门中 |
重要：建议开启 JIT。企业微信企业中的用户数量通常较多，手动在平台逐一创建账号效率低下。通过 JIT 可实现企业微信用户"即登即用"。
安全提示：建议为不同认证源用户创建专门的默认部门，并遵循最小权限原则，确保自动创建的用户不会获得过高权限。
完成配置
1.
2.
3.
4.
验证与测试
| 测试项 | 验证方法 | 预期结果 |
|---|---|---|
| 认证源连通性 | 在认证源列表中点击 测试连接 | 提示连接成功 |
| 登录跳转 | 打开登录页，点击企业微信认证源图标 | 正确跳转至企业微信授权页面 |
| 用户授权 | 在企业微信页面完成授权 | 成功跳回平台并完成登录 |
| 属性同步 | 登录后查看用户中心个人信息 | 用户名、显示名称与企业微信一致 |
| JIT 创建 | 使用企业微信中未预先创建的新用户登录 | 平台自动创建该用户账号 |
| 拒绝授权 | 在企业微信页面拒绝授权 | 平台显示相应提示，不创建用户 |
常见问题
修改于 2026-05-06 10:49:05