infra(keycloak): Phase 1 Sprint 1 — keycloak 独立 Gradle project 雛形(SPI 用)(S1Infra-3)

[win2cot]

Phase 1 Sprint 1 Infra-3: keycloak 独立 Gradle project 雛形(SPI 用)

概要

keycloak/ 配下に Keycloak 用の 独立 Gradle project を作成し、ADR-0006(改訂)の User Storage SPI を実装する雛形を構築する。ビルドした JAR は 共有 platform Keycloak Custom Image(#321) に同梱され、platform の共有 Keycloak runtime(#322)で動く(全プロジェクト SPI を同梱する共有ビルド、当面 tasks のみ)。

詳細仕様: docs/adr/0006(改訂)/ infrastructure-plan §3.3。

背景

• monorepo 構造(Setup 0 完了)で keycloak/ subdir は確保済
• ADR-0006 改訂: SPI は tasks users を read-only profile federate + email のみ writable(資格・MFA は Keycloak 自前ストア、氏名・住所等は read-only)
• 本 Issue では SPI 実装の雛形(class skeleton + Gradle build + test 雛形)に集中

やること

• keycloak/build.gradle.kts(独立 Gradle project)作成
• keycloak/src/main/java/.../TasksWebApiUserStorageProvider.java 雛形:
  • UserStorageProvider + UserLookupProvider + UserQueryProvider(read)
  • email のみ writable な属性更新(Update-Email 経由)
  • UserRegistrationProvider は admin/障害時のみ(主経路は本システム API)
  • CredentialInputValidator は 実装しない(資格は Keycloak)
• keycloak/src/main/resources/META-INF/services/... で SPI 登録
• テスト雛形(Keycloak Test SPI / JUnit、compile + load 確認)
• ./gradlew :keycloak:build で JAR 生成

受入条件

• keycloak/build.gradle.kts 存在 + JAR ビルド成功
• SPI 登録ファイル + read-only lookup/query + email-only writable の skeleton 存在(資格 interface は未実装)
• root build から ./gradlew :keycloak:build が成功
• テスト雛形 green

関連

• 親 tracker Issue: [Phase 1 Infra] Setup 0-2 + Sprint 0-5 Infra ストリーム横断 tracker #206 / ADR: ADR-0006(改訂)
• Milestone: Phase 1 / Iteration: Phase 1 Sprint 1
• 依存: Setup 0(infra(repo): monorepo 構造整理 PR(webapi/ 等 subdir + 資材移動 + CI workflow パス更新) #207 monorepo)/ ADR-0006(design(security/db): Keycloak User Storage SPI 設計 ADR(docs/adr/0006-...) #220 closed、改訂は PR docs(adr): Keycloak 共有 platform IdP + identity 所有モデル改訂 (ADR-0004/0006) #386)
• 隣接(blocks): S1Infra-4(infra(keycloak): Phase 1 Sprint 1 — Keycloak Custom Docker Image(公式 + SPI JAR)(S1Infra-4) #321 共有 Custom Image、本 JAR を取り込む)

備考

• task-type: task-type:impl / 優先度: priority/p0 / area: area/keycloak + area/infra
• claude-automation: 適用

[win2cot]

実装完了 — PR #443

PR: #443

---

作成したファイル

ファイル	役割
build.gradle	ルート build file（spotless / errorprone を apply false で宣言、サブプロジェクト間クラスローダー競合を解消）
keycloak/build.gradle.kts	Kotlin DSL。Keycloak 26.2.5 compileOnly、NullAway + Spotless を webapi 規約に合わせて設定
keycloak/src/main/java/…/package-info.java	@NullMarked
keycloak/src/main/java/…/TasksWebApiUserStorageProviderFactory.java	ComponentFactory 実装（Keycloak 26.x 対応、後述）
keycloak/src/main/java/…/TasksWebApiUserStorageProvider.java	Provider + UserLookupProvider + UserQueryProvider + UserRegistrationProvider 実装。CredentialInputValidator は意図的に未実装
keycloak/src/main/java/…/UserAdapter.java	AbstractInMemoryUserAdapter 拡張。email のみ writable、その他属性は read-only
keycloak/src/main/resources/META-INF/services/org.keycloak.component.ComponentFactory	SPI 登録ファイル
keycloak/src/test/java/…/TasksWebApiUserStorageProviderFactoryTest.java	getId() + ServiceLoader 登録を検証するテスト雛形（2 テスト green）

---

Keycloak 26.x 対応メモ（ADR-0006 との差分）

実装中に判明した重要事項: ADR-0006 が参照する API が Keycloak 26.x で削除済み。

ADR-0006 記載（旧 API）	Keycloak 26.x 実装
UserStorageProviderFactory	ComponentFactory<T, T>
AbstractUserAdapterFederatedStorage	AbstractInMemoryUserAdapter
META-INF/services/org.keycloak.storage.UserStorageProviderFactory	META-INF/services/org.keycloak.component.ComponentFactory

UserLookupProvider / UserQueryProvider / UserRegistrationProvider / StorageId は 26.x でも同パッケージ・同インターフェース名で存在。機能的な意図（read-only federation + email-only writable）は ADR-0006 §3.1 に完全準拠。

ADR-0006 の実装メモ §4「Sprint 1 Infra で…」内の API 名は 25.x ベースのため、本 PR のクラス名が ADR-0006 記載と異なる旨を ADR 本文に注記することを推奨（別 PR でよい）。

---

受入条件の確認

• keycloak/build.gradle.kts 存在 + JAR ビルド成功（./gradlew :keycloak:build → BUILD SUCCESSFUL）
• SPI 登録ファイル + read-only lookup/query + email-only writable の skeleton 存在
• root build から ./gradlew :keycloak:build が成功
• テスト雛形 green（2 テスト pass）