3
Z'ícB ã @ s d Z ddlmZ ddlZddlZddlmZ ddlm Z
yddl m Z W n$ e
k
rl G dd deZ Y nX dd lmZ dd
lmZ dd lmZ ydd lmZ W n$ e
k
rÆ dZd
dlmZ Y nX ddlZddlZddlZddlZd
dl m Z d
dl m Z d
dl m!Z! ej"de#d
d ddgZ$dZ%e j&ej'j(e!ej'j(ej)ej'j*iZ+e,edrpe,ej'drpej'j-e+ej.< e,edre,ej'drej'j/e+ej0< e,edrÀe,ej'd rÀej'j1e+ej2< ej3ej'j4ej5ej'j6ej7ej'j6ej'j8 iZ9e:d d e9j; D Z<d Z=e j%Z>e j?j@ZAejBeCZDd d ZEd!d ZFd"d# ZGd$d% ZHd&d' ZIG d(d) d)eJZKerfd2d+d,ZLneZLeLeK_LG d-d. d.eJZMd/d0 ZNdS )3a
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)ÚUnsupportedExtensionc @ s e Zd ZdS )r N)Ú__name__Ú
__module__Ú __qualname__© r r ú</tmp/pip-build-gk9425m9/urllib3/urllib3/contrib/pyopenssl.pyr ; s r )ÚBytesIO)Úerror)Útimeout)Ú _fileobjecté )Úbackport_makefile)Úutil)Úsix)ÚPROTOCOL_TLS_CLIENTz°'urllib3.contrib.pyopenssl' module is deprecated and will be removed in a future release of urllib3 2.x. Read more in this issue: https://github.com/urllib3/urllib3/issues/2680)ÚcategoryÚ
stacklevelÚinject_into_urllib3Úextract_from_urllib3TÚPROTOCOL_SSLv3Ú SSLv3_METHODÚPROTOCOL_TLSv1_1ÚTLSv1_1_METHODÚPROTOCOL_TLSv1_2ÚTLSv1_2_METHODc c s | ]\}}||fV qd S )Nr )Ú.0ÚkÚvr r r
ú <genexpr>v s r! i @ c C s4 t tt_ttj_tt_ttj_dt_dtj_dS )z7Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.TN)Ú_validate_dependencies_metÚPyOpenSSLContextr Ú
SSLContextÚssl_ÚHAS_SNIÚ IS_PYOPENSSLr r r r
r 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| dddkr$tdddlm} | }t|dddkrNtddS ) z{
Verifies that PyOpenSSL's package-level dependencies have been met.
Throws `ImportError` if they are not met.
r )Ú
ExtensionsÚget_extension_for_classNzX'cryptography' module missing required functionality. Try upgrading to v1.3.4 or newer.)ÚX509Z_x509zS'pyOpenSSL' module missing required functionality. Try upgrading to v0.14 or newer.)Z cryptography.x509.extensionsr* ÚgetattrÚ ImportErrorÚOpenSSL.cryptor, )r* r, r r r r
r" s r" c C s@ dd }d| kr| S || } | dkr(dS t jdkr<| jd} | 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 sl ddl }yFx:dD ]2}| j|r| t|d
} |jd|j| S qW |j| S |jjk
rf 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ú*.Ú.Úascii)r0 r1 )ÚidnaÚ
startswithÚlenÚencodeÚcoreÚ IDNAError)Únamer3 Úprefixr r r
Ú idna_encode s
z'_dnsname_to_stdlib.<locals>.idna_encodeú:Né r zutf-8)r= r )ÚsysÚ version_infoÚdecode)r9 r; r r r
Ú_dnsname_to_stdlib´ s
rA c C sÐ t | dr| j }n tjjtjj| }tj|t}y|j j
tj j }W nL tj
k
r\ g S tjttjtfk
r } ztjd| g S d}~X nX dd tt|jtjD }|jdd |jtjD |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 k rd|fqS )NÚDNSr )r r9 r r r
ú
<listcomp> s z%get_subj_alt_name.<locals>.<listcomp>c s s | ]}d t |fV qdS )z
IP AddressN)Ústr)r r9 r r r
r! s z$get_subj_alt_name.<locals>.<genexpr>)ÚhasattrrB ÚOpenSSLÚcryptoÚdump_certificateÚ
FILETYPE_ASN1r Zload_der_x509_certificateÚopenssl_backendÚ
extensionsr+ ZSubjectAlternativeNameÚvalueZExtensionNotFoundZDuplicateExtensionr ZUnsupportedGeneralNameTypeÚ UnicodeErrorÚlogÚwarningÚmaprA Zget_values_for_typeZDNSNameÚextendZ IPAddress)Z peer_certÚcertZderÚextÚeÚnamesr r r
Úget_subj_alt_nameß s,
rW 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 )#Ú
WrappedSocketz§API-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)Ú
connectionÚsocketÚsuppress_ragged_eofsÚ_makefile_refsÚ_closed)ÚselfrY rZ r[ r r r
Ú__init__ s
zWrappedSocket.__init__c C s
| j j S )N)rZ Úfileno)r^ r r r
r` " s zWrappedSocket.filenoc C s* | j dkr| j d8 _ | jr&| j d S )Nr é )r\ r] Úclose)r^ r r r
Ú_decref_socketios& s
z WrappedSocket._decref_socketiosc O s y| j j||}W nè tjjk
rX } z&| jr<|jdkr<dS tt|W Y d d }~X n¨ tjj k
r | j j
tjj krdS Y nz tjj k
rÆ t
j| j| jj s¶tdn | j||S Y n: tjjk
rú } ztjd| W Y d d }~X nX |S d S )Nra úUnexpected EOFó z The read operation timed outzread error: %réÿÿÿÿ)rf rd )rY ÚrecvrG ÚSSLÚ SysCallErrorr[ ÚargsÚ SocketErrorrE ÚZeroReturnErrorÚ get_shutdownÚRECEIVED_SHUTDOWNÚ
WantReadErrorr Ú
wait_for_readrZ Ú
gettimeoutr
ÚErrorÚsslÚSSLError)r^ rj ÚkwargsÚdatarU r r r
rg , s"
zWrappedSocket.recvc O sü y| j j||S tjjk
rT } z&| jr8|jdkr8dS tt|W Y d d }~X n¤ tjj k
r | j j
tjj kr|dS Y nv tjj k
r t
j| j| jj s²tdn | j||S Y n6 tjjk
rö } ztjd| W Y d d }~X nX d S )Nra úUnexpected EOFr z The read operation timed outzread error: %rrf )rf rw )rY Ú recv_intorG rh ri r[ rj rk rE rl rm rn ro r rp rZ rq r
rr rs rt )r^ rj ru rU r r r
rx E s
zWrappedSocket.recv_intoc C s | j j|S )N)rZ Ú
settimeout)r^ r
r r r
ry \ s zWrappedSocket.settimeoutc C s| xvy | j j|S tjjk
rB tj| j| jj s<t wY q tjj
k
rr } zt t |W Y d d }~X qX qW d S )N)
rY ÚsendrG rh ZWantWriteErrorr Úwait_for_writerZ rq r
ri rk rE )r^ rv rU r r r
Ú_send_until_done_ s z WrappedSocket._send_until_donec C s8 d}x.|t |k r2| j|||t
}||7 }qW d S )Nr )r5 r| ÚSSL_WRITE_BLOCKSIZE)r^ rv Ú
total_sentÚsentr r r
Úsendallj s
zWrappedSocket.sendallc C s | j j d S )N)rY Úshutdown)r^ r r r
r r s zWrappedSocket.shutdownc C sH | j dk r6yd| _| jj S tjjk
r2 d S X n| j d8 _ d S )Nra T)r\ r] rY rb rG rh rr )r^ r r r
rb v s
zWrappedSocket.closeFc C sD | j j }|s|S |r(tjjtjj|S d|j jffft|dS )NÚ
commonName)ÚsubjectÚsubjectAltName) rY Zget_peer_certificaterG rH rI rJ Z get_subjectZCNrW )r^ Ú binary_formr r r r
Ú getpeercert s
zWrappedSocket.getpeercertc C s
| j j S )N)rY Zget_protocol_version_name)r^ r r r
Úversion s zWrappedSocket.versionc C s | j d7 _ d S )Nra )r\ )r^ r r r
Ú_reuse s zWrappedSocket._reusec C s& | j dk r| j n| j d8 _ d S )Nra )r\ rb )r^ r r r
Ú_drop s
zWrappedSocket._dropN)T)F)r r r Ú__doc__r_ r` rc rg rx ry r| r r rb r r r r r r r r
rX s
rX ra c C s | j d7 _ t| ||ddS )Nra T)rb )r\ r )r^ ÚmodeÚbufsizer 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 | | _tjj| j| _d| _d| _d S )Nr F)Ú_openssl_versionsÚprotocolrG rh ÚContextÚ_ctxÚ_optionsÚcheck_hostname)r^ r r r r
r_ ® s
zPyOpenSSLContext.__init__c C s | j S )N)r )r^ r r r
Úoptions´ s zPyOpenSSLContext.optionsc C s || _ | jj| d S )N)r r Z set_options)r^ rM r r r
r ¸ s c C s t | jj S )N)Ú_openssl_to_stdlib_verifyr Zget_verify_mode)r^ r r r
Ú verify_mode½ s z PyOpenSSLContext.verify_modec C s | j jt| t d S )N)r Z
set_verifyÚ_stdlib_to_openssl_verifyÚ_verify_callback)r^ rM r r r
r Á s c C s | j j d S )N)r Úset_default_verify_paths)r^ r r r
r Å s z)PyOpenSSLContext.set_default_verify_pathsc C s& t |tjr|jd}| jj| d S )Nzutf-8)Ú
isinstancer Ú text_typer6 r Zset_cipher_list)r^ Úciphersr r r
Ú set_ciphersÈ s
z PyOpenSSLContext.set_ciphersNc C s |d k r|j d}|d k r$|j d}y*| jj|| |d k rL| jjt| W n4 tjjk
r } ztjd| W Y d d }~X nX d S )Nzutf-8z'unable to load trusted certificates: %r) r6 r Úload_verify_locationsr rG rh rr rs rt )r^ ÚcafileÚcapathÚcadatarU r r r
r Í s
z&PyOpenSSLContext.load_verify_locationsc sR | j j| d k r>t tjs* jd | j j fdd | j j|pJ| d S )Nzutf-8c s S )Nr )Ú_)Úpasswordr r
Ú<lambda>Þ s z2PyOpenSSLContext.load_cert_chain.<locals>.<lambda>)r Zuse_certificate_chain_filer r Ú binary_typer6 Z
set_passwd_cbZuse_privatekey_file)r^ ÚcertfileÚkeyfiler£ r )r£ r
Úload_cert_chainÙ s
z PyOpenSSLContext.load_cert_chainc C s dd |D }| j j|S )Nc S s g | ]}t j|qS r )r Z
ensure_binary)r Úpr r r
rD â s z7PyOpenSSLContext.set_alpn_protocols.<locals>.<listcomp>)r Zset_alpn_protos)r^ Z protocolsr r r
Úset_alpn_protocolsá s z#PyOpenSSLContext.set_alpn_protocolsFTc C sÄ t jj| j|}t|tjr&|jd}|d k r8|j| |j xxy |j
W nd t jj k
r t j
||j sztdwBY n4 t jjk
r² } ztjd| W Y d d }~X nX P qBW t||S )Nzutf-8zselect timed outzbad handshake: %r)rG rh Ú
Connectionr r r r r6 Zset_tlsext_host_nameZset_connect_stateÚ do_handshakero r rp rq r
rr rs rt rX )r^ ÚsockÚ server_sideÚdo_handshake_on_connectr[ Úserver_hostnameÚcnxrU r r r
Ú wrap_socketå s"
z PyOpenSSLContext.wrap_socket)NNN)NN)FTTN)r r r r r_ Úpropertyr Úsetterr r r r r¨ rª r² r r r r
r# § s
r# c C s |dkS )Nr r )r± r Zerr_noZ err_depthZ return_coder r r
r s r rf )rf )Or Ú
__future__r r/ rG Z OpenSSL.SSLZ cryptographyr Z$cryptography.hazmat.backends.opensslr rK Zcryptography.x509r r. Ú ExceptionÚior rZ r rk r
r Zpackages.backports.makefiler Úloggingrs r> ÚwarningsÚ r Úpackagesr Z util.ssl_r ÚwarnÚDeprecationWarningÚ__all__r& Ú PROTOCOL_TLSrh Z
SSLv23_METHODÚPROTOCOL_TLSv1Z TLSv1_METHODr rF r r r r r r Ú CERT_NONEZ VERIFY_NONEÚ
CERT_OPTIONALZ VERIFY_PEERÚ
CERT_REQUIREDZVERIFY_FAIL_IF_NO_PEER_CERTr ÚdictÚitemsr r} r) r% r$ r( Ú getLoggerr rO r r r" rA rW ÚobjectrX r r# r r r r r
Ú<module>/ sz
+5 ^