# Registry: Secrets Classification # Schema owner: feature-contract-registry-governance # Owner branch: feature-secrets-config-source-contract # Last updated: 2026-05-22 # # 표기 규칙 # - 분류는 세 등급이다 (feature-secrets-config-source-contract 2026-05-22): # public-config | sensitive-config | secret # - `secret` rows: prod_default 항상 null. dev fake 식별자는 `__LOCAL_DEV_` prefix # (feature-secrets-config-source-contract 2026-05-22: "dev/local sentinel value prefix = __LOCAL_DEV_"). # - prod profile에서 `__LOCAL_DEV_` prefix 발견 시 startup fail # (feature-secrets-config-source-contract 2026-05-22). # - prod profile에서 비밀값이 `fixture-`로 시작하면(이 저장소에 적힌 lane fixture 비밀번호 — # compose/redis/acl, compose lane의 REDIS_LANE_*) 같은 이유로 startup fail (review 2026-11-03 # RR-07-04). 비밀값만 본다: 이 파일의 `secret` 행(SecretSourceValidator.CLASSIFIED_SECRETS, # SecretsClassificationRegistryTest가 1:1로 묶음), 모듈이 기여한 비밀, `secret://…/` 참조가 # 가리키는 변수. HOSTNAME·앱 이름 같은 비밀이 아닌 값은 보지 않는다 (review 2026-11-04 RR2-04-01). # - `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만 둠. secrets: # === 3등급: secret (진짜 비밀 — password/private-key/HMAC-salt) === - name: APP_DATASOURCE_PASSWORD # source: feature-secrets-config-source-contract 2026-05-22 # "DB credential은 dual-bind 60s" + "__LOCAL_DEV_FAKE_DB_PASSWORD" 예시 classification: secret source: secret-manager # persistence-jpa가 모듈이 켜진 동안 기여한다(JpaStartupAutoConfiguration#jpaProductionSecrets). 조립 루트의 # 관문은 이제 모듈 스위치를 읽지 않는다(P22-new-1). required_when: app.persistence-jpa.enabled=true rotation_policy: dual-bind-60s prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: feature-secrets-config-source-contract masking_rule: full compatibility_impact: breaking required_test: SecretSourceValidatorTest - name: SPRING_MAIL_PASSWORD # source: notification/fileserver techlead review H2 — Spring Mail이 직접 읽는 자격 증명이라 APP_* 별칭을 두지 # 않고 일부러 SPRING_* 이름을 유지한다. classification: secret source: secret-manager rotation_policy: restart-only prod_default: null required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: 2026-09-21-notification-review-remediation masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_CACHE_REDIS_PASSWORD # source: feature-secrets-config-source-contract 2026-05-22 # 3등급 분류 "secret" + feature-integration-adapter-templates "Redis | disabled optional module" # (Redis를 켜고 인증을 쓰면 secret으로 분류) classification: secret source: secret-manager rotation_policy: restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.cache.bindings.default=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: feature-secrets-config-source-contract masking_rule: full compatibility_impact: breaking required_test: SecretSourceValidatorTest - name: APP_CACHE_REDIS_TRUST_PEM # 공개 CA bundle 내용이지만 무결성이 중요하고, 마운트된 환경이 준다. classification: sensitive-config source: mounted-env rotation_policy: restart-only prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability masking_rule: full compatibility_impact: additive required_test: SecretsClassificationRegistryTest - name: APP_CACHE_REDIS_KEY_HMAC_SECRET # 바뀌지 않는 캐시 key HMAC 자료. Redis 인증 자격 증명과 다르다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.cache.bindings.default=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: codex-phase-a-ci-recovery masking_rule: full compatibility_impact: breaking required_test: SecretSourceValidatorTest - name: APP_RATE_LIMIT_REDIS_PASSWORD # coordination role 전용 Redis 자격 증명. 캐시 Redis에서 물려받지 않는다. classification: secret source: secret-manager rotation_policy: restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.rate-limit.provider=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-distributed-rate-limit masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_RATE_LIMIT_REDIS_TRUST_PEM # coordination role CA bundle 내용. 무결성이 중요하지만 자격 증명 자료는 아니다. classification: sensitive-config source: mounted-env rotation_policy: restart-only prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability masking_rule: full compatibility_impact: additive required_test: SecretsClassificationRegistryTest - name: APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET # rate-limit 대상과 정책 개정에 쓰는, 바뀌지 않는 비공개 key 파생 자료. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.rate-limit.provider=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-distributed-rate-limit masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_SESSION_REDIS_PASSWORD # session role 전용 ACL 자격 증명. 캐시나 coordination과 몰래 함께 쓰지 않는다. classification: secret source: secret-manager rotation_policy: restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.security.auth-mode=redis-session dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_SESSION_REDIS_TRUST_PEM # session role CA bundle 내용. 무결성이 중요하지만 자격 증명 자료는 아니다. classification: sensitive-config source: mounted-env rotation_policy: restart-only prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability masking_rule: full compatibility_impact: additive required_test: SecretsClassificationRegistryTest - name: APP_SESSION_REDIS_KEY_HMAC_SECRET # 가명 Redis session key에 쓰는, 바뀌지 않는 비공개 파생 자료. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.security.auth-mode=redis-session dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET # owner-safe 요청 replay key가 tenant·scope·요청 식별자를 드러내면 안 된다. classification: secret source: secret-manager rotation_policy: cold-cutover-restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.idempotency.provider=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability-completion masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_LEASE_REDIS_KEY_HMAC_SECRET # 효율 lease의 자원·소유자 scope는 전용 파생 key를 쓴다. classification: secret source: secret-manager rotation_policy: cold-cutover-restart-only prod_default: null # app.redis.enabled=true이고 이 role을 고르면 필요하다. adapter-outbound-cache-redis의 RedisProductionSecrets가 확인한다. required_when: app.capabilities.lease.provider=redis dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: redis-production-capability-completion masking_rule: full compatibility_impact: additive required_test: SecretSourceValidatorTest - name: APP_PRIVACY_PSEUDONYMIZATION_SALT # source: feature-data-retention-privacy-contract 2026-05-22 # "pseudonymization key = HMAC-SHA-256 with rotating salt. salt rotation interval = 90일. # rotation 시 old salt 90일 retain (lookup 가능)." # + feature-tenant-context-policy "tenant identifier는 raw PII가 아니어야 하며 ... pseudonymized id" classification: secret source: secret-manager rotation_policy: salt-rotation-90d prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: feature-data-retention-privacy-contract masking_rule: full compatibility_impact: breaking required_test: SecretSourceValidatorTest # === 2등급: sensitive-config (토큰이 든 URL이나 노출을 제한할 id) === - name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY # 저장된 수신자 연락처(주소와 전화번호)를 암호화한다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY # 연락처의 blind index. 조회에 평문이 필요 없게 한다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY # provider가 전달 결과를 보내는 callback URL에 서명한다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY # 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY # 저장된 알림 변수와 보관한 callback 본문을 암호화한다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY # provider 쪽 식별자인 provider request id의 key 있는 hash. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY # callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다. # purpose별 key 일곱 중 하나다. 모두 달라야 한다: 한 key를 여러 용도에 다시 쓰면 하나가 털릴 때 일곱이 모두 # 털린다. 플랫폼은 배포가 알아챘으리라 믿지 않고 기동할 때 구별을 강제한다. classification: secret source: secret-manager rotation_policy: dual-read-restart-only prod_default: null required_when: app.notification.platform.enabled=true dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: worktree-notification-platform masking_rule: full compatibility_impact: behavior-change required_test: SecretSourceValidatorTest - name: APP_DATASOURCE_USERNAME # source: feature-secrets-config-source-contract 2026-05-22 — "sensitive-config" 등급 # (DB user는 password와 함께 노출되면 위험하므로 sensitive-config) classification: sensitive-config source: mounted-env rotation_policy: dual-bind-60s prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: feature-secrets-config-source-contract masking_rule: none compatibility_impact: breaking required_test: SecretsClassificationRegistryTest - name: SPRING_MONGODB_URI # MongoDB URI에는 사용자 이름·비밀번호가 들어 있을 수 있어 public config로 로그에 남기면 안 된다. # typed profile 배포는 URI 자체가 env 데이터가 되지 않게 uri-secret을 쓰는 편이 낫다. classification: sensitive-config source: mounted-env rotation_policy: restart-only prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: persistence-mongo-runtime-remediation masking_rule: userinfo compatibility_impact: additive required_test: LogMaskingPatternsTest - name: APP_DATASOURCE_URL # source: feature-secrets-config-source-contract 2026-05-22 — JDBC URL은 host/db 포함하므로 sensitive-config # (env-keys.yaml에서는 public-config 처리; 본 파일에서는 노출 통제 관점에서 sensitive로 재분류 — masking 기준 명시 목적) classification: sensitive-config source: mounted-env rotation_policy: restart-only prod_default: null dev_sentinel_prefix: __LOCAL_DEV_ owner_branch: feature-secrets-config-source-contract masking_rule: userinfo compatibility_impact: breaking required_test: LogMaskingPatternsTest # === 1등급: public-config (참조만 — 행 전체는 env-keys.yaml에 있다) === - name: APP_NAME # 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_NAME - name: SPRING_PROFILES_ACTIVE # 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#SPRING_PROFILES_ACTIVE - name: OTEL_EXPORTER_OTLP_ENDPOINT # source: feature-distributed-tracing-contract — public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-distributed-tracing-contract masking_rule: none reference: env-keys.yaml#OTEL_EXPORTER_OTLP_ENDPOINT