Files
messaging-library/docs/messaging/security.md
T

5.0 KiB

Messaging 보안

Credential 분리

producer / consumer / admin은 서로 다른 credential이다. MessageSecurityValidator가 startup에서 강제한다.

producer credential == consumer credential  → 실패
admin credential == producer|consumer       → 실패
production 프로필에 admin credential 존재    → 실패

마지막 규칙이 "애플리케이션은 topic을 purge할 수 없다"를 구조적으로 만든다. runtime이 admin 자격 증명을 아예 보유하지 않으므로, 침해된 handler가 상승시킬 대상이 없다.

Production 필수 조건

  • TLS 활성
  • TLS hostname verification 활성
  • broker authentication 활성
  • topology auto-create 비활성

Kafka는 추가로 enable.idempotence=true, acks=all, max.in.flight.requests.per.connection <= 5, consumer auto-commit 금지.

RabbitMQ는 추가로 publisher confirm, publisher return, mandatory=true, durable work queue의 quorum queue, consumer auto-ack 금지.

Credential은 값이 아니라 참조다

BrokerCredentialProfile의 어떤 variant도 secret을 담지 않는다. 식별자만 보관하고 connect 시점에 CredentialProvider로 해석한다. heap dump나 설정 출력에서 사용 가능한 credential이 나오지 않는다.

CredentialIds는 bearer , sk-, -----begin, eyJ 같은 접두사를 거부한다. 참조가 들어갈 자리에 secret 자체를 붙여넣는 가장 흔한 사고를 막는다.

SASL(PLAIN·SCRAM) 사용자 이름도 CredentialProvider.username(credentialId)가 준다. credential id는 저장소 안의 참조이지 broker가 아는 사용자 이름이 아니다. provider가 이름을 주지 않으면 기동에 실패한다.

key store·trust store는 경로만 설정에 둔다. 비밀번호는 credential id로 provider가 해석한다 (configuration-reference.md 보안 절).

Rotation

CredentialRotationPlan.isDue()는 만료 전에 참이 된다. broker가 연결을 거부하기 시작한 시점에는 이미 publish가 실패하고 consumer가 멈춰 있다.

Kafka SASL credential은 producer를 다시 만들지 않고 바뀐다. JAAS 설정에는 login module 이름만 있고, KafkaCredentialCallbackHandler가 연결이 인증할 때마다 CredentialRuntimeRegistry에서 사용자 이름과 비밀번호를 읽는다. registry는 provider가 준 만료 시각의 rotation lead(기본 30분) 안으로 들어오면 새로 가져오므로, 새 연결과 재인증(broker connections.max.reauth.ms)이 새 값을 쓴다. 만료 시각을 주지 않는 provider의 credential은 캐시된 값을 계속 쓴다.

key store·trust store 비밀번호는 예외다. Kafka가 SSL context를 만들 때 한 번 읽으므로 바꾸려면 producer를 다시 만들어야 한다(재기동).

transport 세대 교체(DefaultMessagingRuntimeRegistry.install())는 transport 자체를 바꿀 때 쓴다. 새 세대를 원자적으로 게시하고, 이전 세대는 마지막 lease가 닫힐 때까지 열려 있다가 닫힌다. drain deadline이 이 대기를 제한한다.

Header

금지 header는 application·platform 양쪽에서 거부한다.

Authorization, Proxy-Authorization, Cookie, Set-Cookie,
access_token, refresh_token, api_key, password, client_secret

credential이 header에 들어가면 broker storage, DLQ dump, 운영 도구에 남는다. downstream redaction으로는 되돌릴 수 없다.

예약 header(msg.*, traceparent, tracestate, baggage)는 platform만 쓴다. application이 msg.id를 설정할 수 있으면 Inbox 중복 제거와 DLQ 상관관계가 의존하는 logical identity가 호출자 제어가 된다.

ACL

publisher가 broker ACL 이전에 검사한다(PUBLISH_FORBIDDEN). broker ACL 거부는 애플리케이션 컨텍스트가 없는 연결 수준 오류로 도착하므로 "어느 모듈이 어디에 publish하려 했는가"가 조사 대상이 된다.

publish 가능한 destination은 선언된 destination이다. broker에 app.messaging.security.<broker> 항목이 있으면 그중 access.publishable에 적힌 것만 남는다(빈 목록이면 publish 불가).

관측성 누출

MessagingRedactor는 denylist다.

  • secret: authorization, cookie, token, password, secret, credential
  • per-message identity: messageId, correlationId, causationId, partitionKey, key, offset, deliveryTag, sequence
  • payload: payload, body, data
  • 예외 상세: exceptionMessage, stackTrace

identity를 지우는 이유는 두 가지다. bounded metric을 message당 하나의 series로 만들고, support log를 재식별 표면으로 만들기 때문이다.

CardinalityGuard는 dimension당 값 개수를 상한한다. cardinality 사고는 점진적이지 않다. 테스트 10건에서는 멀쩡하고 운영에서 백엔드를 죽인다.

감사

MessagingAuditEvent는 replay, redrive, offset reset, purge, delete를 기록한다. subject(운영자 identity), approval ticket, 그리고 redactor를 통과한 details만 담는다. 누가 무엇을 했는지 증명하되 payload의 두 번째 사본이 되지 않는다.