diff --git a/src/main/java/com/youlai/boot/client/controller/ClientRemoteControlController.java b/src/main/java/com/youlai/boot/client/controller/ClientRemoteControlController.java new file mode 100644 index 00000000..b2f7dd90 --- /dev/null +++ b/src/main/java/com/youlai/boot/client/controller/ClientRemoteControlController.java @@ -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> 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)); + } +} diff --git a/src/test/java/com/youlai/boot/client/controller/ClientRemoteControlControllerTest.java b/src/test/java/com/youlai/boot/client/controller/ClientRemoteControlControllerTest.java new file mode 100644 index 00000000..de3e88b9 --- /dev/null +++ b/src/test/java/com/youlai/boot/client/controller/ClientRemoteControlControllerTest.java @@ -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 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(); + } + } +}