U
fK
@ sX U d Z ddlmZ ddlZddlmZ zddlmZ W n$ e k
rZ G dd de
ZY nX ddl Z ddl Z ddl
Z
ddlmZ dd lmZ dd
lmZ d d lmZ e
jrdd
lmZ ddgZejjejj ejj ejj e j ejj iZ de!d< e"e dre"ejdrejj#e e j$< e"e drde!d%< d&Z?ejj@ZAe BeCZDd'd(d)dZEd'd(d*dZFd'd(d+d,ZGd-d.d/d0d1ZHd2d3d4d5d6ZIG d7d8 d8ZJejKeJ_KG d9d: d:ZLd;d2ddddd?ZMdS )@a
Module for using pyOpenSSL as a TLS backend. This module was relevant before
the standard library ``ssl`` module supported SNI, but now that we've dropped
support for Python 2.7 all relevant Python versions support SNI so
**this module is no longer recommended**.
This needs the following packages installed:
* `pyOpenSSL`_ (tested with 16.0.0)
* `cryptography`_ (minimum 1.3.4, from pyopenssl)
* `idna`_ (minimum 2.0)
However, pyOpenSSL depends on cryptography, so while we use all three directly here we
end up having relatively few packages required.
You can install them with the following command:
.. code-block:: bash
$ python -m pip install pyopenssl cryptography idna
To activate certificate checking, call
:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
before you begin making HTTP requests. This can be done in a ``sitecustomize``
module, or at any other time before your application begins using ``urllib3``,
like this:
.. code-block:: python
try:
import urllib3.contrib.pyopenssl
urllib3.contrib.pyopenssl.inject_into_urllib3()
except ImportError:
pass
.. _pyopenssl: https://www.pyopenssl.org
.. _cryptography: https://cryptography.io
.. _idna: https://github.com/kjd/idna
) annotationsN)x509)UnsupportedExtensionc @ s e Zd ZdS )r N)__name__
__module__ __qualname__ r r J/opt/alt/python38/lib/python3.8/site-packages/urllib3/contrib/pyopenssl.pyr 2 s r )BytesIO)socket)timeout )utilX509inject_into_urllib3extract_from_urllib3zdict[int, int]_openssl_versionsPROTOCOL_TLSv1_1TLSv1_1_METHODPROTOCOL_TLSv1_2TLSv1_2_METHODc C s i | ]\}}||qS r r ).0kvr r r
Y s r OP_NO_SSLv2 OP_NO_SSLv3int_OP_NO_SSLv2_OR_SSLv3 OP_NO_TLSv1 _OP_NO_TLSv1
OP_NO_TLSv1_1_OP_NO_TLSv1_1
OP_NO_TLSv1_2_OP_NO_TLSv1_2
OP_NO_TLSv1_3_OP_NO_TLSv1_3 _openssl_to_ssl_minimum_version _openssl_to_ssl_maximum_versioni @ Nonereturnc C s& t tt_ttj_dt_dtj_dS )z7Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.TN)_validate_dependencies_metPyOpenSSLContextr
SSLContextssl_ IS_PYOPENSSLr r r r r s
c C s t t_t tj_dt_dtj_dS )z4Undo monkey-patching by :func:`inject_into_urllib3`.FN)orig_util_SSLContextr r/ r0 r1 r r r r r s c C sR ddl m} t| dddkr$tdddlm} | }t|dddkrNtddS ) z{
Verifies that PyOpenSSL's package-level dependencies have been met.
Throws `ImportError` if they are not met.
r )
Extensionsget_extension_for_classNzX'cryptography' module missing required functionality. Try upgrading to v1.3.4 or newer.r Z_x509zS'pyOpenSSL' module missing required functionality. Try upgrading to v0.14 or newer.)Z cryptography.x509.extensionsr3 getattr ImportErrorOpenSSL.cryptor )r3 r r r r r r- s r- str
str | Nonenamer, c C s: ddddd}d| kr | S || }|dkr0dS | dS ) a%
Converts a dNSName SubjectAlternativeName field to the form used by the
standard library on the given Python version.
Cryptography produces a dNSName as a unicode string that was idna-decoded
from ASCII bytes. We need to idna-encode that string to get it back, and
then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).
If the name cannot be idna-encoded then we return None signalling that
the name given should be skipped.
r8 bytes | Noner: c S sr ddl }zJdD ]8}| |r| t|d } |d|| W S q|| W S |jjk
rl Y dS X dS )z
Borrowed wholesale from the Python Cryptography Project. It turns out
that we can't just safely call `idna.encode`: it can explode for
wildcard names. This avoids that problem.
r N)z*..ascii)idna
startswithlenencodecore IDNAError)r; r? prefixr r r idna_encode s
z'_dnsname_to_stdlib..idna_encode:Nutf-8)decode)r; rF encoded_namer r r _dnsname_to_stdlib s rK r zlist[tuple[str, str]]) peer_certr, c C s | }z|jtjj}W nZ tjk
r6 g Y S tjttj t
fk
rv } zt d| g W Y S d}~X Y nX dd t
t|tjD }|dd |tjD |S )zU
Given an PyOpenSSL certificate, provides all the subject alternative names.
zA problem was encountered with the certificate that prevented urllib3 from finding the SubjectAlternativeName field. This can affect certificate validation. The error was %sNc S s g | ]}|d k rd|fqS )NDNSr r r; r r r
s z%get_subj_alt_name..c s s | ]}d t |fV qdS )z
IP AddressN)r8 rN r r r s z$get_subj_alt_name..)Zto_cryptography
extensionsr4 r ZSubjectAlternativeNamevalueZExtensionNotFoundZDuplicateExtensionr ZUnsupportedGeneralNameType UnicodeErrorlogwarningmaprK Zget_values_for_typeZDNSNameextendZ IPAddress)rL certextenamesr r r get_subj_alt_name s.
r\ c @ s e Zd ZdZd2ddddddd Zd
d d d
Zdd ddZddddddZddd
dddZdddddZ dd
dd d Z
dddd d Z dd d d!Z dd d"d#Z
dd d$d%Zd3dd'd(d)d*Zd+d d,d-Zd.d d/d0Zd1S )4
WrappedSocketz@API-compatibility wrapper for Python OpenSSL's Connection-class.TOpenSSL.SSL.Connection
socket_clsboolr* )
connectionr suppress_ragged_eofsr, c C s" || _ || _|| _d| _d| _d S Nr F)ra r rb _io_refs_closed)selfra r rb r r r __init__ s
zWrappedSocket.__init__r r+ c C s
| j S N)r filenorf r r r ri ! s zWrappedSocket.filenoc C s* | j dkr| j d8 _ | jr&| d S )Nr )rd re closerj r r r _decref_socketios% s
z WrappedSocket._decref_socketiosz
typing.Anybytes)argskwargsr, c
O s4 z| j j||}W n tjjk
rj } z4| jrD|jdkrDW Y dS t|jd t||W 5 d }~X Y n tjj k
r | j
tjj krY dS Y n tjj k
r } z8t
| j| j std|n| j|| W Y S W 5 d }~X Y n> tjjk
r* } ztd||W 5 d }~X Y nX |S d S )NzUnexpected EOF r The read operation timed out read error: )ra recvOpenSSLSSL SysCallErrorrb ro OSErrorr8 ZeroReturnError get_shutdownRECEIVED_SHUTDOWN
WantReadErrorr
wait_for_readr
gettimeoutr ErrorsslSSLError)rf ro rp datarZ r r r rv + s"
& $$zWrappedSocket.recvc
O s, z| j j||W S tjjk
rf } z4| jr@|jdkr@W Y dS t|jd t||W 5 d }~X Y n tjj k
r | j
tjj krY dS Y n tjj k
r } z8t
| j| j std|n| j|| W Y S W 5 d }~X Y n: tjjk
r& } ztd||W 5 d }~X Y nX d S )Nrq r rt ru )ra recv_intorw rx ry rb ro rz r8 r{ r| r} r~ r r r r r r r r )rf ro rp rZ r r r r D s
& $zWrappedSocket.recv_intofloat)r r, c C s | j |S rh )r
settimeout)rf r r r r r [ s zWrappedSocket.settimeout)r r, c
C s z| j |W S tjjk
rX } z(t| j| j s@t |W Y q W 5 d }~X Y q tjj
k
r } zt |j d t
||W 5 d }~X Y q X q d S Nr )ra sendrw rx ZWantWriteErrorr wait_for_writer r r ry rz ro r8 )rf r rZ r r r _send_until_done^ s z WrappedSocket._send_until_donec C s4 d}|t |k r0| |||t }||7 }qd S r )rA r SSL_WRITE_BLOCKSIZE)rf r
total_sentsentr r r sendalli s zWrappedSocket.sendallc C s | j d S rh )ra shutdownrj r r r r q s zWrappedSocket.shutdownc C s d| _ | jdkr| d S )NTr )re rd _real_closerj r r r rl u s
zWrappedSocket.closec C s, z | j W S tjjk
r& Y d S X d S rh )ra rl rw rx r rj r r r r z s zWrappedSocket._real_closeFz"dict[str, list[typing.Any]] | None) binary_formr, c C sD | j }|s|S |r(tjtjj|S d| jffft|dS )N
commonName)subjectsubjectAltName) ra Zget_peer_certificaterw ZcryptoZdump_certificateZ
FILETYPE_ASN1Z get_subjectZCNr\ )rf r r r r r getpeercert s
zWrappedSocket.getpeercertr8 c C s
| j S rh )ra Zget_protocol_version_namerj r r r version s zWrappedSocket.versionr9 c C s | j }|r| S d S rh )ra Zget_alpn_proto_negotiatedrI )rf Z
alpn_protor r r selected_alpn_protocol s
z$WrappedSocket.selected_alpn_protocolN)T)F)r r r __doc__rg ri rm rv r r r r r rl r r r r r r r r r] s" r] c @ sB e Zd ZdZdddddZedddd Zejddd
d d Zeddd d
Zejddd
dd
ZddddZ dddddZ
d7dddddddZ d8d dddd d d Z d dd!d"d#Z
d9d&d'd'd'd(d)d*d+d,Zddd-d.Zeddd/d0Zejddd1d2d0Zeddd3d4Zejddd5d6d4ZdS ):r. z
I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
for translating the interface of the standard library ``SSLContext`` object
to calls into PyOpenSSL.
r r* )protocolr, c C s> t | | _tj| j| _d| _d| _tj j
| _ tj j | _
d S rc )r r rw rx Context_ctx_optionscheck_hostnamer
TLSVersionMINIMUM_SUPPORTED_minimum_versionMAXIMUM_SUPPORTED_maximum_version)rf r r r r rg s
zPyOpenSSLContext.__init__r+ c C s | j S rh )r rj r r r options s zPyOpenSSLContext.options)rR r, c C s || _ | d S rh )r _set_ctx_optionsrf rR r r r r s c C s t | j S rh )_openssl_to_stdlib_verifyr Zget_verify_moderj r r r verify_mode s z PyOpenSSLContext.verify_modezssl.VerifyModec C s | j t| t d S rh )r Z
set_verify_stdlib_to_openssl_verify_verify_callbackr r r r r s c C s | j d S rh )r set_default_verify_pathsrj r r r r s z)PyOpenSSLContext.set_default_verify_pathsz bytes | str)ciphersr, c C s$ t |tr|d}| j| d S )NrH )
isinstancer8 rB r Zset_cipher_list)rf r r r r set_ciphers s
z PyOpenSSLContext.set_ciphersNr9 r< )cafilecapathcadatar, c
C s |d k r| d}|d k r$| d}z*| j|| |d k rL| jt| W n8 tjjk
r } ztd||W 5 d }~X Y nX d S )NrH z%unable to load trusted certificates: ) rB r load_verify_locationsr
rw rx r r r )rf r r r rZ r r r r s
z&PyOpenSSLContext.load_verify_locationsr8 )certfilekeyfilepasswordr, c
s zP| j | d k r>t ts* d | j fdd | j |pJ| W n8 tjj k
r } zt
d||W 5 d }~X Y nX d S )NrH c s S rh r )_r r r rs z2PyOpenSSLContext.load_cert_chain..z"Unable to load certificate chain: ) r Zuse_certificate_chain_filer rn rB Z
set_passwd_cbZuse_privatekey_filerw rx r r r )rf r r r rZ r r r load_cert_chain s
z PyOpenSSLContext.load_cert_chainzlist[bytes | str]) protocolsr, c C s dd |D }| j |S )Nc S s g | ]}t j |d qS )r> )r to_bytes)r pr r r rO s z7PyOpenSSLContext.set_alpn_protocols..)r Zset_alpn_protos)rf r r r r set_alpn_protocols s z#PyOpenSSLContext.set_alpn_protocolsFTr_ r` zbytes | str | Noner] )sock server_sidedo_handshake_on_connectrb server_hostnamer, c
C s t j| j|}|r>tj|s>t|tr4| d}|
| | z | W q t jj
k
r } z&t|| std|W Y qFW 5 d }~X Y q t jjk
r } ztd||W 5 d }~X Y qX qqFt||S )NrH zselect timed outzbad handshake: )rw rx
Connectionr r r0 is_ipaddressr r8 rB Zset_tlsext_host_nameZset_connect_state do_handshaker~ r r r r r r r] )rf r r r rb r cnxrZ r r r wrap_socket s
$z PyOpenSSLContext.wrap_socketc C s& | j | jt| j B t| j B d S rh )r Z set_optionsr r( r r) r rj r r r r s z!PyOpenSSLContext._set_ctx_optionsc C s | j S rh )r rj r r r minimum_version s z PyOpenSSLContext.minimum_version)r r, c C s || _ | d S rh )r r )rf r r r r r s c C s | j S rh )r rj r r r maximum_version s z PyOpenSSLContext.maximum_version)r r, c C s || _ | d S rh )r r )rf r r r r r s )NNN)NN)FTTN)r r r r rg propertyr setterr r r r r r r r r r r r r r r. sD r. r^ r` )r r err_no err_depth return_coder, c C s |dkS r r )r r r r r r r r r ! s r )Nr
__future__r Z OpenSSL.SSLrw Z cryptographyr Zcryptography.x509r r6 Exceptionloggingr typingior
r r_ r r
TYPE_CHECKINGr7 r __all__r0 PROTOCOL_TLSrx Z
SSLv23_METHODPROTOCOL_TLS_CLIENTPROTOCOL_TLSv1Z TLSv1_METHODr __annotations__hasattrr r r r CERT_NONEZ VERIFY_NONE
CERT_OPTIONALZ VERIFY_PEER
CERT_REQUIREDZVERIFY_FAIL_IF_NO_PEER_CERTr itemsr r5 r r! r# r% r' r r TLSv1TLSv1_1TLSv1_2TLSv1_3r r( r) r r/ r2 getLoggerr rT r r r- rK r\ r] makefiler. r r r r r s (
)0