feat(client): 新增家属端 Web 远程协助一次性票据

浏览器无法携带 WebSocket 鉴权头,签发绑定目标 SN、30 秒有效的一次性票据,
供家属 Web 端建立信令连接;签发时校验家属与设备绑定关系,老人端仍需逐次确认。
This commit is contained in:
tongtong committed 2026-11-13 17:56:25 +08:00
1 parent 755df133c3
commit b6495bc0ac
2 files changed
+128

No files matched your search

@@ -0,0 +1,61 @@
package com.youlai.boot.client.controller;
import com.youlai.boot.client.service.ClientUserService;
import com.youlai.boot.common.result.Result;
import com.youlai.boot.device.model.entity.SnDeviceInfo;
import com.youlai.boot.device.service.DeviceService;
import com.youlai.boot.framework.security.token.TokenManager;
import com.youlai.boot.framework.security.util.SecurityUtils;
import com.youlai.boot.framework.web.ratelimit.RateLimit;
import lombok.RequiredArgsConstructor;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.time.Duration;
import java.util.Map;
import java.util.UUID;
/** Browser signaling tickets retain family authorization and device confirmation. */
@RestController
@Tag(name = "家属端远程协助")
@RequestMapping("/api/v1/client/remote-control")
@RequiredArgsConstructor
public class ClientRemoteControlController {
private final DeviceService devices;
private final ClientUserService users;
private final TokenManager tokens;
private final StringRedisTemplate redis;
@PostMapping("/ticket")
@Operation(summary = "签发家属 Web 一次性信令票据")
@RateLimit(limit = 10, window = 60)
public Result<Map<String, String>> ticket(@RequestParam String sn,
@RequestHeader("Authorization") String authorization) {
var principal = SecurityUtils.getUser().orElse(null);
if (principal == null || principal.getUserId() == null || !"client".equals(principal.getClientType())
|| !authorization.startsWith("Bearer ") || sn.isBlank() || sn.length() > 128
|| sn.contains("\n") || sn.contains("\r")) {
return Result.failed("远程协助请求无效");
}
String token = authorization.substring(7);
if (!tokens.validateToken(token) || tokens.validateRefreshToken(token)) {
return Result.failed("需要有效的家属访问令牌");
}
var user = users.getById(principal.getUserId());
SnDeviceInfo device = devices.lambdaQuery().eq(SnDeviceInfo::getSerialno, sn).one();
if (user == null || !Integer.valueOf(1).equals(user.getStatus()) || user.getMobile() == null
|| user.getMobile().isBlank() || device == null || Integer.valueOf(0).equals(device.getStatus())
|| !user.getMobile().equals(device.getSnMobile())) {
return Result.failed("无权协助该设备");
}
String ticket = UUID.randomUUID().toString();
redis.opsForValue().set("webrtc:family-ticket:" + ticket, sn + "\n" + token, Duration.ofSeconds(30));
return Result.success(Map.of("ticket", ticket));
}
}