ProxyDetect.hpp

Go to the documentation of this file.

/*
 * BastionGuard™ Secure Connection
 * Copyright (C) 2025–2026 Calogero Scarnà
 * GPL-3.0
 */
 
#pragma once
#include <cstdint>
#include <string>
#include <vector>
 
namespace bsc::ui_util {
 
/**
 * Rileva i proxy HTTP/SOCKS configurati nell'ambiente e nei file
 * di sistema (/etc/environment, /etc/profile.d/proxy.sh, ecc.) al primo
 * uso; cache-ati per la sessione.
 *
 * BSC non manipola il traffico proxy (lo gestisce bastionguard-cef),
 * ma vogliamo mostrare un hint all'utente quando una connessione va verso
 * il proxy configurato, cosi' capisce subito che non e' traffico anomalo.
 */
struct ProxyEndpoint {
    std::string host;
    std::uint16_t port{0};
    std::string scheme;  // http, https, socks5, ...
};
 
/**
 * Restituisce la lista dei proxy rilevati. Lista vuota se nessun proxy.
 * Thread-safe, idempotente, risultato cache-ato.
 */
const std::vector<ProxyEndpoint>& detected_proxies();
 
/**
 * Ritorna true se (host, port) matcha uno dei proxy rilevati.
 * `host` puo' essere hostname o IP; il confronto e' case-insensitive e
 * risolve anche localhost/127.0.0.1/::1 come equivalenti.
 */
bool matches_configured_proxy(const std::string& host, std::uint16_t port);
 
} // namespace bsc::ui_util