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

@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행.
This commit is contained in:
DongHyeonka
2026-11-13 12:24:54 +09:00
parent 3ac824ae60
commit 2f0aefadee
62 changed files with 1862 additions and 179 deletions
+5 -4
View File
@@ -238,9 +238,10 @@ application/domain 을 프레임워크-free 로 유지하는 핵심 장치.
- 인증된 호출자가 필요한 `Permission` 을 못 가졌을 때 `AuthorizationPort` 가 던진다.
- **프레임워크-free, application 소유**: application 계층은 Spring Security 에 의존할 수 없어
Spring `AccessDeniedException` 을 던질 수 없다. web adapter 의 method-security enforcement
point 가 경계에서 이 예외를 잡아 Spring authorization 실패로 번역하고, error pipeline 이
`AUTHZ_INSUFFICIENT_PERMISSION` 403 으로 매핑한다(코드 SSOT 는 베이스라인 소유).
Spring `AccessDeniedException` 을 던질 수 없다. 대신 이 예외가 `ApiErrorCarrier`로
`AUTHZ_INSUFFICIENT_PERMISSION`을 싣는다. web adapter 의 method-security enforcement point 는 이 예외를
Spring 실패로 바꾸지 않고 그대로 내보낸다. 그래서 web(403)·gRPC(`PERMISSION_DENIED`)·GraphQL(`FORBIDDEN`)이 같은
코드로 답한다. STOMP `@MessageMapping` 안의 거부는 frame을 보내지 않고, 4xx carrier라 로그도 남기지 않는다.
- **fail-closed**: denial 은 필요한 권한과 호출자 subject 만 담고, 호출자의 *유효 권한 집합* 은
절대 담지 않는다(인가 표면을 클라이언트에 노출하지 않기 위함).
@@ -685,7 +686,7 @@ leaf의 코드 Javadoc과 `docs/notification/`이 정본이다. R1 오케스트
| `messaging.event.ValidatedIntegrationEvent` | 안정된 semantic identity와 바뀌지 않는 정확한 인코딩 바이트·hash. 뒤의 durable append 경계로 넘길 준비가 된 값이다. |
| `messaging.event.IntegrationEventEncoderPort` | 프레임워크 없는 로컬 경계(초안 → 검증된 이벤트). outbound 어댑터가 구현한다(템플릿은 `adapter:outbound:support`의 `JsonIntegrationEventEncoder`). |
| `outbox.OutboxAppendPort` | 유일한 outbox append: `ValidatedIntegrationEvent` 하나를 호출자의 쓰기 트랜잭션 안에서 넣는다. |
| `tenant.TenantId` | 테넌트 식별자와 그 유일한 문법(`[A-Za-z0-9][A-Za-z0-9_.-]{0,63}`). web과 GraphQL 전송 문맥이 모두 이 값을 싣는다. 전송 계층이 검증된 인증 데이터로만 만든다. |
| `tenant.TenantId` | 테넌트 식별자와 그 유일한 문법(`[A-Za-z0-9][A-Za-z0-9_.-]{0,63}`). web과 GraphQL 전송 문맥이 모두 이 값을 싣는다. 전송 계층이 검증된 인증 데이터로만 만든다. 전송 계층이 거절하는 tenant 입력 이름(`namesATenant`)도 여기 하나로 둔다. |
### 패키지 소유 (Package ownership)
@@ -1,15 +1,24 @@
package dev.caskeleton.application.security;
import dev.caskeleton.shared.error.ApiErrorCarrier;
import dev.caskeleton.shared.error.ApiErrorCode;
import dev.caskeleton.shared.error.OperationalError;
import dev.caskeleton.shared.security.Permission;
/**
* Raised by {@link AuthorizationPort} when an authenticated caller lacks a required {@link
* Permission}. Framework-free and application-owned (the layer cannot throw Spring's {@code
* AccessDeniedException}); the web adapter translates it to a {@code AUTHZ_INSUFFICIENT_PERMISSION}
* 403. Fail-closed: it carries the required permission and subject for diagnostics, never the
* caller's effective permission set. See README.
* AccessDeniedException}). Fail-closed: it carries the required permission and subject for
* diagnostics, never the caller's effective permission set. See README.
*
* <p>It carries {@code AUTHZ_INSUFFICIENT_PERMISSION} itself, so a denial answers with that code:
* 403 on web, {@code PERMISSION_DENIED} on gRPC, {@code FORBIDDEN} on GraphQL. A STOMP {@code
* MessageMapping} method sends no frame either way; the denial is a client-side carrier, so it
* leaves no line. The method-security check lets it through instead of turning it into Spring's
* {@code AccessDeniedException}, which only the web adapter maps; the others answered that as an
* unclassified failure with an ERROR line (review 2026-11-12).
*/
public class AuthorizationDeniedException extends RuntimeException {
public class AuthorizationDeniedException extends RuntimeException implements ApiErrorCarrier {
private static final long serialVersionUID = 1L;
@@ -27,6 +36,11 @@ public class AuthorizationDeniedException extends RuntimeException {
this.requiredPermission = requiredPermission;
}
@Override
public ApiErrorCode errorCode() {
return OperationalError.AUTHZ_INSUFFICIENT_PERMISSION;
}
public Permission requiredPermission() {
return requiredPermission;
}
@@ -1,6 +1,10 @@
package dev.caskeleton.application.tenant;
import java.util.Collection;
import java.util.Locale;
import java.util.Objects;
import java.util.Optional;
import java.util.Set;
import java.util.regex.Pattern;
/**
@@ -29,6 +33,9 @@ public record TenantId(String value) {
private static final Pattern PATTERN = Pattern.compile(GRAMMAR);
/** {@link #namesATenant} names, folded: lower case, no {@code -} or {@code _}. */
private static final Set<String> TENANT_INPUT_NAMES = Set.of("tenant", "tenantid", "xtenantid");
public TenantId {
if (value == null || !PATTERN.matcher(value).matches()) {
throw new IllegalArgumentException("tenant identifier must match " + GRAMMAR);
@@ -45,6 +52,44 @@ public record TenantId(String value) {
return value == null || value.isBlank() ? Optional.empty() : Optional.of(new TenantId(value));
}
/**
* Whether a request input name — a header, a query or form parameter, a GraphQL argument or
* variable — would carry a tenant if anybody believed it.
*
* <p>The one vocabulary every transport refuses: {@code tenant}, {@code tenant_id}, {@code
* tenantId}, {@code X-Tenant-Id} and their spellings, compared without case and without {@code -}
* and {@code _}. Web and GraphQL each kept a list — web lower-case names without {@code
* tenant_id}, GraphQL the caller's own names compared case-sensitively — so the same input was
* refused by one transport and passed by the other (review 2026-11-12).
*
* @param name the input's name; {@code null} names nothing
*/
public static boolean namesATenant(String name) {
return namesATenant(name, Set.of());
}
/**
* {@link #namesATenant(String)}, or one of a schema's own tenant names, compared the same way.
*
* @param name the input's name; {@code null} names nothing
* @param extraNames further names that denote a tenant where the caller works
*/
public static boolean namesATenant(String name, Collection<String> extraNames) {
if (name == null) {
return false;
}
String folded = folded(name);
return TENANT_INPUT_NAMES.contains(folded)
|| extraNames.stream()
.filter(Objects::nonNull)
.map(TenantId::folded)
.anyMatch(folded::equals);
}
private static String folded(String name) {
return name.replace("-", "").replace("_", "").toLowerCase(Locale.ROOT);
}
@Override
public String toString() {
return value;
@@ -74,4 +74,26 @@ class TenantIdTest {
.isInstanceOf(IllegalArgumentException.class)
.hasMessage("tenant identifier must match " + TenantId.GRAMMAR);
}
@ParameterizedTest
@ValueSource(
strings = {
"tenant",
"tenant_id",
"tenant-id",
"tenantId",
"TenantId",
"X-Tenant-Id",
"x_tenant_id"
})
@DisplayName("tenant 를 실을 입력 이름은 대소문자·'-'·'_' 와 상관없이 하나의 어휘로 알아본다")
void everySpellingOfATenantInputNameIsRecognised(String name) {
assertThat(TenantId.namesATenant(name)).isTrue();
}
@ParameterizedTest
@ValueSource(strings = {"id", "tenancy", "owner", "x-request-id"})
void otherInputNamesAreNotTenants(String name) {
assertThat(TenantId.namesATenant(name)).isFalse();
}
}