RequestAnalyzer 1.0.13

RequestAnalyzer

A powerful .NET library for comprehensive HTTP request analysis with built-in security detection, device identification, and proxy chain analysis.

Features

• Comprehensive Request Analysis: Extract IP address, device type, browser information, and more
• Security Detection: VPN detection, suspicious request analysis with confidence scoring
• Bot Detection: Detect bots and automated traffic with confidence scores
• Proxy Chain Analysis: Detect and analyze proxy chains
• Device Detection: Automatic device type identification (Desktop, Mobile, Tablet)
• Correlation ID: Automatic correlation ID generation and discovery
• Easy Integration: Simple dependency injection integration
• Geo-Location: Country detection and Tor network identification

Installation

dotnet add package RequestAnalyzer

Quick Start

Basic Setup

using RequestAnalyzer;

var builder = WebApplication.CreateBuilder(args);

// Add RequestAnalyzer services
builder.Services.AddRequestAnalyzer();

var app = builder.Build();

app.Run();

Advanced Configuration

// Configure RequestAnalyzer with custom options
builder.Services.AddRequestAnalyzer(options =>
{
    options.EnableVPNDetection = true;
    options.EnableSuspiciousRequestDetection = true;
    options.VPNConfidenceThreshold = 80;
    options.SuspiciousRequestScoreThreshold = 70;
});

Usage

Inject and Use RequestAnalyzer

using RequestAnalyzer;
using Microsoft.AspNetCore.Mvc;

public class MyController : ControllerBase
{
    private readonly RequestAnalyzer.RequestAnalyzer _requestAnalyzer;

    public MyController(RequestAnalyzer.RequestAnalyzer requestAnalyzer)
    {
        _requestAnalyzer = requestAnalyzer;
    }

    [HttpGet]
    public IActionResult Get()
    {
        // Access request analysis data
        var clientIP = _requestAnalyzer.IP;
        var deviceType = _requestAnalyzer.Device;
        var isSuspicious = _requestAnalyzer.IsSuspiciousRequest;
        var isUsingVPN = _requestAnalyzer.IsUsingVPN;
        var correlationId = _requestAnalyzer.CorrelationId;
        var browser = _requestAnalyzer.Browser;
        
        return Ok(new { 
            IP = clientIP, 
            Device = deviceType,
            IsSuspicious = isSuspicious,
            IsUsingVPN = isUsingVPN,
            CorrelationId = correlationId,
            Browser = browser.BrowserName,
            OperatingSystem = browser.OperatingSystem
        });
    }
}

Available Properties

Basic Information

• Language (string): Detected language from request headers
• IP (string): Client IP address (automatically detects from best source)
• IsPrivateIP (bool?): Whether the IP is private/internal
• CorrelationId (string): Request correlation ID for tracing
• Device (DeviceType): Device type (Unknown, Desktop, Mobile, Tablet)

Browser Information

• Browser (BrowserInfo): Detailed browser and OS information
  • Browser.BrowserName: Browser name (e.g., "Chrome", "Firefox")
  • Browser.OperatingSystem: OS name (e.g., "Windows", "macOS")
  • Browser.OperatingSystemVersion: OS version

Proxy Chain Analysis

• ProxyChain (IPAddress[]): Array of proxies in the chain
• ProxyCount (int): Number of proxies in the chain
• FirstProxy (IPAddress): First proxy in the chain
• LastProxy (IPAddress): Last proxy in the chain
• IsFromTrustedProxy (bool): Whether request is from trusted proxy

VPN Detection

• IsUsingVPN (bool): Whether client is using VPN
• VPNConfidenceScore (int): Confidence score 0-100

Bot & Threat Detection

• CloudflareCountryCode (string?): Client country code (T1=Tor, XX=Unknown)
• CloudflareRayId (string?): Unique request ID for support/debugging
• CloudflareBotScore (int?): Bot detection score 0-99 (lower = more likely bot)
• CloudflareThreatScore (int?): Threat level 0-100 (higher = more threatening)

Security Analysis

• IsSuspiciousRequest (bool): Whether request is suspicious
• SuspiciousScore (int): Suspicious score 0-100
• SuspiciousReasons (string): Semicolon-separated list of reasons

Usage Examples

VPN Detection

public IActionResult MyAction(RequestAnalyzer analyzer)
{
    // Block VPN users
    if (analyzer.IsUsingVPN)
    {
        return Forbid("VPN usage detected");
    }
    
    // Check confidence level
    if (analyzer.VPNConfidenceScore > 80)
    {
        _logger.LogWarning("High confidence VPN from {IP}", analyzer.IP);
    }
    
    return Ok();
}

Bot Detection

public IActionResult MyAction(RequestAnalyzer analyzer)
{
    // Check bot score (when available)
    if (analyzer.CloudflareBotScore.HasValue && analyzer.CloudflareBotScore < 30)
    {
        return Forbid("Bot detected");
    }
    
    // Check threat level
    if (analyzer.CloudflareThreatScore > 50)
    {
        return Forbid("High threat level");
    }
    
    return Ok();
}

Tor Network Detection

public IActionResult MyAction(RequestAnalyzer analyzer)
{
    // Block Tor traffic
    if (analyzer.CloudflareCountryCode == "T1")
    {
        return Forbid("Tor network not allowed");
    }
    
    return Ok();
}

Suspicious Request Detection

public IActionResult MyAction(RequestAnalyzer analyzer)
{
    if (analyzer.IsSuspiciousRequest)
    {
        _logger.LogWarning("Suspicious request from {IP}: {Reasons}", 
            analyzer.IP, analyzer.SuspiciousReasons);
        return BadRequest("Suspicious activity detected");
    }
    
    return Ok();
}

Get Client IP

public IActionResult MyAction(RequestAnalyzer analyzer)
{
    // Get client IP - automatically handles proxies and load balancers
    string clientIp = analyzer.IP;
    
    Console.WriteLine($"Client IP: {clientIp}");
    
    return Ok();
}

Configuration Options

public class RequestAnalyzerOptions
{
    public bool EnableVPNDetection { get; set; } = true;
    public bool EnableSuspiciousRequestDetection { get; set; } = true;
    public int VPNConfidenceThreshold { get; set; } = 70;
    public int SuspiciousRequestScoreThreshold { get; set; } = 60;
}

Device Types

public enum DeviceType
{
    Unknown = 0,
    Desktop = 1,
    Mobile = 2,
    Tablet = 3
}

Support

For support, bug reports, feature requests, or any inquiries:

📧 Email: info@waelelazizy.com

We're here to help! Don't hesitate to reach out.

License

MIT

Requirements

• .NET 9.0 or higher
• ASP.NET Core