Merge branch 'vfaronov-docs-ssl-context' into development

python-hyper · Mar 4, 2017 · cbee16c · cbee16c
2 parents 04f3266 + c6ae836
commit cbee16c
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/docs/source/advanced.rst b/docs/source/advanced.rst
@@ -71,7 +71,14 @@ SSL/TLS Certificate Verification
 
 By default, all HTTP/2 connections are made over TLS, and ``hyper`` bundles
 certificate authorities that it uses to verify the offered TLS certificates.
-Currently certificate verification cannot be disabled.
+
+You can change how certificates are verified by passing your own
+``ssl_context`` to the :class:`HTTPConnection <hyper.HTTPConnection>`.
+For example, this will disable verification altogether::
+
+    import ssl
+    context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+    conn = HTTPConnection('http2bin.org:443', ssl_context=context)
 
 Streaming Uploads
 -----------------