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, 프레임워크 없음).
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)와 그 시험.
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에 연결되지 않는다.
@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행.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰의 인증·인가 묶음(B4)과 GraphQL·WebSocket 계약 묶음(B11b), 그리고 같은 파일을 고치는 WebSocket 로그 발견 하나(RR9-02-25, B6a에서 옮김)를 고친다. 파생 서비스가 그대로 물려받는 인가 빈틈이다.
SecurityContext에 넣지 않아@RequiresPermission유스케이스가 권한 있는 호출자도 거부했고, 거부는 web 403, gRPCINTERNAL+ERROR, GraphQL 가린INTERNAL_ERROR+ERROR로 갈렸다.User.salary규칙이 판정되지 않아 누구나 그 field를 읽었다.SPRING_PROFILES_ACTIVE=test로 떴다(RR9-02-20). prod 검사(비밀 sentinel, 파일 서버 인가 등)가 모두 꺼졌다.rolesclaim을 권한으로 읽었다.sub없는 token이 통과해 뒤에서 500이 됐고, 틀린 tenant claim은 문자열 매칭으로AUTH_TOKEN_MALFORMED였다.tenant_id가 없었고, GraphQL은 대소문자 구분으로 비교했고, 익명 요청 tenant 출처가SYSTEM이었고, 죽은 검사와 틀린 Javadoc이 있었다.maxInputListElements계약이 실제보다 넓었다(RR9-02-31). STOMP ERROR frame이 code만 싣고 원인 사슬 어디의 IAE든BAD_PARAMETER로 봤다(RR9-03-14). cursor·connection 예외가 「안정 코드」라면서INTERNAL_ERROR+ERROR가 됐다(RR9-03-29).AUTH_TOKEN_MALFORMED로 분류됐다. 503AUTH_JWKS_UNAVAILABLE로 답한다.고른 방법과 버린 대안
AuthorizationDeniedException을AUTHZ_INSUFFICIENT_PERMISSIONcarrier로 만들고 method security가 그것을 그대로 던진다. 전송마다 있는 carrier 대응이 같은 코드로 답한다. 버린 안: 전송마다AccessDeniedException대응 추가(네 곳에 같은 표).SecurityContext에 둔다(spring-security-core의존, lockfile 갱신). gRPC는 끝나면 그 thread에 있던 context로 되돌린다.sub없음·틀린 tenant는 401AUTH_CLAIM_MAPPING_FAILED다. callback은 profile을 먼저 찾고 없으면 감사 없이 400이다.TenantId.namesATenant하나로 모은다(application-core, 프레임워크 없음).MessagingException포장을 벗긴 실패 자신만 IAE로 보고,error-retryable(모든 frame)·error-category(등록된 코드) header를 더한다.정한 기본값
Principal호출자(gRPC·STOMP)는 권한 없는 인증 token으로 둔다. 역할은 web의AuthenticatedPrincipal일 때만 읽는다.ANONYMOUS(값public)이고 거부하지 않는다. 공개 DataLoader가 그 tenant로 돈다.maxInputListElements는 구현을 넓히지 않고 계약 문서를 실제 검사 범위로 좁혔다.CALLBACK_PAYLOAD_REJECTED)이다._Service같은 이름)은 판정하지 않고 읽힌다. root 좌표는 이름이 틀리면 닫힌 채 실패한다.platformCodes()에 더한다(graphql AGENTS에 예외로 적음).위험과 영향
sub없음 401, JWKS 재조회 실패 503, 모르는 callback 400, test profile 기동 실패, GraphQL cursor·connection 코드, STOMP header. 할 일은docs/upgrade/2026-11-round9-authz.md113행이다(B4 111행, B11b 12~13행).ProviderCallbackAdapterRegistry.require가find로 바뀌어 직접 구현한 서비스는 컴파일이 깨진다.2f0aefad)은 따로 돌리지 않았다. desktop 검증은 head 트리 기준이다.@RequiresPermission거부가PERMISSION_DENIED가 되는 end-to-end wire 시험은 없다(단위 시험 조합으로 확인).검증
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 verifyDependencyLocksrc=0(시험 2723건, 실패 0).scripts/verify.sh pr: rc=0(트리d85b60d3, 시험 6877건, 실패 0, 건너뜀 35). 처음 돌렸을 때 SpotBugs가 web-advanced에서 실패해(PatchAuthorizationException이Stream.toList()목록을 그대로 돌려줌)List.copyOf로 고친 뒤 통과했다.리뷰어가 볼 곳
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.발견 판정
2f0aefad2f0aefad2f0aefad2f0aefad2f0aefad2f0aefad2f0aefad2f0aefad2f0aefad01caee3c01caee3c01caee3c01caee3c관련
docs/reviews/2026-11-12-round9-review/(색인 「묶음」 B4·B11b, RR9-02-25는 B6a).auth-jwks-unavailable.md에 적은 「캐시가 지난 뒤 503」은 이 PR의 분류 수정이 만든다.GraphQlResolverObservationConvention·GraphQlDataLoaderObservationConventionbean이 Spring observation에 연결되지 않는다.@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행.