Http.TLS 1.2.1

Http.TLS

.NET library for HTTP/2 HTTP/3 requests with TLS fingerprinting support. Based on bogdanfinn/tls-client, it allows you to mimic various browser fingerprints to bypass bot protection.

Installation

dotnet add package Http.TLS

Native Library

Download the appropriate native library for your platform from the bogdanfinn/tls-client releases page.

Initialization:

// Initialize once at application startup
RequestClient.Initialize("path/to/native-library");

Quick Start

using Http.TLS;
using Http.TLS.Builders;
using Http.TLS.Core;
using Http.TLS.Core.Request;

// Initialize library
RequestClient.Initialize("path/to/native-library");

// Create client
using var client = new RequestClientBuilder()
    .WithBrowserType(BrowserType.Chrome133)
    .WithTimeout(TimeSpan.FromSeconds(30))
    .Build();

// Send request
var request = new Request
{
    RequestUrl = "https://httpbin.org/post",
    RequestMethod = "POST",
    RequestBody = "{\"message\": \"Hello\"}",
    Headers = { ["Content-Type"] = "application/json" }
};

var response = client.Send(request);
Console.WriteLine($"Status: {response.Status}");
Console.WriteLine($"Body: {response.Body}");

RequestClientBuilder

Fluent API for client configuration:

using var client = new RequestClientBuilder()
    .WithBrowserType(BrowserType.Chrome133)
    .WithTimeout(TimeSpan.FromSeconds(30))
    .WithProxy("http://proxy:8080")
    .WithCookieJar(true)
    .WithDebug(true)
    .Build();

Available methods:

• WithBrowserType() - browser fingerprint selection
• WithTimeout() - request timeout
• WithProxy() - proxy configuration
• WithCookieJar() / WithoutCookieJar() - cookie management
• WithInsecureSkipVerify() - skip SSL verification
• ...

RequestBuilder

Fluent API for request creation:

var request = new RequestBuilder()
    .WithUrl("https://api.example.com/data")
    .WithMethod(HttpMethod.Post)
    .WithBody(new { name = "John", age = 30 })
    .WithHeader("Authorization", "Bearer token")
    .WithTimeout(TimeSpan.FromSeconds(30))
    .Build();

Available methods:

• WithUrl() - request URL
• WithMethod() - HTTP method
• WithBody() - request body (string, object, byte[])
• WithHeader() / WithHeaders() - headers
• WithCookie() / WithCookies() - cookies
• ...

Features

• HTTP/1.1, HTTP/2, HTTP/3 - MFull protocol support with automatic negotiation
• Protocol Racing - Chrome-like "Happy Eyeballs" for HTTP/2 vs HTTP/3
• TLS Fingerprinting - Mimic Chrome, Firefox, Safari, and other browsers
• HTTP/3 Fingerprinting - Accurate QUIC/HTTP/3 fingerprints matching real browsers
• Custom Header Ordering - Control the order of HTTP headers
• Proxy Support - HTTP and SOCKS5 proxies
• Cookie Jar Management - Built-in cookie handling
• Certificate Pinning - Enhanced security with custom certificate validation ...

Examples

GET Request

var request = new Request
{
    RequestUrl = "https://httpbin.org/headers",
    RequestMethod = "GET",
    Headers = { ["X-Custom"] = "value" }
};

var response = client.Send(request);

POST with JSON

var request = new RequestBuilder()
    .WithUrl("https://httpbin.org/post")
    .WithMethod(HttpMethod.Post)
    .WithBody(new { name = "John", age = 30 })
    .Build();

var response = client.Send(request);

Target Frameworks

• .NET Standard 2.0
• .NET 5.0, 6.0, 8.0, 9.0 10.0

License

MIT License | Report an Issue