fix(security)!: 모든 전송이 같은 호출자로 권한을 판정하고 JWT·tenant 빈틈을 막는다 #31

Merged
donghyeon.kang merged 3 commits from claude/r9-a-authz into main 2026-11-13 04:44:08 +00:00
Owner

무엇을, 왜

round9 리뷰의 인증·인가 묶음(B4)과 GraphQL·WebSocket 계약 묶음(B11b), 그리고 같은 파일을 고치는 WebSocket 로그 발견 하나(RR9-02-25, B6a에서 옮김)를 고친다. 파생 서비스가 그대로 물려받는 인가 빈틈이다.

  • 권한 검사가 web 밖에서 늘 거부하고 코드도 달랐다(RR9-02-18). gRPC·STOMP는 인증한 호출자를 SecurityContext에 넣지 않아 @RequiresPermission 유스케이스가 권한 있는 호출자도 거부했고, 거부는 web 403, gRPC INTERNAL+ERROR, GraphQL 가린 INTERNAL_ERROR+ERROR로 갈렸다.
  • GraphQL 정책이 하위 좌표 규칙을 받고 버렸다(RR9-02-17). User.salary 규칙이 판정되지 않아 누구나 그 field를 읽었다.
  • 배포 jar가 SPRING_PROFILES_ACTIVE=test로 떴다(RR9-02-20). prod 검사(비밀 sentinel, 파일 서버 인가 등)가 모두 꺼졌다.
  • JWT 변환(RR9-02-02·02-23). client 없는 최상위 roles claim을 권한으로 읽었다. sub 없는 token이 통과해 뒤에서 500이 됐고, 틀린 tenant claim은 문자열 매칭으로 AUTH_TOKEN_MALFORMED였다.
  • 알림 callback(RR9-02-16). 인증 없는 POST가 모르는 profile을 보내면 500 + ERROR였고, 크기·형식 검사가 먼저라 공격자 문자열이 보안 감사 WARN에 남았다.
  • patch 거부(RR9-02-28). 요청이 쓴 이름을 메시지·details에 제한 없이 되풀이했다.
  • tenant 규칙(RR9-02-29). web 거부 목록에 tenant_id가 없었고, GraphQL은 대소문자 구분으로 비교했고, 익명 요청 tenant 출처가 SYSTEM이었고, 죽은 검사와 틀린 Javadoc이 있었다.
  • B11b. STOMP broadcast가 모든 인증 세션에 가는데 규칙이 없었다(RR9-02-19). maxInputListElements 계약이 실제보다 넓었다(RR9-02-31). STOMP ERROR frame이 code만 싣고 원인 사슬 어디의 IAE든 BAD_PARAMETER로 봤다(RR9-03-14). cursor·connection 예외가 「안정 코드」라면서 INTERNAL_ERROR+ERROR가 됐다(RR9-03-29).
  • RR9-02-25. STOMP 거부가 자기 로그를 남기지 않았고, 설정 주석이 순서를 틀리게 적었다.
  • 고치며 찾음. decoder를 만든 뒤 JWKS 재조회(모르는 kid, 키 캐시 만료)를 IdP가 받지 않으면 라이브러리 문구 때문에 401 AUTH_TOKEN_MALFORMED로 분류됐다. 503 AUTH_JWKS_UNAVAILABLE로 답한다.

