ADR-0023: DM 표시 신원은 서버가 결정한다 (데이터/제어 2평면 경계)
- Status: Accepted
- Date: 2026-10-20
- 관련: HMH-10094 (이번 작업) · HMH-10093(현행 클라 스냅샷 DM 생성 RPC) · ADR-0018(통합 채팅 데이터 모델) · ADR-0020(chat-api 프로비저닝)
Context
통합 DM 생성 RPC cv2_create_or_get_dm(0018)은 표시 닉네임/이미지를 클라이언트가 넘긴 인자(p_my_nickname·p_peer_nickname …)로 channel_member.display_* 에 저장했다. 앱이 anon key + 사용자 JWT 를 갖고 있어 RPC 인자를 조작해 “내가 상대에게 보일 내 이름”을 위조할 수 있다(CodeRabbit Major, PR #6353 — 0013 에서 DM 신고 스냅샷을 “클라 금지→서버 생성”으로 바꾼 것과 같은 원칙).
제약이 결정을 가른다:
- DM 표시명은 “방 닉네임”(
formattedNickname, 예 “113동 홍길동”)이다 — 전역 닉네임을 넣으면 상대 화면에 그 이름으로 굳는 버그가 있었다(HMH-9641). 이 값은 백엔드 RDS 의 ChatProfile 에 있다. - Supabase RPC 는 백엔드 RDS 에 접근 못 한다(cross-DB). RPC 혼자서는 방 닉네임을 알 수 없어 서버 결정이 불가능하다.
- DM 에는 chatUrl 이 없다(
identity_scope='dm:<low>:<high>'로만 식별). 백엔드 ChatProfile 조회는/v1/chat/{chatUrl}/user/{userId}/profile로 chatUrl 기반이라, “상대를 발견한 방”의 chatUrl 을 생성 시점에 함께 넘겨야 한다.
그때 확인한 더 큰 그림: 우리 채팅은 Sendbird(닫힌 API, 클라·서버 모두 경유 필수)와 달리 Supabase + RLS 라, 클라가 DB 에 직접 붙어도 행 수준 권한이 강제된다. 이게 월 비용 703→25 달러 절감의 전제다. 따라서 “모든 작업을 단일 게이트웨이로” 통일하는 것은 그 이점을 버리는 안티패턴이고, 무엇을 클라 직접으로 두고 무엇을 서버로 올릴지의 경계가 핵심 질문이 된다.
검토한 대안
| 대안 | 채택 / 안 한 이유 |
|---|---|
| A′ front-api + custom-JWT RPC (채택) | front-api 가 verifyMe + 백엔드 ChatProfile 양쪽 조회로 display 를 서버 결정한 뒤, 호출자 본인으로 서명한 JWT 로 기존 RPC 호출. service_role 불요(dm-report 와 동일 패턴). 작업 최소·키 확산 없음. 앱 경로 위조를 봉쇄한다. |
| A″ chat-api service_role | RPC 를 service_role 전용으로 막아 직접 호출까지 완전 봉쇄. 단 chat-api 엔드포인트 확장(display 수용) + front-api→chat-api 호출 경로 필요 → DM(사적 1:1) 위협 대비 과투자. 완전 봉쇄가 필요해지면 승급 경로. |
| A″ front-api service_role | front-api 에 service_role 키 부여. chat-api 경유는 없지만 지금껏 chat-api 에만 있던 키가 front-api 로 확산(노출면 증가) → 기각. |
| B RPC 유지 + 렌더 시점 조회 | display 를 null 로 두고 렌더 때 백엔드 조회. DM 엔 chatUrl 이 없어 렌더 시점에 어느 방 프로필인지 알 수 없음 → “방 닉네임” 유지 불가 → 기각. |
Decision
DM 표시 신원은 서버가 결정한다. 데이터/제어 2평면으로 경계를 긋는다:
- 데이터 평면(메시지 송수신·리액션·읽음·차단·realtime): 클라가 custom JWT + RLS 로 Supabase 직접. 변경 없음.
- 제어 평면 — 백엔드 트리거(채널 프로비저닝·멤버, service_role): chat-api(X-Internal-Secret, ADR-0020).
- 제어 평면 — 앱 트리거(서버 결정·위조 방지·cross-DB): front-api(Bearer→custom JWT). DM 생성이 여기 해당한다.
배선:
apps/api/src/features/apiAuth.ts—fetchBackendChatProfile(authorization, chatUrl, userId): 호출자 토큰으로 백엔드 ChatProfile 조회(참여자 아니면 403).apps/api/src/app/app/community-v2/dm/route.ts—POST /app/community-v2/dm: verifyMe → ChatProfile 양쪽 서버 결정 →signSupabaseJWT(me)→cv2_create_or_get_dm(서버 결정값만 전달) → channelId.packages/api/lib/community-v2—CommunityV2API.openDm({peerId, chatUrl}).- native
ChatDmScreen.ensureChannelId가 클라 RPC(openOrCreateDmChannel) 대신openDm호출. 클라는peerId + chatUrl만 보낸다. 진입 헤더의peerNickname은 생성 전 표시용 fallback(저장 안 됨, 서버 결정값으로 대체).
RPC cv2_create_or_get_dm 자체는 바꾸지 않는다(멱등 로직 유지). 표시값의 출처만 클라→서버로 옮겼다.
Consequences
좋아지는 것
- 앱에서 상대/내 표시 신원을 위조할 수 없다(서버가 백엔드 ChatProfile 로 결정). chatUrl 방 참여자가 아니면 조회가 403.
- service_role 키 확산 없음(front-api 는 custom JWT 만). Supabase 직접-접근 이점(realtime·비용) 유지.
- “왜 메시지는 클라 직접인데 DM 생성만 서버 경유냐”의 답을 2평면 경계로 명문화.
감수하는 것
cv2_create_or_get_dm은 여전히 authenticated grant 라, 앱 바이너리를 뜯어 RPC 를 직접 호출하면 표시값 위조가 가능하다(앱 경로만 봉쇄). DM 은 사적 1:1 이라 피해가 그룹 신고 증거 위조만큼 크지 않고(운영 뱃지는 닉네임 텍스트가 아니라 백엔드 role), HMH-10093 수용 근거와 동일하게 받아들인다.- DM 생성에 왕복 1회(front-api)가 추가된다. 생성은 첫 전송 1회뿐이라 영향 미미.
- 생성 경로에 chatUrl 이 필수 — 기존 채널 진입(슬라이스 목록)은 channelId 를 이미 알아 생성을 안 타므로 chatUrl 없이 동작한다.
이 결정을 다시 열어야 할 때
- 직접 RPC 호출 위조가 실제 악용되거나 사칭 리포트가 생기면 → A″(chat-api service_role + RPC authenticated revoke)로 승급해 완전 봉쇄.
- 그룹 채팅까지 통합 이관돼 “백엔드 프로비저닝”(chat-api) 경계와 합쳐야 할 때 2평면 경계를 재점검.
Last updated on