Files
DongHyeonka a7f44d8a8d fix(secrets)!: 로컬 비밀 기본값을 __LOCAL_DEV_ 규칙에 맞추고 가림 약속을 구현과 맞춘다
로컬 비밀 기본값(compose·lane·application-local의 DB 비밀번호, MinIO
root, Keycloak admin)이 __LOCAL_DEV_ 접두어 규칙을 따르지 않아 prod
sentinel 검사가 그 값을 알아보지 못한다. secrets-classification.yaml은
구현 없는 masking_rule full_except_last_4를 약속하고, full로 적은 키 일부
(salt·PEM·HMAC/signing key, URI 사용자 정보)를 LogMaskingPatterns가 가리지
않는다. required_test는 없는 시험 이름이다. IP 신뢰 설정을 두 문서가
다르게 적는다(application-local은 framework, rate-limiting은 native).

- 기본값을 __LOCAL_DEV_db_password__·__LOCAL_DEV_minio_root__·
  __LOCAL_DEV_keycloak_admin__로 바꾼다.
- masking_rule을 full|userinfo|none 셋으로 줄이고, LogMaskingPatterns의
  키 목록을 넓히고 URI userinfo와 여러 줄 PEM 블록 가림을 더한다. 시험이 masking_rule 어휘,
  required_test 클래스 존재, full·userinfo 행이 실제로 가려지는지 본다.
  버린 안: full_except_last_4 구현(끝 네 자리를 남길 값이 없다).
- IP 신뢰는 native + 내부 proxy 목록 하나로 적는다.

위험: 로컬 compose 볼륨이 옛 비밀번호로 만들어졌으면 DB 접속이 실패한다
(docs/upgrade/2026-11-round9-observability.md 6행). 운영 값은 바뀌지
않는다.

검증: 위와 같은 desktop 실행(묶음 셋을 합친 트리) rc=0.

Refs: RR9-02-10, RR9-02-12, RR9-02-13
BREAKING CHANGE: 로컬 compose·lane의 비밀 기본값이 바뀐다. 옛 볼륨은
  지우거나 env로 옛 값을 준다(docs/upgrade/2026-11-round9-observability.md 6~7행).
2026-11-13 13:12:09 +09:00

2.3 KiB

요청률 제한 (rate limiting) — 기본 OFF, ingress 책임

  • 결정: 소유자, 2026-11-12 (W4 red team BE-OBS-A).

자세(posture)

이 템플릿은 요청 빈도(rate) 제한을 앱에서 기본으로 켜지 않는다(APP_RATE_LIMIT_ENABLED 기본 false). 요청률 제한은 ingress/gateway의 책임이다. 파생 서비스는 앞단(ingress-nginx·API gateway·CDN·WAF)에서 IP·클라이언트·경로별 요청률을 건다.

이것은 보호가 없다는 뜻이 아니다. 앱은 크기/양 bound를 이미 강제한다: 업로드/다운로드 크기·range 수, 메시지 payload(64KB), GraphQL complexity(10000)·page-size(100)·depth/alias, gRPC 메시지(1MiB)·deadline, 연결 수(WS 1000)·send-buffer. 빠진 것은 요청 빈도 한 축이고, 그것은 앞단이 서비스 전체(여러 인스턴스) 기준으로 보는 게 맞다.

앞단에서 안 거는 배포라면 — 앱 내 limiter 켜기

redis 기반 limiter를 쓸 수 있다(fail-closed):

  1. 모듈을 런타임에 둔다: runtimeOnly project(':adapter:outbound:cache-redis').
  2. APP_REDIS_ENABLED=true + redis 접속(APP_*_REDIS_*).
  3. APP_RATE_LIMIT_ENABLED=true, APP_RATE_LIMIT_PROVIDER=redis, APP_RATE_LIMIT_FAILURE_POLICY=fail-closed.
  4. 클라이언트 IP 해석: APP_SERVER_FORWARD_HEADERS_STRATEGY=native + Tomcat server.tomcat.remoteip.internal-proxies(신뢰하는 프록시의 IP 정규식)로 getRemoteAddr() 하나를 쓴다. limiter는 그 값만 읽고 따로 고르는 IP 모드가 없다(옛 APP_RATE_LIMIT_CLIENT_IP_MODE는 지웠다, docs/capability-status.md). framework는 모든 peer의 X-Forwarded-*를 믿어 호출자가 자기 IP를 고를 수 있으니 쓰지 않는다(src/bootstrap/app/src/main/resources/config/server.yml).

자세한 키는 docs/registries/env-keys.yaml의 APP_RATE_LIMIT_*, 모듈 기본값은 src/adapter/outbound/cache-redis/src/main/resources/config/module-defaults/cache-redis.yml.

파생 서비스가 정할 것 (릴리스 전 확인)

  • 이 서비스의 요청률 제한을 어디서 거는가(ingress / app / 둘 다)를 배포 설계에 적는다.
  • ingress에서 건다면 그 규칙(IP·경로·버스트)을 배포 repo에 둔다. 앱에서 건다면 위 4단계 + redis 용량.
  • 둘 다 안 걸면 그것이 의식적 결정임을 적는다(내부 전용·앞단 보호 있음 등).