Update release notes for 21.1 (#19718)
* Update release notes for 21.1 * Update docs/documentation/release_notes/topics/21_1_0.adoc Co-authored-by: Pedro Igor <pigor.craveiro@gmail.com> * Update docs/documentation/upgrading/topics/keycloak/changes-21_1_0.adoc Co-authored-by: Jon Koops <jonkoops@gmail.com> * Update docs/documentation/release_notes/topics/21_1_0.adoc Co-authored-by: Jon Koops <jonkoops@gmail.com> * Update docs/documentation/upgrading/topics/keycloak/changes-21_1_0.adoc Co-authored-by: Jon Koops <jonkoops@gmail.com> --------- Co-authored-by: Pedro Igor <pigor.craveiro@gmail.com> Co-authored-by: Jon Koops <jonkoops@gmail.com>
This commit is contained in:
Stian Thorgersen
GitHub
parent
f4cabea08c
commit
feb20de2ef
5 changed files with 62 additions and 22 deletions
|
|
@ -13,8 +13,8 @@ include::topics/templates/document-attributes.adoc[]
|
|||
:release_header_latest_link: {releasenotes_link_latest}
|
||||
include::topics/templates/release-header.adoc[]
|
||||
|
||||
== {project_name_full} 22.0.0
|
||||
include::topics/22_0_0.adoc[leveloffset=2]
|
||||
// == {project_name_full} 22.0.0
|
||||
// include::topics/22_0_0.adoc[leveloffset=2]
|
||||
|
||||
== {project_name_full} 21.1.0
|
||||
include::topics/21_1_0.adoc[leveloffset=2]
|
||||
|
|
|
|||
|
|
@ -1,3 +1,16 @@
|
|||
= Monorepo
|
||||
|
||||
In the past Keycloak was maintained across multiple GitHub repositories:
|
||||
|
||||
* https://github.com/keycloak/keycloak-documentation[Documentation repository]
|
||||
* https://github.com/keycloak/keycloak-ui[UI repository]
|
||||
* https://github.com/keycloak/keycloak-nodejs-admin-client[Node.js admin client repository]
|
||||
|
||||
Having multiple repositories introduced a lot of complexity and toil. For example frequently multiple pull requests had to be sent
|
||||
to different repositories for a single change.
|
||||
|
||||
To simplify things we have now migrated everything into the https://github.com/keycloak/keycloak[main repository].
|
||||
|
||||
= FIPS 140-2 support
|
||||
|
||||
FIPS 140-2 support in Keycloak, which was preview in the previous release, is now promoted to be officially supported.
|
||||
|
|
@ -9,3 +22,28 @@ The Account Console version 3 is now available as an experimental feature in Key
|
|||
```
|
||||
bin/kc.sh start-dev --features=account3
|
||||
```
|
||||
= Changes to Keycloak Authorization Services support in Keycloak Java-based Adapters
|
||||
|
||||
As part of the removal of the https://www.keycloak.org/2023/03/adapter-deprecation-update[deprecated] adapters, the Keycloak Policy Enforcer was extracted from the adapters code base
|
||||
into a separate dependency:
|
||||
|
||||
[source,xml]
|
||||
----
|
||||
<dependency>
|
||||
<groupId>org.keycloak</groupId>
|
||||
<artifactId>keycloak-policy-enforcer</artifactId>
|
||||
<version>${version.keycloak}</version>
|
||||
</dependency>
|
||||
----
|
||||
|
||||
By providing this dependency, we expect making it possible to integrate the policy enforcer with the Java stack of your preference.
|
||||
|
||||
It also provides built-in support for enabling the policy enforcer to Jakarta applications protected with https://docs.wildfly.org/26/Admin_Guide.html#Elytron_OIDC_Client[Wildfly Elytron].
|
||||
|
||||
For now, this dependency is not yet GA as we are still working on the quickstarts and documentation.
|
||||
|
||||
This work should not impact existing applications using the deprecated adapters.
|
||||
= Javascript engine available by default
|
||||
|
||||
In the previous version, when Keycloak was used on Java 17 with Javascript providers it was needed to add the Nashorn
|
||||
javascript engine to the distribution. This is no longer needed as Nashorn javascript engine is available in Keycloak server by default.
|
||||
|
|
|
|||
|
|
@ -13,4 +13,22 @@ Default `Client ID` mapper of `Service Account Client` has been changed. `Token
|
|||
- https://www.rfc-editor.org/rfc/rfc7662#section-2.2[OAuth 2.0 Token Introspection]
|
||||
- https://datatracker.ietf.org/doc/html/rfc8693#section-4.3[OAuth 2.0 Token Exchange]
|
||||
|
||||
`clientId` userSession note still exists.
|
||||
`clientId` userSession note still exists.
|
||||
|
||||
= Keycloak JS adapter must be instanciated with the `new` operator
|
||||
|
||||
Historically it has been possible to create an instance of the Keycloak JS adapter by calling the `Keycloak()` function directly:
|
||||
|
||||
[source,javascript]
|
||||
----
|
||||
const keycloak = Keycloak();
|
||||
----
|
||||
|
||||
To align this with modern conventions in the JavaScript world it has been possible to use the https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/new[`new` operator] to create an instance instead:
|
||||
|
||||
[source,javascript]
|
||||
----
|
||||
const keycloak = new Keycloak();
|
||||
----
|
||||
|
||||
The function-style constructor has been deprecated for a while, but starting this version we will actively log a deprecation message when it used. This style of constructor will be removed in a future version so make sure to migrate your code to use the `new` operator.
|
||||
|
|
|
|||
|
|
@ -38,19 +38,3 @@ try {
|
|||
alert('failed to initialize');
|
||||
}
|
||||
```
|
||||
|
||||
= Keycloak JS adapter must be instanciated with the `new` operator
|
||||
|
||||
Historically it has been possible to create an instance of the Keycloak JS adapter by calling the `Keycloak()` function directly:
|
||||
|
||||
```js
|
||||
const keycloak = Keycloak();
|
||||
```
|
||||
|
||||
To align this with modern conventions in the JavaScript world it has been possible to use the https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/new[`new` operator] to create an instance instead:
|
||||
|
||||
```js
|
||||
const keycloak = new Keycloak();
|
||||
```
|
||||
|
||||
The function-style constructor has been deprecated for a while, but starting this version we will actively log a deprecation message when it used. This style of constructor will be removed in a future version so make sure to migrate your code to use the `new` operator.
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
== Migration Changes
|
||||
|
||||
=== Migrating to 22.0.0
|
||||
|
||||
include::changes-22_0_0.adoc[leveloffset=3]
|
||||
// === Migrating to 22.0.0
|
||||
//
|
||||
// include::changes-22_0_0.adoc[leveloffset=3]
|
||||
|
||||
=== Migrating to 21.1.0
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue