身份认证与应用安全 / 系统课时
区分不同设备登录状态
区分不同设备登录状态
同一账号往往需要同时在线于浏览器和移动端,但退出、顶人或审计时又必须精确到某一种终端。Sa-Token 可以在登录时记录设备类型,让每个 Token 带上自己的终端身份,再按这个身份分别管理登录状态。
学习目标
- 为浏览器和移动端定义稳定的设备类型
- 登录后读取当前 Token 对应的设备类型
- 验证同一账号的不同设备类型可以独立存在
用固定设备类型建立边界
设备类型本质上是登录时写入会话关系的字符串。业务中不要直接使用 User-Agent 或任意客户端参数作为设备类型,而应先归一化成有限集合,例如 WEB、APP。如果还要保证同一类型只保留一个登录,可以同时关闭并发登录。
sa-token:
is-concurrent: false生效行为:账号可以同时拥有 WEB 与 APP 两类登录,但第二个 WEB 登录会按互斥规则处理第一个 WEB 登录,不会误伤 APP。
在登录时写入设备类型
下面是片段示例:放入已经接入 Sa-Token 的 Spring Boot 项目中。示例用固定账号便于验证;生产环境必须先完成用户名密码、短信码或其他凭据校验,再使用服务端确认的用户 ID 登录。
package com.example.auth;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/auth")
public class DeviceLoginController {
private static final long DEMO_USER_ID = 10001L;
// 两个入口都由服务端写死设备类型,避免终端自行扩展类型。
@PostMapping("/login/web")
public String loginWeb() {
StpUtil.login(DEMO_USER_ID, "WEB");
return StpUtil.getTokenValue();
}
@PostMapping("/login/app")
public String loginApp() {
StpUtil.login(DEMO_USER_ID, "APP");
return StpUtil.getTokenValue();
}
// 从当前请求携带的 Token 读取登录时记录的设备类型。
@GetMapping("/device")
public String currentDevice() {
StpUtil.checkLogin();
return StpUtil.getLoginDevice();
}
}这段代码依赖已有的 Spring Boot 与 Sa-Token 启动配置,本身不是独立应用。返回 Token 是为了演示终端状态区分;实际项目通常把 Token 放进统一响应结构或由既有登录接口返回。
验证两个设备状态彼此独立
假设服务运行在 http://localhost:<PORT>,且使用默认 Token 名称 satoken,可以分别登录两个端,再带各自 Token 查询设备类型。
WEB_TOKEN=$(curl -s -X POST "http://localhost:<PORT>/auth/login/web")
APP_TOKEN=$(curl -s -X POST "http://localhost:<PORT>/auth/login/app")
curl -s -H "satoken: $WEB_TOKEN" "http://localhost:<PORT>/auth/device"
printf '\n'
curl -s -H "satoken: $APP_TOKEN" "http://localhost:<PORT>/auth/device"预期输出:
WEB
APP如果项目修改过 token-name,把请求头 satoken 替换成实际名称。Token 值是动态生成的,因此验证重点不是比较 Token 文本,而是确认两个 Token 分别返回自己的设备类型。

把设备类型用于精确控制
区分设备类型后,退出和会话管理就不必把账号的所有终端一起处理。例如业务可以只让账号的 WEB 端下线,同时保留 APP;也可以在后台审计时先读取 getLoginDevice(),记录本次请求来自哪类终端。
最容易出错的是设备命名不一致。WEB、Web、PC 如果在不同代码路径中混用,就会形成多个逻辑设备类型。实际项目应把设备类型收敛成常量或枚举,并在服务端根据登录入口、客户端渠道或可信请求上下文决定类型,而不是直接接受任意字符串。