a
t~`A @ st d Z ddlmZ ddlZddlmZ ddlmZ ddl
m Z zddl m
Z
W n" eyn G dd d eZ
Y n0 dd
lmZ dd lmZ dd lmZ zdd
lmZ W n" ey dZddlmZ Y n0 ddlZddlZddlZddl m Z ddl m Z ddl m!Z! ddgZ"dZ#e j$ej%j&e!ej%j&ej'ej%j(iZ)e*edrXe*ej%drXej%j+e)ej,< e*edre*ej%drej%j-e)ej.< e*edre*ej%drej%j/e)ej0< ej1ej%j2ej3ej%j4ej5ej%j4ej%j6 iZ7e8d d e79 D Z:d Z;e j#ZZ?e@eAZBd d ZCd d ZDd!d" ZEd#d$ ZFd%d& ZGG d'd( d(eHZIerNd0d*d+ZJneZJeJeI_JG d,d- d-eHZKd.d/ ZLdS )1a
TLS with SNI_-support for Python 2. Follow these instructions if you would
like to verify TLS certificates in Python 2. Note, the default libraries do
*not* do certificate checking; you need to do additional work to validate
certificates yourself.
This needs the following packages installed:
* `pyOpenSSL`_ (tested with 16.0.0)
* `cryptography`_ (minimum 1.3.4, from pyopenssl)
* `idna`_ (minimum 2.0, from cryptography)
However, pyopenssl depends on cryptography, which depends on idna, 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
Now you can use :mod:`urllib3` as you normally would, and it will support SNI
when the required modules are installed.
Activating this module also has the positive side effect of disabling SSL/TLS
compression in Python 2 (see `CRIME attack`_).
.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
.. _pyopenssl: https://www.pyopenssl.org
.. _cryptography: https://cryptography.io
.. _idna: https://github.com/kjd/idna
)absolute_importN)x509)backend) _Certificate)UnsupportedExtensionc @ s e Zd ZdS )r N)__name__
__module__ __qualname__ r
r
=/usr/lib/python3.9/site-packages/urllib3/contrib/pyopenssl.pyr ; s r )BytesIO)error)timeout) _fileobject )backport_makefile)util)six)PROTOCOL_TLS_CLIENTinject_into_urllib3extract_from_urllib3TPROTOCOL_SSLv3 SSLv3_METHODPROTOCOL_TLSv1_1TLSv1_1_METHODPROTOCOL_TLSv1_2TLSv1_2_METHODc c s | ]\}}||fV qd S Nr
).0kvr
r
r m r! i @ c C s4 t tt_ttj_tt_ttj_dt_dtj_dS )z7Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.TN)_validate_dependencies_metPyOpenSSLContextr
SSLContextssl_HAS_SNI IS_PYOPENSSLr
r
r
r r y s c C s. t t_t tj_tt_ttj_dt_dtj_dS )z4Undo monkey-patching by :func:`inject_into_urllib3`.FN)orig_util_SSLContextr r% r& orig_util_HAS_SNIr' r( r
r
r
r r s c C sR ddl m} t| dddu r$tdddlm} | }t|dddu rNtddS ) 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.)X509_x509zS'pyOpenSSL' module missing required functionality. Try upgrading to v0.14 or newer.)Z cryptography.x509.extensionsr+ getattr ImportErrorZOpenSSL.cryptor- )r+ r- r r
r
r r# s r# c C s@ dd }d| v r| S || } | du r(dS t jdkr<| d} | S )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.
c S sp ddl }zJdD ]8}| |r| t|d } |d|| W S q|| W S |jjyj Y dS 0 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
startswithlenencodeZcoreZ IDNAError)namer3 prefixr
r
r idna_encode s
z'_dnsname_to_stdlib..idna_encode:N) r utf-8)sys version_infodecode)r7 r9 r
r
r _dnsname_to_stdlib s
r@ c C s t | dr| }n tt| j}z|jtjj }W nV tj
yL g Y S tj t tj
tfy } z td| g W Y d}~S d}~0 0 dd tt|tjD }|dd |tjD |S )zU
Given an PyOpenSSL certificate, provides all the subject alternative names.
to_cryptographyzA 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 urd|fqS )NZDNSr
r r7 r
r
r
s z%get_subj_alt_name..c s s | ]}d t |fV qdS )z
IP AddressN)strrB r
r
r r! s z$get_subj_alt_name..)hasattrrA r openssl_backendr.
extensionsr, r ZSubjectAlternativeNamevalueZExtensionNotFoundZDuplicateExtensionr ZUnsupportedGeneralNameType UnicodeErrorlogZwarningmapr@ Zget_values_for_typeZDNSNameextendZ IPAddress)Z peer_certZcertextenamesr
r
r get_subj_alt_name s2
rP c @ s e Zd ZdZd!ddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dd Z dd Z
d"ddZdd Zd d Zd d Zd S )#
WrappedSocketzAPI-compatibility wrapper for Python OpenSSL's Connection-class.
Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
collector of pypy.
Tc C s" || _ || _|| _d| _d| _d S Nr F)
connectionsocketsuppress_ragged_eofs_makefile_refs_closed)selfrS rT rU r
r
r __init__ s
zWrappedSocket.__init__c C s
| j S r )rT filenorX r
r
r rZ s zWrappedSocket.filenoc C s* | j dkr| j d8 _ | jr&| d S )Nr )rV rW closer[ r
r
r _decref_socketios s
z WrappedSocket._decref_socketiosc
O s z| j j|i |}W n tjjyj } z6| jrJ|jdkrJW Y d }~dS tt|W Y d }~nd }~0 tjj y | j
tjj krY dS Y n tjj y t
| j| j stdn| j|i | Y S Y n< tjjy } ztd| W Y d }~nd }~0 0 |S d S )NzUnexpected EOFr" The read operation timed outread error: %r)rS recvOpenSSLSSL SysCallErrorrU args SocketErrorrD ZeroReturnError get_shutdownRECEIVED_SHUTDOWN
WantReadErrorr
wait_for_readrT
gettimeoutr ErrorsslSSLError)rX rg kwargsdatarN r
r
r rc $ s"
$zWrappedSocket.recvc
O s z| j j|i |W S tjjyf } z6| jrF|jdkrFW Y d }~dS tt|W Y d }~nd }~0 tjj y | j
tjj krY dS Y n~ tjj y t
| j| j stdn| j|i | Y S Y n8 tjjy } ztd| W Y d }~n
d }~0 0 d S )Nr_ r ra rb )rS recv_intord re rf rU rg rh rD ri rj rk rl r rm rT rn r ro rp rq )rX rg rr rN r
r
r rt = s
zWrappedSocket.recv_intoc C s | j |S r )rT
settimeout)rX r r
r
r ru T s zWrappedSocket.settimeoutc
C s| z| j |W S tjjyB t| j| j s:t Y q Y q tjj
yt } zt t |W Y d }~q d }~0 0 q d S r )
rS sendrd re ZWantWriteErrorr Zwait_for_writerT rn r rf rh rD )rX rs rN r
r
r _send_until_doneW s z WrappedSocket._send_until_donec C s4 d}|t |k r0| |||t }||7 }qd S Nr )r5 rw SSL_WRITE_BLOCKSIZE)rX rs Z
total_sentsentr
r
r sendallb s zWrappedSocket.sendallc C s | j d S r )rS shutdownr[ r
r
r r| j s zWrappedSocket.shutdownc C sJ | j dk r8zd| _| j W S tjjy4 Y d S 0 n| j d8 _ d S )Nr\ T)rV rW rS r] rd re ro r[ r
r
r r] n s
zWrappedSocket.closeFc C sD | j }|s|S |r(tjtjj|S d| jffft|dS )NZ
commonName)ZsubjectZsubjectAltName) rS Zget_peer_certificaterd ZcryptoZdump_certificateZ
FILETYPE_ASN1Z get_subjectZCNrP )rX Z binary_formr r
r
r getpeercertx s
zWrappedSocket.getpeercertc C s
| j S r )rS Zget_protocol_version_namer[ r
r
r version s zWrappedSocket.versionc C s | j d7 _ d S Nr\ )rV r[ r
r
r _reuse s zWrappedSocket._reusec C s& | j dk r| n| j d8 _ d S r )rV r] r[ r
r
r _drop s
zWrappedSocket._dropN)T)F)r r r __doc__rY rZ r^ rc rt ru rw r{ r| r] r} r~ r r r
r
r
r rQ s
rQ r` c C s | j d7 _ t| ||ddS )Nr\ T)r] )rV r )rX modebufsizer
r
r makefile s r c @ s e Zd ZdZdd Zedd Zejdd Zedd Zejd d Zd
d Z d d
Z
dddZ dddZ dd Z
dddZdS ) 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.
c C s* t | | _tj| j| _d| _d| _d S rR )_openssl_versionsprotocolrd re ZContext_ctx_optionsZcheck_hostname)rX r r
r
r rY s
zPyOpenSSLContext.__init__c C s | j S r )r r[ r
r
r options s zPyOpenSSLContext.optionsc C s || _ | j| d S r )r r Z set_optionsrX rH r
r
r r s c C s t | j S r )_openssl_to_stdlib_verifyr Zget_verify_moder[ r
r
r verify_mode s z PyOpenSSLContext.verify_modec C s | j t| t d S r )r Z
set_verify_stdlib_to_openssl_verify_verify_callbackr r
r
r r s c C s | j d S r )r set_default_verify_pathsr[ r
r
r r s z)PyOpenSSLContext.set_default_verify_pathsc C s& t |tjr|d}| j| d S )Nr< )
isinstancer text_typer6 r Zset_cipher_list)rX Zciphersr
r
r set_ciphers s
z PyOpenSSLContext.set_ciphersNc
C s |d ur| d}|d ur$| d}z*| j|| |d urL| jt| W n6 tjjy } ztd| W Y d }~n
d }~0 0 d S )Nr< z'unable to load trusted certificates: %r) r6 r load_verify_locationsr rd re ro rp rq )rX ZcafileZcapathZcadatarN r
r
r r s
z&PyOpenSSLContext.load_verify_locationsc sR | j | d ur>t tjs* d | j fdd | j |pJ| d S )Nr< c s S r r
)_passwordr
r r" z2PyOpenSSLContext.load_cert_chain..)r Zuse_certificate_chain_filer r Z binary_typer6 Z
set_passwd_cbZuse_privatekey_file)rX ZcertfileZkeyfiler r
r r load_cert_chain s
z PyOpenSSLContext.load_cert_chainc C s dd |D }| j |S )Nc S s g | ]}t |qS r
)r Z
ensure_binary)r pr
r
r rC r" z7PyOpenSSLContext.set_alpn_protocols..)r Zset_alpn_protos)rX Z protocolsr
r
r set_alpn_protocols s z#PyOpenSSLContext.set_alpn_protocolsFTc
C s t j| j|}t|tjr&|d}|d ur8|| | z |
W q t jj y~ t
|| svtdY q@Y q t jjy } ztd| W Y d }~qd }~0 0 qq@t||S )Nr< zselect timed outzbad handshake: %r)rd re Z
Connectionr r r r r6 Zset_tlsext_host_nameZset_connect_stateZ do_handshakerl r rm rn r ro rp rq rQ )rX ZsockZ server_sideZdo_handshake_on_connectrU Zserver_hostnamecnxrN r
r
r wrap_socket s
$z PyOpenSSLContext.wrap_socket)NNN)NN)FTTN)r r r r rY propertyr setterr r r r r r r r
r
r
r r$ s(
r$ c C s |dkS rx r
)r r Zerr_noZ err_depthZ return_coder
r
r r s r )r` )Mr Z
__future__r Z OpenSSL.SSLrd Z cryptographyr Z$cryptography.hazmat.backends.opensslr rF Z)cryptography.hazmat.backends.openssl.x509r Zcryptography.x509r r0 Exceptionior rT r
rh r r Zpackages.backports.makefiler Zloggingrp r= r Zpackagesr Z util.ssl_r __all__r' Z PROTOCOL_TLSre Z
SSLv23_METHODZPROTOCOL_TLSv1Z TLSv1_METHODr rE r r r r r r Z CERT_NONEZ VERIFY_NONEZ
CERT_OPTIONALZ VERIFY_PEERZ
CERT_REQUIREDZVERIFY_FAIL_IF_NO_PEER_CERTr dictitemsr ry r* r& r% r) Z getLoggerr rJ r r r# r@ rP objectrQ r r$ r r
r
r
r sv /
+6 ^