This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: SSLError when cancelling an SSL connection
Type: Stage: resolved
Components: asyncio Versions: Python 3.11
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: Nosy List: asvetlov, kumaraditya, mehaase, yselivanov
Priority: normal Keywords:

Created on 2017-06-23 14:08 by mehaase, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (2)
msg296720 - (view) Author: Mark Haase (mehaase) * Date: 2017-06-23 14:08
If a task is cancelled while it waiting for SSL negotiation, then an SSLError is raised, but there is no way (as far as I can tell) for the caller to catch it. (The example below is pretty contrived, but in an application I'm working on, the user can cancel downloads at any time.) Here's an example:

    import asyncio, random, ssl

    async def download(host):
        ssl_context = ssl.create_default_context()
        reader, writer = await asyncio.open_connection(host, 443, ssl=ssl_context)
        request = f'HEAD / HTTP/1.1\r\nHost: {host}\r\n\r\n'
        lines = list()
        while True:
            newdata = await reader.readline()
            if newdata == b'\r\n':
        return lines[0]

    async def main():
        while True:
            task = asyncio.Task(download(''))
            await asyncio.sleep(random.uniform(0.0, 0.5))
                response = await task
            except asyncio.CancelledError:
                print('request cancelled!')
            except ssl.SSLError:
                print('caught SSL error')
            await asyncio.sleep(1)

    loop = asyncio.get_event_loop()

Running this script yields the following output:

    HTTP/1.1 200 OK
    request cancelled!
    HTTP/1.1 200 OK
    HTTP/1.1 200 OK
    <asyncio.sslproto.SSLProtocol object at 0x7fe7c00e5a20>: SSL handshake failed
    Traceback (most recent call last):
      File "/usr/lib/python3.6/asyncio/", line 803, in _create_connection_transport
        yield from waiter
      File "/usr/lib/python3.6/asyncio/", line 304, in _wakeup

    During handling of the above exception, another exception occurred:

    Traceback (most recent call last):
      File "/usr/lib/python3.6/asyncio/", line 577, in _on_handshake_complete
        raise handshake_exc
      File "/usr/lib/python3.6/asyncio/", line 638, in _process_write_backlog
        ssldata = self._sslpipe.shutdown(self._finalize)
      File "/usr/lib/python3.6/asyncio/", line 155, in shutdown
        ssldata, appdata = self.feed_ssldata(b'')
      File "/usr/lib/python3.6/asyncio/", line 219, in feed_ssldata
      File "/usr/lib/python3.6/", line 692, in unwrap
        return self._sslobj.shutdown()
    ssl.SSLError: [SSL] shutdown while in init (_ssl.c:2299)

I posted this on async-sig, and Nathaniel replied:

> SSLObject.unwrap has the contract that if it finishes successfully, then the SSL connection has been cleanly shut down and both sides remain in sync, and can continue to use the socket in unencrypted mode. When asyncio calls unwrap before the handshake has completed, then this contract is impossible to fulfill, and raising an error is the right thing to do. So imo the ssl module is correct here, and this is a (minor) bug in asyncio.

The unwrap() call that throws is already wrapped in `try ... except SSLError` but the exception handler checks for specific SSL error codes and re-throws this particular SSL error. 

        except (ssl.SSLError, ssl.CertificateError) as exc:
            if getattr(exc, 'errno', None) not in (
                    ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE,
                if self._state == _DO_HANDSHAKE and self._handshake_cb:
            self._need_ssldata = (exc.errno == ssl.SSL_ERROR_WANT_READ)

I think this could be fixed checking for SSL_R_SHUTDOWN_WHILE_IN_INIT in this exception handler, but that constant doesn't exist in _ssl.c.

As an alternative, maybe a new state _ABORT_HANDSHAKE could be introduced (the existing states are _DO_HANDSHAKE, _WRAPPED, _SHUTDOWN, and _UNWRAP).

I'm happy to try my hand at either one of these approaches if somebody can point me in the right direction.
msg414796 - (view) Author: Kumar Aditya (kumaraditya) * (Python triager) Date: 2022-03-09 12:06
This is fixed on main branch with bpo-44011 and does not raises exception. This can be closed now @asvetlov.
Date User Action Args
2022-04-11 14:58:48adminsetgithub: 74925
2022-03-10 01:49:02asvetlovsetstatus: open -> closed
resolution: fixed
stage: resolved
2022-03-09 12:06:45kumaradityasetnosy: + asvetlov, kumaraditya

messages: + msg414796
versions: + Python 3.11, - Python 3.6
2017-06-23 14:08:45mehaasecreate