Files
Febe/tools/Febe.Sonda/Program.cs
T

172 lines
6.9 KiB
C#

using System.Globalization;
using Febe.Browser.Diagnostics;
using Febe.Browser.Hosting;
using Febe.Core.Abstractions;
using Febe.Core.Collection;
using Febe.Sonda;
// Passive probe of M0 (spec §14.5).
// febe-sonda registra --cartella <fuori dal repository> [--display :0 | --xvfb] [--porta 9333] [--chromium <file>] [--no-sandbox]
// [--sito <host> --cdn <host>] (solo per provarla sul sito di prova)
// febe-sonda ripulisci --da <grezzi> --a <ripuliti> [--ammessi <ripulitura.json>] [--sito <host> --cdn <host>]
// febe-sonda verifica --grezzi <grezzi> --ripuliti <ripuliti> [--ammessi <ripulitura.json>]
return args.Length == 0 ? Usage() : args[0] switch
{
"registra" => await RecordAsync(args[1..]),
"ripulisci" => Sanitize(args[1..]),
"verifica" => Verify(args[1..]),
_ => Usage(),
};
static int Usage()
{
Console.Error.WriteLine("""
Uso:
febe-sonda registra --cartella <cartella fuori dal repository> [--display :0 | --xvfb] [--porta 9333] [--chromium <file>] [--no-sandbox]
febe-sonda ripulisci --da <campioni grezzi> --a <campioni ripuliti> [--ammessi <ripulitura.json>]
febe-sonda verifica --grezzi <campioni grezzi> --ripuliti <campioni ripuliti> [--ammessi <ripulitura.json>]
La sonda è passiva: apre il browser e registra ciò che la pagina riceve mentre navighi tu. Non compie gesti.
""");
return 2;
}
static async Task<int> RecordAsync(string[] args)
{
var folder = Option(args, "--cartella");
if (string.IsNullOrWhiteSpace(folder))
{
Console.Error.WriteLine("Indicare --cartella <cartella fuori dal repository>.");
return 2;
}
try
{
RepositoryGuard.EnsureOutside(folder);
}
catch (InvalidOperationException ex)
{
Console.Error.WriteLine(ex.Message);
return 3;
}
var log = new DelegateBrowserLog((level, message, _) =>
{
if (level >= BrowserLogLevel.Warning)
{
Console.Error.WriteLine(message);
}
});
XvfbProcess? xvfb = null;
var display = Option(args, "--display");
if (args.Contains("--xvfb"))
{
display = XvfbProcess.FindFreeDisplay() ?? throw new InvalidOperationException("Nessun display libero per Xvfb.");
xvfb = new XvfbProcess(display, 1280, 900, log: log);
await xvfb.StartAsync(CancellationToken.None);
Console.WriteLine($"Xvfb avviato su {display}: il browser non è visibile da qui (serve la vista remota di Febe o un display vero con --display).");
}
var hosts = Hosts(args);
var profile = Path.Combine(Path.GetFullPath(folder), SampleSanitizer.BrowserProfileFolder);
var host = new ChromiumProcessHost(new ChromiumLaunchOptions { NoSandbox = args.Contains("--no-sandbox") }, log: log);
try
{
await host.StartAsync(
new BrowserOptions(profile, 1280, 900, int.TryParse(Option(args, "--porta"), NumberStyles.Integer, CultureInfo.InvariantCulture, out var port) ? port : 9333, Option(args, "--chromium"), display),
CancellationToken.None);
await using var recorder = new ProbeRecorder(host.Cdp, hosts, folder);
await recorder.StartAsync();
Console.WriteLine($"""
Sonda in ascolto. Campioni grezzi in: {recorder.Folder}
Accedi e naviga a mano nella finestra del browser seguendo docs/prove-dal-vivo.md.
La sonda non compie gesti e non apre pagine da sola. Premi Invio (o Ctrl+C) per terminare.
""");
var stop = new TaskCompletionSource();
Console.CancelKeyPress += (_, e) =>
{
e.Cancel = true;
stop.TrySetResult();
};
_ = Task.Run(() =>
{
Console.ReadLine();
stop.TrySetResult();
});
await stop.Task;
await recorder.StopAsync();
var stats = recorder.Stats;
Console.WriteLine($"Registrate {stats.Responses} risposte, {stats.Navigations} navigazioni, {stats.Interactions} interazioni.");
Console.WriteLine("Ora: febe-sonda ripulisci --da <cartella> --a <copia ripulita>, poi febe-sonda verifica.");
return 0;
}
finally
{
await host.DisposeAsync();
if (xvfb is not null)
{
await xvfb.DisposeAsync();
}
}
}
static int Sanitize(string[] args)
{
var from = Option(args, "--da");
var to = Option(args, "--a");
if (string.IsNullOrWhiteSpace(from) || string.IsNullOrWhiteSpace(to))
{
Console.Error.WriteLine("Indicare --da <campioni grezzi> e --a <campioni ripuliti>.");
return 2;
}
var allowlist = Option(args, "--ammessi") is { } path ? SanitizerAllowlist.Load(path) : SanitizerAllowlist.Default;
var report = new SampleSanitizer(allowlist, Hosts(args)).SanitizeFolder(from, to);
Console.WriteLine($"Ripuliti {report.Files} file ({report.Lines} righe): {report.ReplacedStrings} testi, {report.ReplacedNumbers} numeri, {report.ReplacedKeys} chiavi, {report.Addresses} indirizzi sostituiti.");
var verify = SampleVerifier.Verify(from, to, allowlist);
Console.WriteLine(verify.Passed ? "Verifica superata." : $"Verifica NON superata: {verify.Leaks.Count} frammenti sopravvissuti.");
return verify.Passed ? 0 : 1;
}
static int Verify(string[] args)
{
var raw = Option(args, "--grezzi");
var clean = Option(args, "--ripuliti");
if (string.IsNullOrWhiteSpace(raw) || string.IsNullOrWhiteSpace(clean))
{
Console.Error.WriteLine("Indicare --grezzi <campioni grezzi> e --ripuliti <campioni ripuliti>.");
return 2;
}
var allowlist = Option(args, "--ammessi") is { } path ? SanitizerAllowlist.Load(path) : SanitizerAllowlist.Default;
var report = SampleVerifier.Verify(raw, clean, allowlist);
Console.WriteLine($"Grezzi: {report.RawFiles} file; ripuliti: {report.CleanFiles}; frammenti controllati: {report.CheckedTokens}.");
foreach (var missing in report.MissingCleanFiles)
{
Console.WriteLine($"Manca la copia ripulita di {missing}.");
}
foreach (var leak in report.Leaks)
{
// Where, never what: the value itself stays on this machine.
Console.WriteLine($"Sopravvive un frammento di {leak.Length} {leak.Kind} in {leak.CleanFile}.");
}
Console.WriteLine(report.Passed ? "Verifica superata: nessun valore dei grezzi sopravvive fuori dall'elenco ammesso." : "Verifica NON superata.");
return report.Passed ? 0 : 1;
}
static HostClassifier Hosts(string[] args)
{
var site = Option(args, "--sito");
var cdn = Option(args, "--cdn");
return site is null && cdn is null
? HostClassifier.Instagram
: new HostClassifier((site ?? string.Empty).Split(',', StringSplitOptions.RemoveEmptyEntries), (cdn ?? string.Empty).Split(',', StringSplitOptions.RemoveEmptyEntries));
}
static string? Option(string[] args, string name)
{
var index = Array.IndexOf(args, name);
return index >= 0 && index + 1 < args.Length ? args[index + 1] : null;
}