Skip to content

Commit aa3ad3f

Browse files
beldmitclaude
andcommitted
Add CHANGES.md and NEWS.md entries for multi-key derivation
Record the new EVP_KDF_derive_SKEYs() API and its provider interface for the 4.2 release notes. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent dbdd741 commit aa3ad3f

2 files changed

Lines changed: 18 additions & 0 deletions

File tree

‎CHANGES.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,20 @@ OpenSSL 4.2
3333

3434
### Changes between 4.1 and 4.2 [xx XXX xxxx]
3535

36+
* Added support for deriving several symmetric keys and IVs from a single
37+
KDF operation. `EVP_KDF_derive_SKEYs()` performs the derivation and
38+
`EVP_KDF_CTX_get1_SKEY()` and `EVP_KDF_CTX_get0_IV()` collect the
39+
individual results by purpose, for example "client_cipher_key" or
40+
"server_iv". TLS1-PRF and TLS13-KDF implement it, so a TLS 1.2 key block
41+
can be produced in one call. The caller names the cipher and MAC the keys
42+
are for and the provider chooses the key type accordingly, which lets a
43+
provider holding its keys on a token derive them all in a single
44+
operation without ever exposing the raw bytes. Providers implement this
45+
through the new `OSSL_FUNC_kdf_derive_multi()` and its companion
46+
functions.
47+
48+
*Dmitry Belyavskiy*
49+
3650
* `X509_OBJECT_up_ref_count()` has been deprecated. Despite its name,
3751
X509_OBJECT_up_ref_count() does not reference count the X509_OBJECT itself.
3852
With X509_OBJECT being opaque there is nothing useful an application can do

‎NEWS.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,10 @@ OpenSSL 4.2
3232
* Added support for Java keytool PKCS#12 files with symmetric keys.
3333
New API `PKCS12_parse_ex()` with `PKCS12_PARSE_CTX` has been added.
3434

35+
* Added support for deriving several `EVP_SKEY` objects and IVs from a
36+
single KDF operation, as TLS requires. New API `EVP_KDF_derive_SKEYs()`,
37+
`EVP_KDF_CTX_get1_SKEY()` and `EVP_KDF_CTX_get0_IV()` have been added.
38+
3539
OpenSSL 4.1
3640
-----------
3741

0 commit comments

Comments
 (0)