# 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의 `MethodSecurityConfig` advisor가 한다. 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`이다. ## 추가할 한 줄 ```groovy // 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`로 런타임 존재 여부를 직접 조회한다.** 이유: `@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`면 `Tracer` bean이 없다.** `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 이 된다. - **`TracingSamplingRateGaugeRegistrar` record 는 등록된 active profile 과 resolved rate 를 노출하는 값 홀더다.** 정식 포트나 use case 가 아니라, 살아있는 `MeterRegistry` 없이도 테스트가 "무엇이 등록되었는지" 검사할 수 있게 하는 bootstrap 내부 전용 장치다. #### TracingSettings - **`app.tracing.*` 바인딩 `@ConfigurationProperties` record.** 세 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 레지스트리 속성명), null `error`는 방어적 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 에서 공급되어야 한다. - **검증은 "warn-and-default"다.** blank salt 는 경고를 남기고, 명확히 표시된 dev sentinel(`__LOCAL_DEV_` 접두사)로 폴백해 local/test 실행이 절대 기동에 실패하지 않게 한다. - **이 sentinel 을 prod 로 승격하는 것은 별도 계약이 독립적으로 차단한다** — prod 프로파일에서 `__LOCAL_DEV_` 값이면 시작이 실패한다. 그 게이트는 이 record 의 책임 밖이라 여기서 중복 강제하지 않는다. ### management/security — 액추에이터 엔드포인트 보안 체인 #### ManagementSecurityConfig - **`actuatorSecurityFilterChain`은 `@Order(0)`으로 메인 앱 체인(adapter-web `SecurityConfig`)보다 앞서 실행된다.** 그래서 액추에이터 엔드포인트에 매칭되는 요청은 앱 체인이 아니라 이 체인이 처리한다. 보안 매처는 `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`)가 이를 정적 으로 강제한다.