Skip to content

docs(tenancy): mark the jwt resolver as reserved (not yet shipped)#69

Merged
jlc488 merged 1 commit into
mainfrom
docs/fix-jwt-resolver-status
Jun 3, 2026
Merged

docs(tenancy): mark the jwt resolver as reserved (not yet shipped)#69
jlc488 merged 1 commit into
mainfrom
docs/fix-jwt-resolver-status

Conversation

@jlc488
Copy link
Copy Markdown
Contributor

@jlc488 jlc488 commented Jun 3, 2026

EN

The deepened tenancy guide listed resolver: jwt as a working option, but TenantAutoConfiguration throws for case JWT — it requires the (unshipped) devslab-kit-oauth2-resource-server-starter. Only fixed / header / subdomain actually resolve; jwt fails fast at startup.

  • moves jwt to the bottom of the resolver table, marked reserved — not yet shipped, with a warning admonition pointing at a custom TenantResolver bean (the login JWT already carries a tenant claim to read)
  • fixes the YAML comment that advertised jwt as selectable

EN + KO. Pinned { #custom-resolver } on the KO heading so the new fragment link resolves in the KO build.

Note: JWT claims themselves are fully supported — the issued token carries tenant + roles (+ loginId, status, …) and JwtAuthenticationFilter consumes them. This fix is only about the tenant-resolver strategy named jwt.

Verification: mkdocs build --strict — clean.

KO (한국어)

보강한 tenancy 가이드가 resolver: jwt를 동작 옵션처럼 적었지만, TenantAutoConfigurationcase JWT에서 예외를 던집니다 — (미출시) devslab-kit-oauth2-resource-server-starter가 필요합니다. 실제로는 fixed / header / subdomain만 동작하고 jwt는 부팅 시 즉시 실패합니다.

  • jwt를 리졸버 표 맨 아래로 옮기고 예약 — 아직 미출시로 표기, 커스텀 TenantResolver을 가리키는 경고 노트 추가(로그인 JWT는 이미 tenant 클레임을 실음)
  • jwt를 선택 가능한 것처럼 적은 YAML 주석 정정

한/영. ko 빌드에서 fragment 링크가 동작하도록 ko 헤딩에 { #custom-resolver } 고정.

참고: JWT 클레임 자체는 완전 지원됩니다 — 발급 토큰이 tenant + roles(+ loginId, status …)를 싣고 JwtAuthenticationFilter가 소비합니다. 이 수정은 jwt라는 이름의 테넌트 리졸버 전략에 한정됩니다.

검증: mkdocs build --strict — clean.

The deepened tenancy guide listed `resolver: jwt` as a working option, but
TenantAutoConfiguration throws for `case JWT`: it requires the (unshipped)
devslab-kit-oauth2-resource-server-starter. Only fixed / header / subdomain
actually resolve; jwt fails fast at startup.

- move jwt to the bottom of the resolver table, marked "reserved — not yet
  shipped", with a warning admonition pointing at a custom TenantResolver
  bean (the login JWT already carries a `tenant` claim to read)
- fix the yaml comment that advertised jwt as selectable

EN + KO. Pinned { #custom-resolver } on the KO heading so the new
fragment link resolves in the KO build.

Verification: mkdocs build --strict clean.
@jlc488 jlc488 merged commit 79dc16a into main Jun 3, 2026
2 checks passed
@jlc488 jlc488 deleted the docs/fix-jwt-resolver-status branch June 3, 2026 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant