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));
}
}
@@ -0,0 +1,67 @@
package com.youlai.boot.client.controller;
import com.baomidou.mybatisplus.extension.conditions.query.LambdaQueryChainWrapper;
import com.youlai.boot.client.model.entity.ClientUser;
import com.youlai.boot.client.service.ClientUserService;
import com.youlai.boot.device.model.entity.SnDeviceInfo;
import com.youlai.boot.device.service.DeviceService;
import com.youlai.boot.framework.security.model.SecurityUserDetails;
import com.youlai.boot.framework.security.token.TokenManager;
import org.junit.jupiter.api.Test;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.context.SecurityContextHolder;
import java.time.Duration;
import java.util.List;
import static org.mockito.ArgumentMatchers.*;
import static org.mockito.Mockito.*;
class ClientRemoteControlControllerTest {
@Test
@SuppressWarnings("unchecked")
void ticketsRequireActiveBoundFamilyAndExpireAfterThirtySeconds() {
var devices = mock(DeviceService.class);
var users = mock(ClientUserService.class);
var tokens = mock(TokenManager.class);
var redis = mock(StringRedisTemplate.class, RETURNS_DEEP_STUBS);
var controller = new ClientRemoteControlController(devices, users, tokens, redis);
var principal = new SecurityUserDetails();
principal.setUserId(1L);
principal.setClientType("client");
SecurityContextHolder.getContext().setAuthentication(
new UsernamePasswordAuthenticationToken(principal, null, List.of()));
try {
when(tokens.validateToken("access")).thenReturn(true);
var user = new ClientUser();
user.setStatus(1);
user.setMobile("123");
when(users.getById(1L)).thenReturn(user);
var device = new SnDeviceInfo();
device.setStatus(1);
device.setSnMobile("456");
LambdaQueryChainWrapper<SnDeviceInfo> query = mock(LambdaQueryChainWrapper.class);
when(devices.lambdaQuery()).thenReturn(query);
when(query.eq(any(), eq("SN-1"))).thenReturn(query);
when(query.one()).thenReturn(device);
controller.ticket("SN-1", "Bearer access");
verify(redis, never()).opsForValue();
device.setSnMobile("123");
device.setStatus(0);
controller.ticket("SN-1", "Bearer access");
verify(redis, never()).opsForValue();
device.setStatus(1);
principal.setClientType("admin");
controller.ticket("SN-1", "Bearer access");
verify(redis, never()).opsForValue();
principal.setClientType("client");
controller.ticket("SN-1", "Bearer access");
verify(redis.opsForValue()).set(startsWith("webrtc:family-ticket:"),
eq("SN-1\naccess"), eq(Duration.ofSeconds(30)));
} finally {
SecurityContextHolder.clearContext();
}
}
}