Skip to content

客户端管理功能 ​


版本 ​

  • 2.X

客户端字段说明 ​

输入图片说明

字段名称取值说明注意事项
客户端id后端生成,用于登录校验与接口数据加密无法修改,不要删除默认数据
客户端key前端自定义无法修改,不要删除默认数据
客户端秘钥前端自定义无法修改,不要删除默认数据
授权类型密码/短信/邮件/小程序/第三方认证决定该客户端支持的登录方式
设备类型PC 端 / APP 端-
Token 活跃超时秒无操作即过期,默认 1800 秒
Token 固定超时秒固定过期时间,默认 604800 秒

使用新的客户端 ID ​

步骤:

  1. 在客户端管理页面生成新的客户端 ID
  2. 将 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)。

输入图片说明

校验分组(可自定义):

输入图片说明

砚考 · 让每一次考试都经得起检验