Skip to content

Rename the SSLContext#ecdh_curves= to #groups=. #901

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from

Conversation

junaruga
Copy link
Member

This PR is related to the #894 (comment). I checked the generated rdoc document by this change. I am still keeping the SSLContext#ecdh_curves= without deprecation in this PR. If we want to mark the SSLContext#ecdh_curves= as the deprecated, we can add the comment # <b>Deprecated in version 3.4.</b> Use #groups= instead. in the future, maybe before releasing the Ruby OpenSSL version 3.4.

What do you think?


Rename the SSLContext#ecdh_curves= to #groups=, keeping the #ecdh_curves= as an alias of the #groups= for backward compatibility.

In OpenSSL version 1.1.1 SSL_CTX_set1_curves_list was renamed to SSL_CTX_set1_groups_list, keeping the SSL_CTX_set1_curves_list at the following commit. Because TLS 1.3 renamed the extension. openssl/openssl@de4d764

As we only support OpenSSL version 1.1.1 or later versions, it is no problem to use the SSL_CTX_set1_groups_list.

For the document of the ossl_sslctx_set_groups,
I referred to the following RFC 8446 TLS 1.3 Supported Groups section. https://datatracker.ietf.org/doc/html/rfc8446#section-4.2.7

Rename the `SSLContext#ecdh_curves=` to `#groups=`, keeping the `#ecdh_curves=`
as an alias of the `#groups=` for backward compatibility.

In OpenSSL version 1.1.1 `SSL_CTX_set1_curves_list` was renamed to
`SSL_CTX_set1_groups_list`, keeping the `SSL_CTX_set1_curves_list` at the
following commit. Because TLS 1.3 renamed the extension.
openssl/openssl@de4d764

As we only support OpenSSL version 1.1.1 or later versions, it is no problem to
use the `SSL_CTX_set1_groups_list`.

For the document of the `ossl_sslctx_set_groups`,
I referred to the following RFC 8446 TLS 1.3 Supported Groups section.
https://datatracker.ietf.org/doc/html/rfc8446#section-4.2.7
@junaruga
Copy link
Member Author

junaruga commented Jun 19, 2025

I see @rhenium opened the PR #900 before just 13 minutes that I opened this PR. :) So, I am happy to close this PR.

@junaruga junaruga closed this Jun 19, 2025
@junaruga junaruga deleted the wip/ssl-context-groups branch June 26, 2025 12:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant