On Mon, 18 Nov 2024 18:05:34 GMT, Martin Balao <mba...@openjdk.org> wrote:

> We would like to propose an implementation of the HKDF algorithms for 
> SunPKCS11, aligned with the KDF API proposed for JDK 24 (see [JEP 478: Key 
> Derivation Function API 
> (Preview)](https://bugs.openjdk.org/browse/JDK-8189808)).
> 
> This implementation will be under the _Preview_ umbrella until the KDF API 
> becomes stable in a future JDK release. The benefit of this early proposal is 
> to gather more feedback about the KDF API for future improvements.
> 
> The `P11KDF` class has the core implementation and Java calls to the PKCS 11 
> API. Different native mechanism were used to merge key material: 
> CKM_CONCATENATE_BASE_AND_DATA (key and data), CKM_CONCATENATE_BASE_AND_KEY 
> (key and key) and CKM_CONCATENATE_DATA_AND_BASE (data and key). The 
> implementation also supports merging data with data, at the Java level. List 
> of HKDF algorithms supported: HKDF-SHA256, HKDF-SHA384, and, HKDF-SHA512.
> 
> Derivation modes supported: extract, expand, and, extract-expand.
> 
> We further advanced the consolidation of algorithm and key info in the 
> P11SecretKeyFactory map —this effort started with the PBE support enhancement 
> and has helped to avoid duplication—. The map has now information about HMAC 
> (`HMACKeyInfo` class) and HKDF (`HKDFKeyInfo` class) algorithms. P11Mac is 
> now aligned to take the information from the map.
> 
> Generic keys now supported in SecretKeyFactory. Derived keys could be Generic.
> 
> Testing
> 
>  * 
> [TestHKDF.java](https://github.com/openjdk/jdk/blob/e87ec99b90ff742f531a5031fdeeb9f2e039856d/test/jdk/sun/security/pkcs11/KDF/TestHKDF.java)
>  test added
>    * All non-SHA1 & non-SHA224 RFC 5869 test vectors checked
>    * Cross-checking against SunJCE's HKDF implementation for every algorithm 
> possible
>       * Static assertion data for resilience if SunJCE were not available
>    * Use of derived key for encryption check
>    * Concatenation of input key material and salt checked (multiple 
> combinations)
>    * Multiple derivation types checked (extract only, expand only, and, 
> extract-expand)
>    * Derive key and derive data checked
>    * All supported HKDF algorithms tested (HKDF-SHA256, HKDF-SHA384, and, 
> HKDF-SHA512)
>    * DH and ECDH key derivation for TLS checked
>    * Informative output for debugging purposes (shown automatically if there 
> is a test failure)
>      * Note: test failures do not prevent all tests for running
>    * Test integrated to the SunPKCS11 tests framework
> 
>  * No regressions observed in jdk/sun/security/pkcs11 (114 tests passed, 0 
> failed)
> 
> A CSR will be proposed.
> 
> This proposal is...

This pull request has now been integrated.

Changeset: 6ddbcc34
Author:    Martin Balao <mba...@openjdk.org>
URL:       
https://git.openjdk.org/jdk/commit/6ddbcc34c019d780fc12d8f636e3aa3de33ecaaa
Stats:     1611 lines in 16 files changed: 1545 ins; 29 del; 37 mod

8328119: Support HKDF in SunPKCS11 (Preview)
8346720: Support Generic keys in SunPKCS11 SecretKeyFactory

Co-authored-by: Francisco Ferrari Bihurriet <fferr...@openjdk.org>
Co-authored-by: Martin Balao <mba...@openjdk.org>
Reviewed-by: valeriep, kdriver, weijun

-------------

PR: https://git.openjdk.org/jdk/pull/22215

Reply via email to