pip._vendor.urllib3.util.ssl_match_hostname Namespace Reference

Classes
class	CertificateError

Functions
	_dnsname_match (dn, hostname, max_wildcards=1)
	_to_unicode (obj)
	_ipaddress_match (ipname, host_ip)
	match_hostname (cert, hostname)

Variables
	ipaddress = None

Detailed Description

The match_hostname() function from Python 3.3.3, essential when using SSL.

Function Documentation

_dnsname_match()

pip._vendor.urllib3.util.ssl_match_hostname._dnsname_match (   dn,   hostname,   max_wildcards = 1  )

protected

Matching according to RFC 6125, section 6.4.3

http://tools.ietf.org/html/rfc6125#section-6.4.3

_ipaddress_match()

pip._vendor.urllib3.util.ssl_match_hostname._ipaddress_match (   ipname,   host_ip  )

protected

Exact matching of IP addresses.

RFC 6125 explicitly doesn't define an algorithm for this
(section 1.7.2 - "Out of Scope").

match_hostname()

pip._vendor.urllib3.util.ssl_match_hostname.match_hostname	(		cert,
			hostname
	)

Verify that *cert* (in decoded format as returned by
SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
rules are followed, but IP addresses are not accepted for *hostname*.

CertificateError is raised on failure. On success, the function
returns nothing.