문제: 3차 수정의 확인 리뷰가 새 Important 없이 Minor 19건을 남겼다. 동작에 닿는 것이 셋이다. JDK read-idle watchdog이 공용 ForkJoinPool에서 돌아 그 풀이 바쁘면 300ms timeout이 6초 가까이 늦었다. 붙여 쓴 -x<task>를 verifyStrictLaneStages가 읽지 않아 lane을 뺀 workflow가 통과했다. 사용자 전송이 중간 클래스를 거쳐 @SystemCaller bean을 부르면 ArchUnit 규칙을 지났다. 잠금 대기 검사기는 FK·trigger·REINDEX와 lock_timeout = 0을 못 봤고, 쿼터 보정 SQL은 코드와 다른 모양의 행을 넣었다. 방법: 영역별 4묶음이 맡은 Minor만 test-driven-development 절차로 고쳤다(재리뷰 README 12절). - watchdog은 전용 데몬 스레드 하나에서 돌고 스트림을 닫으면 작업을 취소한다. read당 비용은 그대로다(21–24ns). - 사용자 전송 → @SystemCaller는 직접·간접 의존 모두 거부한다. 리뷰가 권한 직접 의존 검사는 중간 클래스 하나로 다시 열려서 버렸다. - 검사기를 보강하면서 새로 걸린 이미 배포된 마이그레이션 5개는 내용을 바꾸지 않고 동결 목록에 더했다(main과 blob이 같다). - 비밀 목록 bean은 규칙보다 먼저 만들어 실제 클래스로 검사한다. 위험·한계: 회복 필요 예외 메시지 끝에 scope digest가 붙고 기동 실패 문구가 바뀌어, 문구 전체에 맞추던 로그 매처는 고쳐야 한다. 코드가 든 Redis 계정 참조의 fixture- 검사는 문서로만 막았다(코드로 막으려면 새 의존 edge가 필요하다). failure-retention ≥ replay-ttl 기동 검사는 넣지 않았다. -mx 같은 짧은 플래그 묶음과 graphql 전송 fixture는 남았다. spotbugsTestFixtures(게이트 밖)의 정규식 경고가 15건으로 늘었다. 검증: ci, 두 빌드의 verifyStrictLaneStages --dry-run, mainCheck, :integrationCheck, -p optional-platforms ci integrationCheck performanceCheck, :performanceCheck, :releaseCheck(-PgitRevision), verify-compose-profile-contracts(18 lane) 첫 실행 통과. watchdog은 공용 풀을 채운 상태에서 300ms 설정이 300ms에 끝나는 것을 쟀다. Refs: docs/reviews/2026-11-03-rereview/README.md 11·12절, round3/
23 KiB
composition:service-runtime — 모든 서비스가 받는 runtime 배선
- Module ID:
composition-service-runtime - Gradle path:
:composition:service-runtime - Package:
dev.caskeleton.composition.runtime - 테스트:
./gradlew :composition:service-runtime:test --console=plain
제공하는 것
capability와 무관하게 서비스 구성 루트 둘(app-bootstrap, sample-portfolio)이 모두 필요로 하는 runtime 배선이다. 예전에는 app-bootstrap에 있었고 sample이 그 복사본을 들고 있었다.
composition:service-runtime
├─ tracing/ TracingConfig(SpanErrorRecorder·ActiveTrace·sampling gauge), TracingSettings,
│ TracingSampleRateResolver, TracingEnvironmentPostProcessor(app.tracing.* →
│ Boot 키), TracingSwitchImportFilter(enabled=false면 Boot tracing 제외)
├─ metrics/ MetricsContractConfig(cardinality deny-list + SLO 분포 filter)
├─ context/ DomainContextConfig
├─ logging/ PseudonymizationConfig, PrivacySettings (user_principal HMAC 가명화)
├─ management/security/ ManagementSecurityConfig (actuator chain)
└─ authorization/ PermissionEnforcementConfig(PermissionEnforcementGuard: @RequiresPermission
빈이 있는데 적용되는 advisor가 없으면 기동 실패)
-
권한 검사 장치 부재 = 기동 실패.
@RequiresPermission은 application-core 선언이고 검사는 web leaf의MethodSecurityConfigadvisor가 한다. web을 뺀 조립(gRPC 전용·배치 전용)은 예전엔 선언만 남은 채 정상 기동했다. 이제PermissionEnforcementGuard가 선언 빈마다 pointcut이 맞는 advisor가 있는지 보고, 없으면REQUIRED_ADAPTER_DISABLED(exit 72)로 기동을 멈춘다. 한계: "어떤 advisor든 pointcut이 맞으면 통과"라 인가가 아닌 advisor를 구분하지 못한다.new로 만든 유스케이스는 검사 대상이 아니다(시스템 호출용은@SystemInvoked). 반대로@SystemInvoked유스케이스가 빈으로 등록돼 있으면 같은 가드가 기동을 멈춘다 — 권한 검사가 없는 쓰기를 전송 계층이 닿는 곳에 두는 조립이기 때문이다(review 2026-11-03 RR-01-02). 가드가 허용하는 경우는 하나다: 시스템 호출자의 bean이 자기가new로 만든 use case를 필드로 든다(스케줄러에 넘기는 조립 모듈, 또는@SystemCaller메시지 handler·예약 작업 — RR-01-12, 목록의 정본은 매뉴얼 07장 「시스템이 부르는 쓰기」). 가드는 bean 타입만 보므로 모두 기동한다. -
모두 이 모듈의
AutoConfiguration.imports로 등록된다(설정 브리지와 tracing 스위치는spring.factories의EnvironmentPostProcessor·AutoConfigurationImportFilter). 구성 루트의 component scan에 기대지 않는다. -
Tracer·span processor·OTLP exporter는 이 모듈이 만들지 않는다. Spring Boot 4의
spring-boot-micrometer-tracing-opentelemetry(+opentelemetry-exporter-otlp)가 만들고, 이 모듈은app.tracing.*값을 Boot 키로 옮기고 끄는 스위치만 둔다(아래 "tracing" 절). -
설정 키는 옮기지 않았다:
app.tracing.*,app.privacy.*. 값은 각 구성 루트의application.yml/config/observability.yml에 있다. -
actuator chain은 servlet 웹 애플리케이션에서만 만들어지고, 구성 루트가 같은 이름
actuatorSecurityFilterChain의 bean을 두면 물러난다. sample-portfolio는 공개 데모라 그렇게 모든 요청을 허용하는 자기 chain을 둔다. -
sample 복사본과의 차이 중 원본을 따른 것: 샘플 레이트는
RuntimeEnvironment어휘(prod 0.01, 그 밖 1.0)이고staging=0.10분기는 없다. 설정 검증 실패는IllegalStateException이 아니라StartupFailures.envValidation이다.
추가할 한 줄
// app-bootstrap/build.gradle (sample-portfolio/build.gradle 도 같다)
runtimeOnly project(':composition:service-runtime')
기본 조립에 있다. 이 줄을 지우면 Tracer·SpanErrorRecorder·가명화 포트·DomainContextPropagator가
빠지고, 그것을 주입받는 web adapter(RequestLoggingFilter)와 persistence audit이 기동에 실패한다.
필요한 env 키
전체 목록과 타입은 docs/registries/env-keys.yaml이 SSOT다.
| 언제 | 키 |
|---|---|
| 프로덕션 전 | APP_PRIVACY_PSEUDONYMIZATION_SALT (비면 dev sentinel로 경고 후 기동) |
| 조정할 때 | APP_TRACING_SAMPLE_RATE, OTEL_EXPORTER_OTLP_ENDPOINT |
설계 결정 참조 (app-bootstrap에서 옮김)
이 모듈의 코드는 2026-09-28에 app-bootstrap(autoconfigure/tracing, concurrency, metrics,
management/security, logging/PseudonymizationConfig, settings/PrivacySettings)에서 옮겨 왔다.
아래 근거는 그때의 기록이다.
tracing — 분산 트레이싱 wiring과 샘플링 정책
Boot tracing으로 바꾼 이유 (리뷰 07-01, 2026-11-01)
- 예전에는
TracingConfig가Tracer를 직접 만들었다.SdkTracerProvider에 sampler만 있고 span processor·exporter가 없었고, Boot tracing 자동 설정은 classpath에 없었다. 그래서 HTTP 요청이 span을 만들지 않았고OTEL_EXPORTER_OTLP_ENDPOINT를 넣어도 아무것도 나가지 않았다. - 고른 방법: 직접 조립을 지우고 Boot 4의
spring-boot-micrometer-tracing-opentelemetry를 쓴다. Boot가 SDK,BatchSpanProcessor, observation→span 핸들러, propagator, 그리고management.opentelemetry.tracing.export.otlp.endpoint가 있을 때만 OTLP exporter를 만든다.spring-boot-starter-opentelemetry는 쓰지 않는다 — OTLP 메트릭 push(micrometer-registry-otlp)까지 켜서 이 템플릿의 Prometheus scrape 계약 밖의 전송이 생긴다. - 버린 대안: (1) 직접 만든
SdkTracerProvider에 processor·exporter를 붙이기 — observation→span 연결과 propagator까지 다시 짜야 한다. (2) tracing을 빼고 로그 상관만 제공 — 소유자가 관측 기본 제공을 정했다. - trace id 하나로 맞추기: Boot의 서버 observation(
HIGHEST_PRECEDENCE + 1)이 span을 연 뒤에WebMvcRequestIdFilter(+ 10)가 돈다. 필터는ActiveTrace로 그 span의 id를 받아meta.traceId, 로그trace_id·span_id, 응답traceparent에 쓴다. tracer가 없으면 예전처럼 들어온traceparent를 쓰거나 새로 만든다.
TracingConfig
- 컴포지션 루트의 트레이싱 부속을 등록한다. 세 가지를 한다: (1) 시작 시
tracing.sampling.rate게이지 등록, (2)SpanErrorRecorder빈 등록, (3)ActiveTrace빈 등록(Tracer가 없으면NONE). Boot의OpenTelemetryTracingAutoConfiguration뒤에 돈다. SpanErrorRecorder빈은@ConditionalOnBean(Tracer.class)가 아니라ObjectProvider<Tracer>로 런타임 존재 여부를 직접 조회한다. 이유:@ConditionalOnBean은 사용자 정의@Configuration에서 autoconfiguration 이 만드는 빈(여기서는Tracer)을 조건으로 쓸 때 빈 등록 순서가 보장되지 않아 신뢰할 수 없기 때문이다.Tracer가 있으면MicrometerSpanErrorRecorder를, 없으면SpanErrorRecorder.NOOP을 반환한다.@ConditionalOnMissingBean(SpanErrorRecorder.class)를 붙여, 테스트 mock 이나 fork 가 자체SpanErrorRecorder빈을 이미 등록한 경우 이 빈은 backoff 한다. adapter-web 의GlobalExceptionHandler는ObjectProvider로SpanErrorRecorder를 조회하므로, 자기 자신의 NOOP self-default 에서 여기서 등록한 실제 구현으로 자동 교체된다.- span export는
OTEL_EXPORTER_OTLP_ENDPOINT가 정한다. 비어 있으면 Boot exporter 키가 생기지 않아 exporter bean이 없다(기본 주소로 보내지도 않는다). 값이 있으면 OTLP/HTTP로<값>/v1/traces에 보낸다.TracingExportSystemTest가 로컬 수신기로 이것을 확인한다. APP_TRACING_ENABLED=false면Tracerbean이 없다.TracingSwitchImportFilter가org.springframework.boot.micrometer.tracing.아래 자동 설정을 모두 뺀다. Boot의management.tracing.export.enabled=false는 export만 끄고 tracer와 span은 그대로 만들기 때문에 쓰지 않았다.spring.autoconfigure.exclude에 넣는 방법은 운영자가 쓴 exclude 목록과 덮어쓰기 경쟁을 해서 버렸다.- 게이지 등록 시 active profile 은
Environment.getActiveProfiles()의 첫 번째 값을 쓴다. 멀티 프로파일 배포에서는 맨 앞에 나열된 프로파일이 권위 있는 배포 환경이라는 규약이다.MeterRegistry가 classpath 에 없으면(Actuator 미탑재) 게이지 등록은 조용히 no-op 이 된다. TracingSamplingRateGaugeRegistrarrecord 는 등록된 active profile 과 resolved rate 를 노출하는 값 홀더다. 정식 포트나 use case 가 아니라, 살아있는MeterRegistry없이도 테스트가 "무엇이 등록되었는지" 검사할 수 있게 하는 bootstrap 내부 전용 장치다.
TracingSettings
app.tracing.*바인딩@ConfigurationPropertiesrecord. 세 env 키가 들어온다:APP_TRACING_ENABLED→enabled,APP_TRACING_SAMPLE_RATE→sampleRate,OTEL_EXPORTER_OTLP_ENDPOINT→exporter.otlpEndpoint.sampleRate가 blank 이면 숫자 검증을 건너뛴다. blank 는 "값이 잘못됐다"가 아니라 "프로파일별 기본값에 위임하라"는 신호이기 때문이다. 실제 런타임별 기본값(prod=0.01, dev/local=1.0)은TracingSampleRateResolver가 적용하고, profile vocabulary 자체는RuntimeEnvironment가 소유한다. resolved 된 값은TracingEnvironmentPostProcessor가 Spring Boot 네이티브management.tracing.sampling.probability로 브리지한다.- 검증은 시작 시 fail-fast 다.
sampleRate가 non-blank 인데 [0.0, 1.0] float 이 아니면 시작이 실패하고,otlpEndpoint가 non-empty 인데 scheme 없는 잘못된 URL 이면 시작이 실패한다.enabled는 Spring 바인딩이boolean타입을 강제하므로 추가 검증이 필요 없다.otlpEndpoint가 비어 있으면 exporter off 상태(seam 기본값)이고, 이것이 정상 동작이므로 검증을 통과시킨다. sampleRateValue()는 호출 전sampleRate().isBlank()확인이 caller 규약이다. blank 인 상태로 호출하면IllegalStateException을 던지는데, 이는 파싱 오류가 아니라 caller 규약 위반을 드러내기 위한 것이다.
TracingSampleRateResolver
- 런타임별 트레이싱 샘플 정책을 적용한다. prod=0.01(1%), dev/local=1.0(100%)이며,
런타임 이름의 SSOT는
RuntimeEnvironment다. shipped runtime이 아닌 값은 1.0 안전값을 사용한다.APP_TRACING_SAMPLE_RATE가 non-blank 이고 [0,1] float 로 파싱되면 프로파일 기본값을 override 한다. - Spring 의존성이 전혀 없는 순수 Java 로 작성했다. 어떤 컨텍스트도 없이 단위 테스트할 수 있고,
EnvironmentPostProcessor(컨텍스트 생성 이전 단계)와TracingConfig(빈 생성 단계) 양쪽에서 동일 로직을 재사용하기 위함이다.
TracingSamplingRateGauge
tracing.sampling.rate게이지를 등록한다. metric 계약: type=gauge, tag=profile(prod/dev/local 허용), value=resolved effective sample rate(double in [0.0, 1.0]).- deployable
RuntimeEnvironment가 정확히 하나 해석될 때만 시리즈 하나를 방출한다. test/profileless/unknown 컨텍스트를local로 가장하지 않으며, shipped app은 그보다 앞선 profile validator에서 잘못된 런타임 환경을 거부한다. MeterRegistry를ObjectProvider로 조회하며, Actuator 미탑재로 빈이 없으면 등록을 조용히 건너뛴다. 이는BackgroundJobMetrics/OutboxMetrics의 선례를 그대로 따른다.
TracingEnvironmentPostProcessor
app.tracing.*을 Boot tracing 키로 옮기는EnvironmentPostProcessor다. (1) resolved 된 유효 샘플 비율 →management.tracing.sampling.probability, (2)app.tracing.exporter.otlp-endpoint(=OTEL_EXPORTER_OTLP_ENDPOINT) →management.opentelemetry.tracing.export.otlp.endpoint. (2)는 OpenTelemetry 규약대로 기준 주소에/v1/traces를 붙인다(끝의/는 하나로 정리). gRPC 전송이나 다른 경로가 필요하면 Boot 키(management.opentelemetry.tracing.export.otlp.*)를 직접 주며, 직접 준 값은 덮어쓰지 않는다. 예전 이름은TracingSamplingEnvironmentPostProcessor다(순서 상수는StartupOrder.TRACING_PROPERTIES그대로). 이를 통해 "프로파일별 기본값 + env override"라는 우리 규약을 Spring Boot 의 기본 샘플링 메커니즘에 그대로 연결한다.- 샘플링 브리지 우선순위. (1) 사용자가
management.tracing.sampling.probability를 이미 명시했으면 덮어쓰지 않고 그대로 둔다, (2)app.tracing.sample-rate가 non-blank 면 그 값 사용, (3) blank 면TracingSampleRateResolver.defaultRateForProfile(...)로 active profile 기본값 적용. META-INF/spring.factories에org.springframework.boot.EnvironmentPostProcessor키로 등록된다.EnvironmentPostProcessor는 ApplicationContext 가 생성되기 전에 실행되므로 일반 빈이 아니라 Spring Boot bootstrap factory 로 등록해야 한다.
MicrometerSpanErrorRecorder
- NOOP 을 대체하는 Micrometer/OTel 기반 실제
SpanErrorRecorder다. 현재 span 에 예외와error.code태그를 기록한다. 계약 이행:Span.error(Throwable)호출(OTel bridge 를 통해recordException+ span status ERROR 매핑),span.tag("error.code", errorCode)(ca-tmpl 레지스트리 속성명), nullerror는 방어적 no-op, 현재 span 이 없으면 no-op. - "sampled span 에만 스택트레이스 부착" 정책은 의도적으로 구현하지 않았다. Micrometer Tracing
추상화 레벨에서는 sampled 여부를 직접 제어할 수 없기 때문이다(
Span.isNoop()은 OTel NOOP span 여부일 뿐 sampling 여부가 아니다). 다만 OTel SDK 의 unsampled span 은 이미 no-op 으로 처리되므로 명시적 sampled-only 분기가 없어도 실제 성능 부담은 없다.
metrics — 메트릭 계약 MeterFilter 설치
MetricsCardinalityMeterFilter
- 금지 태그가 붙은 미터를 런타임에서 막는 방어 필터다. 미터의
Meter.Id에 붙은 태그 키 중 하나라도ForbiddenMetricTags.FORBIDDEN에 들어 있으면 그 미터를DENY하고, 아니면NEUTRAL을 반환한다.user_id,request_id,raw_url,raw_query,raw_header_value,ip_address같은 고카디널리티(high-cardinality) 라벨 키는 고유 값마다 Prometheus 시계열을 하나씩 만들어 수백만 개로 폭증할 수 있어 차단한다. - 이 필터는 카디널리티 계약의 런타임(runtime) 절반이다. 정적(static) 절반은 레지스트리 계약
테스트(
MetricsAlertingContractTest)가 담당한다 — 둘이 짝을 이뤄 심층 방어를 구성한다. - 상태가 없어(stateless) 여러 레지스트리에 공유해도 안전하다. public no-arg 생성자는
MetricsContractConfig.install()이 직접 인스턴스화하기 위한 계약이다.
MetricsContractConfig
@PostConstruct에서MeterFilter들을MeterRegistry에 직접 설치한다.@Bean MeterFilter로 등록하지 않는 이유: 이 템플릿 클래스패스에는@Bean MeterFilter를 자동 수집하는 Spring Boot Actuator 자동설정(MeterRegistryCustomizer)이 없어서@Bean MeterFilter는 그냥 동작하지 않는 (inert) 죽은 빈이 되기 때문이다.OutboundHttpResilienceConfig에서 확립한 선례를 따른다.- 설치 순서가 중요하다. (1)
MetricsCardinalityMeterFilter(deny-list)를 먼저 설치해 금지 태그가 붙은 미터가 분포 필터에 닿기 전에 거부되도록 하고, (2) 그다음MetricsDistributionMeterFilter(SLO 기반 히스토그램 설정)를 설치한다. - 필터는 설치 이후 등록되는 미터에만 적용된다.
@PostConstruct는 Spring 빈 생명주기 중 애플리 케이션 코드가 어떤 미터든 등록하기 전에 실행되므로 모든 미터가 필터 적용 대상이 된다. MeterRegistry부재 시 no-op.ObjectProvider.getIfAvailable()로 해석해 레지스트리 빈이 없으면(Actuator 미탑재) DEBUG 로그만 남기고 설치를 건너뛴다.install(MeterRegistry)를 public static 으로 둔 이유. 계약 테스트가 Spring 컨텍스트 없이SimpleMeterRegistry에 대해 직접 구동할 수 있게 하기 위함이다.
MetricsDistributionMeterFilter
- 소유한(owned) 타이머 메트릭 5종에만 SLO 기반 히스토그램·백분위 설정을 적용한다. 대상:
http.server.requests,http.server.requests.latency,dependency.client.requests,db.query.duration,jvm.gc.pause. 이들은metrics.yaml에서 이 브랜치가 소유하고histogram_buckets: slo_driven인 행이다.resilience4j.circuitbreaker.calls,hikaricp.connections.acquire처럼 소비만 하고 소유하지 않는(consumed-but-not-owned) 행은 다른 브랜치 소유라 의도적으로 제외 — 덮어쓰면 안 된다. - 히스토그램 전략은 두 축이다.
- 인스턴스 간 집계 가능한 진실의 원천:
percentilesHistogram(true)(=publishPercentileHistogram)가_bucket시계열을 생성하고, Prometheus 에서histogram_quantile()로 인스턴스 간 집계할 수 있다. 이것이 다중 인스턴스 배포의 정식 p50/p95/p99 다. - 클라이언트 측 편의값(집계 불가):
percentiles(0.5, 0.9, 0.95, 0.99)(=publishPercentiles)는 단일 인스턴스 가시성을 위한 사전 계산 분위 게이지를 제공한다. 이 값들은 인스턴스 간 평균을 내면 안 된다(통계적으로 틀림). 인스턴스 간 집계는 반드시histogram_quantile()로 한다.
- 인스턴스 간 집계 가능한 진실의 원천:
- SLO 경계값
100ms / 500ms / 1s / 5s는 잠정 SLO 역산이며 외부 표준에서 유도한 값이 아니다. 정식 SLO 가 채택되면 재검토 대상이다. 함께 설정하는minimumExpectedValue=1ms,maximumExpectedValue=10s는 히스토그램 버킷의 관측 범위를 한정한다. - 상태가 없어 여러 레지스트리에 공유해도 안전하고, public no-arg 생성자는
MetricsContractConfig.install()이 직접 인스턴스화하기 위한 계약이다.
concurrency — 도메인 컨텍스트 전파 전략 조립
DomainContextConfig
DomainContextPropagator를 빈으로 노출하고ThreadLocalDomainContextPropagator를 직접 만든다. 제공하는 전략이 하나뿐이라 선택 설정(strategy)을 두지 않는다. 두 번째 전략이 생기면 그 구현과 둘 중 하나를 고르는 설정을 함께 추가한다(A-10c). use case 코드는 포트만 주입받으므로 어떤 전파 방식인지 모른다.
logging — user_principal 가명화
PseudonymizationConfig
user_principal(로그에 남는 사용자 식별자)를 전체 HMAC 방식으로 가명화한다.UserPrincipalPseudonymizerPort(application-core)를 HMAC-SHA-256 구현(adapter-identifier)에 바인딩하고, 솔트는PrivacySettings에서 가져온다. 원본 식별자를 그대로 로그에 남기지 않으려는 개인정보 보호 결정이다. 실제 사용처는adapter-web의RequestLoggingFilter로, 보안 principal 이 MDC/로그에 닿기 전에 이 포트로 가린다.@ConditionalOnMissingBean으로 기본 구현을 둔다. 이 템플릿을 포크한 프로젝트가 자기만의 가명화기(예: 향후 솔트 회전을 지원하는 구현)를 등록하면 이 기본 빈이 비켜주도록, 즉 기본값은 제공하되 교체를 막지 않도록 하기 위해서다.
PrivacySettings
- 보안/감사 로그에서
user_principal을 가명화하는 데 쓰는 HMAC salt 를 보관한다.app.privacy.*바인딩(원천APP_PRIVACY_PSEUDONYMIZATION_SALT). 알고리즘은 HMAC-SHA-256- 90일 회전 salt 이고, 이 salt 는
secret-tier 값이라 prod 에서는 반드시 secret manager 에서 공급되어야 한다.
- 90일 회전 salt 이고, 이 salt 는
- 검증은 "warn-and-default"다. blank salt 는 경고를 남기고, 명확히
표시된 dev sentinel(
__LOCAL_DEV_접두사)로 폴백해 local/test 실행이 절대 기동에 실패하지 않게 한다. - 이 sentinel 을 prod 로 승격하는 것은 별도 계약이 독립적으로
차단한다 — prod 프로파일에서
__LOCAL_DEV_값이면 시작이 실패한다. 그 게이트는 이 record 의 책임 밖이라 여기서 중복 강제하지 않는다.
management/security — 액추에이터 엔드포인트 보안 체인
ManagementSecurityConfig
actuatorSecurityFilterChain은@Order(0)으로 메인 앱 체인(adapter-webSecurityConfig)보다 앞서 실행된다. 그래서 액추에이터 엔드포인트에 매칭되는 요청은 앱 체인이 아니라 이 체인이 처리한다. 보안 매처는EndpointRequest.toAnyEndpoint()로, 관리 포트의/actuator/**경로만 이 체인 범위에 든다.- 접근 정책.
health,info,prometheus는 permit-all 이다. 자격 증명 없이 Kubernetes 프로브와 Prometheus 스크레이프가 접근할 수 있어야 하고, 이 엔드포인트들은 민감 데이터를 노출하지 않기 때문이다(health 상세는never). 나머지(/actuator링크 등)는 모두 인증이 필요하다. loggers는 노출하지 않는다. 이 체인에는 인증 수단(httpBasic·oauth2ResourceServer)이 없어authenticated()에 걸리는 엔드포인트는 어떤 자격 증명으로도 도달할 수 없다. 그래서loggers노출과show-details: when-authorized를 뺐다. 로그 레벨을 런타임에 보거나 바꿔야 하면 인증 수단을 이 체인에 먼저 붙이고 노출한다.- 인증 실패 시 기본값 403 대신 401(자격 증명 필요)을 반환한다(
HttpStatusEntryPoint(UNAUTHORIZED)). 대화형 로그인이나 basic-auth realm 은 제공하지 않는다 — 관리 포트는 네트워크 ACL 뒤에 있으므로 올바른 HTTP 의미(credentials required)만 신호하면 된다. - 운영에서 deny-by-default 보장은 관리 포트를 별도 포트로 분리해 네트워크 ACL 수준에서 강제한다. 이 in-process 체인은 그 위의 심층 방어 계층이다.
- SHAPE-OWNERSHIP(하드 규칙): 이 클래스는
HealthEndpoint/HealthIndicator/HealthComponent를 import·구현·의존해선 안 된다 — health 엔드포인트의 형태(shape)는 runtime-health 브랜치 소유다. 보안 매칭은 오직 엔드포인트 id 문자열로만 하고 health 내부 구조에는 절대 손대지 않는다. ArchUnit 규칙management_security_does_not_depend_on_health_internals(CleanArchitectureTest)가 이를 정적 으로 강제한다.