Keycloak JS 26.2.0 リリース

2025年2月20日

ハイライト

本日、バージョン26.2.0のリリースにより、Keycloak JSの進化における重要な節目を迎えました。この新バージョンは、JavaScriptアダプターがKeycloakエコシステムと並行して開発および進化していく方法における転換点を表しています。この新バージョンでは、アダプターに機能的な変更は導入されていませんが、いくつかの組織的な変更が含まれています。

最も注目すべき変更は、Keycloak JSがメインのKeycloakプロジェクトのリリースサイクルから独立したことです。今年初めに発表されたように、JavaScriptアダプターは独自の独立した開発パスをたどります。メインプロジェクトからの分離により、機能、バグ修正のリリース頻度を高め、コミュニティからのフィードバックへの対応を改善できます。JavaScriptアダプターは、Keycloakサーバーのアクティブにサポートされているすべてのリリースとの下位互換性を維持し、これからの逸脱は破壊的な変更と見なされます。

メインプロジェクト自体よりも高いバージョンを使用した選択は、Keycloakのリリースサイクルからの脱却をユーザーに知らせるために意図的に行われました。ただし、セマンティックバージョニングの使用を継続し、下位互換性のない変更が行われた場合にのみメジャーバージョンを上げます。これはNPMエコシステムで慣例となっているとおりです。メンテナンスアップデートは、Keycloakサーバーの現在の安定版リリースに関連付けられているため、26.1.xシリーズで継続されますが、ユーザーは必要に応じて新しいバージョンにアップグレードすることをお勧めします。

もう一つの重要な変更は、コードベースを独自の専用リポジトリに再配置したことです。この構造的な調整は、単なる管理上のものだけでなく、保守性の向上に向けた戦略的な動きを表しています。JavaScriptアダプターをメインのKeycloakリポジトリから分離することにより、開発チームはコードベースの管理とコミュニティからの貢献の処理において、より大きな柔軟性を得ることができます。貢献を提供したり、問題を報告したりする場合は、こちらにリダイレクトしてください。

今後、Keycloak JSの今後の展望に焦点を当てていきます。最初にリリースされた当時、クライアントサイドJavaScript用のOpenID Connectアダプターはわずかしか存在しなかったため、独自のアダプターを作成する必要がありました。しかし、現在の状況は大きく異なり、多くの成熟したソリューションが利用可能です。Keycloak JSのコードは現代化が必要であり、複雑さが増しているため、保守が困難になっています。Keycloak JSのリファクタリングを継続することが理にかなっているか、コラボレーションできる成熟したサードパーティライブラリを組み込むか、または確立されたコミュニティソリューションに置き換えるかについて、引き続き評価していきます。

アップグレード

アップグレードする前に、変更点の完全なリストについては、移行ガイドを参照してください。