sa-token/sa-token-doc/doc/up/token-prefix.md

31 lines
909 B
Markdown
Raw Normal View History

2021-07-22 20:36:46 +08:00
# 自定义 Token 前缀
### 需求场景
在某些系统中前端提交token时会在前面加个固定的前缀例如
``` js
{
"satoken": "Bearer xxxx-xxxx-xxxx-xxxx"
}
```
此时后端如果不做任何特殊处理,框架将会把`Bearer `视为token的一部分无法正常读取token信息导致鉴权失败
为此我们需要在yml中添加如下配置
``` java
2021-07-01 15:15:54 +08:00
sa-token:
# token前缀
2021-07-22 20:36:46 +08:00
token-prefix: Bearer
```
2021-07-22 20:36:46 +08:00
此时 Sa-Token 便可在读取 Token 时裁剪掉 `Bearer`,成功获取`xxxx-xxxx-xxxx-xxxx`
### 注意点
2021-07-22 20:36:46 +08:00
1. Token前缀 与 Token值 之间必须有一个空格
2. 一旦配置了 Token前缀则前端提交token时必须带有前缀否则会导致框架无法读取token
3. 由于`Cookie`中无法存储空格字符也就意味配置token前缀后Cookie鉴权方式将会失效此时只能将token提交到`header`里进行传输