261102_01_ENH: 요청 사용자 Context Provider 공용화 및 beta.1.7.1 버전 상향

This commit is contained in:
2026-11-02 13:59:34 +09:00
parent 59a4281cea
commit 2bbda10eb5
10 changed files with 116 additions and 49 deletions

View File

@@ -99,6 +99,20 @@ import com.kri.common.feature.web.RequestUserContext;
컨트롤러 파라미터로 선언하면 현재 인증 사용자와 client IP를 받을 수 있습니다. `JwtService` Bean이 있을 때 `RequestUserContextArgumentResolver`가 자동 등록됩니다.
`beta.1.7.1`부터 인터셉터 등에서도 공개 API인 `RequestUserContextProvider`를 주입받아 동일한 컨텍스트를 조회할 수 있습니다.
```java
import com.kri.common.feature.web.RequestUserContext;
import com.kri.common.feature.web.RequestUserContextProvider;
// 생성자로 주입받은 Provider를 요청 처리 중 호출합니다.
RequestUserContext ctx = requestUserContextProvider.resolve(request);
```
기본 Provider는 기존 Resolver의 principal → details → 검증된 Bearer 토큰 순서와 IP 해석을 유지합니다. 인증 정보를 찾지 못하면 사용자 필드가 비어 있는 컨텍스트를 반환합니다. 요청 파라미터에서 사용자 정보를 가져오지 않으며, 인증 필수 여부나 업무 권한은 호출 서비스에서 검사해야 합니다. 요청 간 컨텍스트를 캐시하지 않습니다.
기본 Provider는 `kri.web.enabled=true`와 `JwtService` Bean이 있을 때 등록되며, 서비스가 `RequestUserContextProvider` Bean을 제공하면 이를 사용합니다. 기존 컨트롤러 주입 방식과 Resolver 교체 지점, `JwtService`를 받는 기존 Resolver 생성자는 유지됩니다. Provider도 기존 Web 통합과 마찬가지로 Servlet/Spring Web classpath가 필요합니다.
Swagger 자동 구성이 활성화되면 `RequestUserContext`는 요청 입력 문서에서 제외됩니다. `authenticated`, `clientIp`, `userRole` 등의 입력 항목은 표시되지 않으며, 실제 요청의 인증 정보와 IP 주입 동작은 유지됩니다.
```java
@@ -932,6 +946,8 @@ Endpoint:
## 변경 이력
- 2026-11-02: `beta.1.7.1`에서 공개 `RequestUserContextProvider`를 추가하고 기존 컨트롤러 인자 해석을 위임하도록 정리했습니다. 인증 정보와 IP 해석, 기존 Resolver 생성자 및 자동 등록 조건을 유지합니다.
- 2026-08-06: `beta.1.6.3`에서 non-ASCII multipart 파일명을 ASCII fallback/
`filename*` 없이 원본 `filename`의 UTF-8 바이트로 전송하도록 복원했습니다.
- 2026-08-06: `beta.1.6.2`에서 non-ASCII multipart 파일명에 ASCII `filename`