Skip to content

Commit c65d563

Browse files
updates to 25.0.0.9 blog
1 parent 0fcffd7 commit c65d563

File tree

1 file changed

+27
-42
lines changed

1 file changed

+27
-42
lines changed

posts/2025-09-09-25.0.0.9.adoc

Lines changed: 27 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
22
layout: post
3-
title: "ECDH-ES support added to JwtBuilder"
3+
title: "ECDH-ES support added to JwtBuilder in 25.0.0.9"
44
# Do NOT change the categories section
55
categories: blog
66
author_picture: https://avatars3.githubusercontent.com/IsmathBadsha
77
author_github: https://github.com/IsmathBadsha
8-
seo-title: ECDH-ES support added to JwtBuilder - OpenLiberty.io
8+
seo-title: ECDH-ES support added to JwtBuilder in 25.0.0.9 - OpenLiberty.io
99
seo-description: 'This release introduces ECDH-ES support in JwtBuilder.'
1010
blog_description: 'This release introduces ECDH-ES support in JwtBuilder.'
1111
open-graph-image: https://openliberty.io/img/twitter_card.jpg
1212
open-graph-image-alt: Open Liberty Logo
1313
---
14-
= ECDH-ES support added to JwtBuilder
14+
= ECDH-ES support added to JwtBuilder in 25.0.0.9
1515
Ismath Badsha <https://github.com/IsmathBadsha>
16-
:imagesdir: /
16+
:imagesdir: /s
1717
:url-prefix:
1818
:url-about: /
1919
//Blank line here is necessary before starting the body of the post.
@@ -66,16 +66,10 @@ This release introduces ECDH-ES support in JwtBuilder.
6666

6767
In link:{url-about}[Open Liberty] 25.0.0.9:
6868

69-
* <<ECDH-ES, Add ECDH-ES support to JwtBuilder>>
69+
* <<ECDH_ES, Add ECDH-ES support to JwtBuilder>>
7070
* <<CVEs, Security Vulnerability (CVE) Fixes>>
7171
* <<bugs, Notable bug fixes>>
7272

