test(grpc): handler가 부른 @RequiresPermission 거부를 wire에서 확인한다

gRPC handler가 부른 @RequiresPermission 유스케이스가 권한 없는 호출자를
PERMISSION_DENIED로 돌려보내는지는 조각마다의 단위 시험으로만 본다.
인터셉터가 SecurityContext에 호출자를 두는 것, web method security가
그것을 읽는 것, 거부가 AUTHZ_INSUFFICIENT_PERMISSION carrier인 것,
예외 인터셉터가 그것을 PERMISSION_DENIED로 바꾸는 것이 따로 시험되고,
한 서버에서 함께 돌려 본 시험이 없다.

GrpcRequiresPermissionWireTest가 실제 loopback Netty 서버를 띄우고 web
어댑터의 MethodSecurityConfig·AuthorizationAdapter로 order:close 권한을
판정한다. 권한 없는 호출자는 PERMISSION_DENIED와 trailer
error-code=AUTHZ_INSUFFICIENT_PERMISSION을, 권한 있는 호출자는 같은
유스케이스의 응답을 받는다. 시험에만 :adapter:inbound:web·
:application-core를 testImplementation으로 더하고 lockfile을 다시
만든다. grpcTransportQualificationTest lane이 이 시험을 반드시 돌린다.

버린 안: app-bootstrap integrationTest에 두기. grpc 자동 설정은 모듈이
classpath에 있으면 켜지므로, app-bootstrap 시험 classpath에 grpc를
넣으면 그 leaf의 모든 시험에서 gRPC 서버 설정이 돈다. 운영 의존
(api·implementation)은 그대로라 registry edge는 바뀌지 않는다(의존
방향 검사는 운영 configuration만 본다).

위험: 시험 classpath만 커진다. gRPC lockfile을 자기 쪽에서 고친 파생
서비스는 upgrade 문서 7행대로 lockfile을 다시 만든다.

검증: desktop :adapter:inbound:grpc:check
:adapter:inbound:grpc:grpcTransportQualificationTest
:adapter:inbound:grpc:verifyDependencyLocks, scripts/verify.sh pr.

