From 5d38206c787a675304452a007b50d3a6a65edcb8 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Sat, 19 Mar 2016 12:02:14 -0400 Subject: Mention CRYPTOGRAPHY_ALLOW_OPENSSL_098 in the FAQ --- docs/faq.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'docs') diff --git a/docs/faq.rst b/docs/faq.rst index 3456ba97..2c17e285 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -40,6 +40,19 @@ If you have no other libraries using OpenSSL in your process, or they do not appear to be at fault, it's possible that this is a bug in ``cryptography``. Please file an `issue`_ with instructions on how to reproduce it. +Importing cryptography causes a ``RuntimeError`` about OpenSSL 0.9.8 +-------------------------------------------------------------------- + +The OpenSSL project has dropped support for the 0.9.8 release series. Since it +is no longer receiving security patches from upstream, ``cryptography`` is also +dropping support for it. To fix this issue you should upgrade to a newer +version of OpenSSL (1.0.1 or later), this may require you to upgrade to a newer +operating system. + +For the 1.4 release, you can set the ``CRYPTOGRAPHY_ALLOW_OPENSSL_098`` +environment variable. Please note that this is *temporary* and will be removed +in ``cryptography`` 1.5. + .. _`NaCl`: https://nacl.cr.yp.to/ .. _`PyNaCl`: https://pynacl.readthedocs.org .. _`WSGIApplicationGroup`: https://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIApplicationGroup.html -- cgit v1.2.3