tls-fingerprint-impersonation
Spoof TLS ClientHello and JA4 fingerprints for browser impersonation.
Install / Use
npx skills add uphiago/recon-skills --skill tls-fingerprint-impersonationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of tls-fingerprint-impersonation
tls-fingerprint-impersonation scores 89/100 on our quality scale, 1385th of 2,780 Automation skills we index (top 50%).
Its SKILL.md is 8.2 KB long, well organised into 31 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.
With 1,280 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so tls-fingerprint-impersonation is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
tls-fingerprint-impersonation compared with similar skills
All 4 of these similar skills score higher than tls-fingerprint-impersonation; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| tls-fingerprint-impersonation (this skill)by uphiago | 89 | 1.3k | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install tls-fingerprint-impersonation?
- Run
npx skills add uphiago/recon-skills --skill tls-fingerprint-impersonation. The install tabs above show the steps for each supported agent. - Which AI agents does tls-fingerprint-impersonation work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is tls-fingerprint-impersonation safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is tls-fingerprint-impersonation still maintained?
- The repository was last updated about 3 months ago, so tls-fingerprint-impersonation is actively maintained.
Skill content
View source on GitHubname: tls-fingerprint-impersonation description: Spoof TLS ClientHello and JA4 fingerprints for browser impersonation. version: 1.1.0 revision_date: 2026-07-25 license: MIT platforms: [linux] compatibility: Requires curl, httpx, python3 tags: [recon, TLS, JA3, JA4, fingerprint, impersonation, HTTP, browser] category: recon related_skills:
- http2-header-impersonation
- stealth-browser-launch
- humanize-automation
TLS Fingerprint Impersonation
Spoof TLS ClientHello parameters — cipher suites, key exchange groups, signature algorithms, and extension order — to match real browsers at the JA3/JA4 fingerprint level. Uses patched rustls to rebuild the TLS layer with browser-identical configurations. Bypasses TLS fingerprinting detection (Cloudflare, Akamai, F5) that flags non-browser TLS stacks. Supports 20 browser profiles including Chrome 100-142, Firefox 128-144, Safari iOS 18, and OkHttp 3-5 (Android).
When to Use
- Target returns 403/blocked on curl/httpx even with correct User-Agent headers.
- Cloudflare or Akamai is fingerprinting TLS ClientHello (JA3/JA4 mismatch with browser).
- API probing requires mobile-app impersonation (OkHttp fingerprint for Android).
- Need high-throughput HTTP requests that pass TLS fingerprint checks without running a full browser.
- Target shows different behavior based on TLS fingerprint (mobile vs desktop endpoints).
Prerequisites
terminalwith python3.- Python:
pip install impit(wraps the Rust library via PyO3). - Or Node.js:
npm install impit(native binding). - Or Rust:
impitcrate with patched dependencies in Cargo.toml.
Quick Detection
# Check if a target blocks non-browser TLS
curl --max-time 30 --connect-timeout 10 -sk https://target.com | head -1
# If 403, test with browser impersonation:
python3 -c "
from impit import Impit
impit = Impit.builder().with_fingerprint('chrome142').build()
r = impit.get('https://target.com').text
print(r[:200])
"
Procedure
Phase 1 — Browser Profile Selection
Choose the right fingerprint for your target:
| Profile | Use case | Key differentiator |
|---|---|---|
| chrome142 | Modern desktop | Latest Chrome, post-quantum KEX (X25519MLKEM768), GREASE |
| chrome100 | Legacy systems | Older cipher suites, no GREASE in key exchange |
| firefox144 | Firefox desktop | Different pseudo-header order, FFDHE groups, SHA-1 signatures |
| safari_ios18 | iOS mobile | 3DES ciphers, duplicate signature algorithm, no session tickets |
| okhttp4 | Android apps | BoringSSL profile, no GREASE, no ECH, simpler cipher suites |
| chrome124 | Common default | Good balance of modern compatibility and detection pass rate |
from impit import Impit
# Chrome 142 (latest)
client = Impit.builder().with_fingerprint("chrome142").build()
# Firefox 144
client = Impit.builder().with_fingerprint("firefox144").build()
# Safari iOS 18 (mobile API endpoints)
client = Impit.builder().with_fingerprint("ios18").build()
# OkHttp 4 (Android app impersonation)
client = Impit.builder().with_fingerprint("okhttp4").build()
Phase 2 — Basic Request
from impit import Impit
impit = (
Impit.builder()
.with_fingerprint("chrome142")
.with_ignore_tls_errors(True) # for self-signed certs during recon
.with_http3() # HTTP/3 support
.with_fallback_to_vanilla(True) # retry without fingerprint if blocked
.build()
)
response = impit.get("https://target.com")
print(response.status_code)
print(response.headers)
print(response.text()[:500])
Phase 3 — With Proxy
impit = (
Impit.builder()
.with_fingerprint("chrome142")
.with_proxy("http://user:pass@residential-proxy:8080")
.with_default_timeout(15_000) # 15 seconds in milliseconds
.build()
)
response = impit.get("https://target.com/api/endpoint")
Phase 4 — Custom Headers
# Custom headers are merged with fingerprint defaults
# Fingerprint headers have lower priority — custom headers win on conflict
response = impit.get(
"https://target.com/api/v1",
headers={
"X-Forwarded-For": "[REDACTED_IP]",
"Authorization": "Bearer token",
}
)
Phase 5 — Cookie Session
from impit.cookie import Jar
impit = (
Impit.builder()
.with_fingerprint("chrome142")
.with_cookie_store(Jar()) # persistent cookie jar
.build()
)
# Login
impit.post("https://target.com/login", json={
"username": "admin", "password": "admin"
})
# Authenticated request — cookies preserved automatically
response = impit.get("https://target.com/dashboard")
Phase 6 — Fingerprint Selection Logic
Choose based on target characteristics:
def select_fingerprint(target_url):
"""Auto-select browser fingerprint based on target."""
if "mobile" in target_url or "api/v2" in target_url:
return "ios18"
elif "android" in target_url or "play.google" in target_url:
return "okhttp4"
elif target_url.startswith("https://"):
return "chrome142" # default for modern HTTPS
return "chrome124"
Phase 7 — JA4 Hash Validation
Verify your TLS fingerprint is working correctly:
# Test against a site that returns JA4 hash in response headers
python3 -c "
from impit import Impit
impit = Impit.builder().with_fingerprint('chrome142').build()
r = impit.get('https://cloudflare.com/cdn-cgi/trace')
print(r.text())
# Look for JA4 hash in trace output or response headers
"
Browser Fingerprint Reference
TLS Configuration per Browser
| Feature | Chrome 142 | Firefox 144 | Safari iOS 18 | OkHttp 4 | |---|---|---|---|---| | TLS versions | 1.3 + 1.2 | 1.3 + 1.2 | 1.3 + 1.2 | 1.3 + 1.2 | | GREASE cipher | ✅ (pos 1) | ❌ | ✅ | ❌ | | GREASE key exchange | ✅ (pos 1) | ❌ | ✅ | ❌ | | Post-quantum (MLKEM768) | ✅ | ✅ | ✅ | ❌ | | FFDHE groups | ❌ | ✅ (2048/3072) | ❌ | ❌ | | SHA-1 signatures | ❌ | ✅ | ✅ (legacy) | ✅ (RSA only) | | ECH GREASE | ✅ | ✅ | ❌ | ❌ | | 3DES ciphers | ❌ | ❌ | ✅ | ❌ | | Certificate compression | Brotli | Zlib+Brotli+Zstd | Zlib | ❌ | | Delegated credentials | ❌ | ✅ | ❌ | ❌ | | Session tickets | ✅ | ✅ | ❌ | ✅ | | Duplicate signatures | ❌ | ❌ | ✅ (RsaPssRsaSha384) | ❌ |
HTTP/2 Settings per Browser
| Browser | Stream Window | Connection Window | Pseudo-Header Order |
|---|---|---|---|
| Chrome | 6,291,456 | 15,663,105 | :method :authority :scheme :path |
| Firefox | 131,072 | 12,517,377 | :method :path :authority :scheme |
| Safari iOS | 2,097,152 | 10,485,760 | :method :scheme :authority :path |
| OkHttp | 16,777,216 | 16,777,216 | :method :path :authority :scheme |
Multipart Boundary Format
| Browser | Format | Example |
|---|---|---|
| Chrome | ----WebKitFormBoundary + 16 alphanumeric | ----WebKitFormBoundaryx8fH3kLm9pQr2sTv |
| Firefox | ----geckoformboundary + hex u64 values | ----geckoformboundary3fa8c10e5d6b2904 |
| OkHttp | UUID v4 | 550e8400-e29b-41d4-a716-446655440000 |
Pitfalls
- Not all sites use TLS fingerprinting. Test with curl first — if it works, TLS fingerprinting is not the blocker.
- Fingerprint must match User-Agent. Using Chrome TLS with Firefox UA headers will be detected.
- HTTP/1.1-only sites don't use HTTP/2 impersonation. The
with_http3()flag only matters for sites that support it. - OkHttp 3 is TLS 1.2 only. Some modern servers reject TLS 1.2 connections.
- TLS fingerprint caching means first request is slowest.
CryptoProviderinstances are cached per fingerprint — subsequent requests are fast. - Vanilla fallback may leak your real TLS fingerprint. Disable
vanilla_fallbackif stealth is critical.
Verification
- Confirm TLS fingerprint matches target browser using
https://www.howsmyssl.com/or Cloudflare trace endpoint. - Check
cf-ja4response header when hitting Cloudflare-protected sites. - Verify response status changes from 403 → 200 when using browser fingerprint vs vanilla curl.
- Test with multiple browser profiles to find the one that passes the target's detection.
Related Skills
http2-header-impersonation— HTTP/2 pseudo-header ordering and SETTINGS frame matching.stealth-browser-launch— Full browser automation with C++ fingerprint patches for JS-heavy targets.humanize-automation— Human-like interaction patterns for behavioral detection bypass.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
