summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorPaul Bailey <paul.m.bailey@gmail.com>2018-10-08 18:49:29 (GMT)
committerAndrew Svetlov <andrew.svetlov@gmail.com>2018-10-08 18:49:29 (GMT)
commit4c339970570d07916bee6ade51f4e9781d51627a (patch)
treed389f9afd8cdb4e2a02e4d941d983cbecccb07e6 /Doc/library
parentaf5658ae93b0a87ab4420a7dc30a07fa5a83e252 (diff)
downloadcpython-4c339970570d07916bee6ade51f4e9781d51627a.zip
cpython-4c339970570d07916bee6ade51f4e9781d51627a.tar.gz
cpython-4c339970570d07916bee6ade51f4e9781d51627a.tar.bz2
bpo-34911: Added support for secure websocket cookies (GH-9734)
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/http.cookiejar.rst10
1 files changed, 6 insertions, 4 deletions
diff --git a/Doc/library/http.cookiejar.rst b/Doc/library/http.cookiejar.rst
index d8da668..4c8be29 100644
--- a/Doc/library/http.cookiejar.rst
+++ b/Doc/library/http.cookiejar.rst
@@ -78,14 +78,16 @@ The following classes are provided:
from / returned to the server.
-.. class:: DefaultCookiePolicy( blocked_domains=None, allowed_domains=None, netscape=True, rfc2965=False, rfc2109_as_netscape=None, hide_cookie2=False, strict_domain=False, strict_rfc2965_unverifiable=True, strict_ns_unverifiable=False, strict_ns_domain=DefaultCookiePolicy.DomainLiberal, strict_ns_set_initial_dollar=False, strict_ns_set_path=False )
+.. class:: DefaultCookiePolicy( blocked_domains=None, allowed_domains=None, netscape=True, rfc2965=False, rfc2109_as_netscape=None, hide_cookie2=False, strict_domain=False, strict_rfc2965_unverifiable=True, strict_ns_unverifiable=False, strict_ns_domain=DefaultCookiePolicy.DomainLiberal, strict_ns_set_initial_dollar=False, strict_ns_set_path=False, secure_protocols=("https", "wss") )
Constructor arguments should be passed as keyword arguments only.
*blocked_domains* is a sequence of domain names that we never accept cookies
from, nor return cookies to. *allowed_domains* if not :const:`None`, this is a
- sequence of the only domains for which we accept and return cookies. For all
- other arguments, see the documentation for :class:`CookiePolicy` and
- :class:`DefaultCookiePolicy` objects.
+ sequence of the only domains for which we accept and return cookies.
+ *secure_protocols* is a sequence of protocols for which secure cookies can be
+ added to. By default *https* and *wss* (secure websocket) are considered
+ secure protocols. For all other arguments, see the documentation for
+ :class:`CookiePolicy` and :class:`DefaultCookiePolicy` objects.
:class:`DefaultCookiePolicy` implements the standard accept / reject rules for
Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (ie. cookies