mirror of
https://github.com/daijro/camoufox.git
synced 2026-11-19 00:07:28 +00:00
A context sets its own user agent and platform, but appVersion came only from the launch config, so a macOS context in a Windows launch reported "5.0 (Windows)" beside a Macintosh user agent, in the page and in its workers. navigator-spoofing.patch adds setNavigatorAppVersion, stored, guarded and removed the way setNavigatorPlatform and setNavigatorUserAgent are, and read by Navigator::GetAppVersion and WorkerNavigator::GetAppVersion before the launch config. window-setter-seal.patch seals it with the others, and is regenerated against Firefox 158 with every patch before it applied. The launchers' per-context init script calls it with the appVersion _app_version_from_user_agent already derives for the context's config, in Python and TypeScript alike, so the rule stays in one place. The context-app-version guard compares the page against that same function instead of a copy of its own; the init script golden covers the setter. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
172 lines
6.5 KiB
Python
172 lines
6.5 KiB
Python
"""
|
|
Tests that a device preset does not leak the host's operating system.
|
|
|
|
Run with:
|
|
cd python && python -m pytest tests/test_preset_appversion.py -v
|
|
|
|
The regression these guard (daijro/camoufox#744): from_preset() sets
|
|
navigator.userAgent, platform and oscpu from the captured device, but never
|
|
appVersion. Firefox reports appVersion as "5.0 (<OS token>)", so an unset value
|
|
falls through to the host's own -- and a page reading two properties sees a
|
|
Linux platform beside "5.0 (Macintosh)".
|
|
|
|
Measured before the fix on 152.0.4-beta.29, macOS host, os="linux" with
|
|
fingerprint_preset=True:
|
|
|
|
navigator.platform Linux x86_64
|
|
navigator.appVersion 5.0 (Macintosh) <- the host
|
|
|
|
The generated (fpgen) path already emits a coherent pair, which is why
|
|
this only shows up on the preset path.
|
|
"""
|
|
|
|
import json
|
|
|
|
import pytest
|
|
|
|
from camoufox.fingerprints import _app_version_from_user_agent, from_preset
|
|
|
|
# The tokens Firefox actually reports: Windows and Macintosh collapse to the family name, X11 keeps a
|
|
# distro token when the user agent carries one, and Android keeps its version.
|
|
_MAC = "5.0 (Macintosh)"
|
|
_WINDOWS = "5.0 (Windows)"
|
|
_X11 = "5.0 (X11)"
|
|
_X11_UBUNTU = "5.0 (X11; Ubuntu)"
|
|
|
|
|
|
def _preset(platform: str, user_agent: str) -> dict:
|
|
return {"navigator": {"platform": platform, "userAgent": user_agent}}
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
("platform", "user_agent", "expected"),
|
|
[
|
|
(
|
|
"Linux x86_64",
|
|
"Mozilla/5.0 (X11; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0",
|
|
_X11,
|
|
),
|
|
(
|
|
"Win32",
|
|
"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:152.0) Gecko/20100101 Firefox/152.0",
|
|
_WINDOWS,
|
|
),
|
|
(
|
|
"MacIntel",
|
|
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:152.0) Gecko/20100101 Firefox/152.0",
|
|
_MAC,
|
|
),
|
|
],
|
|
)
|
|
def test_app_version_follows_the_preset_platform(platform, user_agent, expected):
|
|
"""Every preset must carry the appVersion its own platform implies."""
|
|
config = from_preset(_preset(platform, user_agent))
|
|
|
|
assert config["navigator.appVersion"] == expected
|
|
|
|
|
|
def test_app_version_agrees_with_the_user_agent():
|
|
"""The pair a page compares must not contradict itself.
|
|
|
|
This is the check the issue is about: not that appVersion holds any
|
|
particular string, but that it names the same system as the userAgent
|
|
beside it.
|
|
"""
|
|
config = from_preset(
|
|
_preset("Linux x86_64", "Mozilla/5.0 (X11; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0")
|
|
)
|
|
|
|
assert "X11" in config["navigator.userAgent"]
|
|
assert config["navigator.appVersion"] == _X11
|
|
assert "Macintosh" not in config["navigator.appVersion"]
|
|
assert "Windows" not in config["navigator.appVersion"]
|
|
|
|
|
|
def test_a_preset_that_carries_its_own_app_version_follows_its_user_agent():
|
|
"""Firefox computes appVersion from the user agent, so a carried value that
|
|
differs ("5.0 (Windows NT 10.0; Win64; x64)" is Chrome's form) is replaced."""
|
|
preset = _preset("Win32", "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:152.0) Firefox/152.0")
|
|
preset["navigator"]["appVersion"] = "5.0 (Windows NT 10.0; Win64; x64)"
|
|
|
|
config = from_preset(preset)
|
|
|
|
assert config["navigator.appVersion"] == "5.0 (Windows)"
|
|
|
|
|
|
def test_an_unknown_platform_follows_its_user_agent():
|
|
"""The user agent is the authority, not the platform string beside it."""
|
|
config = from_preset(_preset("iPhone", "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) Gecko/20100101"))
|
|
|
|
assert config["navigator.appVersion"] == "5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)"
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
("user_agent", "expected"),
|
|
[
|
|
# Every shape in the captured corpus, with the counts they appeared in.
|
|
("Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:152.0) Gecko/20100101 Firefox/152.0", _WINDOWS),
|
|
("Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:152.0) Gecko/20100101 Firefox/152.0", _MAC),
|
|
("Mozilla/5.0 (X11; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0", _X11),
|
|
("Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0", _X11_UBUNTU),
|
|
("Mozilla/5.0 (Android 16; Mobile; rv:152.0) Gecko/152.0 Firefox/152.0", "5.0 (Android 16)"),
|
|
],
|
|
)
|
|
def test_the_derivation_matches_what_firefox_reports(user_agent, expected):
|
|
assert _app_version_from_user_agent(user_agent) == expected
|
|
|
|
|
|
def test_a_distro_token_survives():
|
|
"""Twenty of the bundled Linux presets say "X11; Ubuntu" in their user agent.
|
|
|
|
Deriving from the platform instead would flatten those to "X11" — a smaller
|
|
mismatch than the host leaking, but the same kind, and Firefox never emits it.
|
|
"""
|
|
config = from_preset(
|
|
_preset(
|
|
"Linux x86_64",
|
|
"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0",
|
|
)
|
|
)
|
|
|
|
assert config["navigator.appVersion"] == _X11_UBUNTU
|
|
|
|
|
|
def test_a_user_agent_it_cannot_read_is_left_alone():
|
|
"""Better an absent value than an invented one."""
|
|
config = from_preset(_preset("Win32", "not a user agent"))
|
|
|
|
assert "navigator.appVersion" not in config
|
|
|
|
|
|
def test_a_drawn_app_version_follows_the_drawn_user_agent():
|
|
"""fpgen draws appVersion as a value of its own.
|
|
|
|
Its recorded data pairs some Linux user agents with "5.0 (Windows)", which a
|
|
browser only reports with an extension rewriting one of the two. Firefox
|
|
computes appVersion from the user agent, so the config does the same.
|
|
"""
|
|
from camoufox.fingerprints import from_fpgen, generate_fingerprint
|
|
|
|
fingerprint = generate_fingerprint(os="linux")
|
|
fingerprint["navigator"] = {
|
|
**fingerprint["navigator"],
|
|
"userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:152.0) Gecko/20100101 Firefox/152.0",
|
|
"appVersion": "5.0 (Windows)",
|
|
}
|
|
config = from_fpgen(fingerprint, "156")
|
|
|
|
assert config["navigator.appVersion"] == "5.0 (X11)"
|
|
|
|
|
|
@pytest.mark.parametrize("os_name", ["macos", "linux", "windows"])
|
|
def test_a_context_is_given_its_own_app_version(os_name):
|
|
"""A NewContext() identity on another OS than the launch must not report the
|
|
launch's appVersion, so its init script sets the one its user agent implies."""
|
|
from camoufox.fingerprints import generate_context_fingerprint
|
|
|
|
fp = generate_context_fingerprint(os=os_name)
|
|
app_version = _app_version_from_user_agent(fp["config"]["navigator.userAgent"])
|
|
|
|
assert app_version
|
|
assert f"setNavigatorAppVersion({json.dumps(app_version)})" in fp["init_script"]
|