Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

4.3 KB
Raw Blame
package config

import (
	"fmt"
	"strings"
)

// AllowedBrowserExtraFlags returns the subset of browser.extraFlags that are
// allowed to reach the browser process after security and ownership checks.
func AllowedBrowserExtraFlags(raw string) []string {
	allowed, _ := assessBrowserExtraFlags(raw)
	return allowed
}

// SanitizeBrowserExtraFlags rewrites browser.extraFlags to contain only the
// allowed subset. Invalid, unsafe, and reserved flags are dropped.
func SanitizeBrowserExtraFlags(raw string) string {
	return strings.Join(AllowedBrowserExtraFlags(raw), " ")
}

func validateBrowserExtraFlags(raw string) []error {
	_, errs := assessBrowserExtraFlags(raw)
	return errs
}

func assessBrowserExtraFlags(raw string) ([]string, []error) {
	fields := strings.Fields(raw)
	allowed := make([]string, 0, len(fields))
	var errs []error

	for _, field := range fields {
		if field == "" {
			continue
		}
		if err := validateChromeExtraFlag(field); err != nil {
			errs = append(errs, err)
			continue
		}
		allowed = append(allowed, field)
	}

	return allowed, errs
}

func validateChromeExtraFlag(flag string) error {
	if !strings.HasPrefix(flag, "--") {
		return chromeExtraFlagsError(flag, "must use Chrome flag syntax like --name or --name=value")
	}

	name, value := splitChromeFlag(flag)
	lowerName := strings.ToLower(name)

	if reservedField, ok := reservedChromeExtraFlagFields[lowerName]; ok {
		return chromeExtraFlagsError(flag, fmt.Sprintf("is owned by PinchTab launch config; use %s instead", reservedField))
	}
	if msg, ok := disallowedBrowserExtraFlags[lowerName]; ok {
		return chromeExtraFlagsError(flag, msg)
	}
	if lowerName == "--disable-features" && disablesSiteIsolation(value) {
		return chromeExtraFlagsError(flag, "disables site isolation, which weakens browser security and is not allowed")
	}

	return nil
}

func splitChromeFlag(flag string) (name, value string) {
	parts := strings.SplitN(flag, "=", 2)
	name = parts[0]
	if len(parts) == 2 {
		value = parts[1]
	}
	return name, value
}

func disablesSiteIsolation(value string) bool {
	for _, feature := range strings.Split(strings.ToLower(value), ",") {
		feature = strings.TrimSpace(feature)
		switch feature {
		case "siteperprocess", "site-per-process", "isolateorigins", "isolate-origins":
			return true
		}
	}
	return false
}

func chromeExtraFlagsError(flag, message string) error {
	return ValidationError{
		Field:   "browser.extraFlags",
		Message: fmt.Sprintf("flag %q %s", flag, message),
	}
}

var reservedChromeExtraFlagFields = map[string]string{
	"--disable-automation":                      "the built-in stealth launch contract",
	"--disable-blink-features":                  "the built-in stealth launch contract",
	"--enable-automation":                       "the built-in stealth launch contract",
	"--enable-network-information-downlink-max": "the built-in stealth launch contract",
	"--headless":                                "instanceDefaults.mode",
	"--load-extension":                          "browser.extensionPaths",
	"--disable-extensions-except":               "browser.extensionPaths",
	"--remote-debugging-address":                "browser.remoteDebuggingPort",
	"--remote-debugging-pipe":                   "browser.remoteDebuggingPort",
	"--remote-debugging-port":                   "browser.remoteDebuggingPort",
	"--tz":                                      "instanceDefaults.timezone",
	"--user-agent":                              "instanceDefaults.userAgent",
	"--user-data-dir":                           "profiles.baseDir / profiles.defaultProfile",
	"--window-size":                             "the built-in runtime window model",
}

var disallowedBrowserExtraFlags = map[string]string{
	"--allow-running-insecure-content":      "weakens browser security and is not allowed",
	"--disable-site-isolation-for-policy":   "weakens browser security and is not allowed",
	"--disable-site-isolation-trials":       "weakens browser security and is not allowed",
	"--disable-web-security":                "weakens browser security and is not allowed",
	"--ignore-certificate-errors":           "weakens TLS validation and is not allowed",
	"--ignore-certificate-errors-spki-list": "weakens TLS validation and is not allowed",
	"--no-sandbox":                          "is not allowed in browser.extraFlags; PinchTab enables it only through runtime compatibility when needed",
}