RequestAnalyzer 1.0.9

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
• Proxy Chain Analysis: Detect and analyze proxy chains from X-Forwarded-For headers
• Device Detection: Automatic device type identification (Desktop, Mobile, Tablet)
• Correlation ID: Automatic correlation ID generation and discovery
• Easy Integration: Simple dependency injection integration

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 (handles proxies correctly)
• 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

Security Analysis

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

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
}

License

MIT

Requirements

• .NET 9.0 or higher
• ASP.NET Core