Refs: round9 그룹 A 범위 밖 후속 5
This commit is contained in:
DongHyeonka
2026-11-13 19:30:12 +09:00
parent 593615b019
commit 346f8be837
6 changed files with 271 additions and 3 deletions
+4 -1
View File
@@ -1,6 +1,6 @@
# 업그레이드 안내 — 2026-11 GraphQL 관측 tag·안 쓰는 헤더 상수·인증 설정 runbook 이름 # 업그레이드 안내 — 2026-11 GraphQL 관측 tag·안 쓰는 헤더 상수·인증 설정 runbook 이름
- 범위: 2026-11-12 전체 리뷰를 고친 뒤 남은 후속. GraphQL resolver·DataLoader 지표가 플랫폼 tag를 달고, GraphQL 지표가 요청마다 같은 tag key를 달고, 쓰는 곳 없는 `ApiHeaders` 상수 둘을 지웠고, `INTERNAL_AUTH_MISCONFIGURATION`의 runbook 이름을 내용에 맞췄다. - 범위: 2026-11-12 전체 리뷰를 고친 뒤 남은 후속. GraphQL resolver·DataLoader 지표가 플랫폼 tag를 달고, GraphQL 지표가 요청마다 같은 tag key를 달고, 쓰는 곳 없는 `ApiHeaders` 상수 둘을 지웠고, `INTERNAL_AUTH_MISCONFIGURATION`의 runbook 이름을 내용에 맞췄다. gRPC 권한 거부를 wire에서 확인하는 시험을 더했다.
- 근거: 2026-11-12 전체 리뷰(`docs/reviews/2026-11-12-round9-review/`)의 관측·인증 묶음을 고칠 때 범위 밖으로 남긴 후속 - 근거: 2026-11-12 전체 리뷰(`docs/reviews/2026-11-12-round9-review/`)의 관측·인증 묶음을 고칠 때 범위 밖으로 남긴 후속
## 1. 누가 읽나 ## 1. 누가 읽나
@@ -18,7 +18,10 @@ web `ApiHeaders` 상수를 부르는 서비스, 오류 코드의 runbook 링크
| 4 | `GraphQlResolverObservationConvention`이 내는 무게 tag 이름이 `graphql.operation.type`에서 `graphql.resolver.weight`로, `GraphQlDataLoaderObservationConvention`의 batch 크기 tag가 `graphql.complexity.bucket`에서 `graphql.batch.size.bucket`으로 바뀌었다. 두 convention은 이제 `DataFetcherObservationConvention`·`DataLoaderObservationConvention` bean(adapter)으로 Spring observation에 붙는다 | 두 convention의 `tags(...)`를 직접 불러 옛 key를 읽던 코드를 새 key로 바꾼다. 자기 `DataFetcherObservationConvention`·`DataLoaderObservationConvention` bean을 둔 서비스는 그 bean이 쓰이고 위 2·3번 tag가 붙지 않는다 | 옛 key를 찾는 코드가 빈 값을 본다 | 두 convention을 직접 쓰거나 바꾼 서비스 | | 4 | `GraphQlResolverObservationConvention`이 내는 무게 tag 이름이 `graphql.operation.type`에서 `graphql.resolver.weight`로, `GraphQlDataLoaderObservationConvention`의 batch 크기 tag가 `graphql.complexity.bucket`에서 `graphql.batch.size.bucket`으로 바뀌었다. 두 convention은 이제 `DataFetcherObservationConvention`·`DataLoaderObservationConvention` bean(adapter)으로 Spring observation에 붙는다 | 두 convention의 `tags(...)`를 직접 불러 옛 key를 읽던 코드를 새 key로 바꾼다. 자기 `DataFetcherObservationConvention`·`DataLoaderObservationConvention` bean을 둔 서비스는 그 bean이 쓰이고 위 2·3번 tag가 붙지 않는다 | 옛 key를 찾는 코드가 빈 값을 본다 | 두 convention을 직접 쓰거나 바꾼 서비스 |
| 5 | web `ApiHeaders.DEPRECATION`·`ApiHeaders.DATE` 상수를 지웠다. 운영 코드가 쓰지 않았다 | 그 상수를 부르던 코드는 자기 상수나 Spring `HttpHeaders.DATE`로 바꾼다(마지막으로 있던 커밋은 `docs/capability-status.md` 제거 표) | 컴파일이 실패한다 | 그 상수를 부르던 서비스 | | 5 | web `ApiHeaders.DEPRECATION`·`ApiHeaders.DATE` 상수를 지웠다. 운영 코드가 쓰지 않았다 | 그 상수를 부르던 코드는 자기 상수나 Spring `HttpHeaders.DATE`로 바꾼다(마지막으로 있던 커밋은 `docs/capability-status.md` 제거 표) | 컴파일이 실패한다 | 그 상수를 부르던 서비스 |
| 6 | `INTERNAL_AUTH_MISCONFIGURATION`의 `runbook_link`가 `runbook://auth/public-path-misconfiguration`에서 `runbook://auth/decoder-misconfiguration`으로, 파일이 `docs/runbooks/auth-public-path-misconfiguration.md`에서 `docs/runbooks/auth-decoder-misconfiguration.md`로 바뀌었다. 그 runbook은 `status: 운영`이라 `RunbookCoverageContractTest`의 `LEGACY_STUB_DEBT`(초안 runbook 목록)에서 빠졌다 | 옛 링크·파일 이름을 가리키는 경보·대시보드·문서를 새 이름으로 바꾼다. 옛 파일을 자기 쪽에서 고쳐 두었으면 그 내용을 새 파일로 옮기고 옛 파일을 지운다 | 경보의 runbook 링크가 없는 파일을 가리킨다. 옛 파일이 `status: 초안`으로 남으면 목록과 맞지 않아 `RunbookCoverageContractTest`가 실패한다 | 그 runbook을 쓰거나 고친 서비스 | | 6 | `INTERNAL_AUTH_MISCONFIGURATION`의 `runbook_link`가 `runbook://auth/public-path-misconfiguration`에서 `runbook://auth/decoder-misconfiguration`으로, 파일이 `docs/runbooks/auth-public-path-misconfiguration.md`에서 `docs/runbooks/auth-decoder-misconfiguration.md`로 바뀌었다. 그 runbook은 `status: 운영`이라 `RunbookCoverageContractTest`의 `LEGACY_STUB_DEBT`(초안 runbook 목록)에서 빠졌다 | 옛 링크·파일 이름을 가리키는 경보·대시보드·문서를 새 이름으로 바꾼다. 옛 파일을 자기 쪽에서 고쳐 두었으면 그 내용을 새 파일로 옮기고 옛 파일을 지운다 | 경보의 runbook 링크가 없는 파일을 가리킨다. 옛 파일이 `status: 초안`으로 남으면 목록과 맞지 않아 `RunbookCoverageContractTest`가 실패한다 | 그 runbook을 쓰거나 고친 서비스 |
| 7 | gRPC leaf의 시험 classpath에 `:adapter:inbound:web`·`:application-core`가 더해졌다(`testImplementation`, 운영 의존은 그대로). `grpcTransportQualificationTest` lane이 `GrpcRequiresPermissionWireTest`를 반드시 돌린다 | gRPC `build.gradle`이나 그 lockfile을 자기 쪽에서 고친 서비스는 merge 뒤 lockfile을 다시 만든다(`./gradlew :adapter:inbound:grpc:resolveAndLockAll --write-locks`) | lockfile 검사가 실패한다 | gRPC leaf를 고친 서비스 |
## 3. 바뀌지 않은 것 ## 3. 바뀌지 않은 것
- 지표 이름(`graphql.request`, `graphql.datafetcher`, `graphql.dataloader`)과 GraphQL 응답 모양은 그대로다. - 지표 이름(`graphql.request`, `graphql.datafetcher`, `graphql.dataloader`)과 GraphQL 응답 모양은 그대로다.
- gRPC 권한 거부의 wire 응답(`PERMISSION_DENIED`, `error-code=AUTHZ_INSUFFICIENT_PERMISSION`)도 그대로다. 이번에 더한 시험이
그것을 확인한다.
+3
View File
@@ -107,6 +107,9 @@ listener 시작이 실패한다. 정책은 `Optional<Principal> authenticate(Met
- `GrpcP1BoundaryWireTest`: 실제 loopback ephemeral Netty unary service의 auth 성공/실패, - `GrpcP1BoundaryWireTest`: 실제 loopback ephemeral Netty unary service의 auth 성공/실패,
reflection-off, handler/listener/observer/raw-status 오류 sanitization과 sentinel redaction. reflection-off, handler/listener/observer/raw-status 오류 sanitization과 sentinel redaction.
서버 한도(메시지 크기, 기본 deadline, 연결당 동시 호출, executor 포화)도 같은 wire 에서 검증한다. 서버 한도(메시지 크기, 기본 deadline, 연결당 동시 호출, executor 포화)도 같은 wire 에서 검증한다.
- `GrpcRequiresPermissionWireTest`: handler가 부른 `@RequiresPermission` 유스케이스를 web 어댑터의 method
security와 권한 port가 판정하고, 권한 없는 호출자는 wire에서 `PERMISSION_DENIED`
(`AUTHZ_INSUFFICIENT_PERMISSION`)를 받는다. web 어댑터는 이 시험에만 쓰는 `testImplementation`이다.
이 증거는 local insecure unary qualification일 뿐 production-ready 근거가 아니다. TLS/mTLS, 이 증거는 local insecure unary qualification일 뿐 production-ready 근거가 아니다. TLS/mTLS,
external bind, 메서드별 deadline, streaming/backpressure, generated protobuf 호환성은 P2로 남아 있다. external bind, 메서드별 deadline, streaming/backpressure, generated protobuf 호환성은 P2로 남아 있다.
+1
View File
@@ -136,6 +136,7 @@ handler가 metadata를 다시 해석하지 않는다. 빈 값·`null` 반환과
gRPC가 어느 executor thread에서 돌리든 넣고, 끝나면 그 thread에 먼저 있던 context로 되돌린다(없었으면 지운다). `@RequiresPermission`이 읽는 곳이 거기라서, gRPC gRPC가 어느 executor thread에서 돌리든 넣고, 끝나면 그 thread에 먼저 있던 context로 되돌린다(없었으면 지운다). `@RequiresPermission`이 읽는 곳이 거기라서, gRPC
handler가 부른 유스케이스도 web 요청과 같은 방식으로 권한을 판정한다. 권한이 없으면 handler가 부른 유스케이스도 web 요청과 같은 방식으로 권한을 판정한다. 권한이 없으면
`AuthorizationDeniedException`(`AUTHZ_INSUFFICIENT_PERMISSION`)이 아래 표대로 `PERMISSION_DENIED`가 된다. `AuthorizationDeniedException`(`AUTHZ_INSUFFICIENT_PERMISSION`)이 아래 표대로 `PERMISSION_DENIED`가 된다.
`GrpcRequiresPermissionWireTest`가 실제 서버와 wire에서 web 어댑터의 method security로 이 흐름 전체를 확인한다.
- 호출자가 Spring Security `Authentication`이면 그대로 둔다. 역할은 그 principal이 web의 `AuthenticatedPrincipal`일 - 호출자가 Spring Security `Authentication`이면 그대로 둔다. 역할은 그 principal이 web의 `AuthenticatedPrincipal`일
때만 읽힌다. 정책이 web의 JWT decoder로 token을 검증하고 `JwtToAuthenticatedPrincipalConverter`로 바꾸면 그렇다. 때만 읽힌다. 정책이 web의 JWT decoder로 token을 검증하고 `JwtToAuthenticatedPrincipalConverter`로 바꾸면 그렇다.
+6 -1
View File
@@ -47,13 +47,18 @@ dependencies {
testImplementation "io.grpc:grpc-protobuf:${grpcVersion}" testImplementation "io.grpc:grpc-protobuf:${grpcVersion}"
// Wire qualification directly uses ClientCalls/ServerCalls/MetadataUtils without generated stubs. // Wire qualification directly uses ClientCalls/ServerCalls/MetadataUtils without generated stubs.
testImplementation "io.grpc:grpc-stub:${grpcVersion}" testImplementation "io.grpc:grpc-stub:${grpcVersion}"
// Test-only: the web adapter's method security and port judge a @RequiresPermission use case a
// gRPC handler calls (GrpcRequiresPermissionWireTest), as an application that has both does.
testImplementation project(':adapter:inbound:web')
testImplementation project(':application-core')
} }
strictTestLanes { strictTestLanes {
lane('grpcTransportQualificationTest') { lane('grpcTransportQualificationTest') {
description = 'Runs exact no-skip gRPC conditional transport wire evidence.' description = 'Runs exact no-skip gRPC conditional transport wire evidence.'
requires 'dev.caskeleton.adapter.inbound.grpc.GrpcSafeActivationTest', requires 'dev.caskeleton.adapter.inbound.grpc.GrpcSafeActivationTest',
'dev.caskeleton.adapter.inbound.grpc.GrpcP1BoundaryWireTest' 'dev.caskeleton.adapter.inbound.grpc.GrpcP1BoundaryWireTest',
'dev.caskeleton.adapter.inbound.grpc.GrpcRequiresPermissionWireTest'
rejectSkipped = true rejectSkipped = true
} }
} }
+41 -1
View File
@@ -4,6 +4,12 @@
biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,testCompileClasspath biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,testCompileClasspath
ch.qos.logback:logback-classic:1.5.38=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath ch.qos.logback:logback-classic:1.5.38=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
ch.qos.logback:logback-core:1.5.38=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath ch.qos.logback:logback-core:1.5.38=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
com.fasterxml.jackson.core:jackson-annotations:2.21=testRuntimeClasspath
com.fasterxml.jackson.core:jackson-core:2.21.7=testRuntimeClasspath
com.fasterxml.jackson.core:jackson-databind:2.21.7=testRuntimeClasspath
com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.21.7=testRuntimeClasspath
com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.21.7=testRuntimeClasspath
com.fasterxml.jackson:jackson-bom:2.21.7=testRuntimeClasspath
com.fasterxml:classmate:1.7.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath com.fasterxml:classmate:1.7.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor
com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor
@@ -31,6 +37,7 @@ com.google.protobuf:protobuf-java-util:3.25.8=runtimeClasspath,testRuntimeClassp
com.google.protobuf:protobuf-java:3.25.8=annotationProcessor,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath com.google.protobuf:protobuf-java:3.25.8=annotationProcessor,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath
com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins
com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath
com.nimbusds:nimbus-jose-jwt:10.4=testRuntimeClasspath
com.puppycrawl.tools:checkstyle:13.5.0=checkstyle com.puppycrawl.tools:checkstyle:13.5.0=checkstyle
com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath
commons-beanutils:commons-beanutils:1.11.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle
@@ -52,6 +59,9 @@ io.grpc:grpc-util:1.75.0=runtimeClasspath,testRuntimeClasspath
io.micrometer:micrometer-commons:1.16.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-commons:1.16.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
io.micrometer:micrometer-observation:1.16.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-observation:1.16.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
io.perfmark:perfmark-api:0.27.0=runtimeClasspath,testRuntimeClasspath io.perfmark:perfmark-api:0.27.0=runtimeClasspath,testRuntimeClasspath
io.swagger.core.v3:swagger-annotations-jakarta:2.2.38=testRuntimeClasspath
io.swagger.core.v3:swagger-core-jakarta:2.2.38=testRuntimeClasspath
io.swagger.core.v3:swagger-models-jakarta:2.2.38=testRuntimeClasspath
jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath
jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
jakarta.validation:jakarta.validation-api:3.1.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.validation:jakarta.validation-api:3.1.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
@@ -65,7 +75,7 @@ net.minidev:json-smart:2.6.0=testCompileClasspath,testRuntimeClasspath
net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs
org.antlr:antlr4-runtime:4.13.2=checkstyle org.antlr:antlr4-runtime:4.13.2=checkstyle
org.apache.bcel:bcel:6.12.0=spotbugs org.apache.bcel:bcel:6.12.0=spotbugs
org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs,testRuntimeClasspath
org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.15.0=spotbugs
org.apache.commons:commons-text:1.3=checkstyle org.apache.commons:commons-text:1.3=checkstyle
org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle
@@ -77,7 +87,9 @@ org.apache.maven.doxia:doxia-core:1.12.0=checkstyle
org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle
org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle
org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle
org.apache.tomcat.embed:tomcat-embed-core:11.0.27=testRuntimeClasspath
org.apache.tomcat.embed:tomcat-embed-el:11.0.27=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.tomcat.embed:tomcat-embed-el:11.0.27=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.apache.tomcat.embed:tomcat-embed-websocket:11.0.27=testRuntimeClasspath
org.apache.xbean:xbean-reflect:3.7=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle
org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath
org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath
@@ -105,6 +117,7 @@ org.junit:junit-bom:6.1.0=spotbugs
org.mockito:mockito-core:5.20.0=mockitoAgent,testCompileClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=mockitoAgent,testCompileClasspath,testRuntimeClasspath
org.mockito:mockito-junit-jupiter:5.20.0=testCompileClasspath,testRuntimeClasspath org.mockito:mockito-junit-jupiter:5.20.0=testCompileClasspath,testRuntimeClasspath
org.objenesis:objenesis:3.3=testRuntimeClasspath org.objenesis:objenesis:3.3=testRuntimeClasspath
org.openapitools:jackson-databind-nullable:0.2.6=testRuntimeClasspath
org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath
org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,testCompileClasspath org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,testCompileClasspath
org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,testCompileClasspath org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,testCompileClasspath
@@ -123,25 +136,52 @@ org.slf4j:jul-to-slf4j:2.0.20=compileClasspath,runtimeClasspath,testCompileClass
org.slf4j:slf4j-api:2.0.20=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-api:2.0.20=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath
org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j
org.slf4j:slf4j-simple:2.0.20=checkstyle org.slf4j:slf4j-simple:2.0.20=checkstyle
org.springdoc:springdoc-openapi-starter-common:3.0.0=testRuntimeClasspath
org.springdoc:springdoc-openapi-starter-webmvc-api:3.0.0=testRuntimeClasspath
org.springframework.boot:spring-boot-autoconfigure:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-autoconfigure:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-configuration-processor:4.0.9=annotationProcessor org.springframework.boot:spring-boot-configuration-processor:4.0.9=annotationProcessor
org.springframework.boot:spring-boot-http-converter:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-jackson:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-security-oauth2-resource-server:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-security:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-servlet:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-jackson:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-logging:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-logging:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-starter-oauth2-resource-server:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-security:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-test:4.0.9=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-test:4.0.9=testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-tomcat:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter-validation:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-validation:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-starter-web:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-starter:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-test-autoconfigure:4.0.9=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-test-autoconfigure:4.0.9=testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-test:4.0.9=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-test:4.0.9=testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-tomcat:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-validation:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-validation:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.boot:spring-boot-web-server:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot-webmvc:4.0.9=testRuntimeClasspath
org.springframework.boot:spring-boot:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot:4.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.security:spring-security-config:7.0.8=testRuntimeClasspath
org.springframework.security:spring-security-core:7.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.security:spring-security-core:7.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.security:spring-security-crypto:7.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.security:spring-security-crypto:7.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework.security:spring-security-oauth2-core:7.0.8=testRuntimeClasspath
org.springframework.security:spring-security-oauth2-jose:7.0.8=testRuntimeClasspath
org.springframework.security:spring-security-oauth2-resource-server:7.0.8=testRuntimeClasspath
org.springframework.security:spring-security-web:7.0.8=testRuntimeClasspath
org.springframework.session:spring-session-core:4.0.5=testRuntimeClasspath
org.springframework:spring-aop:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-aop:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework:spring-beans:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-beans:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework:spring-context:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-context:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework:spring-core:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-core:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework:spring-expression:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-expression:7.0.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
org.springframework:spring-test:7.0.10=testCompileClasspath,testRuntimeClasspath org.springframework:spring-test:7.0.10=testCompileClasspath,testRuntimeClasspath
org.springframework:spring-web:7.0.10=testRuntimeClasspath
org.springframework:spring-webmvc:7.0.10=testRuntimeClasspath
org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs
org.xmlunit:xmlunit-core:2.10.4=testCompileClasspath,testRuntimeClasspath org.xmlunit:xmlunit-core:2.10.4=testCompileClasspath,testRuntimeClasspath
org.yaml:snakeyaml:2.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.yaml:snakeyaml:2.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath
tools.jackson.core:jackson-core:3.1.7=testRuntimeClasspath
tools.jackson.core:jackson-databind:3.1.7=testRuntimeClasspath
tools.jackson:jackson-bom:3.1.7=testRuntimeClasspath
empty= empty=
@@ -0,0 +1,216 @@
package dev.caskeleton.adapter.inbound.grpc;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.catchThrowableOfType;
import dev.caskeleton.adapter.inbound.web.auth.AuthenticatedPrincipal;
import dev.caskeleton.adapter.inbound.web.authz.AuthorizationAdapter;
import dev.caskeleton.adapter.inbound.web.authz.MethodSecurityConfig;
import dev.caskeleton.adapter.inbound.web.authz.RolePermissionPolicy;
import dev.caskeleton.adapter.inbound.web.authz.RolePermissionRegistry;
import dev.caskeleton.application.security.AuthorizationPort;
import dev.caskeleton.application.security.RequiresPermission;
import io.grpc.BindableService;
import io.grpc.CallOptions;
import io.grpc.Channel;
import io.grpc.ClientInterceptors;
import io.grpc.ManagedChannel;
import io.grpc.ManagedChannelBuilder;
import io.grpc.Metadata;
import io.grpc.MethodDescriptor;
import io.grpc.ServerServiceDefinition;
import io.grpc.Status;
import io.grpc.StatusRuntimeException;
import io.grpc.stub.ClientCalls;
import io.grpc.stub.MetadataUtils;
import io.grpc.stub.ServerCalls;
import io.grpc.stub.StreamObserver;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import java.util.Set;
import java.util.concurrent.TimeUnit;
import java.util.function.Function;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.runner.ApplicationContextRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
/**
* A {@code @RequiresPermission} use case a gRPC handler calls is judged as the caller the
* authentication policy returned, and a denial reaches the client as {@code PERMISSION_DENIED}.
*
* <p>The whole chain on a real server and wire: the interceptor puts the caller on the {@code
* SecurityContext} of the thread the handler runs on, the web adapter's method security reads it,
* the denial is the {@code AUTHZ_INSUFFICIENT_PERMISSION} carrier, and the exception interceptor
* maps it. Each piece had its own unit test; nothing ran them together (review 2026-11-13).
*/
class GrpcRequiresPermissionWireTest {
private static final String SERVICE_NAME = "test.authz.Orders";
private static final Metadata.Key<String> AUTHORIZATION =
Metadata.Key.of("authorization", Metadata.ASCII_STRING_MARSHALLER);
private static final MethodDescriptor<String, String> CLOSE_ORDER =
MethodDescriptor.<String, String>newBuilder()
.setType(MethodDescriptor.MethodType.UNARY)
.setFullMethodName(MethodDescriptor.generateFullMethodName(SERVICE_NAME, "CloseOrder"))
.setRequestMarshaller(StringMarshaller.INSTANCE)
.setResponseMarshaller(StringMarshaller.INSTANCE)
.build();
private final ApplicationContextRunner contextRunner =
new ApplicationContextRunner()
.withUserConfiguration(
GrpcServerConfig.class, MethodSecurityConfig.class, OrdersConfiguration.class)
.withPropertyValues(
"app.grpc.server.enabled=true",
"app.grpc.server.port=0",
"app.grpc.server.bind-address=127.0.0.1",
"app.grpc.server.allow-insecure-local=true",
"app.grpc.server.reflection-enabled=false");
@Test
@DisplayName(
"권한 없는 호출자가 gRPC handler 로 부른 @RequiresPermission 유스케이스는 wire 에서 PERMISSION_DENIED 다")
void aCallerWithoutThePermissionIsDeniedOnTheWire() {
// when
StatusRuntimeException failure =
call(
channel ->
catchThrowableOfType(
StatusRuntimeException.class, () -> closeOrder(channel, "reader", "o-1")));
// then
assertThat(failure).isNotNull();
assertThat(
List.of(
failure.getStatus().getCode(),
String.valueOf(failure.getTrailers().get(GrpcStatusMapper.CODE_KEY))))
.containsExactly(Status.Code.PERMISSION_DENIED, "AUTHZ_INSUFFICIENT_PERMISSION");
}
@Test
@DisplayName("권한이 있는 호출자는 같은 유스케이스를 통과한다 — 거부는 판정이지 빈 context 가 아니다")
void aCallerWithThePermissionPasses() {
// when
String answer = call(channel -> closeOrder(channel, "writer", "o-1"));
// then
assertThat(answer).isEqualTo("closed o-1");
}
private <T> T call(Function<Channel, T> action) {
Object[] result = new Object[1];
contextRunner.run(
context -> {
assertThat(context.getStartupFailure()).isNull();
int port = context.getBean(GrpcServerRunner.class).getListeningPort();
ManagedChannel channel =
ManagedChannelBuilder.forAddress("127.0.0.1", port).usePlaintext().build();
try {
result[0] = action.apply(channel);
} finally {
channel.shutdownNow();
channel.awaitTermination(5, TimeUnit.SECONDS);
}
});
@SuppressWarnings("unchecked") // the single value action.apply returned
T value = (T) result[0];
return value;
}
private static String closeOrder(Channel channel, String token, String orderId) {
Metadata headers = new Metadata();
headers.put(AUTHORIZATION, "Bearer " + token);
Channel authenticated =
ClientInterceptors.intercept(channel, MetadataUtils.newAttachHeadersInterceptor(headers));
return ClientCalls.blockingUnaryCall(
authenticated,
CLOSE_ORDER,
CallOptions.DEFAULT.withDeadlineAfter(5, TimeUnit.SECONDS),
orderId);
}
/**
* A use case guarded the way an application guards one. Not final: method security proxies it.
*/
static class CloseOrderUseCase {
@RequiresPermission("order:close")
public String close(String orderId) {
return "closed " + orderId;
}
}
@Configuration(proxyBeanMethods = false)
static class OrdersConfiguration {
/** The web adapter's real port: roles to permissions, `writer` may close orders. */
@Bean
AuthorizationPort authorizationPort() {
return new AuthorizationAdapter(
new RolePermissionRegistry(
new RolePermissionPolicy(Map.of("writer", List.of("order:close")))));
}
/** A token names the caller and its role, as a policy built on the web JWT converter would. */
@Bean
GrpcAuthenticationPolicy grpcAuthenticationPolicy() {
return metadata -> {
String header = metadata.get(AUTHORIZATION);
if (header == null || !header.startsWith("Bearer ")) {
return Optional.empty();
}
String role = header.substring("Bearer ".length());
AuthenticatedPrincipal principal =
new AuthenticatedPrincipal(role + "-user", role + "@example.test", Set.of(role));
return Optional.of(
UsernamePasswordAuthenticationToken.authenticated(principal, null, List.of()));
};
}
@Bean
CloseOrderUseCase closeOrderUseCase() {
return new CloseOrderUseCase();
}
@Bean
@GrpcExposedService
BindableService ordersService(CloseOrderUseCase useCase) {
return () ->
ServerServiceDefinition.builder(SERVICE_NAME)
.addMethod(
CLOSE_ORDER,
ServerCalls.asyncUnaryCall(
(String orderId, StreamObserver<String> observer) -> {
observer.onNext(useCase.close(orderId));
observer.onCompleted();
}))
.build();
}
}
private enum StringMarshaller implements MethodDescriptor.Marshaller<String> {
INSTANCE;
@Override
public InputStream stream(String value) {
return new ByteArrayInputStream(value.getBytes(StandardCharsets.UTF_8));
}
@Override
public String parse(InputStream stream) {
try {
return new String(stream.readAllBytes(), StandardCharsets.UTF_8);
} catch (IOException e) {
throw new IllegalStateException("failed to decode test response", e);
}
}
}
}