BSSL Integrations

BSSL project integration with existing http clients

Supported projects

• aiohttp
• aiohttp-socks
• httpx sync Client without proxy support (yet)

Installation

Project is available on PyPI (now in prerelease stage, so you need to allow prerelease installation).

pip install --pre bssl-integrations
poetry add --allow-prereleases bssl-integrations
uv add --prerelease if-necessary bssl-integrations  # explicitly allow prelease

❗Note that the HTTP client libraries must be installed separately.

Usage

Aiohttp

Module expose BSSLConnector class, which is a subclass of aiohttp.TCPConnector with bssl context.

import aiohttp
import bssl
from bssl_integrations.aiohttp import BSSLConnector

my_tls_config = bssl.TLSClientConfiguration(...)

connector = BSSLConnector(my_tls_config)
session = aiohttp.ClientSession(connector=connector)

# do with session whatever you want

Aiohttp-socks

As aiohttp connector above, but with socks proxy support. See aiohttp-socks for more info.

import aiohttp
import bssl
from bssl_integrations.aiohttp_socks import BSSLProxyConnector

my_tls_config = bssl.TLSClientConfiguration(...)

connector = BSSLProxyConnector(
    host="127.0.0.1",
    port=1080,
    username="user",
    password="password",
    dest_tls_config=my_tls_config,
)
# OR
connector = BSSLProxyConnector.from_url("socks5://user:password@127.0.0.1:1080", dest_tls_config=my_tls_config)
session = aiohttp.ClientSession(connector=connector)

# do with session whatever you want

❗ Note that you need aiohttp-socks to be installed.

Httpx

import httpx
import bssl
from bssl_integrations.httpx import BSSLTransport

my_tls_config = bssl.TLSClientConfiguration(...)

transport = BSSLTransport(my_tls_config)
client = httpx.Client(transport=transport)

# do with client whatever you want

Credits

• bssl
• tls.peet.ws - TLS fingerprinting API
• jsonip.com - IP API