TCP TLS tunnel for HTTP requests with HTTP2 support.
Project description
TCP TLS Tunnel Adapters for Python
Provides functionality for creating a TCP-TLS tunnel for HTTP / HTTPS
requests. Currently supported libraries are request
, hyper
and httpx
.
Our TLS Layer pass ciphers and has SSL session ticket support by default.
If you are really interested in testing it for free,
you can find out more details in our Discord Channel.
Usage examples
These sections show usage examples for HTTP/1.1 and HTTP/2.0.
Requests adapter (HTTP/1.1)
Installation
pip install tls-tunnel
Example
Let's show, how it works for requests
in case of HTTP/1.1:
from requests import Session
from tcp_tls_tunnel.requests_adapter import TunneledHTTPAdapter
from tcp_tls_tunnel.constants import Client
from tcp_tls_tunnel.dto import AdapterOptions, ProxyOptions
# if necessary
proxy_opts = ProxyOptions(
host="your.proxy.host",
port=1234,
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
)
adapter = TunneledHTTPAdapter(
adapter_opts=AdapterOptions(
host="127.0.0.1", # tunnel address
port=1337, # tunnel port
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
client=Client.CHROME, # imitated Client that will be used
),
proxy_opts=proxy_opts # or None if not required
)
session = Session()
# connect adapter for requests.Session instance
session.mount("http://", adapter)
session.mount("https://", adapter)
Request to howsmyssl.com
:
response = session.get('https://www.howsmyssl.com/a/check')
Output:
# response.status_code
200
# response.headers
{'Content-Length': '874',
'Access-Control-Allow-Origin': '*',
'Connection': 'close',
'Content-Type': 'application/json',
'Date': 'Mon, 12 Oct 2020 21:55:42 GMT',
'Strict-Transport-Security': 'max-age=631138519; includeSubdomains; preload'}
# response.json()
{'able_to_detect_n_minus_one_splitting': False,
'beast_vuln': False,
'ephemeral_keys_supported': True,
'given_cipher_suites': ['TLS_GREASE_IS_THE_WORD_2A',
'TLS_AES_128_GCM_SHA256',
'TLS_AES_256_GCM_SHA384',
'TLS_CHACHA20_POLY1305_SHA256',
'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256',
'TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256',
'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384',
'TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384',
'TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256',
'TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256',
'TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA',
'TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA',
'TLS_RSA_WITH_AES_128_GCM_SHA256',
'TLS_RSA_WITH_AES_256_GCM_SHA384',
'TLS_RSA_WITH_AES_128_CBC_SHA',
'TLS_RSA_WITH_AES_256_CBC_SHA'],
'insecure_cipher_suites': {},
'rating': 'Probably Okay',
'session_ticket_supported': True,
'tls_compression_supported': False,
'tls_version': 'TLS 1.3',
'unknown_cipher_suite_supported': False}
Requests adapter (HTTP/2.0 with hyper)
Installation
pip install 'tls-tunnel[hyper]'
Example
Let's show, how it works for requests
in case of HTTP/2.0:
import requests
from tcp_tls_tunnel.dto import ProxyOptions, AdapterOptions
from tcp_tls_tunnel.hyper_http2_adapter import TunnelHTTP20Adapter
adapter = TunnelHTTP20Adapter(
proxy_opts=ProxyOptions(
host="your.proxy.host",
port=1234,
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
),
adapter_opts=AdapterOptions(
host="127.0.0.1", # tunnel address
port=1337, # tunnel port
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
),
)
session = requests.Session()
session.mount("http://", adapter)
session.mount("https://", adapter)
Request to http2.pro
:
response = session.get("https://http2.pro/api/v1")
print(response.json())
Output:
{
'http2': 1,
'protocol': 'HTTP/2.0',
'push': 1,
'user_agent': 'python-requests/2.24.0'
}
HTTPX Transport (HTTP/2.0)
Installation
pip install 'tls-tunnel[httpx]'
Example
Let's show, how it works for httpx
in case of HTTP/2.0:
from tcp_tls_tunnel.dto import AdapterOptions, ProxyOptions
from tcp_tls_tunnel.httpx_adapter import TunnelHTTPTransport
transport = TunnelHTTPTransport(
adapter_opts=AdapterOptions(
host="127.0.0.1", # tunnel address
port=1337, # tunnel port
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
),
proxy_opts=ProxyOptions(
host="your.proxy.host",
port=1234,
auth_login="YOUR_LOGIN",
auth_password="YOUR_PASSWORD",
),
)
Request to http2.pro
:
from httpx import Client
headers = {
'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36'
}
with Client(transport=transport, headers=headers) as client:
response = client.get("https://http2.pro/api/v1")
print(response.json())
Output:
{
'http2': 1,
'protocol': 'HTTP/2.0',
'push': 0,
'user_agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36'
}
Tests
In addition, you can try to run the tests that are available in the tests
directory,
there are more examples of using the right adapters.
In order to use environment variables it is recommended to create directories with tests .env
file,
which will be used automatically at startup.
You can do this with the command:
python -m unittest -v tests/*_tests.py
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tcp_tls_tunnel-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d82edd5763cecb0d688bbc3948b6050a155cb15b0e010f7900a8d4c2b8eb43cb |
|
MD5 | 3a7dcc77cfd7103ec556b1b76259cb9e |
|
BLAKE2b-256 | 4e6f3733b618ca76b7f5b897287e2721c39a466af99044edd2dc4adeb0e90b4d |