Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
120 lines
4.2 KiB
C#
120 lines
4.2 KiB
C#
using System.Collections.Frozen;
|
|
|
|
namespace Febe.Browser.Cdp;
|
|
|
|
/// <summary>
|
|
/// The CDP commands Febe may send (spec §6.1). Everything else is refused before it reaches the browser.
|
|
/// Adding a command requires a line in docs/decisioni.md with the reason.
|
|
/// </summary>
|
|
public static class CdpCommandPolicy
|
|
{
|
|
/// <summary>The allowlist of spec §6.1, grouped by purpose.</summary>
|
|
public static FrozenSet<string> Allowed { get; } = FrozenSet.Create(
|
|
StringComparer.Ordinal,
|
|
// Navigate and read the state (Runtime.evaluate read-only only, see ReadOnlyScriptGuard).
|
|
"Page.enable",
|
|
"Page.navigate",
|
|
"Page.getFrameTree",
|
|
"Runtime.evaluate",
|
|
// Capture responses.
|
|
"Network.enable",
|
|
"Network.getResponseBody",
|
|
// Gestures.
|
|
"Input.dispatchMouseEvent",
|
|
"Input.dispatchKeyEvent",
|
|
// Download files.
|
|
"Network.loadNetworkResource",
|
|
"IO.read",
|
|
"IO.close",
|
|
// Remote view and preview.
|
|
"Page.startScreencast",
|
|
"Page.screencastFrameAck",
|
|
"Page.stopScreencast",
|
|
"Page.captureScreenshot",
|
|
// Check the session: existence of the session cookie only.
|
|
"Network.getCookies");
|
|
|
|
/// <summary>Commands explicitly forbidden by spec §2 rule 2 and §6.1, refused with a specific message.</summary>
|
|
public static FrozenSet<string> ForbiddenCommands { get; } = FrozenSet.Create(
|
|
StringComparer.Ordinal,
|
|
"Network.setUserAgentOverride",
|
|
"Network.setExtraHTTPHeaders",
|
|
"Page.addScriptToEvaluateOnNewDocument");
|
|
|
|
/// <summary>Whole domains that are forbidden (spec §6.1).</summary>
|
|
public static IReadOnlyList<string> ForbiddenDomains { get; } = ["Emulation", "Fetch"];
|
|
|
|
public static bool IsAllowed(string method) => method is not null && Allowed.Contains(method);
|
|
|
|
public static bool IsExplicitlyForbidden(string method)
|
|
{
|
|
if (string.IsNullOrEmpty(method))
|
|
{
|
|
return false;
|
|
}
|
|
|
|
if (ForbiddenCommands.Contains(method))
|
|
{
|
|
return true;
|
|
}
|
|
|
|
var dot = method.IndexOf('.', StringComparison.Ordinal);
|
|
var domain = dot < 0 ? method : method[..dot];
|
|
return ForbiddenDomains.Contains(domain, StringComparer.Ordinal);
|
|
}
|
|
|
|
/// <summary>Throws <see cref="CdpCommandNotAllowedException"/> unless <paramref name="method"/> is on the allowlist.</summary>
|
|
public static void EnsureAllowed(string method)
|
|
{
|
|
if (IsExplicitlyForbidden(method))
|
|
{
|
|
throw new CdpCommandNotAllowedException(
|
|
method,
|
|
$"Il comando CDP «{method}» è vietato: altera ciò che il browser dichiara o le richieste che invia (specifica §2, regola 2; §6.1).");
|
|
}
|
|
|
|
if (!IsAllowed(method))
|
|
{
|
|
throw new CdpCommandNotAllowedException(
|
|
method,
|
|
$"Il comando CDP «{method}» non è nell'elenco dei comandi ammessi (specifica §6.1). Ogni aggiunta va motivata in docs/decisioni.md.");
|
|
}
|
|
}
|
|
}
|
|
|
|
/// <summary>A CDP command was refused by <see cref="CdpCommandPolicy"/> and never sent.</summary>
|
|
public sealed class CdpCommandNotAllowedException(string method, string message) : InvalidOperationException(message)
|
|
{
|
|
public string Method { get; } = method;
|
|
}
|
|
|
|
/// <summary>The browser answered a command with an error. The message never contains parameters.</summary>
|
|
public sealed class CdpCommandException(string method, int code, string browserMessage)
|
|
: Exception($"Il comando CDP «{method}» è fallito: {browserMessage} (codice {code}).")
|
|
{
|
|
public string Method { get; } = method;
|
|
|
|
public int Code { get; } = code;
|
|
|
|
public string BrowserMessage { get; } = browserMessage;
|
|
}
|
|
|
|
/// <summary>The connection to the browser is closed (browser exited, crashed or is restarting).</summary>
|
|
public sealed class CdpDisconnectedException : Exception
|
|
{
|
|
public CdpDisconnectedException()
|
|
: base("Il collegamento con il browser è chiuso.")
|
|
{
|
|
}
|
|
|
|
public CdpDisconnectedException(string message)
|
|
: base(message)
|
|
{
|
|
}
|
|
|
|
public CdpDisconnectedException(string message, Exception? inner)
|
|
: base(message, inner)
|
|
{
|
|
}
|
|
}
|