uTLS ClientHello Mimicry (Outbound)#

Added in v0.5. The proxy-to-teamserver leg used to negotiate a JA3 that screams “python httpx”; any defender inspecting the outbound leg fingerprints that instantly. With tls_profile set on a domain, the outbound ProxyHandler swaps its httpx.AsyncClient for a curl_cffi.AsyncSession that presents a real browser ClientHello.

Enable#

Install the extra:

pip install curl_cffi

Set tls_profile on the domain:

domains:
  cdn.example.com:
    upstream: https://10.0.0.5:8443
    profile_path: profiles/mythic-httpx.json
    profile_type: mythic
    tls_profile: chrome120       # or firefox109, safari16_0, edge101, ...

Available profiles (see infraguard.core.utls_mimicry.BROWSER_PROFILES):

  • chrome110, chrome116, chrome119, chrome120
  • firefox102, firefox109
  • safari15_5, safari16_0
  • edge99, edge101

Failure mode#

If curl_cffi is not installed, the wrapper logs a warning and the proxy silently falls back to plain httpx for that domain. The config keeps working; the JA3 stops mimicking.

If the profile name is not recognised, same fallback applies.

Verification#

Point a test JA3-capturing endpoint at the proxy and confirm the outbound leg matches the browser you configured. Chrome 120 lands on JA3 1c... today; regenerate the reference set periodically since browser TLS stacks drift.