From: Senthil Kumaran Date: Sat, 28 Jan 2017 07:05:34 +0000 (-0800) Subject: Add clarity to the warning on certificate verification in urllib. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=19048c3ada0a0ad5c3fd76099dc028d6261a06fa;p=python Add clarity to the warning on certificate verification in urllib. --- diff --git a/Doc/library/urllib.rst b/Doc/library/urllib.rst index 439482aeb9..2a5ea717f0 100644 --- a/Doc/library/urllib.rst +++ b/Doc/library/urllib.rst @@ -26,11 +26,16 @@ reading, and no seek operations are available. .. seealso:: - The `Requests package `_ + The `Requests package `_ is recommended for a higher-level HTTP client interface. -.. warning:: When opening HTTPS URLs, it does not attempt to validate the - server certificate. Use at your own risk! +.. versionchanged:: 2.7.9 + + For HTTPS URIs, :mod:`urllib` performs all the neccessary certificate and hostname checks by default. + +.. warning:: + + For Python versions earlier than 2.7.9, urllib does not attempt to validate the server certificates of HTTPS URIs. Use at your own risk! High-level interface @@ -142,7 +147,7 @@ High-level interface :envvar:`no_proxy` environment variable. .. versionchanged:: 2.7.9 - The *context* parameter was added. + The *context* parameter was added. All the neccessary certificate and hostname checks are done by default. .. deprecated:: 2.6 The :func:`urlopen` function has been removed in Python 3 in favor