고른 방법과 버린 대안

  • AuthorizationDeniedException을 AUTHZ_INSUFFICIENT_PERMISSION carrier로 만들고 method security가 그것을 그대로 던진다. 전송마다 있는 carrier 대응이 같은 코드로 답한다. 버린 안: 전송마다 AccessDeniedException 대응 추가(네 곳에 같은 표).
  • gRPC listener callback과 STOMP frame 처리 동안 호출자를 SecurityContext에 둔다(spring-security-core 의존, lockfile 갱신). gRPC는 끝나면 그 thread에 있던 context로 되돌린다.
  • GraphQL 실행 전 판정이 selection마다 「돌 수 있는 object 타입 집합」을 들고 문서를 걷는다. 집합에 root 타입이 있으면 root 좌표(deny-by-default), 나머지는 규칙이 있을 때만 판정하고 그 object들과 그 interface 좌표의 규칙을 모두 본다. fragment는 집합마다 한 번 펼친다. 버린 안: 쓰인 타입 하나로만 판정(interface·union으로 규칙을 피하고, interface로 고른 root field가 deny-by-default를 빠져나간다 — 리뷰 중 실제로 찾은 우회).
  • 배포 산출물은 test profile을 기동 실패로 거부한다. JWT는 최상위 roles를 버리고, sub 없음·틀린 tenant는 401 AUTH_CLAIM_MAPPING_FAILED다. callback은 profile을 먼저 찾고 없으면 감사 없이 400이다.
  • tenant 입력 이름 어휘를 TenantId.namesATenant 하나로 모은다(application-core, 프레임워크 없음).
  • STOMP 오류 처리기는 MessagingException 포장을 벗긴 실패 자신만 IAE로 보고, error-retryable(모든 frame)·error-category(등록된 코드) header를 더한다.
  • broadcast는 규칙(모든 tenant의 인증 사용자가 읽어도 되는 것만)을 문서로 적는다. 버린 안: destination을 tenant별로 나누기(projector가 tenant를 모르고 simple broker는 R1 증거라 범위 밖).

정한 기본값

  • plain Principal 호출자(gRPC·STOMP)는 권한 없는 인증 token으로 둔다. 역할은 web의 AuthenticatedPrincipal일 때만 읽는다.
  • 익명 GraphQL 요청의 tenant 출처는 ANONYMOUS(값 public)이고 거부하지 않는다. 공개 DataLoader가 그 tenant로 돈다.
  • maxInputListElements는 구현을 넓히지 않고 계약 문서를 실제 검사 범위로 좁혔다.
  • 모르는 profile의 callback은 감사·로그 없이 400(CALLBACK_PAYLOAD_REJECTED)이다.
  • 규칙이 이름 붙일 수 없는 하위 GraphQL 타입(_Service 같은 이름)은 판정하지 않고 읽힌다. root 좌표는 이름이 틀리면 닫힌 채 실패한다.
  • 서비스 resolver가 부르는 pagination 라이브러리 거부 코드는 platformCodes()에 더한다(graphql AGENTS에 예외로 적음).

위험과 영향

  • 응답이 바뀐다: gRPC·GraphQL 권한 거부 코드, sub 없음 401, JWKS 재조회 실패 503, 모르는 callback 400, test profile 기동 실패, GraphQL cursor·connection 코드, STOMP header. 할 일은 docs/upgrade/2026-11-round9-authz.md 113행이다(B4 111행, B11b 12~13행).
  • ProviderCallbackAdapterRegistry.require가 find로 바뀌어 직접 구현한 서비스는 컴파일이 깨진다.
  • GraphQL 인가가 전보다 많이 거부할 수 있다: interface·union·fragment를 거쳐 root 타입에 닿는 선택, 하위 좌표 규칙. 의도한 변화다.
  • 중간 커밋(2f0aefad)은 따로 돌리지 않았다. desktop 검증은 head 트리 기준이다.
  • gRPC handler 안의 @RequiresPermission 거부가 PERMISSION_DENIED가 되는 end-to-end wire 시험은 없다(단위 시험 조합으로 확인).