73-
74-
// // // // // // // //
75-
// If there were updates to guides since last release, keep the following, otherwise remove section.
76-
// // // // // // // //
77-
Along with the new features and functions added to the runtime, we’ve also made <<guides, updates to our guides>>.
78-
7973
// // // // // // // //
8074
// In the preceding section:
8175
// Replace the TAG_X with a short label for the feature in lower-case, eg: mp3
@@ -161,30 +155,37 @@ image::img/blog/blog_btn_stack.svg[Ask a question on Stack Overflow, align="cent
161155
// Blog issue: https://github.com/OpenLiberty/open-liberty/issues/32660
162156
// Contact/Reviewer: tloodu
163157
// // // // // // // //
164-
[#ECDH-ES]
158+
[#ECDH_ES]
165159
== Add ECDH-ES support to JwtBuilder
166160

167-
Open Liberty has enhanced its JSON Web Token 1.0 (`jwt-1.0`) feature by introducing support for ECDH-ES (Elliptic Curve Diffie-Hellman Ephemeral Static) as a key management algorithm in the JwtBuilder configuration. This update allows application developers to use Elliptic Curve Cryptography for encrypting the Content Encryption Key (CEK) of a JWE, providing a modern alternative to the previously supported RSA-OAEP with enhanced security.To use ECDH-ES, developers must define an Elliptic Curve public key in the keyManagementKeyAlias attribute.The EC public and private key pair can be generated using securityUtility or keytool, for example:
168-
- `./securityUtility createSSLCertificate --sigAlg=SHA256withECDSA --keySize=256 --server=myServer --validity=3650 --password=password`
169-
- `keytool -genkeypair -alias eccert -keyalg EC -groupname secp256r1 -validity 3650 -storetype pkcs12 -keystore myKeystore.p12 -storepass password`
170-
ECDH-ES can be configured under the `keyManagementKeyAlgorithm` attribute in a JwtBuilder element of `JSON Web Token 1.0` (`jwt-1.0`) feature.The EC public key used for encryption must be referenced by its alias in `keyManagementKeyAlias`, and the keystore must be specified using the `trustStoreRef` attribute.
171-
Sample server.xml configuration:
161+
Open Liberty has enhanced its JSON Web Token 1.0 (`jwt-1.0`) feature by introducing support for ECDH-ES (Elliptic Curve Diffie-Hellman Ephemeral Static) as a key management algorithm in the JwtBuilder configuration. This update allows application developers to use Elliptic Curve Cryptography for encrypting the Content Encryption Key (CEK) of a JWE, providing a modern alternative to the previously supported RSA-OAEP with enhanced security.
172162

173-
[source,xml]
163+
To use ECDH-ES, developers must define an Elliptic Curve public key in the `keyManagementKeyAlias` attribute. The EC public and private key pair can be generated using securityUtility or keytool, for example:
164+
+
165+
```
166+
./securityUtility createSSLCertificate --sigAlg=SHA256withECDSA --keySize=256 --server=myServer --validity=3650 --password=password
167+
```
168+
+
169+
```
170+
keytool -genkeypair -alias eccert -keyalg EC -groupname secp256r1 -validity 3650 -storetype pkcs12 -keystore myKeystore.p12 -storepass password
171+
```
172+
173+
ECDH-ES can be configured under the `keyManagementKeyAlgorithm` attribute in a JwtBuilder element of `JSON Web Token 1.0` (jwt-1.0) feature. The EC public key used for encryption must be referenced by its alias in `keyManagementKeyAlias`, and the keystore must be specified using the `trustStoreRef` attribute.
174+
175+
Sample server.xml configuration:
176+
+
177+
[source, xml]
174178
----
175179
<jwtBuilder
176180
keyManagementKeyAlgorithm="ECDH-ES"
177181
keyManagementKeyAlias="myECPublicKey"
178182
trustStoreRef="myTrustStore" ... />
179183
----
180-
For more details on configuring `JwtBuilder` and using ECDH-ES, refer to the https://openliberty.io/docs/latest/reference/config/jwtBuilder.html[Open Liberty documentation].
184+
185+
For more details on configuring `JwtBuilder` and using ECDH-ES, check the link:https://openliberty.io/docs/latest/reference/config/jwtBuilder.html[Open Liberty documentation].
181186

182-
183187
// DO NOT MODIFY THIS LINE. </GHA-BLOG-TOPIC>
184188

185-
186-
For more details, check the LINK[LINK_DESCRIPTION].
187-
188189
// // // // // // // //
189190
// In the preceding section:
190191
// Replace TAG_X/SUB_TAG_X with the given tag of your secton from the contents list
@@ -210,19 +211,19 @@ For more details, check the LINK[LINK_DESCRIPTION].
210211
|5.3
211212
|Denial of service
212213
|18.0.0.2-25.0.0.8
213-
|Affects the `feature:servlet-3.1`, `feature:servlet-4.0`, `feature:servlet-5.0` and `feature:servlet-6.0` features
214+
|Affects the `servlet-3.1`, `servlet-4.0`, `servlet-5.0` and `servlet-6.0` features
214215

215216
|https://www.cve.org/CVERecord?id=CVE-2025-48976[CVE-2025-48976]
216217
|7.5
217218
|Denial of service
218219
|17.0.0.3-25.0.0.8
219-
|Affects the `feature:servlet-3.1`, `feature:servlet-4.0`, `feature:servlet-5.0` and `feature:servlet-6.0` features
220+
|Affects the `servlet-3.1`, `servlet-4.0`, `servlet-5.0` and `servlet-6.0` features
220221

221222
|https://www.cve.org/CVERecord?id=CVE-2025-36124[CVE-2025-36124]
222223
|5.9
223224
|Bypass security
224225
|17.0.0.3-25.0.0.8
225-
|Affects the `feature:wasJmsServer-1.0`, `feature:wasJmsSecurity-1.0`, `feature:wasJmsClient-2.0`, `feature:messagingServer-3.0`, `feature:messagingSecurity-3.0` and `feature:messagingClient-3.0` features
226+
|Affects the `wasJmsServer-1.0`, `wasJmsSecurity-1.0`, `wasJmsClient-2.0`, `messagingServer-3.0`, `messagingSecurity-3.0` and `messagingClient-3.0` features
226227
|===
227228
// // // // // // // //
228229
// In the preceding section:
@@ -288,22 +289,6 @@ We’ve spent some time fixing bugs. The following sections describe just some o
288289
// // // // // // // //
289290

290291

291-
// // // // // // // //
292-
// If there were updates to guides since last release, keep the following, otherwise remove section.
293-
// Check with Gilbert Kwan, otherwise Michal Broz or YK Chang
294-
// // // // // // // //
295-
[#guides]
296-
== New and updated guides since the previous release
297-
As Open Liberty features and functionality continue to grow, we continue to add link:https://openliberty.io/guides/?search=new&key=tag[new guides to openliberty.io] on those topics to make their adoption as easy as possible. Existing guides also receive updates to address any reported bugs/issues, keep their content current, and expand what their topic covers.
298-
299-
// // // // // // // //
300-
// In the following section, list any new guides, or changes/updates to existing guides.
301-
// The following is an example of how the list can be structured (similar to the bugs section):
302-
// * link:{url-prefix}/guides/[new/updated guide].html[Guide Title]
303-
// ** Description of the guide or the changes made to the guide.
304-
// // // // // // // //
305-
306-
307292
== Get Open Liberty 25.0.0.9 now
308293

309294
Available through <<run,Maven, Gradle, Docker, and as a downloadable archive>>.

0 commit comments

Comments
 (0)