How lexiforest/curl-impersonate works
Main Components
a) Core Components:
• libcurl-impersonate (Modified libcurl)
• BoringSSL Integration (Google's TLS library)
• Browser Impersonation Engine
• Command-line Interface
• Library Interface (libcurl-impersonate.so)
b) Browser Support Modules:
• Chrome/Chromium Implementation
• Edge Implementation
• Safari Implementation
• Firefox Implementation (in progress)
Key Relationships
a) Data Flow:
• Client Request → Command Line/Library Interface
• Browser Selection → Impersonation Engine
• TLS Handshake Flow
• HTTP/2 Handshake Flow
b) Integration Points:
• BoringSSL ↔ TLS Handler
• Browser Signatures ↔ Impersonation Engine
• Configuration Management
Architectural Elements
[Client Applications]
• ↓
[Interface Layer]
• CLI Wrappers (curl_chrome*, curl_safari*)
• Library API (libcurl-impersonate)
• ↓
[Core Processing]
• Browser Impersonation Engine
• Configuration Manager
• TLS/HTTP Handler
• ↓
[Integration Layer]
• BoringSSL Integration
• Browser Signatures
• ↓
[Network Layer]
• TLS Handshake
• HTTP/2 Protocol
Implementation Details to Highlight
• Blue: Core Components
• Green: Browser-specific Implementations
• Orange: External Dependencies
• Purple: Network Protocol Handlers
b) Special Features:
• TLS Extension Management
• HTTP/2 Settings Configuration
• Browser Signature Matching
• Certificate Handling
Configuration Elements
Configuration flows for:
• Browser Selection
• TLS Parameters
• HTTP Headers
• Cipher Suites
• Extension Orders
Testing & Validation
A section showing:
• Signature Verification
• Compatibility Testing
• Docker Testing Environment
Deployment Options
Different deployment methods:
• Direct Binary Usage
• Library Integration
• Docker Container
• LD_PRELOAD Usage
The integration points with external systems and libraries
Use standardized symbols:
• Rectangles: Components
• Diamonds: Decision Points
• Clouds: External Services/Networks
Keep the abstraction level high enough to show the overall architecture while including sufficient detail to understand the impersonation mechanism and configuration options.