客户端管理功能
版本
- 2.X
客户端字段说明

| 字段名称 | 取值说明 | 注意事项 |
|---|---|---|
| 客户端id | 后端生成,用于登录校验与接口数据加密 | 无法修改,不要删除默认数据 |
| 客户端key | 前端自定义 | 无法修改,不要删除默认数据 |
| 客户端秘钥 | 前端自定义 | 无法修改,不要删除默认数据 |
| 授权类型 | 密码/短信/邮件/小程序/第三方认证 | 决定该客户端支持的登录方式 |
| 设备类型 | PC 端 / APP 端 | - |
| Token 活跃超时 | 秒 | 无操作即过期,默认 1800 秒 |
| Token 固定超时 | 秒 | 固定过期时间,默认 604800 秒 |
使用新的客户端 ID
步骤:
- 在客户端管理页面生成新的客户端 ID
- 将 ID 写入前端配置文件
通常对应前端环境变量 VITE_APP_CLIENT_ID,如果使用默认 exam-front,优先从环境配置文件统一修改,不要散落在业务代码里硬编码。

新增自定义客户端
1. 新增客户端数据
示例:新增小程序端。


2. 配置前端请求头
需要在全局请求头中增加 clientid。
可参考前端 request.ts:

VITE_APP_CLIENT_ID 为配置文件中的客户端 ID。
注意:不同客户端登录后获取的 token 互不通用。
补充说明:
- Cloud 登录入口在认证中心,但客户端 ID 的使用方式与 Vue 版本一致
exam-front的请求头、SSE、WebSocket 等都会带上这个clientid- 如果更换了客户端 ID,前端环境变量和认证中心客户端配置要一起调整
新增自定义登录方式
说明:不要新增独立登录接口,系统统一使用同一登录接口,通过策略扩展鉴权方式。
调试步骤参考:关于登录调试步骤
1. 新增字典数据


2. 新增/修改客户端数据
3. 后端新增认证策略
实现 IAuthStrategy 接口:

参照已有策略实现自定义参数校验与登录逻辑。

注意修改 @Service 名称保证规范性。

LoginBody 校验参数(可自定义):

示例:扩展小程序登录参数(继承 LoginBody)。

校验分组(可自定义):
