Improve documentation Poco::Crypto::RSAKey & Poco::Crypto::ECKey deprecated

[ClaudeTO80]

According to their documentations, both Poco::Crypto::RSAKey & Poco::Crypto::ECKey are deprecated. I wonder if it is possible describe why such classes are deprecated and which class(es) should be used in are their replacement.

[aleks-f]

Anything that does not use the envelope openssl api is deprecated (as it is in openssl, since 3.0).

In this particular case, you can use EVPPKey:

poco/Crypto/include/Poco/Crypto/EVPPKey.h

Line 46 in d11e48f

class Crypto_API EVPPKey

[ClaudeTO80]

@aleks-f Thank you very much for your reply. It would be very useful if such information and links were shared in documentation. Thanks for your work.

[Mike4Online]

@aleks-f,

I am trying to migrate from Poco::Crypto::RSAKey to Poco::Crypto::EVPPKey, but I am stuck:

I can create an EVPPKey with the constructor:

EVPPKey(
int type,
int param
);

Which lets me set the type to EVP_PKEY_RSA and set the key length. But I cannot set the exponent to small or large, as I can when constructing an RSAKey:

RSAKey(
KeyLength keyLength,
Exponent exp
);

Also, when I need to create a Cipher from this new key, I can do so using two methods:

Cipher * createCipher(
const RSAKey & key,
RSAPaddingMode paddingMode = RSA_PADDING_PKCS1
);

Or

Cipher * createCipher(
const EVPPKey & key
);

The second method, which takes an EVPPKey, offers no optional parameter to set the RSA padding mode. The first method offers this option, but it uses the deprecated RSAKey class which I am trying to get away from.

How can I use EVPPKey for RSA encryption with a specified exponent size and RSA padding mode?

Thank you.