feat(续期): 凭据领取顺带回发新 JWT——旧客户端忽略未知键故服务端可先行

挂点是现成的:桌面端每 30 分钟带 JWT 领一次凭据(TTL_SECONDS=1800),不必新加往返、
也不必客户端先学会调 refresh。既有 5 个键名逐字不动(旧客户端按 data.get 取值),
用例同时钉住「不许改名/删键」——那会让存量设备当场领不到凭据,比装机率更糟。
This commit is contained in:
2026-10-09 15:11:37 +08:00
parent 7edbae0cda
commit 9fa9dcc4c2
4 changed files with 90 additions and 1 deletions
@@ -31,7 +31,8 @@ class ClientCredentialControllerTest {
private final HttpServletRequest request = mock(HttpServletRequest.class);
private ClientCredentialController newController() {
return new ClientCredentialController(adminAuthSupport, properties);
return new ClientCredentialController(adminAuthSupport, properties,
mock(com.nanri.aiimage.common.security.JwtService.class));
}
private void configureAll() {
@@ -0,0 +1,74 @@
package com.nanri.aiimage.modules.clientcredential.controller;
import com.nanri.aiimage.common.api.ApiResponse;
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
import com.nanri.aiimage.common.security.AdminAuthSupport;
import com.nanri.aiimage.common.security.JwtService;
import com.nanri.aiimage.config.ClientCredentialProperties;
import com.nanri.aiimage.modules.clientcredential.model.vo.ClientCredentialVo;
import jakarta.servlet.http.HttpServletRequest;
import org.junit.jupiter.api.Test;
import java.util.Arrays;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;
/**
* 会话续期挂在凭据领取口上:桌面端本来就每 30 分钟带着 JWT 打这里一次
* ({@code client_credentials.py} 的 TTL_SECONDS=1800),所以多发一个字段就是现成的续期通道。
*
* <p>两条底线:既有键名一个字不许改(旧客户端按 {@code data.get(key)} 取值,忽略未知键才零破坏);
* 续期不许成为容忍的前提——存量客户端不接这个字段也必须靠容忍活着。</p>
*/
class ClientCredentialRenewalTest {
private final AdminAuthSupport adminAuthSupport = mock(AdminAuthSupport.class);
private final JwtService jwtService = mock(JwtService.class);
private final ClientCredentialProperties properties = new ClientCredentialProperties();
private final HttpServletRequest request = mock(HttpServletRequest.class);
private ClientCredentialController newController() {
return new ClientCredentialController(adminAuthSupport, properties, jwtService);
}
private void configureAll() {
properties.setZiniaoCompany("company-x");
properties.setZiniaoUsername("user-x");
properties.setZiniaoPassword("password-x");
properties.setMysqlPassword("mysql-pass-x");
}
private ClientCredentialVo handOut() {
AdminUserEntity user = new AdminUserEntity();
user.setId(7L);
user.setUsername("小魏16");
when(adminAuthSupport.requireUser(any())).thenReturn(user);
when(adminAuthSupport.currentInternalToken()).thenReturn("token-x");
when(adminAuthSupport.currentDeviceId(any())).thenReturn("dev-1");
when(jwtService.issue(eq(7L), eq("小魏16"), eq("dev-1"))).thenReturn("jwt-fresh");
configureAll();
ApiResponse<ClientCredentialVo> response = newController().credentials(request);
assertThat(response.isSuccess()).isTrue();
return response.getData();
}
@Test
void freshJwtIsHandedBackAlongsideCredentials() {
ClientCredentialVo vo = handOut();
assertThat(vo.getJwt()).isEqualTo("jwt-fresh");
assertThat(vo.getInternalToken()).isEqualTo("token-x"); // 续期不改写既有载荷
}
@Test
void legacyKeyNamesAreUntouched() {
// 旧客户端只认这几个键;改名或删键 = 存量设备当场领不到凭据(比装机率更糟:全员炸)
assertThat(Arrays.asList(ClientCredentialVo.class.getDeclaredFields()).stream()
.map(f -> f.getName()).toList())
.contains("internalToken", "ziniaoCompany", "ziniaoUsername", "ziniaoPassword", "mysqlPassword")
.doesNotContain("token", "jwtToken");
}
}