RFR: 8325448: Hybrid Public Key Encryption [v33]

[Sean Mullan]

On Tue, 26 Aug 2025 15:48:31 GMT, Weijun Wang <weijun at openjdk.org> wrote:

>> src/java.base/share/classes/javax/crypto/spec/HPKEParameterSpec.java line 40:
>> 
>>> 38:  * This immutable class specifies the set of parameters used with a {@code Cipher} for the
>>> 39:  * <a href="https://www.rfc-editor.org/info/rfc9180">Hybrid Public Key Encryption</a>
>>> 40:  * (HPKE) algorithm. The <a href=
>> 
>> I think would be useful to add one or two (but no more) sentences describing HPKE and what it should be used for.
>
> I've added
> 
>      * HPKE is a public key encryption scheme for encrypting
>      * arbitrary-sized plaintexts to a receiver's public key. It combines a key
>      * encapsulation mechanism (KEM), a key derivation function (KDF), and an
>      * authenticated encryption with additional data (AEAD) cipher.
> 
> These are copied from [the Abstract of RFC 9180](https://www.rfc-editor.org/rfc/rfc9180.html#abstract) with a few tweaks.

First sentence, should it be "with a receiver's public key"?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/18411#discussion_r2303750559