검증

  • desktop(트리 b38b9406, SpotBugs 수정 한 줄 전): lockfile 재생성(grpc·websocket·app-bootstrap) 뒤 spotlessApply, :adapter:inbound:web:check :adapter:inbound:web:systemTest :adapter:inbound:web-advanced:check :adapter:inbound:graphql:check :adapter:inbound:graphql:systemTest :adapter:inbound:grpc:check :adapter:inbound:grpc:grpcTransportQualificationTest :adapter:inbound:websocket:check :adapter:inbound:websocket:systemTest :composition:notification-platform:check :application-core:check :adapter:outbound:notification:check :app-bootstrap:test :app-bootstrap:architectureTest :app-bootstrap:documentContractTest verifyDependencyLocks rc=0(시험 2723건, 실패 0).
  • desktop scripts/verify.sh pr: rc=0(트리 d85b60d3, 시험 6877건, 실패 0, 건너뜀 35). 처음 돌렸을 때 SpotBugs가 web-advanced에서 실패해(PatchAuthorizationException이 Stream.toList() 목록을 그대로 돌려줌) List.copyOf로 고친 뒤 통과했다.
  • 그 뒤 main에 들어온 #29(테스트 실패 로그 형식·task 설명·시험 단언 메시지, 이 PR과 겹치는 파일 없음) 위로 옮겼다. 옮긴 트리는 다시 돌리지 않았다.
  • RED: 새 시험은 고치기 전 트리에서 실패했다(초기 묶음). JWKS 재조회 503 통합 시험은 실제 Nimbus 재조회로 503을 확인한다.
  • 새 눈 리뷰 4회(인가·계약 1·2차, 구조 1회, 셋을 묶은 3차, GraphQL walk 4차). 마지막 지적까지 모두 고쳤다.

리뷰어가 볼 곳

  • src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlDocumentAuthorizationHandler.java(CoordinateWalk)와 그 시험.
  • GrpcAuthenticationInterceptor, WebSocketSecurityContextInterceptor, RequiresPermissionAuthorizationManager, SecurityErrorClassifier.
  • docs/upgrade/2026-11-round9-authz.md.

발견 판정

발견 판정 커밋
RR9-02-02 고침 2f0aefad
RR9-02-16 고침 2f0aefad
RR9-02-17 고침 2f0aefad
RR9-02-18 고침 2f0aefad
RR9-02-20 고침 2f0aefad
RR9-02-23 고침 2f0aefad
RR9-02-25 고침 2f0aefad
RR9-02-28 고침 2f0aefad
RR9-02-29 고침 2f0aefad
RR9-02-19 고침 01caee3c
RR9-02-31 고침 01caee3c
RR9-03-14 고침 01caee3c
RR9-03-29 고침 01caee3c

