Skip to content

gh-154517: Document OpenSSL version requirements and post-quantum groups for the ssl group API#154518

Open
fedonman wants to merge 3 commits into
python:mainfrom
fedonman:docs-ssl-pqc-groups
Open

gh-154517: Document OpenSSL version requirements and post-quantum groups for the ssl group API#154518
fedonman wants to merge 3 commits into
python:mainfrom
fedonman:docs-ssl-pqc-groups

Conversation

@fedonman

@fedonman fedonman commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

This fills a few gaps in the ssl module documentation around the key agreement group API added in 3.15.

SSLSocket.group() and SSLContext.get_groups() now state which OpenSSL version they need and that they raise NotImplementedError on older versions. SSLContext.set_groups() gains a short example that prefers the post-quantum hybrid group X25519MLKEM768 and falls back to X25519, along with a note about the OpenSSL 3.5 requirement and the SSLError raised for an unknown group. set_ecdh_curve() now points at the more general set_groups(), and the TLS 1.3 section mentions post-quantum hybrid key agreement.

This is documentation only, so there is no news entry.

@read-the-docs-community

read-the-docs-community Bot commented Jul 23, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33718373 | 📁 Comparing e56cc61 against main (206788a)

  🔍 Preview build  

1 file changed
± library/ssl.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

1 participant