[New-bugs-announce] [issue24516] SSL create_default_socket purpose insufficiently documented

[Petr Messner]

New submission from Petr Messner:

Please, is it possible to put more information about the purpose parameter to the documentation of ssl.create_default_context()? It's not obvious that SERVER_AUTH should be used for client sockets and not server sockets. It took me a while to discover this, while all I was getting was only "SSLEOFError: EOF occurred in violation of protocol" (which is also not helpful).

This is especially confusing, because OpenSSL uses serverAuth and clientAuth (for extendedKeyUsage configuration) in the exactly opposite meaning.

----------
assignee: docs at python
components: Documentation
messages: 245852
nosy: docs at python, messa
priority: normal
severity: normal
status: open
title: SSL create_default_socket purpose insufficiently documented
type: enhancement
versions: Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24516>
_______________________________________