身份认证与应用安全 / 系统课时

区分不同设备登录状态

区分不同设备登录状态

同一账号往往需要同时在线于浏览器和移动端,但退出、顶人或审计时又必须精确到某一种终端。Sa-Token 可以在登录时记录设备类型,让每个 Token 带上自己的终端身份,再按这个身份分别管理登录状态。

学习目标

  • 为浏览器和移动端定义稳定的设备类型
  • 登录后读取当前 Token 对应的设备类型
  • 验证同一账号的不同设备类型可以独立存在

用固定设备类型建立边界

设备类型本质上是登录时写入会话关系的字符串。业务中不要直接使用 User-Agent 或任意客户端参数作为设备类型,而应先归一化成有限集合,例如 WEB、APP。如果还要保证同一类型只保留一个登录,可以同时关闭并发登录。

yaml
sa-token:
  is-concurrent: false

生效行为:账号可以同时拥有 WEB 与 APP 两类登录,但第二个 WEB 登录会按互斥规则处理第一个 WEB 登录,不会误伤 APP。

在登录时写入设备类型

下面是片段示例:放入已经接入 Sa-Token 的 Spring Boot 项目中。示例用固定账号便于验证;生产环境必须先完成用户名密码、短信码或其他凭据校验,再使用服务端确认的用户 ID 登录。

java
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 查询设备类型。

bash
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"

预期输出:

text
WEB
APP

如果项目修改过 token-name,把请求头 satoken 替换成实际名称。Token 值是动态生成的,因此验证重点不是比较 Token 文本,而是确认两个 Token 分别返回自己的设备类型。

同一账号按 WEB 与 APP 设备类型拆分登录状态

把设备类型用于精确控制

区分设备类型后,退出和会话管理就不必把账号的所有终端一起处理。例如业务可以只让账号的 WEB 端下线,同时保留 APP;也可以在后台审计时先读取 getLoginDevice(),记录本次请求来自哪类终端。

最容易出错的是设备命名不一致。WEB、Web、PC 如果在不同代码路径中混用,就会形成多个逻辑设备类型。实际项目应把设备类型收敛成常量或枚举,并在服务端根据登录入口、客户端渠道或可信请求上下文决定类型,而不是直接接受任意字符串。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分不同设备登录状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通