Oya Browser docs
Stealth, fingerprints and proxies
How Oya Browser gives each profile its own fingerprint, proxy and cookie store, what the stealth layer does, and how to choose a persona.
Anonymity
Create and manage browser profiles with unique fingerprints, proxy routing, and isolated cookie stores. Each profile is a complete identity, different canvas hash, WebGL renderer, navigator properties, and session storage.
Fingerprint Spoofing
Each profile generates a coherent set of browser fingerprints that are internally consistent per platform. A Win32 profile gets Windows GPU strings, Windows fonts, and matching screen resolutions.
- Canvas: deterministic pixel noise on
toDataURLandtoBlob - WebGL: spoofed vendor/renderer strings from real GPU database
- AudioContext: noise on
OfflineAudioContext.startRendering - ClientRects: sub-pixel noise on
getBoundingClientRect(bypassed internally for click accuracy) - Navigator: platform, hardwareConcurrency, deviceMemory, languages, vendor
- Screen: width, height, colorDepth, devicePixelRatio
- WebRTC: ICE candidates stripped to prevent local IP leak
- Fonts: platform-consistent font sets
Proxy Support
A persona can take an HTTP, HTTPS or SOCKS5 proxy, given as one url. Chromium cannot authenticate to a SOCKS5 proxy, so a proxy that needs a username and password must be HTTP or HTTPS. The proxy is applied at the session level, so all traffic routes through it, including DNS for SOCKS5. Timezone and locale are matched to the proxy's location over CDP, and a mismatch is reported rather than silently shipped.
const proxy = await oya.proxies.create({
url: "http://user:[email protected]:8080",
geo: "us",
kind: "datacenter",
});
const persona = await oya.personas.create({
name: "us-desktop",
prefs: { platform: "Win32", timezone: "America/New_York" },
});
await oya.personas.pinProxy(persona.id, proxy.id);Anti-Detection Stealth
Always active, no configuration needed. The stealth layer removes automation indicators that anti-bot systems check for:
navigator.webdriverremoved- Electron globals (
window.process,window.require) deleted window.chromefixed to match real Chrome (app, runtime, csi, loadTimes)navigator.pluginspopulated with PDF viewersnavigator.permissions.querypatched- Sec-CH-UA headers rewritten to hide Electron
- Google telemetry domains blocked at the network level
Choosing a persona
A persona is made through the API and chosen when a browser starts. There is no tool that switches one mid-session: the device, cookie jar and proxy are bound together for the persona's life, so changing them would make the browser a different machine halfway through a run. To vary the device, clone the persona.
const personas = await oya.personas.list();
const browser = await oya.browser.start({ persona: personas[0].id });
// A new device, fixed from here on:
const fresh = await oya.personas.create({ prefs: { platform: "MacIntel" } });
// The same device, a second cookie jar:
const twin = await oya.personas.clone(fresh.id);