관련

  • 2026-11-12 전체 리뷰 docs/reviews/2026-11-12-round9-review/(색인 「묶음」 B4·B11b, RR9-02-25는 B6a).
  • 같은 묶음의 runbook PR(#30)이 auth-jwks-unavailable.md에 적은 「캐시가 지난 뒤 503」은 이 PR의 분류 수정이 만든다.
  • 범위 밖으로 남긴 것: graphql GraphQlResolverObservationConvention·GraphQlDataLoaderObservationConvention bean이 Spring observation에 연결되지 않는다.
## 무엇을, 왜 round9 리뷰의 인증·인가 묶음(B4)과 GraphQL·WebSocket 계약 묶음(B11b), 그리고 같은 파일을 고치는 WebSocket 로그 발견 하나(RR9-02-25, B6a에서 옮김)를 고친다. 파생 서비스가 그대로 물려받는 인가 빈틈이다. - **권한 검사가 web 밖에서 늘 거부하고 코드도 달랐다(RR9-02-18).** gRPC·STOMP는 인증한 호출자를 `SecurityContext`에 넣지 않아 `@RequiresPermission` 유스케이스가 권한 있는 호출자도 거부했고, 거부는 web 403, gRPC `INTERNAL`+ERROR, GraphQL 가린 `INTERNAL_ERROR`+ERROR로 갈렸다. - **GraphQL 정책이 하위 좌표 규칙을 받고 버렸다(RR9-02-17).** `User.salary` 규칙이 판정되지 않아 누구나 그 field를 읽었다. - **배포 jar가 `SPRING_PROFILES_ACTIVE=test`로 떴다(RR9-02-20).** prod 검사(비밀 sentinel, 파일 서버 인가 등)가 모두 꺼졌다. - **JWT 변환(RR9-02-02·02-23).** client 없는 최상위 `roles` claim을 권한으로 읽었다. `sub` 없는 token이 통과해 뒤에서 500이 됐고, 틀린 tenant claim은 문자열 매칭으로 `AUTH_TOKEN_MALFORMED`였다. - **알림 callback(RR9-02-16).** 인증 없는 POST가 모르는 profile을 보내면 500 + ERROR였고, 크기·형식 검사가 먼저라 공격자 문자열이 보안 감사 WARN에 남았다. - **patch 거부(RR9-02-28).** 요청이 쓴 이름을 메시지·details에 제한 없이 되풀이했다. - **tenant 규칙(RR9-02-29).** web 거부 목록에 `tenant_id`가 없었고, GraphQL은 대소문자 구분으로 비교했고, 익명 요청 tenant 출처가 `SYSTEM`이었고, 죽은 검사와 틀린 Javadoc이 있었다. - **B11b.** STOMP broadcast가 모든 인증 세션에 가는데 규칙이 없었다(RR9-02-19). `maxInputListElements` 계약이 실제보다 넓었다(RR9-02-31). STOMP ERROR frame이 code만 싣고 원인 사슬 어디의 IAE든 `BAD_PARAMETER`로 봤다(RR9-03-14). cursor·connection 예외가 「안정 코드」라면서 `INTERNAL_ERROR`+ERROR가 됐다(RR9-03-29). - **RR9-02-25.** STOMP 거부가 자기 로그를 남기지 않았고, 설정 주석이 순서를 틀리게 적었다. - **고치며 찾음.** decoder를 만든 뒤 JWKS 재조회(모르는 kid, 키 캐시 만료)를 IdP가 받지 않으면 라이브러리 문구 때문에 401 `AUTH_TOKEN_MALFORMED`로 분류됐다. 503 `AUTH_JWKS_UNAVAILABLE`로 답한다. ## 고른 방법과 버린 대안 - `AuthorizationDeniedException`을 `AUTHZ_INSUFFICIENT_PERMISSION` carrier로 만들고 method security가 그것을 그대로 던진다. 전송마다 있는 carrier 대응이 같은 코드로 답한다. 버린 안: 전송마다 `AccessDeniedException` 대응 추가(네 곳에 같은 표). - gRPC listener callback과 STOMP frame 처리 동안 호출자를 `SecurityContext`에 둔다(`spring-security-core` 의존, lockfile 갱신). gRPC는 끝나면 그 thread에 있던 context로 되돌린다. - GraphQL 실행 전 판정이 selection마다 「돌 수 있는 object 타입 집합」을 들고 문서를 걷는다. 집합에 root 타입이 있으면 root 좌표(deny-by-default), 나머지는 규칙이 있을 때만 판정하고 그 object들과 그 interface 좌표의 규칙을 모두 본다. fragment는 집합마다 한 번 펼친다. 버린 안: 쓰인 타입 하나로만 판정(interface·union으로 규칙을 피하고, interface로 고른 root field가 deny-by-default를 빠져나간다 — 리뷰 중 실제로 찾은 우회). - 배포 산출물은 test profile을 기동 실패로 거부한다. JWT는 최상위 roles를 버리고, `sub` 없음·틀린 tenant는 401 `AUTH_CLAIM_MAPPING_FAILED`다. callback은 profile을 먼저 찾고 없으면 감사 없이 400이다. - tenant 입력 이름 어휘를 `TenantId.namesATenant` 하나로 모은다(application-core, 프레임워크 없음). - STOMP 오류 처리기는 `MessagingException` 포장을 벗긴 실패 자신만 IAE로 보고, `error-retryable`(모든 frame)·`error-category`(등록된 코드) header를 더한다. - broadcast는 규칙(모든 tenant의 인증 사용자가 읽어도 되는 것만)을 문서로 적는다. 버린 안: destination을 tenant별로 나누기(projector가 tenant를 모르고 simple broker는 R1 증거라 범위 밖). ## 정한 기본값 - plain `Principal` 호출자(gRPC·STOMP)는 권한 없는 인증 token으로 둔다. 역할은 web의 `AuthenticatedPrincipal`일 때만 읽는다. - 익명 GraphQL 요청의 tenant 출처는 `ANONYMOUS`(값 `public`)이고 거부하지 않는다. 공개 DataLoader가 그 tenant로 돈다. - `maxInputListElements`는 구현을 넓히지 않고 계약 문서를 실제 검사 범위로 좁혔다. - 모르는 profile의 callback은 감사·로그 없이 400(`CALLBACK_PAYLOAD_REJECTED`)이다. - 규칙이 이름 붙일 수 없는 하위 GraphQL 타입(`_Service` 같은 이름)은 판정하지 않고 읽힌다. root 좌표는 이름이 틀리면 닫힌 채 실패한다. - 서비스 resolver가 부르는 pagination 라이브러리 거부 코드는 `platformCodes()`에 더한다(graphql AGENTS에 예외로 적음). ## 위험과 영향 - 응답이 바뀐다: gRPC·GraphQL 권한 거부 코드, `sub` 없음 401, JWKS 재조회 실패 503, 모르는 callback 400, test profile 기동 실패, GraphQL cursor·connection 코드, STOMP header. 할 일은 `docs/upgrade/2026-11-round9-authz.md` 1~13행이다(B4 1~11행, B11b 12~13행). - `ProviderCallbackAdapterRegistry.require`가 `find`로 바뀌어 직접 구현한 서비스는 컴파일이 깨진다. - GraphQL 인가가 전보다 많이 거부할 수 있다: interface·union·fragment를 거쳐 root 타입에 닿는 선택, 하위 좌표 규칙. 의도한 변화다. - 중간 커밋(2f0aefad)은 따로 돌리지 않았다. desktop 검증은 head 트리 기준이다. - gRPC handler 안의 `@RequiresPermission` 거부가 `PERMISSION_DENIED`가 되는 end-to-end wire 시험은 없다(단위 시험 조합으로 확인). ## 검증 - desktop(트리 `b38b9406`, SpotBugs 수정 한 줄 전): lockfile 재생성(grpc·websocket·app-bootstrap) 뒤 `spotlessApply`, `:adapter:inbound:web:check :adapter:inbound:web:systemTest :adapter:inbound:web-advanced:check :adapter:inbound:graphql:check :adapter:inbound:graphql:systemTest :adapter:inbound:grpc:check :adapter:inbound:grpc:grpcTransportQualificationTest :adapter:inbound:websocket:check :adapter:inbound:websocket:systemTest :composition:notification-platform:check :application-core:check :adapter:outbound:notification:check :app-bootstrap:test :app-bootstrap:architectureTest :app-bootstrap:documentContractTest verifyDependencyLocks` rc=0(시험 2723건, 실패 0). - desktop `scripts/verify.sh pr`: rc=0(트리 `d85b60d3`, 시험 6877건, 실패 0, 건너뜀 35). 처음 돌렸을 때 SpotBugs가 web-advanced에서 실패해(`PatchAuthorizationException`이 `Stream.toList()` 목록을 그대로 돌려줌) `List.copyOf`로 고친 뒤 통과했다. - 그 뒤 main에 들어온 #29(테스트 실패 로그 형식·task 설명·시험 단언 메시지, 이 PR과 겹치는 파일 없음) 위로 옮겼다. 옮긴 트리는 다시 돌리지 않았다. - RED: 새 시험은 고치기 전 트리에서 실패했다(초기 묶음). JWKS 재조회 503 통합 시험은 실제 Nimbus 재조회로 503을 확인한다. - 새 눈 리뷰 4회(인가·계약 1·2차, 구조 1회, 셋을 묶은 3차, GraphQL walk 4차). 마지막 지적까지 모두 고쳤다. ## 리뷰어가 볼 곳 - `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlDocumentAuthorizationHandler.java`(`CoordinateWalk`)와 그 시험. - `GrpcAuthenticationInterceptor`, `WebSocketSecurityContextInterceptor`, `RequiresPermissionAuthorizationManager`, `SecurityErrorClassifier`. - `docs/upgrade/2026-11-round9-authz.md`. ## 발견 판정 | 발견 | 판정 | 커밋 | |---|---|---| | RR9-02-02 | 고침 | 2f0aefad | | RR9-02-16 | 고침 | 2f0aefad | | RR9-02-17 | 고침 | 2f0aefad | | RR9-02-18 | 고침 | 2f0aefad | | RR9-02-20 | 고침 | 2f0aefad | | RR9-02-23 | 고침 | 2f0aefad | | RR9-02-25 | 고침 | 2f0aefad | | RR9-02-28 | 고침 | 2f0aefad | | RR9-02-29 | 고침 | 2f0aefad | | RR9-02-19 | 고침 | 01caee3c | | RR9-02-31 | 고침 | 01caee3c | | RR9-03-14 | 고침 | 01caee3c | | RR9-03-29 | 고침 | 01caee3c | ## 관련 - 2026-11-12 전체 리뷰 `docs/reviews/2026-11-12-round9-review/`(색인 「묶음」 B4·B11b, RR9-02-25는 B6a). - 같은 묶음의 runbook PR(#30)이 `auth-jwks-unavailable.md`에 적은 「캐시가 지난 뒤 503」은 이 PR의 분류 수정이 만든다. - 범위 밖으로 남긴 것: graphql `GraphQlResolverObservationConvention`·`GraphQlDataLoaderObservationConvention` bean이 Spring observation에 연결되지 않는다.
donghyeon.kang added 2 commits 2026-11-13 03:25:14 +00:00
@RequiresPermission이 web 밖에서 늘 거부한다. gRPC·STOMP는 인증한
호출자를 SecurityContext에 넣지 않아 권한 있는 호출자도 거부되고, 거부는
web 403, gRPC INTERNAL+ERROR, GraphQL 가린 INTERNAL_ERROR+ERROR로 갈린다.
GraphQL 정책은 하위 좌표(User.salary) 규칙을 받고 판정하지 않는다. 배포
jar가 SPRING_PROFILES_ACTIVE=test로 떠 prod 검사가 꺼진다. JWT 변환은
최상위 roles claim을 권한으로 읽고, sub 없는 token을 통과시켜 뒤에서 500이
되고, 틀린 tenant claim을 AUTH_TOKEN_MALFORMED로 본다. 모르는 profile의
알림 callback은 500+ERROR이고 공격자 문자열을 감사 WARN에 남긴다. patch
거부는 요청이 쓴 이름을 제한 없이 되풀이한다. tenant 입력 이름 거부가
web·GraphQL에서 갈리고, 익명 GraphQL tenant 출처가 SYSTEM이다. STOMP
거부는 자기 로그가 없고 설정 주석이 순서를 틀리게 적는다.

- AuthorizationDeniedException을 AUTHZ_INSUFFICIENT_PERMISSION carrier로
  만들고 method security가 그것을 그대로 던진다. 전송마다 이미 있는
  carrier 대응이 같은 코드로 답한다(gRPC PERMISSION_DENIED, GraphQL
  FORBIDDEN). 버린 안: 전송마다 AccessDeniedException 대응 추가(네 곳에
  같은 표를 둔다).
- gRPC listener callback과 STOMP frame 처리 동안 호출자를 SecurityContext에
  둔다(spring-security-core 의존, lockfile 갱신). Authentication이면
  그대로, 아니면 권한 없는 인증 token이다. 역할은 AuthenticatedPrincipal
  에서만 읽는다.
- GraphQL 실행 전 판정이 fragment를 한 번씩 펼치며 typed parent로 좌표를
  모은다. root는 늘, 하위 좌표는 규칙이 있을 때 판정하고 interface·구현
  좌표의 규칙도 본다.
- 배포 산출물은 test profile을 기동 실패로 거부한다.
- JWT: 최상위 roles를 버리고, sub 없음·틀린 tenant는 401
  AUTH_CLAIM_MAPPING_FAILED다.
- callback은 profile을 먼저 찾고 없으면 감사 없이 400이다
  (ProviderCallbackAdapterRegistry.require → find).
- patch 거부는 이름을 16개·128자·안전 문자만 되풀이한다.
- tenant 입력 이름 어휘를 TenantId.namesATenant 하나로 모으고, 익명
  GraphQL 출처를 ANONYMOUS로 둔다(값 public, 거부는 하지 않는다 — 공개
  DataLoader가 그 tenant로 돈다).
- STOMP 거부는 사유·command만 담은 WARN 한 줄을 남긴다(session id는
  SockJS가 client URL에서 받아 뺀다).
- 고치며 찾음: decoder를 만든 뒤 JWKS 재조회를 IdP가 받지 않으면 라이브러리
  문구("…decode the Jwt: <HTTP 오류>") 때문에 401 AUTH_TOKEN_MALFORMED로
  분류됐다. 원인 사슬의 HTTP·I/O 실패를 먼저 보고 503
  AUTH_JWKS_UNAVAILABLE로 답한다.

위험: 응답이 바뀐다(gRPC·GraphQL 거부 코드, sub 없음 401, JWKS 재조회
실패 503, 모르는 callback 400, test profile 기동 실패). 할 일은
docs/upgrade/2026-11-round9-authz.md 1~11행이다. registry 구현은 find를
구현해야 컴파일된다.

검증: desktop에서 바뀐 leaf check·systemTest, :app-bootstrap:test·
architectureTest·documentContractTest, verifyDependencyLocks rc=0. 새
시험은 고치기 전 트리에서 실패했다(RED).

Refs: RR9-02-02, RR9-02-16, RR9-02-17, RR9-02-18, RR9-02-20, RR9-02-23,
  RR9-02-25, RR9-02-28, RR9-02-29
BREAKING CHANGE: gRPC·GraphQL 권한 거부 코드, JWT sub 없음·틀린 tenant
  응답, 모르는 알림 callback 응답, test profile 기동, registry require→find
  가 바뀐다. 옮기는 법은 docs/upgrade/2026-11-round9-authz.md 1~11행.
GraphQL cursor·connection 예외는 Javadoc이 「안정 요청 오류 코드」라면서
플랫폼 거부가 아니라 INTERNAL_ERROR와 ERROR 로그가 된다. STOMP ERROR
frame은 code만 싣고, 원인 사슬 어디에 IllegalArgumentException이 있든
BAD_PARAMETER로 본다(다른 전송은 실패 자신만 본다). STOMP broadcast는 모든
인증 세션에 가는데 projector가 무엇을 실어도 되는지 규칙이 없다.
maxInputListElements Javadoc은 실제보다 넓은 상한을 약속한다.

- 두 예외를 GraphQlPlatformRejection으로 만들고 GRAPHQL_CURSOR_REJECTED·
  GRAPHQL_CONNECTION_REJECTED를 catalog에 더한다.
- STOMP 오류 처리기는 MessagingException 포장을 벗긴 실패 자신만 IAE로
  보고, 등록된 코드면 error-category·error-retryable header를 더한다(gRPC
  trailer와 같은 이름·값).
- broadcast 규칙(모든 tenant의 인증 사용자가 읽어도 되는 것만)을
  projector Javadoc·README·AGENTS에 적는다. 버린 안: destination을
  tenant별로 나누기(projector가 tenant를 모르고, simple broker는 R1
  증거라 범위 밖).
- maxInputListElements Javadoc을 실제 검사 범위로 좁힌다.

위험: client가 보는 GraphQL 코드와 STOMP header가 바뀐다.
docs/upgrade/2026-11-round9-authz.md 12~13행.

검증: desktop :adapter:inbound:graphql:check·systemTest,
:adapter:inbound:websocket:check·systemTest rc=0(묶음 전체 실행).

Refs: RR9-02-19, RR9-02-31, RR9-03-14, RR9-03-29
BREAKING CHANGE: GraphQL cursor·connection 거부 코드와 STOMP ERROR frame의
  error-code(묻힌 IAE)·새 header. docs/upgrade/2026-11-round9-authz.md 12~13행.
donghyeon.kang added 1 commit 2026-11-13 03:25:55 +00:00
Merge branch 'main' into claude/r9-a-authz
pr / done (pull_request) Successful in 16m18s
ed7106a249
donghyeon.kang merged commit 3e908c02ee into main 2026-11-13 04:44:08 +00:00
donghyeon.kang deleted branch claude/r9-a-authz 2026-11-13 04:44:09 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#31