> 本文整理自平台文档 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
客户端字段说明

| 字段名称 | 取值说明 | 注意事项 |
|---|---|---|
| 客户端id | 后端生成,用于登录校验与接口数据加密 | 无法修改,不要删除默认数据 |
| 客户端key | 前端自定义 | 无法修改,不要删除默认数据 |
| 客户端秘钥 | 前端自定义 | 无法修改,不要删除默认数据 |
| 授权类型 | 密码/短信/邮件/小程序/第三方认证 | 决定该客户端支持的登录方式 |
| 设备类型 | PC 端 / APP 端 | - |
| Token 活跃超时 | 秒 | 无操作即过期,默认 1800 秒 |
| Token 固定超时 | 秒 | 固定过期时间,默认 604800 秒 |
使用新的客户端 ID
步骤:
1. 在客户端管理页面生成新的客户端 ID 2. 将 ID 写入前端配置文件
通常对应前端环境变量 VITE_APP_CLIENT_ID,本地开发一般修改 .env.development,生产环境按实际部署环境修改对应 .env 文件。

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


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

VITE_APP_CLIENT_ID 为配置文件中的客户端 ID。
注意:不同客户端登录后获取的 token 互不通用。
plus-ui的普通接口请求、SSE、WebSocket 等能力都会读取这个客户端 ID- 如果你只改了某个单独页面而没有统一修改环境变量,联调时很容易出现“客户端ID与Token不匹配”
新增自定义登录方式
说明:不要新增独立登录接口,系统统一使用同一登录接口,通过策略扩展鉴权方式。
调试步骤参考:[关于登录调试步骤](/docs/wujies/5.x/questions/login_step/)
### 1. 新增字典数据


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

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

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

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

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

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

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


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