Security Policy
Mise Browser treats security as a core architectural foundation. This document outlines supported versions, release cadence, security architecture, and procedures for reporting vulnerabilities.
Supported Versions & Release Cadence
Security updates and critical patches are actively maintained for the latest stable release. Because Mise Browser operates on a continuous release cycle without legacy long-term support branches, security fixes are not backported to older releases.
Starting from version 1.2.0, Mise adheres to a structured release workflow:
- Weekly Release Cycle: Routine bug fixes, UI improvements, and feature additions accumulate on the
devbranch throughout the week. Following comprehensive local verification, these changes are merged intomainand released in weekly batches on Sunday nights. - Emergency Security Hotfixes: Critical security vulnerabilities bypass the weekly schedule entirely. They are remediated immediately, merged directly into
main, and published as expedited patch releases (e.g.v1.2.1) to ensure automated package builds deploy without delay. - Upstream Tracking: Mise tracks upstream Electron and Chromium updates and patches daily. All patches and updates to Electron and Chromium are delivered promptly to ensure runtime security and stability (as demonstrated when three Electron updates were delivered within four days). Each release announcement and tagged milestone explicitly lists its corresponding Electron and Chromium runtime versions.
| Version | Supported | Notes |
|---|---|---|
Latest stable release (main) | Yes | Actively maintained with upstream security updates and bug fixes |
Development (dev branch) | Best effort | Active development workshop evaluated and merged in weekly Sunday batches |
| Prior releases | No | Unsupported; please upgrade to the latest release |
Reporting a Vulnerability
The maintainer appreciates the efforts of security researchers and users who report vulnerabilities responsibly:
- Private Reporting: Please do not report security vulnerabilities via public GitHub issues, discussions, or pull requests.
- Preferred Channel: Submit vulnerability disclosures privately via GitHub Security Advisories.
- Alternative Contact: If GitHub Security Advisories are unavailable, contact the project maintainer directly via GitHub profile details.
- Information to Include:
- Detailed description of the vulnerability and its potential impact.
- Step-by-step reproduction instructions or a minimal proof of concept.
- Operating system, architecture, and exact Mise Browser release version.
- Response Timeline: The maintainer aims to acknowledge reports within 48 hours and provide a remediation timeline within 7 calendar days.
Security Architecture & Threat Model
Mise Browser is designed with multiple defence-in-depth layers:
Process Isolation & Sandbox Hardening
- Context Isolation: Strict context isolation (
contextIsolation: true) ensures renderer scripts cannot access Node.js or Electron internal APIs directly. - Zero Node Integration in Webviews: All
<webview>elements run withnodeIntegration: false,nodeIntegrationInSubFrames: false, andsandbox: true. - Remote Module Disabled: Electron's deprecated
enableRemoteModuleis strictly disabled across all windows and webviews. - Preload API Boundary: Communication between web pages and the main process occurs exclusively through a minimal, vetted
contextBridgewhitelist inpreload.js. - Main Shell Navigation Lock: Top-level navigation of the main application window is strictly locked to the local
index.htmlinterface viawill-navigatelisteners. Any attempt to navigate the primary shell to external or remote URLs is cancelled, and unmanaged popup windows are denied unconditionally viasetWindowOpenHandler. - Guest Webview Navigation & Scheme Guards: Guest
<webview>instances are monitored globally throughapp.on('web-contents-created'). Navigations are strictly limited bywill-navigateandnew-windowhandlers to safe protocols (http:,https:,about:blank, or bundled local assets). Dangerous schemes such asfile:,javascript:, and unauthorised custom protocols are rejected. - Content Security Policy & Local Asset Bundling: The application shell (
index.html) enforces a strict Content Security Policy (default-src 'self',script-src 'self',style-src 'self' 'unsafe-inline',font-src 'self' data:,img-src 'self' data: blob: https:,object-src 'none',base-uri 'none',form-action 'none'). All UI assets, stylesheets, and FontAwesome webfonts are bundled 100% locally inassets/, eliminating external CDN tracking, IP leakage, and network requests on launch. - Download Path Containment & Dangerous Extension Safeguards: All download execution and file manager revelation requests dispatched via
open-downloadandreveal-downloadIPC handlers are strictly constrained to canonical realpaths of tracked active or recent downloads. Untracked paths are rejected. Files matching dangerous executable or script extensions (.exe,.msi,.bat,.cmd,.com,.scr,.ps1,.vbs,.js,.jse,.wsf,.lnk,.jar,.sh,.run,.appimage,.desktop,.command,.app,.dmg,.pkg,.deb,.rpm) are detected case-insensitively when opened, automatically diverting from execution to safe revelation in the desktop file manager using non-blocking asynchronous processes with timeouts. - Reader View & Web Clipping Export Gating: Reader View article distillation and note export pipelines enforce trusted interaction gating (
event.isTrustedon genuine overlay action buttons) within guest webview preloads, eliminating CustomEvent forwarding attack surfaces. Invocations are restricted to active reader sessions, throttled to once every 2 seconds per webview, extract article data host-side with strict string type validation and length limits (300 character title, 200,000 character content), and enforce storage quotas (1 MB markdown payload cap, maximum 200 clipping files) to prevent arbitrary data injection or disk exhaustion. - Second-Instance Command Validation: When secondary process invocations dispatch URLs from the command line, targets are strictly validated with
security.isSafeTabUrl(url)before dispatching to tabs, guaranteeing parity withopen-urlhandling and preventing external processes from injecting arbitrary local file paths or dangerous schemes. - Canonical PDF Viewer Preload Capability Scoping: The privileged
__misePDFBridgecontextBridge API is granted exclusively to the genuine vendored viewer (viewer.html). Preload scripts query the canonical viewer URL from the main process and verify exact pathname equality, preventing downloaded or crafted local files from accessing PDF bridge methods. - Address Bar Local File Navigation Guard & Configurable Document Viewing: Direct local filesystem inputs in the address bar (
/orfile://) are strictly validated againstisPdfUrlby default. Only genuine.pdfdocuments are permitted, mediating rendering through the offline vendored PDF viewer. When the optional "Local Document Viewing" toggle is explicitly enabled in Preferences (#tab-privacy), users may view local documents (.html,.htm,.xhtml,.txt,.svg, and.pdf). Target paths are strictly sanitised and resolved (path.resolve,fs.realpathSync), confined away from sensitive system paths (/etc,/proc,/sys,/dev,/boot,/root,/usr/bin,/usr/sbin,/usr/lib,/var), and blocked from accessing hidden credential stores or user dotfiles (~/.ssh,~/.gnupg,~/.config/mise-browser,~/.local/share/keyrings,~/.bash_history,~/.env). Disguised ELF and PE binaries or executable scripts are blocked unconditionally, and clear notification toasts alert users when local document access is rejected or attempted whilst disabled. - Transient Modal Lifecycle Teardown: Modal webview containers (including the transient sharing modal) execute
destroyGuestWebviewprior to closing or replacing guest frames, ensuring audio streams are muted, abort controllers triggered, and the guest navigated toabout:blankto prevent background render processes or resource leaks. - Update Check Safety & Failure Diagnostic Auditing: The in-app update checker explicitly validates check responses for network errors, rate limits, or timeouts. Failed checks display descriptive failure notifications rather than misleading up-to-date notices, and record structured warning entries in local diagnostics logs (
miseAPI.logDiagnosticsEvent) for transparent local auditing. - Host Sender IPC Verification & IPC Guard: All main process IPC listeners and handlers (
ipcMain.handle,handleOnce,on, andonce) are wrapped by an active IPC guard (main/ipcGuard.js) installed at engine startup. Invocations are verified to ensure that the event sender matches the authentic host application window (window.webContents). Invocations originating from untrusted<webview>guest frames targeting host channels are blocked immediately (synchronous handlers return null; asynchronous handlers throw Forbidden errors). Guest webviews may only communicate over an explicit allowlist of safe guest channels (guest-webview-open-urland cosmetic adblocker channels). - Host Channel Argument Hardening & Diagnostics Bounds: Host IPC channels validate parameters against schemas, whitelists, and length bounds. Workspace partition names are validated against
isValidPartitionName, webview key forwarding enforces a 64-character whitelist of recognised keybind actions, external URL opening (open-external) caps URLs at 2048 characters with protocol checks, and diagnostic event logging (log-diagnostics-event) bounds object recursion depth to 6, string lengths to 500 characters, and array sizes to 50 items. - Userscript Bridge Token Lifecycle & Origin Binding: Privileged userscript bridge methods (
GM_*) require ephemeral authorisation tokens generated by the main process. Tokens enforce a 6-hour idle expiry and an eviction ceiling of 2,000 entries. On first use, tokens bind to the callingwebContentsand enforce strict frame origin matching (scheme, host, and port) as well as main-frame checks (senderFrame === webContents.mainFrame). Invocations with null or detached frames are rejected unconditionally. Tokens are revoked automatically on navigation (did-navigate) or frame destruction, and style queries are segregated to a dedicated channel to prevent token churn.
Workspace Container Partitions
- Each workspace operates inside a dedicated, isolated Chromium session partition (
persist:mise_ws_<workspace>). - Partitions prevent cross-site and cross-workspace cookie leakage, keeping personal, work, and banking sessions completely segregated.
Clipboard-Mediated Terminal Handshake & Optional Oversight Tool
- Clipboard Boundary: Mise never executes terminal commands or shell processes automatically in the background. When terminal actions or script executions are triggered, Mise copies the target command to the user's system clipboard and launches an empty, unmanaged external terminal emulator.
- Clipboard Pastejacking Sanitisation: Staged terminal commands dispatched via
execute-terminal-commandare sanitised throughsecurity.sanitiseTerminalCommand. All carriage returns (\r), line feeds (\n), and null bytes (\0) are stripped and replaced with spaces, and length is bounded to 4096 characters. This neutralises terminal pastejacking attacks where embedded or trailing newlines would otherwise execute commands automatically upon pasting. - Optional Oversight Scanner: Active command scanning, heuristic script inspection, Shannon entropy checks, and interactive confirmation paging are provided exclusively by Oversight, an independent, optional external utility created by the same author.
- Execution at User's Own Risk: Oversight is not bundled with Mise. Without the standalone Oversight utility installed in the system PATH, commands staged on the clipboard are pasted and run by the user entirely at their own risk, without automated scanning, heuristic checks, or safety prompts.
Granular Permission Vault & Sensor Sandboxing
- Zero-Trust Sensor Lockdown in Private Profiles: The volatile private profile (
MisePrivateProfile) enforces an unconditional sensor block. Requests for camera, microphone, geolocation, clipboard reading, and notifications are immediately denied without prompt interruption, memory leak, or disk persistence. Benign non-identifying display capabilities (fullscreen,pointerLock,keyboardLock,clipboard-sanitized-write) remain active for seamless navigation. - Granular Per-Domain Permission Vault: For persistent workspaces, permissions for camera, microphone, geolocation, clipboard read, and notifications are tracked granularly per domain in
~/.config/mise-browser/permissions.jsonusing atomic file writes with restrictive0o600POSIX permissions. - Separation from Anti-Fingerprinting Trust: Hardware permissions are strictly decoupled from
trusted_domains. Marking a domain as trusted for anti-fingerprint and tracker exceptions does not grant silent access to cameras, microphones, or location sensors. - Interactive Prompt Broker & Cross-Origin Guards: Unrecorded permission requests trigger an interactive prompt brokered by the main process with a 25-second fail-closed timeout. Subframe requests from cross-origin iframes are blocked unconditionally.
WebRTC IP Handling & Leak Controls
- Anti-Leak Interface Binding: To prevent STUN and ICE queries from leaking local LAN IP addresses or transmitting non-proxied UDP traffic outside of active VPN/proxy tunnels, Mise enforces configurable WebRTC IP handling policies across all browser sessions.
- Selectable Protection Levels: Users can choose between Balanced (default public interface only), Strict / Proxy Safe (
disable_non_proxied_udp), Disabled (neutralisingRTCPeerConnection,RTCSessionDescription, andRTCIceCandidateon untrusted sites), and Permissive standard Chromium mode. - Dynamic Hot-Reloading: Changing the WebRTC policy in Preferences or cycling it via the Command Palette reconfigures active sessions in real time without requiring an application restart.
TLS Certificate Policy & Local Network Trust
- Local Network Certificate Trust: Self-signed TLS certificates on private subnets and local endpoints (RFC 1918
192.168.0.0/16,10.0.0.0/8,172.16.0.0/12, loopback127.0.0.0/8/localhost/::1, link-local169.254.0.0/16, RFC 4193fc00::/7, and local suffixes.local,.lan,.home.arpa,.internal) are automatically trusted viaallow_local_certificates(enabled by default). This eliminates blank page load failures and allows seamless access to home servers, Cockpit, Proxmox, TrueNAS, and router interfaces out of the box. - Informative Navigation Error Interstitial: When network connections fail or untrusted certificates are encountered on public domains, Mise displays a themed Tokyo Night interstitial page (
assets/error.html) detailing the exact failure code (e.g.NET::ERR_CERT_AUTHORITY_INVALID,NET::ERR_CONNECTION_REFUSED) with options to retry, navigate back, or proceed past certificate warnings. - Granular Certificate Exception Allowlist: Specific hosts and port endpoints can be granted explicit certificate trust via the
trusted_certificatesconfiguration setting in Preferences. - Visual Status Bar Auditing: Local self-signed connections and certificate exceptions are highlighted on the status bar with a dedicated
LOCAL TLSbadge, ensuring encrypted connections remain transparent.
Native Request Filtering
- Network requests are intercepted in-process via Ghostery's blocking engine before departing the local machine.
- Known malicious hosts, tracking scripts, and cryptominers are dropped at the network interceptor layer.
- Userscript SSRF Network Protection: Cross-origin
GM_xmlhttpRequestcalls dispatched by userscripts are inspected in the main process and validated against an expanded IP blocklist covering loopback (127.0.0.0/8,::1), private subnets (10.0.0.0/8,172.16.0.0/12,192.168.0.0/16), link-local endpoints (169.254.0.0/16,fe80::/10), unique local IPv6 (fc00::/7), carrier-grade NAT (100.64.0.0/10), benchmark subnets (198.18.0.0/15), documentation ranges (192.0.2.0/24,198.51.100.0/24,203.0.113.0/24,2001:db8::/32), multicast (224.0.0.0/4,ff00::/8), reserved blocks (240.0.0.0/4), discard prefixes (100::/64), and IPv4-translated ranges (64:ff9b::/96,::ffff:0:0/96). Hostname pre-resolution and socket IP pinning eliminate DNS rebinding risks.
Session & Data Storage Architecture
- Transparent Plaintext User Data: Configuration (
config.json), keybindings (keybinds.json), workspaces (session.json), history (history.json), bookmarks (bookmarks.json), and notes (notes.md) are stored in transparent, human-readable JSON and Markdown files under~/.config/mise-browser/, protected by standard user-only filesystem permissions (0600/0700). Users retain full ownership to inspect, edit, or back up files using standard tools. - Session Persistence Integrity & Snapshot Rotation: Tab URL persistence is strictly guarded by
isPersistableTabUrlacross navigation events, capturing only valid web and local file schemes (http:,https:, andfile:) and rejecting transient blank or error schemes. Suspect blank session states are quarantined tosession.suspect.jsonto prevent session corruption. Atomic backups (session.json.bak) are updated solely on valid non-blank writes, and timestamped recovery snapshots (session.snap-YYYYMMDD-HHMMSS.json) are automatically rotated, retaining the 10 newest snapshots with a 10-minute rate limit. - Path Traversal Containment: Local filesystem integrations, including opening Markdown notes in external editors, enforce strict path resolution confined to the application configuration directory (
resolveSafeNotesPath). File paths supplied by renderer IPC requests are stripped or rejected to prevent directory traversal. - Runtime Configuration Patch Validation: Dynamic configuration updates dispatched via
save-browser-settingsandupdate-browser-settingsare sanitised throughvalidateConfigPatchinmain/config.js. Incoming patches enforce strict type, boundary, and enum validation, and unrecognised keys are rejected. - External Notes Command Confirmation Prompt: To prevent malicious scripts from modifying external command invocations, updating the
external_notes_commandsetting via IPC or the settings interface triggers an interactive native confirmation dialog requiring explicit user authorisation before saving to disk. - Session Persistence Payload Bounds: The
save-sessionIPC handler strictly validates session structure and caps sizes (maximum 50 workspaces, maximum 200 tabs per workspace, maximum 5 MB payload size, workspace names bounded to 200 characters, and tab URLs bounded to 16,384 characters), preventing memory exhaustion attacks. - Prototype Pollution Prevention: Userscript key-value storage (
GM_setValueandGM_getValue) operates on isolated, null-prototype dictionaries (Object.create(null)). Storage keys are validated against prototype pollution targets (__proto__,constructor,prototype), and persisted objects are sanitised before saving to disk. - Userscript Storage Quotas & Atomic Persistence: In addition to prototype pollution defences, userscript stores enforce per-script storage quotas: 1 MB per value, 1,000 keys per script, and a 5 MB total storage cap per script store with automatic rollback on error. Stores are persisted using
atomicWriteFileSyncwith restricted0600filesystem permissions and corrupted file recovery (readJsonFileOrBackup), with 500 ms per-script write debouncing flushed on exit. - Markdown Hyperlink Sanitisation: The integrated notes scratchpad strictly validates Markdown hyperlinks (
[label](url)) against safe web schemes (http:andhttps:). Dangerous schemes such asfile:,javascript:, anddata:are neutralised and rendered as plain text. The preview click handler verifiesisSafeTabUrlbefore creating tabs. - Quickmark & Bookmark Jump Safety Validation: Quickmark assignments and bookmark entries are strictly validated with
isSafeTabUrlbefore being stored or dispatched to tabs viaspawnTabWithUrl. Targets with disallowed protocols (such asfile:,javascript:,data:, or malformed URLs) are rejected and return focus cleanly to the active webview, preventing arbitrary local file loading or unintended protocol execution through keyboard shortcuts or overlay clicks. - OS Keyring Cookie Encryption: Persistent workspace partitions isolate cookies and web caches per container. Sensitive session tokens written by Chromium are encrypted at rest using
safeStorage, which binds encryption keys directly to the host operating system's credential keyring (libsecret/ GNOME Keyring / KWallet on Linux, Apple Keychain on macOS, and DPAPI on Windows). - Zero Cloud Synchronisation: No remote telemetry, no cloud profile syncing, and zero analytics.
- Surgical Cookie Clearing: Dedicated cache controls allow wiping tracking tokens for specific domains without invalidating sessions in unrelated tabs.
Credential & Password Management Philosophy
- Zero Embedded Password Manager: Mise intentionally excludes built-in password saving, autofill prompts, and credential vaults.
- Elimination of Malware Targets: Browser-bundled password vaults (such as Chromium's
Login Datafile) represent the primary attack target for infostealers and credential extraction malware. By omitting internal password storage entirely, Mise removes this high-value vulnerability surface. - User Autonomy & External Tools: Users retain full discretion to employ their preferred dedicated password managers (such as Pass, KeePassXC, Bitwarden, or system keychains) outside the browser's execution perimeter.
- External Setup Guide: For step-by-step guidance on pairing standalone tools such as KeePassXC Auto-Type or CLI utilities with automatic clipboard clearing, see the dedicated External Password Managers Guide.
Responsible Disclosure Commitment
In return for responsible disclosure, the project maintainer commits to:
- Working collaboratively with researchers to validate and resolve reported issues promptly.
- Crediting researchers in release notes and security advisories (unless anonymity is requested).
- Providing reasonable notice prior to public disclosure of vulnerabilities and fixes.
