v2.0.0

NETCore.Keycloak v2.0.0 Release Notes

BREAKING CHANGES

• Minimum .NET version raised from 6.0 to 8.0. Supported targets: net8.0, net9.0, net10.0.
• Keycloak versions 20.x through 23.x are no longer actively supported. Users requiring
  support for these older versions should use v1.0.2.

KEYCLOAK 26 SUPPORT

• Full compatibility with Keycloak 26.5.6.
• JavaScript authorization policies are now deployed as JAR files instead of inline
  upload via the Admin API, which was removed in Keycloak 26.
• Added admin-fine-grained-authz:v1 feature flag for Keycloak 26 to restore
  fine-grained admin permissions support.
• Added organization feature flag for Keycloak 26 realm-level organization support.
• Updated bootstrap admin environment variables from KEYCLOAK_ADMIN to
  KC_BOOTSTRAP_ADMIN_USERNAME for Keycloak 26 compatibility.
• Removed deprecated --spi-connections-jpa-legacy-migration-strategy flag for
  Keycloak 25 and above.

NEW FEATURES

• Organizations API: full CRUD operations for Keycloak organizations
  (create, list, get, update, delete, count). Available on Keycloak 26 and above.
• HttpClient socket exhaustion fix: replaced short-lived HttpClient instances with
  a shared HttpClient using SocketsHttpHandler and PooledConnectionLifetime.
  Added optional IHttpClientFactory support for dependency injection scenarios.
  The new KeycloakClient(baseUrl, logger, httpClientFactory) constructor accepts
  an IHttpClientFactory for managed handler lifetimes and connection pooling.
  The existing KeycloakClient(baseUrl, logger) constructor continues to work
  using a default shared HttpClient.

DEPENDENCIES

• Added Microsoft.Extensions.Http for IHttpClientFactory support.