中国 帮助

客户端管理功能

版本 5.X 客户端字段说明 ![输入图片说明](https://foruda.gitee.com/images/1690961819029076660/c44374ac_4959041.png "屏幕截图") 字段

客户端管理功能
封面

> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/basic/client.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-e60f42183931-cover.svg)

  • - -

版本

  • 5.X

客户端字段说明

![输入图片说明](https://foruda.gitee.com/images/1690961819029076660/c44374ac_4959041.png "屏幕截图")

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

使用新的客户端 ID

步骤:

1. 在客户端管理页面生成新的客户端 ID 2. 将 ID 写入前端配置文件

通常对应前端环境变量 VITE_APP_CLIENT_ID,本地开发一般修改 .env.development,生产环境按实际部署环境修改对应 .env 文件。

![输入图片说明](https://foruda.gitee.com/images/1690962894318847386/133d2f90_4959041.png "屏幕截图")

新增自定义客户端

### 1. 新增客户端数据

示例:新增小程序端。

![输入图片说明](https://foruda.gitee.com/images/1690965463070099188/baeb4441_4959041.png "屏幕截图")

![输入图片说明](https://foruda.gitee.com/images/1690965508836621042/df06248f_4959041.png "屏幕截图")

### 2. 配置前端请求头

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

![输入图片说明](https://foruda.gitee.com/images/1690965768235114596/980b88d2_4959041.png "屏幕截图")

VITE_APP_CLIENT_ID 为配置文件中的客户端 ID。

注意:不同客户端登录后获取的 token 互不通用。

  • plus-ui 的普通接口请求、SSE、WebSocket 等能力都会读取这个客户端 ID
  • 如果你只改了某个单独页面而没有统一修改环境变量,联调时很容易出现“客户端ID与Token不匹配”

新增自定义登录方式

说明:不要新增独立登录接口,系统统一使用同一登录接口,通过策略扩展鉴权方式。

调试步骤参考:[关于登录调试步骤](/docs/wujies/5.x/questions/login_step/)

### 1. 新增字典数据

![输入图片说明](https://foruda.gitee.com/images/1690968849418013624/3b28417e_4959041.png "屏幕截图")

![输入图片说明](https://foruda.gitee.com/images/1690968865819397010/64529fad_4959041.png "屏幕截图")

### 2. 新增/修改客户端数据

### 3. 后端新增认证策略

实现 IAuthStrategy 接口:<br />

![输入图片说明](https://foruda.gitee.com/images/1690972828588111954/7614a4c5_4959041.png "屏幕截图")

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

![输入图片说明](https://foruda.gitee.com/images/1718951146945578143/789c80e4_1766278.png "屏幕截图")

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

![输入图片说明](https://foruda.gitee.com/images/1718951179571300385/8db730b9_1766278.png "屏幕截图")

LoginBody 校验参数(可自定义):<br />

![输入图片说明](https://foruda.gitee.com/images/1718951237123374392/f7840db2_1766278.png "屏幕截图")

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

![输入图片说明](https://foruda.gitee.com/images/1718951283931895761/e6348be5_1766278.png "屏幕截图")

校验分组(可自定义):<br />

![输入图片说明](https://foruda.gitee.com/images/1718951343601334215/8ef404b4_1766278.png "屏幕截图")

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-e60f42183931-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容