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행).
This commit is contained in:
DongHyeonka
2026-11-13 13:12:09 +09:00
parent 75df7615e5
commit a7f44d8a8d
12 changed files with 246 additions and 92 deletions
+35 -74
View File
@@ -15,9 +15,14 @@
# RR-07-04). 비밀값만 본다: 이 파일의 `secret` 행(SecretSourceValidator.CLASSIFIED_SECRETS,
# SecretsClassificationRegistryTest가 1:1로 묶음), 모듈이 기여한 비밀, `secret://…/<VAR>` 참조가
# 가리키는 변수. HOSTNAME·앱 이름 같은 비밀이 아닌 값은 보지 않는다 (review 2026-11-04 RR2-04-01).
# - 가림(masking) 기본 = `full_except_last_4` (feature-secrets-config-source-contract 2026-05-22:
# "full mask except last 4 chars for non-secret tokens" — 비밀이 아닌 토큰은 끝 4자만 남기고 가린다).
# 진짜 secret(password/private key)은 `full`.
# - `masking_rule`은 그 값이 로그에 나타났을 때 Layer 1 가림(`LogMaskingPatterns`, JSON·pattern 로그 공통)이
# 하는 일이다. 값 셋만 쓴다(`SecretsClassificationRegistryTest`가 묶음):
# full — 값 전체. 비밀 이름(password·secret·token·api key 등)의 key=value와 Authorization 값을 가린다.
# 한 줄 값은 다음 공백·따옴표·구분자까지, PEM 블록은 여러 줄이어도 BEGIN~END 사이 전체다.
# 진짜 secret(password/private key/HMAC key)은 이것이다.
# userinfo — URI의 사용자 정보 비밀번호(`scheme://user:****@host`). 접속 URI 행이다.
# none — 가리지 않는다.
# - `required_test`는 그 행의 약속을 지키는 app-bootstrap 시험 클래스 이름이다(같은 시험이 클래스가 있는지 본다).
# - 이름 접미사는 보조 신호다 (feature-secrets-config-source-contract: "_TOKEN, _KEY, _PASSWORD").
# - public-config 항목은 env-keys.yaml에서 직접 정의되며 본 파일에는 reference row만 둠.
@@ -39,7 +44,7 @@ secrets:
owner_branch: feature-secrets-config-source-contract
masking_rule: full
compatibility_impact: breaking
required_test: secrets-contract:db-password-no-leak-in-actuator
required_test: SecretSourceValidatorTest
- name: SPRING_MAIL_PASSWORD
# source: notification/fileserver techlead review H2 — Spring Mail이 직접 읽는 자격 증명이라 APP_* 별칭을 두지
@@ -53,7 +58,7 @@ secrets:
owner_branch: 2026-09-21-notification-review-remediation
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:smtp-password-no-leak
required_test: SecretSourceValidatorTest
- name: APP_CACHE_REDIS_PASSWORD
# source: feature-secrets-config-source-contract 2026-05-22
@@ -69,7 +74,7 @@ secrets:
owner_branch: feature-secrets-config-source-contract
masking_rule: full
compatibility_impact: breaking
required_test: secrets-contract:redis-password-no-leak
required_test: SecretSourceValidatorTest
- name: APP_CACHE_REDIS_TRUST_PEM
# 공개 CA bundle 내용이지만 무결성이 중요하고, 마운트된 환경이 준다.
@@ -81,7 +86,7 @@ secrets:
owner_branch: redis-production-capability
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:redis-trust-reference-no-leak
required_test: SecretsClassificationRegistryTest
- name: APP_CACHE_REDIS_KEY_HMAC_SECRET
# 바뀌지 않는 캐시 key HMAC 자료. Redis 인증 자격 증명과 다르다.
@@ -95,7 +100,7 @@ secrets:
owner_branch: codex-phase-a-ci-recovery
masking_rule: full
compatibility_impact: breaking
required_test: secrets-contract:redis-key-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_RATE_LIMIT_REDIS_PASSWORD
# coordination role 전용 Redis 자격 증명. 캐시 Redis에서 물려받지 않는다.
@@ -109,7 +114,7 @@ secrets:
owner_branch: redis-distributed-rate-limit
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:rate-limit-redis-password-no-leak
required_test: SecretSourceValidatorTest
- name: APP_RATE_LIMIT_REDIS_TRUST_PEM
# coordination role CA bundle 내용. 무결성이 중요하지만 자격 증명 자료는 아니다.
@@ -121,7 +126,7 @@ secrets:
owner_branch: redis-production-capability
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:rate-limit-redis-trust-reference-no-leak
required_test: SecretsClassificationRegistryTest
- name: APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET
# rate-limit 대상과 정책 개정에 쓰는, 바뀌지 않는 비공개 key 파생 자료.
@@ -135,7 +140,7 @@ secrets:
owner_branch: redis-distributed-rate-limit
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:rate-limit-redis-key-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_SESSION_REDIS_PASSWORD
# session role 전용 ACL 자격 증명. 캐시나 coordination과 몰래 함께 쓰지 않는다.
@@ -149,7 +154,7 @@ secrets:
owner_branch: redis-production-capability
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:session-redis-password-no-leak
required_test: SecretSourceValidatorTest
- name: APP_SESSION_REDIS_TRUST_PEM
# session role CA bundle 내용. 무결성이 중요하지만 자격 증명 자료는 아니다.
@@ -161,7 +166,7 @@ secrets:
owner_branch: redis-production-capability
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:session-redis-trust-reference-no-leak
required_test: SecretsClassificationRegistryTest
- name: APP_SESSION_REDIS_KEY_HMAC_SECRET
# 가명 Redis session key에 쓰는, 바뀌지 않는 비공개 파생 자료.
@@ -175,7 +180,7 @@ secrets:
owner_branch: redis-production-capability
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:session-redis-key-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET
# owner-safe 요청 replay key가 tenant·scope·요청 식별자를 드러내면 안 된다.
@@ -189,7 +194,7 @@ secrets:
owner_branch: redis-production-capability-completion
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:idempotency-redis-key-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_LEASE_REDIS_KEY_HMAC_SECRET
# 효율 lease의 자원·소유자 scope는 전용 파생 key를 쓴다.
@@ -203,7 +208,7 @@ secrets:
owner_branch: redis-production-capability-completion
masking_rule: full
compatibility_impact: additive
required_test: secrets-contract:lease-redis-key-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_PRIVACY_PSEUDONYMIZATION_SALT
# source: feature-data-retention-privacy-contract 2026-05-22
@@ -218,7 +223,7 @@ secrets:
owner_branch: feature-data-retention-privacy-contract
masking_rule: full
compatibility_impact: breaking
required_test: secrets-contract:pseudonymization-salt-rotation
required_test: SecretSourceValidatorTest
# === 2등급: sensitive-config (토큰이 든 URL이나 노출을 제한할 id) ===
@@ -235,7 +240,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-contact-encryption-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY
# 연락처의 blind index. 조회에 평문이 필요 없게 한다.
@@ -250,7 +255,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-contact-lookup-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY
# provider가 전달 결과를 보내는 callback URL에 서명한다.
@@ -265,7 +270,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-callback-signing-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY
# 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다.
@@ -280,7 +285,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-provider-credential-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY
# 저장된 알림 변수와 보관한 callback 본문을 암호화한다.
@@ -295,7 +300,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-payload-encryption-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY
# provider 쪽 식별자인 provider request id의 key 있는 hash.
@@ -310,7 +315,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-provider-request-lookup-hmac-no-leak
required_test: SecretSourceValidatorTest
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY
# callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다.
@@ -325,35 +330,7 @@ secrets:
owner_branch: worktree-notification-platform
masking_rule: full
compatibility_impact: behavior-change
required_test: secrets-contract:notification-callback-fingerprint-hmac-no-leak
- name: APP_NOTIFICATION_SLACK_WEBHOOK_URL
# source: feature-integration-adapter-templates 2026-05-22
# "Slack | disabled optional module | notification failure policy"
# Slack webhook URL은 token을 path에 포함하므로 sensitive-config (URL 형태이지만 secret과 동급 취급)
classification: sensitive-config
source: secret-manager
rotation_policy: manual
prod_default: null
dev_sentinel_prefix: __LOCAL_DEV_
owner_branch: feature-secrets-config-source-contract
masking_rule: full_except_last_4
compatibility_impact: breaking
required_test: secrets-contract:slack-webhook-no-leak
- name: APP_SECURITY_GOOGLE_OAUTH_CLIENT_ID
# source: feature-secrets-config-source-contract 2026-05-22
# "sensitive-config" 등급 (id이지만 노출 제한)
# + feature-integration-adapter-templates "Google Email | disabled optional module"
classification: sensitive-config
source: mounted-env
rotation_policy: manual
prod_default: null
dev_sentinel_prefix: __LOCAL_DEV_
owner_branch: feature-secrets-config-source-contract
masking_rule: full_except_last_4
compatibility_impact: behavior-change
required_test: secrets-contract:google-oauth-client-id-masked
required_test: SecretSourceValidatorTest
- name: APP_DATASOURCE_USERNAME
# source: feature-secrets-config-source-contract 2026-05-22 — "sensitive-config" 등급
@@ -364,9 +341,9 @@ secrets:
prod_default: null
dev_sentinel_prefix: __LOCAL_DEV_
owner_branch: feature-secrets-config-source-contract
masking_rule: full_except_last_4
masking_rule: none
compatibility_impact: breaking
required_test: secrets-contract:datasource-username-masked-in-actuator
required_test: SecretsClassificationRegistryTest
- name: SPRING_MONGODB_URI
# MongoDB URI에는 사용자 이름·비밀번호가 들어 있을 수 있어 public config로 로그에 남기면 안 된다.
@@ -377,9 +354,9 @@ secrets:
prod_default: null
dev_sentinel_prefix: __LOCAL_DEV_
owner_branch: persistence-mongo-runtime-remediation
masking_rule: full_except_last_4
masking_rule: userinfo
compatibility_impact: additive
required_test: secrets-contract:mongodb-uri-masked
required_test: LogMaskingPatternsTest
- name: APP_DATASOURCE_URL
# source: feature-secrets-config-source-contract 2026-05-22 — JDBC URL은 host/db 포함하므로 sensitive-config
@@ -390,20 +367,12 @@ secrets:
prod_default: null
dev_sentinel_prefix: __LOCAL_DEV_
owner_branch: feature-secrets-config-source-contract
masking_rule: full_except_last_4
masking_rule: userinfo
compatibility_impact: breaking
required_test: secrets-contract:datasource-url-masked-in-actuator
required_test: LogMaskingPatternsTest
# === 1등급: public-config (참조만 — 행 전체는 env-keys.yaml에 있다) ===
- name: APP_PROFILE
# source: feature-env-driven-runtime-configuration — public-config 등급 참조
classification: public-config
source: application-yml
owner_branch: feature-env-driven-runtime-configuration
masking_rule: none
reference: env-keys.yaml#APP_PROFILE
- name: APP_NAME
# source: feature-env-driven-runtime-configuration — public-config 등급 참조
classification: public-config
@@ -412,14 +381,6 @@ secrets:
masking_rule: none
reference: env-keys.yaml#APP_NAME
- name: SERVER_PORT
# source: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조
classification: public-config
source: application-yml
owner_branch: feature-env-driven-runtime-configuration
masking_rule: none
reference: env-keys.yaml#SERVER_PORT
- name: SPRING_PROFILES_ACTIVE
# source: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조
classification: public-config