学员端菜单和登录怎么配？显隐与接入
学员菜单与连接设置
没用到的模块建议在学员菜单里直接隐藏，比留着显示、点进去却是空的体验好得多；隐藏只影响学员端，不影响管理端配置。连接设置对接钉钉、企业微信、飞书等平台后，学员可从第三方免登进入，部门结构也能自动同步，省掉手工维护组织架构的工作。两项能力可分别开关，只要免登也能单独开。
学员端菜单显隐与钉钉企业微信对接怎么配置？
学员菜单配置控制学员端各菜单入口的隐藏与显示，覆盖培训计划、课程学习、在线考试、刷题训练、活动大厅（活动报名、知识竞赛、问卷调查）与积分商城；连接设置用于配置第三方平台对接参数，支持钉钉、企业微信、飞书、微信小程序、微信网页端、微信公众号六大服务商，可分别控制同步登录、部门同步两项能力，实现第三方免登与组织架构数据互通。前者管「学员看到什么」，后者管「用户从哪里来」。
| 项目 | 说明 |
|---|---|
| 使用角色 | 管理员（超管）；连接设置密钥需操作密码解锁查看 |
| 入口 | 【系统设置】 → 【系统配置】 → 【学员菜单配置】 / 【连接设置】页签 |
| 前置条件 | 连接设置需已在第三方平台创建应用并获取 CorpId、AgentId、CorpSecret 等参数 |
| 支持 | 六类学员菜单显隐控制；六大服务商对接参数维护；同步登录与部门同步开关（部门同步仅钉钉、企业微信、飞书支持） |
| 不支持 | 学员菜单开关仅隐藏主菜单入口，不阻断 URL 直接访问；微信类渠道无组织架构能力，不支持部门同步 |
学员菜单配置
切换到【学员菜单配置】页签，可控制学员端各菜单入口的隐藏、显示，包含：培训计划、课程学习、在线考试、刷题训练、活动大厅（活动报名、知识竞赛、问卷调查三个子项）、积分商城。重要提示：开关仅隐藏主菜单入口，但不影响功能使用，学员仍可通过直接访问 URL 使用对应功能。调整完所有菜单的显示状态后，点击【保存配置】完成生效。
连接设置
连接设置页签维护第三方服务商对接记录，列表展示服务商、同步登录开关、部门同步开关与备注信息，支持添加、修改、删除。六大服务商：钉钉、企业微信、飞书、微信小程序、微信网页端、微信公众号。
新增 / 编辑服务商弹窗字段
| 字段 | 说明 |
|---|---|
| 服务商（必选） | 单选对接平台，同一平台仅建议配置一条记录 |
| 应用场景 | 同步登录：启用第三方账号免登；部门同步：启用组织架构同步（仅钉钉、企业微信、飞书支持） |
| AppKey / CorpId（必填） | 第三方平台企业或应用唯一标识，从对应平台后台获取 |
| AppSecret / CorpSecret（必填） | 应用密钥，用于接口鉴权，妥善保管不可泄露 |
| 回调地址（必填） | 系统对接回调接口地址，复制填写至第三方应用后台的授权回调域名配置项，免登流程依赖该地址完成跳转 |
| AgentId | 第三方自建应用 ID，企业微信、钉钉、飞书企业应用专用，微信渠道无需填写 |
| 备注信息 | 填写配置用途、环境说明（演示环境/生产环境）、对接注意事项 |
功能使用规则
- 同步登录：开启对应服务商的同步登录开关后，用户可通过第三方应用入口直接跳转登录本系统，无需重复输入账号密码；覆盖钉钉、企业微信、飞书、微信小程序、微信网页端、微信公众号全部六类渠道；
- 部门同步：仅钉钉、企业微信、飞书支持；开启后可一键同步第三方平台完整组织架构与部门层级，统一管理用户组织数据。
操作步骤
- 进入【学员菜单配置】，按单位业务范围关闭不需要的菜单入口，点击【保存配置】；
- 解锁敏感配置进入【连接设置】，点击【添加】；
- 选择服务商类型，按第三方平台后台的应用信息填写 AppKey/CorpId、AppSecret/CorpSecret、AgentId 与回调地址；
- 把回调地址复制到第三方应用后台的授权回调域名配置，勾选应用场景后保存；
- 打开对应服务商的同步登录开关（需要组织同步的再开启部门同步），用第三方 App 实测一次免登与部门拉取。
注意事项
- 菜单隐藏不是权限隔离：被隐藏的菜单仍可通过 URL 访问，需要彻底限制功能时请配合权限配置模块；
- 回调地址必须一致：第三方平台后台填写的回调域名要与系统弹窗中的回调地址完全一致，否则免登跳转失败；
- 密钥敏感：所有对接密钥、企业 ID 属于敏感信息，管理员解锁可见，禁止普通运维人员随意查看；
- 环境区分：测试环境与生产环境建议分别配置记录，并在备注中写明环境，避免误用演示密钥；
- 上线前联调：生产环境配置完成后，建议测试登录、部门同步接口，确认数据拉取正常后再对外使用。
常见问题
学员端哪些菜单可以隐藏？
可控制培训计划、课程学习、在线考试、刷题训练、活动大厅（活动报名、知识竞赛、问卷调查三个子项）、积分商城六类菜单的显示与隐藏，按单位实际业务范围裁剪。
菜单开关能彻底禁止学员使用某个功能吗？
不能。开关只隐藏学员端主菜单入口，不阻断功能本身，学员通过直接访问 URL 仍可使用被隐藏的功能。需要彻底限制时，请配合权限配置模块做真正的访问控制，两者结合才稳妥。
改了学员菜单配置后没生效怎么办？
调整完所有菜单的显示状态后需要点击【保存配置】才会生效，只改开关不保存不会生效。保存后请让学员刷新页面或重新登录学员端，确认菜单变化符合预期，再通知全体学员。
连接设置支持对接哪些第三方平台？
支持钉钉、企业微信、飞书、微信小程序、微信网页端、微信公众号六大服务商，可分别配置同步登录与部门同步能力，实现第三方免登与组织架构数据互通，同一平台建议只配一条。
同步登录和部门同步分别是什么作用？
同步登录让用户从第三方应用入口直接跳转登录本系统，无需重复输入账号密码；部门同步用于一键拉取第三方组织架构。前者六类渠道都支持，后者仅钉钉、企业微信、飞书支持。
配置钉钉对接需要准备哪些参数？
需准备 AppKey 或 CorpId、AppSecret 或 CorpSecret、AgentId 与回调地址。前两项为必填的企业与应用标识及密钥，回调地址需复制到钉钉开放平台应用后台的授权回调域名配置。
回调地址填什么？还要去第三方平台配置吗？
要。回调地址是系统对接的回调接口地址，需原样复制到第三方应用后台的授权回调域名配置项，两边必须完全一致且域名可被公网访问，否则免登跳转会失败。
AgentId 是每个平台都要填吗？
不是。AgentId 为第三方自建应用 ID，仅企业微信、钉钉、飞书的企业应用需要填写；微信小程序、微信网页端、微信公众号这三类微信渠道无需填写。
第三方扫码后提示回调错误，先核对什么？
核对两处回调配置是否完全一致：系统【连接设置】弹窗里的回调地址，与第三方开放平台应用后台填写的授权回调域名。两者不一致或域名不可公网访问都会报错。
为什么微信渠道没有部门同步开关？
部门同步需要组织架构能力，仅钉钉、企业微信、飞书提供；微信小程序、微信网页端、微信公众号没有组织架构数据，因此只支持同步登录，不显示部门同步效果。
连接设置配好了，但部门没同步过来，先查什么？
先看该服务商是否勾选了部门同步应用场景并保存，再确认 AppKey 与密钥正确、应用已授权该接口权限。可在【部门管理】点【手动同步】立即拉取一次验证。
同一平台可以配多条记录吗？
不建议。同一平台配多条容易造成免登与同步行为混乱，排查问题时也难以定位。测试与生产环境可用备注信息区分，或只保留当前环境的有效配置，避免误用演示环境的密钥。
测试环境和生产环境怎么区分管理？
建议分别建立配置记录，并在备注信息中写明用途与环境（演示环境或生产环境）、对接注意事项。上线前确认使用的是生产环境的密钥，避免两边串用导致登录异常。
连接设置里的密钥谁能查看？
AppSecret、CorpSecret 等密钥属敏感信息，需操作密码解锁后可见，仅限授权管理员查看，禁止普通运维人员随意获取。人员变动时建议在第三方平台重置密钥。