C# (ASP.NET Core)

Para ambientes corporativos Microsoft, integrar o ProxyTracer diretamente no pipeline de requisições HTTP do ASP.NET Core garante que o tráfego malicioso seja rejeitado antes de acionar roteamento, vinculação de modelos (model binding) ou consultas ao banco de dados.

O Middleware

Esta implementação utiliza System.Text.Json para desserialização ultrarrápida, impõe um timeout rigoroso via HttpClient e interrompe o pipeline com uma resposta 403 Forbidden caso a conexão seja sinalizada como ameaça.


using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Logging;
 
namespace ProxyTracer.Security
{
    public class ProxyTracerMiddleware
    {
        private readonly RequestDelegate _next;
        private readonly HttpClient _httpClient;
        private readonly ILogger<ProxyTracerMiddleware> _logger;
        private readonly string _apiKey;
 
        public ProxyTracerMiddleware(RequestDelegate next, IConfiguration config, ILogger<ProxyTracerMiddleware> logger)
        {
            _next = next;
            _logger = logger;
            _apiKey = config["PROXYTRACER_API_KEY"] ?? throw new ArgumentNullException("PROXYTRACER_API_KEY is missing");
            
            // Cliente reutilizável com timeout rigoroso de 500ms
            _httpClient = new HttpClient { Timeout = TimeSpan.FromMilliseconds(500) };
        }
 
        public async Task InvokeAsync(HttpContext context)
        {
            // 1. Extraia o IP (Requer app.UseForwardedHeaders() configurado no Program.cs)
            var ip = context.Connection.RemoteIpAddress?.ToString();
 
            // Ignorar IPs de desenvolvimento local
            if (!string.IsNullOrEmpty(ip) && ip != "127.0.0.1" && ip != "::1")
            {
                try
                {
                    // 2. Consulte a API do ProxyTracer de forma assíncrona
                    using var request = new HttpRequestMessage(HttpMethod.Get, $"https://api.proxytracer.com/v1/check/{ip}");
                    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", _apiKey);
 
                    using var response = await _httpClient.SendAsync(request);
 
                    if (response.IsSuccessStatusCode)
                    {
                        using var jsonStream = await response.Content.ReadAsStreamAsync();
                        var ptResponse = await JsonSerializer.DeserializeAsync<ProxyTracerResult>(jsonStream);
 
                        // 3. Encerre a conexão se um proxy/VPN for detectado
                        if (ptResponse != null && ptResponse.Proxy)
                        {
                            context.Response.StatusCode = StatusCodes.Status403Forbidden;
                            context.Response.ContentType = "application/json";
                            await context.Response.WriteAsync("{\"error\": \"Access Denied: VPN or Proxy detected.\"}");
                            return; // Interrompa o pipeline da requisição
                        }
                    }
                }
                catch (Exception ex)
                {
                    // Fail-open: Registre o erro e permita a passagem da requisição
                    _logger.LogWarning($"ProxyTracer validation failed: {ex.Message}");
                }
            }
 
            // 4. O tráfego é legítimo, prossiga para os controllers
            await _next(context);
        }
 
        // Struct leve mapeando exatamente para a resposta {"proxy": true|false}
        private class ProxyTracerResult
        {
            [JsonPropertyName("proxy")]
            public bool Proxy { get; set; }
        }
    }
}

Configuração:

Para ativar a proteção, registre o middleware no seu arquivo Program.cs. Certifique-se de posicioná-lo após UseForwardedHeaders, mas antes de UseRouting e UseAuthentication.


var app = builder.Build();
 
// 1. Garanta a extração dos IPs reais caso esteja atrás de um balanceador de carga NGINX/Cloudflare
app.UseForwardedHeaders();
 
// 2. Descarte o tráfego malicioso logo no início
app.UseMiddleware<ProxyTracer.Security.ProxyTracerMiddleware>();
 
app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();
 
app.Run();