260421_02_ENH: 전체적으로 정리

This commit is contained in:
2026-04-21 13:51:56 +09:00
parent b65c37d921
commit c90481b4d0
14 changed files with 159 additions and 207 deletions

View File

@@ -208,13 +208,6 @@ kri:
allowed-ips:
# Swagger UI / API Docs 접근 허용 IP
- "127.0.0.1"
webmvc:
# 공통 MVC 자동구성 활성화
enabled: true
ip:
additional-cidrs:
# Swagger 접근 허용 CIDR 추가값
- "192.168.0.0/16"
web:
# 공통 웹 예외/trace 필터 활성화
enabled: true
@@ -267,11 +260,6 @@ kri:
- 사용 대상 클래스: `CommonWebAutoConfiguration`
- 설명: `ErrorAdvice`, `TraceFilter`, MDC 관련 구성을 켜고 끕니다.
#### `kri.webmvc`
- 대상: CORS, Swagger IP 인터셉터, `RequestUserContext` 처리
- 사용 대상 클래스: `KriWebMvcAutoConfiguration`, `KriIpAccessProperties`
- 설명: MVC 확장 기능과 CIDR 기반 접근 제어를 등록합니다.
#### `kri.redis`
@@ -307,19 +295,16 @@ kri:
- `com.kri.common.runtime.swagger`
- `SwaggerIpFilter`
- `com.kri.common.runtime.web`
- `ErrorAdvice`
- `TraceFilter`
- `MdcHandlerConfig`
- `ServiceMdcAspect`
- `com.kri.common.runtime.webmvc`
- `CodeEnumConverter`
- `IpAccessControlInterceptor`
- `IpAccessControlService`
- `ErrorAdvice`
- `IpUtil`
- `RequestUserContextArgumentResolver`
- `TraceFilter`
- `ServiceMdcAspect`
---
## 자동 노출 endpoint
#### `com.kri.common.endpoint.auth.apikey.ApiKeyAdminController`
@@ -330,6 +315,25 @@ kri:
---
## Migration Guide
- `kri.webmvc.enabled` 설정은 제거하고 `kri.web.enabled`만 사용합니다.
- `kri.webmvc.ip.*` 설정은 제거하고 Swagger IP 제어는 `kri.swagger.allowed-ips`만 사용합니다.
- 프록시 환경에서는 API Key admin API와 Swagger가 모두 `IpUtil` 기준으로 클라이언트 IP를 해석합니다. `kri.auth.apikey.admin-allow-ips` 값을 다시 확인하세요.
- 내부 클래스를 직접 import하고 있었다면 아래처럼 경로를 변경해야 합니다.
- `com.kri.common.runtime.webmvc.CodeEnumConverter` -> `com.kri.common.runtime.web.CodeEnumConverter`
- `com.kri.common.runtime.webmvc.IpUtil` -> `com.kri.common.runtime.web.IpUtil`
- `com.kri.common.runtime.webmvc.RequestUserContextArgumentResolver` -> `com.kri.common.runtime.web.RequestUserContextArgumentResolver`
- 아래 클래스와 설정 객체는 제거되었습니다.
- `com.kri.common.autoconfigure.webmvc.KriWebMvcAutoConfiguration`
- `com.kri.common.autoconfigure.webmvc.KriIpAccessProperties`
- `com.kri.common.runtime.web.IpAccessControlInterceptor`
- `com.kri.common.runtime.web.IpAccessControlService`
- `com.kri.common.runtime.web.MdcHandlerConfig`
- Swagger 문서의 인증 표시는 `BearerAuth`와 `ApiKeyAuth`를 동시에 요구하지 않고, 둘 중 하나로 인증 가능한 형태로 바뀌었습니다.
---
## AutoConfiguration 목록
`src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`
@@ -340,7 +344,6 @@ kri:
- `com.kri.common.autoconfigure.auth.apikey.ApiKeyAdminAutoConfiguration`
- `com.kri.common.autoconfigure.security.KriSecurityAutoConfiguration`
- `com.kri.common.autoconfigure.web.CommonWebAutoConfiguration`
- `com.kri.common.autoconfigure.webmvc.KriWebMvcAutoConfiguration`
- `com.kri.common.autoconfigure.swagger.KriSwaggerAutoConfiguration`
- `com.kri.common.autoconfigure.redis.CommonRedisAutoConfiguration`
- `com.kri.common.autoconfigure.scheduling.CommonSchedulingAutoConfiguration`