Appearance
企微部署
一、配置项清单
1.1 pc 端配置修改(/jpwise-web/public/config.js)
javascript
qyhCorpId: "ww2f153ef83032fc2d" // 企业微信企业ID（必须修改）
qyhAgentId: "1000065" // 企业微信应用AgentId（必须修改）
qyhOauthUrl: "https://open.weixin.qq.com/connect/oauth2/authorize" // OAuth授权地址
ssoLoginUrlMobileRoot: "http://sh.goodwaysoft.com:8091",// 移动端地址（必须修改）
ssoLoginUrlMobileHome: "/pages/index/apply", // 移动端主页地址
ssoLoginUrlMobileTask: "/pages/workFlow/flowBefore/index",// 移动端待办地址
ssoLoginUrlPC: "http://sh.goodwaysoft.com:8090/sso-login",// pc端单点登录地址（必须修改）
ssoLoginUrlPCTask: "/dynamicPage", // pc端待办任务地址1.2 app 配置修改(/jpwise-app/utils/define.js)
javascript
qyhCorpId: "ww2f153ef83032fc2d" // 企业微信企业ID（必须修改）
qyhAgentId: "1000065" // 企业微信应用AgentId（必须修改）
qyhOauthUrl: "https://open.weixin.qq.com/connect/oauth2/authorize" // OAuth授权地址
ssoLoginUrlPCRoot: "http://sh.goodwaysoft.com:8090", // pc端单点登录地址（必须修改）
ssoLoginUrlPCHome: "/home", // pc端主页
ssoLoginUrlPCTask: "/dynamicPage", // pc端待办任务地址
ssoLoginUrlMobile: "http://sh.goodwaysoft.com:8091/sso-login", // app端单点登录地址（必须修改）
ssoLoginUrlMobileHome: "/pages/index/apply", // app端主页地址
ssoLoginUrlMobileTask: "/pages/workFlow/flowBefore/index", // app端待办任务地址1.3 平台配置
json
- 企业号id-企业微信企业ID（必须修改）
- 应用凭证-企业微信应用AgentId（必须修改）
- 应用密钥-企业微信应用密钥，参照配置获取方法（必须修改）
json
- pc端单点地址（必须修改）
- 移动端主页（必须修改）
不需要同步发送企业微信消息则不需要
json
- 推送消息的app（必须修改）
- 微信token（必须修改）参照下方的消息配置
- 微信AesKey（必须修改）参照下方的消息配置二、配置项获取方法
1. 获取企业 ID（CorpId）
获取步骤：
登录企业微信管理后台
- 访问：https://work.weixin.qq.com/
- 使用管理员账号登录
查看企业信息
- 点击【我的企业】
- 在企业信息页面底部找到"企业 ID"
- 复制形如
ww2f153ef83032fc2d的字符串
示例截图位置：
企业微信管理后台 > 我的企业 > 企业信息 > 企业ID2. 获取应用 AgentId
获取步骤：
进入应用管理
- 登录企业微信管理后台
- 点击【应用管理】
- 选择【自建】标签
创建或选择应用
- 如果没有应用，点击【创建应用】
- 填写应用名称、Logo、应用介绍
- 设置可见范围（选择部门或成员）
获取 AgentId
- 进入应用详情页
- 在基础信息中找到 "AgentId"
- 复制数字 ID，如
1000065
创建应用时的关键配置：
yaml
应用名称: JPwise系统
应用Logo: 上传企业Logo
可见范围: 根据需要选择部门或全员
应用主页: http://sh.goodwaysoft.com:8091/sso-login?device=workweixin（替换为实际的app地址）3. OAuth 授权地址说明
固定地址：
https://open.weixin.qq.com/connect/oauth2/authorize这是企业微信官方提供的 OAuth2.0 授权接口地址，所有企业都使用相同的地址。
三、企业微信后台配置
1. 配置可信域名
设置位置： 应用详情 > 开发者接口 > 网页授权及 JS-SDK
配置内容：
可信域名: sh.goodwaysoft.com:8091（替换为app的实际地址）
备注: 需要将域名验证文件放置在域名根目录2. 配置应用回调域名
设置位置： 应用详情 > 开发者接口 > 企业微信授权登录
配置内容：
授权回调域: sh.goodwaysoft.com:8091（替换为app的实际地址）
备注: 必须与实际回调地址一致3. 获取应用 Secret（后端使用）
获取步骤：
- 进入应用详情页
- 点击【查看 Secret】
- 通过企业微信扫码验证
- 复制 Secret 密钥
注意： Secret 仅在后端使用，前端配置文件不包含此项
2. 消息推送配置
应用消息推送需要配置：
接收消息服务器配置
- URL:
http://sh.goodwaysoft.com:8089/api/system/OutApp/callBackAsync(替换为实际的 web 接口地址) - Token: 自定义，与后端保持一致
- EncodingAESKey: 随机生成，用于消息加解密
- URL:
消息类型配置
- 文本消息
- 图文消息
- 卡片消息
3. 通讯录同步
权限配置：
- 通讯录同步权限
- 成员信息读取权限
- 部门信息读取权限
2. 测试登录流程
- 访问系统登录页
- 点击"企业微信登录"
- 扫码或在企业微信中打开
- 确认授权
- 自动登录系统
六、常见问题
Q1: 提示"企业应用未授权"
解决方案：
- 检查 AgentId 是否正确
- 确认应用可见范围包含当前用户
- 验证回调域名是否配置
Q2: 无法获取用户信息
解决方案：
- 确认 scope 参数设置正确
- 检查 Secret 是否正确（后端）
- 验证 access_token 是否过期
Q3: 回调地址错误
解决方案：
- 检查可信域名配置
- 确认 redirect_uri 编码正确
- 验证域名是否备案