New submission from Nick Coghlan:

The ssl docs currently have a security warning at the top directing users to 
the Security Considerations section at 
http://docs.python.org/3/library/ssl#ssl-security

That section currently dives directly into the technical details of choosing 
suitable SSL settings, and doesn't reference back to the new 
http://docs.python.org/3/library/ssl#ssl.create_default_context helper function.

I believe this section should *start* with an example of using the 
create_default_context() to create an SSL wrapped socket with reasonable 
settings, and only *then* continue on with the technical details.

----------
assignee: docs@python
components: Documentation
messages: 214173
nosy: alex, christian.heimes, docs@python, giampaolo.rodola, janssen, ncoghlan, 
pitrou
priority: normal
severity: normal
stage: needs patch
status: open
title: Recommend ssl.create_default_context() in "Security considerations"
type: enhancement
versions: Python 3.4, Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue20988>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to