2 /******************************************************************************
4 * https://github.com/pyllyukko/user.js *
5 ******************************************************************************/
7 /******************************************************************************
8 * SECTION: HTML5 / APIs / DOM *
9 ******************************************************************************/
11 // PREF: Disable Service Workers
12 // https://developer.mozilla.org/en-US/docs/Web/API/Worker
13 // https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker_API
14 // https://wiki.mozilla.org/Firefox/Push_Notifications#Service_Workers
15 // NOTICE: Disabling ServiceWorkers breaks functionality on some sites (Google Street View...)
16 // NOTICE: Disabling ServiceWorkers breaks Firefox Sync
17 // Unknown security implications
18 // CVE-2016-5259, CVE-2016-2812, CVE-2016-1949, CVE-2016-5287 (fixed)
19 user_pref("dom.serviceWorkers.enabled", false);
21 // PREF: Disable web notifications
22 // https://support.mozilla.org/en-US/questions/1140439
23 user_pref("dom.webnotifications.enabled", false);
25 // PREF: Disable DOM timing API
26 // https://wiki.mozilla.org/Security/Reviews/Firefox/NavigationTimingAPI
27 // https://www.w3.org/TR/navigation-timing/#privacy
28 user_pref("dom.enable_performance", false);
30 // PREF: Make sure the User Timing API does not provide a new high resolution timestamp
31 // https://trac.torproject.org/projects/tor/ticket/16336
32 // https://www.w3.org/TR/2013/REC-user-timing-20131212/#privacy-security
33 user_pref("dom.enable_user_timing", false);
35 // PREF: Disable Web Audio API
36 // https://bugzilla.mozilla.org/show_bug.cgi?id=1288359
37 // NOTICE: Web Audio API is required for Unity web player/games
38 user_pref("dom.webaudio.enabled", false);
40 // PREF: Disable Location-Aware Browsing (geolocation)
41 // https://www.mozilla.org/en-US/firefox/geolocation/
42 user_pref("geo.enabled", false);
44 // PREF: When geolocation is enabled, use Mozilla geolocation service instead of Google
45 // https://bugzilla.mozilla.org/show_bug.cgi?id=689252
46 user_pref("geo.wifi.uri", "https://location.services.mozilla.com/v1/geolocate?key=%MOZILLA_API_KEY%");
48 // PREF: When geolocation is enabled, don't log geolocation requests to the console
49 user_pref("geo.wifi.logging.enabled", false);
51 // PREF: Disable raw TCP socket support (mozTCPSocket)
52 // https://trac.torproject.org/projects/tor/ticket/18863
53 // https://www.mozilla.org/en-US/security/advisories/mfsa2015-97/
54 // https://developer.mozilla.org/docs/Mozilla/B2G_OS/API/TCPSocket
55 user_pref("dom.mozTCPSocket.enabled", false);
57 // PREF: Disable DOM storage (disabled)
58 // http://kb.mozillazine.org/Dom.storage.enabled
59 // https://html.spec.whatwg.org/multipage/webstorage.html
60 // NOTICE-DISABLED: Disabling DOM storage is known to cause`TypeError: localStorage is null` errors
61 //user_pref("dom.storage.enabled", false);
63 // PREF: Disable leaking network/browser connection information via Javascript
64 // Network Information API provides general information about the system's connection type (WiFi, cellular, etc.)
65 // https://developer.mozilla.org/en-US/docs/Web/API/Network_Information_API
66 // https://wicg.github.io/netinfo/#privacy-considerations
67 // https://bugzilla.mozilla.org/show_bug.cgi?id=960426
68 user_pref("dom.netinfo.enabled", false);
70 // PREF: Disable network API (Firefox < 32)
71 // https://developer.mozilla.org/en-US/docs/Web/API/Connection/onchange
72 // https://www.torproject.org/projects/torbrowser/design/#fingerprinting-defenses
73 user_pref("dom.network.enabled", false);
75 // PREF: Disable WebRTC entirely to prevent leaking internal IP addresses (Firefox < 42)
76 // NOTICE: Disabling WebRTC breaks peer-to-peer file sharing tools (reep.io ...)
77 user_pref("media.peerconnection.enabled", false);
79 // PREF: Don't reveal your internal IP when WebRTC is enabled (Firefox >= 42)
80 // https://wiki.mozilla.org/Media/WebRTC/Privacy
81 // https://github.com/beefproject/beef/wiki/Module%3A-Get-Internal-IP-WebRTC
82 user_pref("media.peerconnection.ice.default_address_only", true); // Firefox 42-51
83 user_pref("media.peerconnection.ice.no_host", true); // Firefox >= 52
85 // PREF: Disable WebRTC getUserMedia, screen sharing, audio capture, video capture
86 // https://wiki.mozilla.org/Media/getUserMedia
87 // https://blog.mozilla.org/futurereleases/2013/01/12/capture-local-camera-and-microphone-streams-with-getusermedia-now-enabled-in-firefox/
88 // https://developer.mozilla.org/en-US/docs/Web/API/Navigator
89 user_pref("media.navigator.enabled", false);
90 user_pref("media.navigator.video.enabled", false);
91 user_pref("media.getusermedia.screensharing.enabled", false);
92 user_pref("media.getusermedia.audiocapture.enabled", false);
94 // PREF: Disable battery API (Firefox < 52)
95 // https://developer.mozilla.org/en-US/docs/Web/API/BatteryManager
96 // https://bugzilla.mozilla.org/show_bug.cgi?id=1313580
97 user_pref("dom.battery.enabled", false);
99 // PREF: Disable telephony API
100 // https://wiki.mozilla.org/WebAPI/Security/WebTelephony
101 user_pref("dom.telephony.enabled", false);
103 // PREF: Disable "beacon" asynchronous HTTP transfers (used for analytics)
104 // https://developer.mozilla.org/en-US/docs/Web/API/navigator.sendBeacon
105 user_pref("beacon.enabled", false);
107 // PREF: Disable clipboard event detection (onCut/onCopy/onPaste) via Javascript
108 // NOTICE: Disabling clipboard events breaks Ctrl+C/X/V copy/cut/paste functionaility in JS-based web applications (Google Docs...)
109 // https://developer.mozilla.org/en-US/docs/Mozilla/Preferences/Preference_reference/dom.event.clipboardevents.enabled
110 user_pref("dom.event.clipboardevents.enabled", false);
112 // PREF: Disable "copy to clipboard" functionality via Javascript (Firefox >= 41)
113 // NOTICE: Disabling clipboard operations will break legitimate JS-based "copy to clipboard" functionality
114 // https://hg.mozilla.org/mozilla-central/rev/2f9f8ea4b9c3
115 user_pref("dom.allow_cut_copy", false);
117 // PREF: Disable speech recognition
118 // https://dvcs.w3.org/hg/speech-api/raw-file/tip/speechapi.html
119 // https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition
120 // https://wiki.mozilla.org/HTML5_Speech_API
121 user_pref("media.webspeech.recognition.enable", false);
123 // PREF: Disable speech synthesis
124 // https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesis
125 user_pref("media.webspeech.synth.enabled", false);
127 // PREF: Disable sensor API
128 // https://wiki.mozilla.org/Sensor_API
129 user_pref("device.sensors.enabled", false);
131 // PREF: Disable pinging URIs specified in HTML <a> ping= attributes
132 // http://kb.mozillazine.org/Browser.send_pings
133 user_pref("browser.send_pings", false);
135 // PREF: When browser pings are enabled, only allow pinging the same host as the origin page
136 // http://kb.mozillazine.org/Browser.send_pings.require_same_host
137 user_pref("browser.send_pings.require_same_host", true);
139 // PREF: Disable IndexedDB (disabled)
140 // https://developer.mozilla.org/en-US/docs/IndexedDB
141 // https://en.wikipedia.org/wiki/Indexed_Database_API
142 // https://wiki.mozilla.org/Security/Reviews/Firefox4/IndexedDB_Security_Review
143 // http://forums.mozillazine.org/viewtopic.php?p=13842047
144 // https://github.com/pyllyukko/user.js/issues/8
145 // NOTICE-DISABLED: IndexedDB could be used for tracking purposes, but is required for some add-ons to work (notably uBlock), so is left enabled
146 //user_pref("dom.indexedDB.enabled", false);
148 // TODO: "Access Your Location" "Maintain Offline Storage" "Show Notifications"
150 // PREF: Disable gamepad API to prevent USB device enumeration
151 // https://www.w3.org/TR/gamepad/
152 // https://trac.torproject.org/projects/tor/ticket/13023
153 user_pref("dom.gamepad.enabled", false);
155 // PREF: Disable virtual reality devices APIs
156 // https://developer.mozilla.org/en-US/Firefox/Releases/36#Interfaces.2FAPIs.2FDOM
157 // https://developer.mozilla.org/en-US/docs/Web/API/WebVR_API
158 user_pref("dom.vr.enabled", false);
160 // PREF: Disable vibrator API
161 user_pref("dom.vibrator.enabled", false);
163 // PREF: Disable resource timing API
164 // https://www.w3.org/TR/resource-timing/#privacy-security
165 user_pref("dom.enable_resource_timing", false);
167 // PREF: Disable Archive API (Firefox < 54)
168 // https://wiki.mozilla.org/WebAPI/ArchiveAPI
169 // https://bugzilla.mozilla.org/show_bug.cgi?id=1342361
170 user_pref("dom.archivereader.enabled", false);
172 // PREF: Disable webGL
173 // https://en.wikipedia.org/wiki/WebGL
174 // https://www.contextis.com/resources/blog/webgl-new-dimension-browser-exploitation/
175 user_pref("webgl.disabled", true);
176 // PREF: When webGL is enabled, use the minimum capability mode
177 user_pref("webgl.min_capability_mode", true);
178 // PREF: When webGL is enabled, disable webGL extensions
179 // https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API#WebGL_debugging_and_testing
180 user_pref("webgl.disable-extensions", true);
181 // PREF: When webGL is enabled, force enabling it even when layer acceleration is not supported
182 // https://trac.torproject.org/projects/tor/ticket/18603
183 user_pref("webgl.disable-fail-if-major-performance-caveat", true);
184 // PREF: When webGL is enabled, do not expose information about the graphics driver
185 // https://bugzilla.mozilla.org/show_bug.cgi?id=1171228
186 // https://developer.mozilla.org/en-US/docs/Web/API/WEBGL_debug_renderer_info
187 user_pref("webgl.enable-debug-renderer-info", false);
188 // somewhat related...
189 //user_pref("pdfjs.enableWebGL", false);
191 // PREF: Spoof dual-core CPU
192 // https://trac.torproject.org/projects/tor/ticket/21675
193 // https://bugzilla.mozilla.org/show_bug.cgi?id=1360039
194 user_pref("dom.maxHardwareConcurrency", 2);
196 // PREF: Disable WebAssembly
197 // https://webassembly.org/
198 // https://en.wikipedia.org/wiki/WebAssembly
199 // https://trac.torproject.org/projects/tor/ticket/21549
200 // NOTICE: WebAssembly is required for Unity web player/games
201 user_pref("javascript.options.wasm", false);
203 /******************************************************************************
205 ******************************************************************************/
207 // PREF: Disable face detection
208 user_pref("camera.control.face_detection.enabled", false);
210 // PREF: Disable GeoIP lookup on your address to set default search engine region
211 // https://trac.torproject.org/projects/tor/ticket/16254
212 // https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_geolocation-for-default-search-engine
213 user_pref("browser.search.countryCode", "US");
214 user_pref("browser.search.region", "US");
215 user_pref("browser.search.geoip.url", "");
217 // PREF: Set Accept-Language HTTP header to en-US regardless of Firefox localization
218 // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
219 user_pref("intl.accept_languages", "en-US, en");
221 // PREF: Don't use OS values to determine locale, force using Firefox locale setting
222 // http://kb.mozillazine.org/Intl.locale.matchOS
223 user_pref("intl.locale.matchOS", false);
225 // PREF: Don't use Mozilla-provided location-specific search engines
226 user_pref("browser.search.geoSpecificDefaults", false);
228 // PREF: Do not automatically send selection to clipboard on some Linux platforms
229 // http://kb.mozillazine.org/Clipboard.autocopy
230 user_pref("clipboard.autocopy", false);
232 // PREF: Prevent leaking application locale/date format using JavaScript
233 // https://bugzilla.mozilla.org/show_bug.cgi?id=867501
234 // https://hg.mozilla.org/mozilla-central/rev/52d635f2b33d
235 user_pref("javascript.use_us_english_locale", true);
237 // PREF: Do not submit invalid URIs entered in the address bar to the default search engine
238 // http://kb.mozillazine.org/Keyword.enabled
239 user_pref("keyword.enabled", false);
241 // PREF: Don't trim HTTP off of URLs in the address bar.
242 // https://bugzilla.mozilla.org/show_bug.cgi?id=665580
243 user_pref("browser.urlbar.trimURLs", false);
245 // PREF: Don't try to guess domain names when entering an invalid domain name in URL bar
246 // http://www-archive.mozilla.org/docs/end-user/domain-guessing.html
247 user_pref("browser.fixup.alternate.enabled", false);
249 // PREF: When browser.fixup.alternate.enabled is enabled, strip password from 'user:password@...' URLs
250 // https://github.com/pyllyukko/user.js/issues/290#issuecomment-303560851
251 user_pref("browser.fixup.hide_user_pass", true);
253 // PREF: Send DNS request through SOCKS when SOCKS proxying is in use
254 // https://trac.torproject.org/projects/tor/wiki/doc/TorifyHOWTO/WebBrowsers
255 user_pref("network.proxy.socks_remote_dns", true);
257 // PREF: Don't monitor OS online/offline connection state
258 // https://trac.torproject.org/projects/tor/ticket/18945
259 user_pref("network.manage-offline-status", false);
261 // PREF: Enforce Mixed Active Content Blocking
262 // https://support.mozilla.org/t5/Protect-your-privacy/Mixed-content-blocking-in-Firefox/ta-p/10990
263 // https://developer.mozilla.org/en-US/docs/Site_Compatibility_for_Firefox_23#Non-SSL_contents_on_SSL_pages_are_blocked_by_default
264 // https://blog.mozilla.org/tanvi/2013/04/10/mixed-content-blocking-enabled-in-firefox-23/
265 user_pref("security.mixed_content.block_active_content", true);
267 // PREF: Enforce Mixed Passive Content blocking (a.k.a. Mixed Display Content)
268 // NOTICE: Enabling Mixed Display Content blocking can prevent images/styles... from loading properly when connection to the website is only partially secured
269 user_pref("security.mixed_content.block_display_content", true);
271 // PREF: Disable JAR from opening Unsafe File Types
272 // http://kb.mozillazine.org/Network.jar.open-unsafe-types
273 // CIS Mozilla Firefox 24 ESR v1.0.0 - 3.7
274 user_pref("network.jar.open-unsafe-types", false);
276 // CIS 2.7.4 Disable Scripting of Plugins by JavaScript
277 // http://forums.mozillazine.org/viewtopic.php?f=7&t=153889
278 user_pref("security.xpconnect.plugin.unrestricted", false);
280 // PREF: Set File URI Origin Policy
281 // http://kb.mozillazine.org/Security.fileuri.strict_origin_policy
282 // CIS Mozilla Firefox 24 ESR v1.0.0 - 3.8
283 user_pref("security.fileuri.strict_origin_policy", true);
285 // PREF: Disable Displaying Javascript in History URLs
286 // http://kb.mozillazine.org/Browser.urlbar.filter.javascript
288 user_pref("browser.urlbar.filter.javascript", true);
290 // PREF: Disable asm.js
292 // https://www.mozilla.org/en-US/security/advisories/mfsa2015-29/
293 // https://www.mozilla.org/en-US/security/advisories/mfsa2015-50/
294 // https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-2712
295 user_pref("javascript.options.asmjs", false);
297 // PREF: Disable SVG in OpenType fonts
298 // https://wiki.mozilla.org/SVGOpenTypeFonts
299 // https://github.com/iSECPartners/publications/tree/master/reports/Tor%20Browser%20Bundle
300 user_pref("gfx.font_rendering.opentype_svg.enabled", false);
302 // PREF: Disable in-content SVG rendering (Firefox >= 53) (disabled)
303 // NOTICE-DISABLED: Disabling SVG support breaks many UI elements on many sites
304 // https://bugzilla.mozilla.org/show_bug.cgi?id=1216893
305 // https://github.com/iSECPartners/publications/raw/master/reports/Tor%20Browser%20Bundle/Tor%20Browser%20Bundle%20-%20iSEC%20Deliverable%201.3.pdf#16
306 //user_pref("svg.disabled", true);
309 // PREF: Disable video stats to reduce fingerprinting threat
310 // https://bugzilla.mozilla.org/show_bug.cgi?id=654550
311 // https://github.com/pyllyukko/user.js/issues/9#issuecomment-100468785
312 // https://github.com/pyllyukko/user.js/issues/9#issuecomment-148922065
313 user_pref("media.video_stats.enabled", false);
315 // PREF: Don't reveal build ID
316 // Value taken from Tor Browser
317 // https://bugzilla.mozilla.org/show_bug.cgi?id=583181
318 user_pref("general.buildID.override", "20100101");
319 user_pref("browser.startup.homepage_override.buildID", "20100101");
321 // PREF: Don't use document specified fonts to prevent installed font enumeration (fingerprinting)
322 // https://github.com/pyllyukko/user.js/issues/395
323 // https://browserleaks.com/fonts
324 // https://github.com/pyllyukko/user.js/issues/120
325 user_pref("browser.display.use_document_fonts", 0);
327 // PREF: Enable only whitelisted URL protocol handlers
328 // http://kb.mozillazine.org/Network.protocol-handler.external-default
329 // http://kb.mozillazine.org/Network.protocol-handler.warn-external-default
330 // http://kb.mozillazine.org/Network.protocol-handler.expose.%28protocol%29
331 // https://news.ycombinator.com/item?id=13047883
332 // https://bugzilla.mozilla.org/show_bug.cgi?id=167475
333 // https://github.com/pyllyukko/user.js/pull/285#issuecomment-298124005
334 // NOTICE: Disabling nonessential protocols breaks all interaction with custom protocols such as mailto:, irc:, magnet: ... and breaks opening third-party mail/messaging/torrent/... clients when clicking on links with these protocols
335 // TODO: Add externally-handled protocols from Windows 8.1 and Windows 10 (currently contains protocols only from Linux and Windows 7) that might pose a similar threat (see e.g. https://news.ycombinator.com/item?id=13044991)
336 // TODO: Add externally-handled protocols from Mac OS X that might pose a similar threat (see e.g. https://news.ycombinator.com/item?id=13044991)
337 // If you want to enable a protocol, set network.protocol-handler.expose.(protocol) to true and network.protocol-handler.external.(protocol) to:
338 // * true, if the protocol should be handled by an external application
339 // * false, if the protocol should be handled internally by Firefox
340 user_pref("network.protocol-handler.warn-external-default", true);
341 user_pref("network.protocol-handler.external.http", false);
342 user_pref("network.protocol-handler.external.https", false);
343 user_pref("network.protocol-handler.external.javascript", false);
344 user_pref("network.protocol-handler.external.moz-extension", false);
345 user_pref("network.protocol-handler.external.ftp", false);
346 user_pref("network.protocol-handler.external.file", false);
347 user_pref("network.protocol-handler.external.about", false);
348 user_pref("network.protocol-handler.external.chrome", false);
349 user_pref("network.protocol-handler.external.blob", false);
350 user_pref("network.protocol-handler.external.data", false);
351 user_pref("network.protocol-handler.expose-all", false);
352 user_pref("network.protocol-handler.expose.http", true);
353 user_pref("network.protocol-handler.expose.https", true);
354 user_pref("network.protocol-handler.expose.javascript", true);
355 user_pref("network.protocol-handler.expose.moz-extension", true);
356 user_pref("network.protocol-handler.expose.ftp", true);
357 user_pref("network.protocol-handler.expose.file", true);
358 user_pref("network.protocol-handler.expose.about", true);
359 user_pref("network.protocol-handler.expose.chrome", true);
360 user_pref("network.protocol-handler.expose.blob", true);
361 user_pref("network.protocol-handler.expose.data", true);
363 /******************************************************************************
364 * SECTION: Extensions / plugins *
365 ******************************************************************************/
367 // PREF: Ensure you have a security delay when installing add-ons (milliseconds)
368 // http://kb.mozillazine.org/Disable_extension_install_delay_-_Firefox
369 // http://www.squarefree.com/2004/07/01/race-conditions-in-security-dialogs/
370 user_pref("security.dialog_enable_delay", 1000);
372 // PREF: Require signatures
373 // https://wiki.mozilla.org/Addons/Extension_Signing
374 //user_pref("xpinstall.signatures.required", true);
376 // PREF: Opt-out of add-on metadata updates
377 // https://blog.mozilla.org/addons/how-to-opt-out-of-add-on-metadata-updates/
378 user_pref("extensions.getAddons.cache.enabled", false);
380 // PREF: Opt-out of themes (Persona) updates
381 // https://support.mozilla.org/t5/Firefox/how-do-I-prevent-autoamtic-updates-in-a-50-user-environment/td-p/144287
382 user_pref("lightweightThemes.update.enabled", false);
384 // PREF: Disable Flash Player NPAPI plugin
385 // http://kb.mozillazine.org/Flash_plugin
386 user_pref("plugin.state.flash", 0);
388 // PREF: Disable Java NPAPI plugin
389 user_pref("plugin.state.java", 0);
391 // PREF: Disable sending Flash Player crash reports
392 user_pref("dom.ipc.plugins.flash.subprocess.crashreporter.enabled", false);
394 // PREF: When Flash crash reports are enabled, don't send the visited URL in the crash report
395 user_pref("dom.ipc.plugins.reportCrashURL", false);
397 // PREF: When Flash is enabled, download and use Mozilla SWF URIs blocklist
398 // https://bugzilla.mozilla.org/show_bug.cgi?id=1237198
399 // https://github.com/mozilla-services/shavar-plugin-blocklist
400 user_pref("browser.safebrowsing.blockedURIs.enabled", true);
402 // PREF: Disable Gnome Shell Integration NPAPI plugin
403 user_pref("plugin.state.libgnome-shell-browser-plugin", 0);
405 // PREF: Disable the bundled OpenH264 video codec (disabled)
406 // http://forums.mozillazine.org/viewtopic.php?p=13845077&sid=28af2622e8bd8497b9113851676846b1#p13845077
407 //user_pref("media.gmp-provider.enabled", false);
409 // PREF: Enable plugins click-to-play
410 // https://wiki.mozilla.org/Firefox/Click_To_Play
411 // https://blog.mozilla.org/security/2012/10/11/click-to-play-plugins-blocklist-style/
412 user_pref("plugins.click_to_play", true);
414 // PREF: Updates addons automatically
415 // https://blog.mozilla.org/addons/how-to-turn-off-add-on-updates/
416 user_pref("extensions.update.enabled", true);
418 // PREF: Enable add-on and certificate blocklists (OneCRL) from Mozilla
419 // https://wiki.mozilla.org/Blocklisting
420 // https://blocked.cdn.mozilla.net/
421 // http://kb.mozillazine.org/Extensions.blocklist.enabled
422 // http://kb.mozillazine.org/Extensions.blocklist.url
423 // https://blog.mozilla.org/security/2015/03/03/revoking-intermediate-certificates-introducing-onecrl/
424 // Updated at interval defined in extensions.blocklist.interval (default: 86400)
425 user_pref("extensions.blocklist.enabled", true);
426 user_pref("services.blocklist.update_enabled", true);
428 // PREF: Decrease system information leakage to Mozilla blocklist update servers
429 // https://trac.torproject.org/projects/tor/ticket/16931
430 user_pref("extensions.blocklist.url", "https://blocklist.addons.mozilla.org/blocklist/3/%APP_ID%/%APP_VERSION%/");
432 // PREF: Disable system add-on updates (hidden & always-enabled add-ons from Mozilla)
433 // https://firefox-source-docs.mozilla.org/toolkit/mozapps/extensions/addon-manager/SystemAddons.html
434 // https://blog.mozilla.org/data/2018/08/20/effectively-measuring-search-in-firefox/
435 // https://github.com/pyllyukko/user.js/issues/419
436 // https://dxr.mozilla.org/mozilla-central/source/toolkit/mozapps/extensions/AddonManager.jsm#1248-1257
437 // NOTICE: Disabling system add-on updates prevents Mozilla from "hotfixing" your browser to patch critical problems (one possible use case from the documentation)
438 user_pref("extensions.systemAddon.update.enabled", false);
440 /******************************************************************************
441 * SECTION: Firefox (anti-)features / components * *
442 ******************************************************************************/
444 // PREF: Disable Extension recommendations (Firefox >= 65)
445 // https://support.mozilla.org/en-US/kb/extension-recommendations
446 user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr", false);
448 // PREF: Trusted Recursive Resolver (DNS-over-HTTPS) (disabled)
449 // https://wiki.mozilla.org/Trusted_Recursive_Resolver
450 //user_pref("network.trr.mode", 0);
452 // PREF: Disable WebIDE
453 // https://trac.torproject.org/projects/tor/ticket/16222
454 // https://developer.mozilla.org/docs/Tools/WebIDE
455 user_pref("devtools.webide.enabled", false);
456 user_pref("devtools.webide.autoinstallADBHelper", false);
457 user_pref("devtools.webide.autoinstallFxdtAdapters", false);
459 // PREF: Disable remote debugging
460 // https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_Desktop
461 // https://developer.mozilla.org/en-US/docs/Tools/Tools_Toolbox#Advanced_settings
462 user_pref("devtools.debugger.remote-enabled", false);
463 user_pref("devtools.chrome.enabled", false);
464 user_pref("devtools.debugger.force-local", true);
466 // PREF: Disable Mozilla telemetry/experiments
467 // https://wiki.mozilla.org/Platform/Features/Telemetry
468 // https://wiki.mozilla.org/Privacy/Reviews/Telemetry
469 // https://wiki.mozilla.org/Telemetry
470 // https://www.mozilla.org/en-US/legal/privacy/firefox.html#telemetry
471 // https://support.mozilla.org/t5/Firefox-crashes/Mozilla-Crash-Reporter/ta-p/1715
472 // https://wiki.mozilla.org/Security/Reviews/Firefox6/ReviewNotes/telemetry
473 // https://gecko.readthedocs.io/en/latest/browser/experiments/experiments/manifest.html
474 // https://wiki.mozilla.org/Telemetry/Experiments
475 // https://support.mozilla.org/en-US/questions/1197144
476 // https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/telemetry/internals/preferences.html#id1
477 user_pref("toolkit.telemetry.enabled", false);
478 user_pref("toolkit.telemetry.unified", false);
479 user_pref("toolkit.telemetry.archive.enabled", false);
480 user_pref("experiments.supported", false);
481 user_pref("experiments.enabled", false);
482 user_pref("experiments.manifest.uri", "");
484 // PREF: Disallow Necko to do A/B testing
485 // https://trac.torproject.org/projects/tor/ticket/13170
486 user_pref("network.allow-experiments", false);
488 // PREF: Disable sending Firefox crash reports to Mozilla servers
489 // https://wiki.mozilla.org/Breakpad
490 // http://kb.mozillazine.org/Breakpad
491 // https://dxr.mozilla.org/mozilla-central/source/toolkit/crashreporter
492 // https://bugzilla.mozilla.org/show_bug.cgi?id=411490
493 // A list of submitted crash reports can be found at about:crashes
494 user_pref("breakpad.reportURL", "");
496 // PREF: Disable sending reports of tab crashes to Mozilla (about:tabcrashed), don't nag user about unsent crash reports
497 // https://hg.mozilla.org/mozilla-central/file/tip/browser/app/profile/firefox.js
498 user_pref("browser.tabs.crashReporting.sendReport", false);
499 user_pref("browser.crashReports.unsubmittedCheck.enabled", false);
501 // PREF: Disable FlyWeb (discovery of LAN/proximity IoT devices that expose a Web interface)
502 // https://wiki.mozilla.org/FlyWeb
503 // https://wiki.mozilla.org/FlyWeb/Security_scenarios
504 // https://docs.google.com/document/d/1eqLb6cGjDL9XooSYEEo7mE-zKQ-o-AuDTcEyNhfBMBM/edit
505 // http://www.ghacks.net/2016/07/26/firefox-flyweb
506 user_pref("dom.flyweb.enabled", false);
508 // PREF: Disable the UITour backend
509 // https://trac.torproject.org/projects/tor/ticket/19047#comment:3
510 user_pref("browser.uitour.enabled", false);
512 // PREF: Enable Firefox Tracking Protection
513 // https://wiki.mozilla.org/Security/Tracking_protection
514 // https://support.mozilla.org/en-US/kb/tracking-protection-firefox
515 // https://support.mozilla.org/en-US/kb/tracking-protection-pbm
516 // https://kontaxis.github.io/trackingprotectionfirefox/
517 // https://feeding.cloud.geek.nz/posts/how-tracking-protection-works-in-firefox/
518 user_pref("privacy.trackingprotection.enabled", true);
519 user_pref("privacy.trackingprotection.pbmode.enabled", true);
521 // PREF: Enable contextual identity Containers feature (Firefox >= 52)
522 // NOTICE: Containers are not available in Private Browsing mode
523 // https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers
524 user_pref("privacy.userContext.enabled", true);
526 // PREF: Enable Firefox's anti-fingerprinting mode ("resist fingerprinting" or RFP) (Tor Uplift project)
527 // https://wiki.mozilla.org/Security/Tor_Uplift/Tracking
528 // https://bugzilla.mozilla.org/show_bug.cgi?id=1333933
529 // https://wiki.mozilla.org/Security/Fingerprinting
530 // NOTICE: RFP breaks some keyboard shortcuts used in certain websites (see #443)
531 // NOTICE: RFP changes your time zone
532 user_pref("privacy.resistFingerprinting", true);
534 // PREF: disable mozAddonManager Web API [FF57+]
535 // https://bugzilla.mozilla.org/buglist.cgi?bug_id=1384330
536 // https://bugzilla.mozilla.org/buglist.cgi?bug_id=1406795
537 // https://bugzilla.mozilla.org/buglist.cgi?bug_id=1415644
538 // https://bugzilla.mozilla.org/buglist.cgi?bug_id=1453988
539 // https://trac.torproject.org/projects/tor/ticket/26114
540 user_pref("privacy.resistFingerprinting.block_mozAddonManager", true);
541 user_pref("extensions.webextensions.restrictedDomains", "");
543 // PREF: enable RFP letterboxing / resizing of inner window [FF67+] (disabled)
544 // https://bugzilla.mozilla.org/1407366
545 //user_pref("privacy.resistFingerprinting.letterboxing", true);
546 //user_pref("privacy.resistFingerprinting.letterboxing.dimensions", "800x600, 1000x1000, 1600x900");
548 // PREF: disable showing about:blank/maximized window as soon as possible during startup [FF60+]
549 // https://bugzilla.mozilla.org/1448423
550 user_pref("browser.startup.blankWindow", false);
552 // PREF: Disable the built-in PDF viewer
553 // https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2015-2743
554 // https://blog.mozilla.org/security/2015/08/06/firefox-exploit-found-in-the-wild/
555 // https://www.mozilla.org/en-US/security/advisories/mfsa2015-69/
556 user_pref("pdfjs.disabled", true);
558 // PREF: Disable collection/sending of the health report (healthreport.sqlite*)
559 // https://support.mozilla.org/en-US/kb/firefox-health-report-understand-your-browser-perf
560 // https://gecko.readthedocs.org/en/latest/toolkit/components/telemetry/telemetry/preferences.html
561 user_pref("datareporting.healthreport.uploadEnabled", false);
562 user_pref("datareporting.healthreport.service.enabled", false);
563 user_pref("datareporting.policy.dataSubmissionEnabled", false);
564 // "Allow Firefox to make personalized extension recommendations"
565 user_pref("browser.discovery.enabled", false);
567 // PREF: Disable Shield/Heartbeat/Normandy (Mozilla user rating telemetry)
568 // https://wiki.mozilla.org/Advocacy/heartbeat
569 // https://trac.torproject.org/projects/tor/ticket/19047
570 // https://trac.torproject.org/projects/tor/ticket/18738
571 // https://wiki.mozilla.org/Firefox/Shield
572 // https://github.com/mozilla/normandy
573 // https://support.mozilla.org/en-US/kb/shield
574 // https://bugzilla.mozilla.org/show_bug.cgi?id=1370801
575 user_pref("app.normandy.enabled", false);
576 user_pref("app.normandy.api_url", "");
577 user_pref("extensions.shield-recipe-client.enabled", false);
578 user_pref("app.shield.optoutstudies.enabled", false);
581 // PREF: Disable Firefox Hello (disabled) (Firefox < 49)
582 // https://wiki.mozilla.org/Loop
583 // https://support.mozilla.org/t5/Chat-and-share/Support-for-Hello-discontinued-in-Firefox-49/ta-p/37946
584 // NOTICE-DISABLED: Firefox Hello requires setting `media.peerconnection.enabled` and `media.getusermedia.screensharing.enabled` to true, `security.OCSP.require` to false to work.
585 //user_pref("loop.enabled", false);
587 // PREF: Disable Firefox Hello metrics collection
588 // https://groups.google.com/d/topic/mozilla.dev.platform/nyVkCx-_sFw/discussion
589 user_pref("loop.logDomains", false);
591 // PREF: Enable Auto Update (disabled)
592 // NOTICE: Fully automatic updates are disabled and left to package management systems on Linux. Windows users may want to change this setting.
594 //user_pref("app.update.auto", true);
596 // PREF: Enforce checking for Firefox updates
597 // http://kb.mozillazine.org/App.update.enabled
598 // NOTICE: Update check page might incorrectly report Firefox ESR as out-of-date
599 user_pref("app.update.enabled", true);
601 // PREF: Enable blocking reported web forgeries
602 // https://wiki.mozilla.org/Security/Safe_Browsing
603 // http://kb.mozillazine.org/Safe_browsing
604 // https://support.mozilla.org/en-US/kb/how-does-phishing-and-malware-protection-work
605 // http://forums.mozillazine.org/viewtopic.php?f=39&t=2711237&p=12896849#p12896849
607 user_pref("browser.safebrowsing.enabled", true); // Firefox < 50
608 user_pref("browser.safebrowsing.phishing.enabled", true); // firefox >= 50
610 // PREF: Enable blocking reported attack sites
611 // http://kb.mozillazine.org/Browser.safebrowsing.malware.enabled
613 user_pref("browser.safebrowsing.malware.enabled", true);
615 // PREF: Disable querying Google Application Reputation database for downloaded binary files
616 // https://www.mozilla.org/en-US/firefox/39.0/releasenotes/
617 // https://wiki.mozilla.org/Security/Application_Reputation
618 user_pref("browser.safebrowsing.downloads.remote.enabled", false);
620 // PREF: Disable Pocket
621 // https://support.mozilla.org/en-US/kb/save-web-pages-later-pocket-firefox
622 // https://github.com/pyllyukko/user.js/issues/143
623 user_pref("browser.pocket.enabled", false);
624 user_pref("extensions.pocket.enabled", false);
626 // PREF: Disable "Recommended by Pocket" in Firefox Quantum
627 user_pref("browser.newtabpage.activity-stream.feeds.section.topstories", false);
629 /******************************************************************************
630 * SECTION: Automatic connections *
631 ******************************************************************************/
633 // PREF: Limit the connection keep-alive timeout to 15 seconds (disabled)
634 // https://github.com/pyllyukko/user.js/issues/387
635 // http://kb.mozillazine.org/Network.http.keep-alive.timeout
636 // https://httpd.apache.org/docs/current/mod/core.html#keepalivetimeout
637 //user_pref("network.http.keep-alive.timeout", 15);
639 // PREF: Disable prefetching of <link rel="next"> URLs
640 // http://kb.mozillazine.org/Network.prefetch-next
641 // https://developer.mozilla.org/en-US/docs/Web/HTTP/Link_prefetching_FAQ#Is_there_a_preference_to_disable_link_prefetching.3F
642 user_pref("network.prefetch-next", false);
644 // PREF: Disable DNS prefetching
645 // http://kb.mozillazine.org/Network.dns.disablePrefetch
646 // https://developer.mozilla.org/en-US/docs/Web/HTTP/Controlling_DNS_prefetching
647 user_pref("network.dns.disablePrefetch", true);
648 user_pref("network.dns.disablePrefetchFromHTTPS", true);
650 // PREF: Disable the predictive service (Necko)
651 // https://wiki.mozilla.org/Privacy/Reviews/Necko
652 user_pref("network.predictor.enabled", false);
654 // PREF: Reject .onion hostnames before passing the to DNS
655 // https://bugzilla.mozilla.org/show_bug.cgi?id=1228457
657 user_pref("network.dns.blockDotOnion", true);
659 // PREF: Disable search suggestions in the search bar
660 // http://kb.mozillazine.org/Browser.search.suggest.enabled
661 user_pref("browser.search.suggest.enabled", false);
663 // PREF: Disable "Show search suggestions in location bar results"
664 user_pref("browser.urlbar.suggest.searches", false);
665 // PREF: When using the location bar, don't suggest URLs from browsing history
666 user_pref("browser.urlbar.suggest.history", false);
668 // PREF: Disable SSDP
669 // https://bugzilla.mozilla.org/show_bug.cgi?id=1111967
670 user_pref("browser.casting.enabled", false);
672 // PREF: Disable automatic downloading of OpenH264 codec
673 // https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_media-capabilities
674 // https://andreasgal.com/2014/10/14/openh264-now-in-firefox/
675 user_pref("media.gmp-gmpopenh264.enabled", false);
676 user_pref("media.gmp-manager.url", "");
678 // PREF: Disable speculative pre-connections
679 // https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_speculative-pre-connections
680 // https://bugzilla.mozilla.org/show_bug.cgi?id=814169
681 user_pref("network.http.speculative-parallel-limit", 0);
683 // PREF: Disable downloading homepage snippets/messages from Mozilla
684 // https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_mozilla-content
685 // https://wiki.mozilla.org/Firefox/Projects/Firefox_Start/Snippet_Service
686 user_pref("browser.aboutHomeSnippets.updateUrl", "");
688 // PREF: Never check updates for search engines
689 // https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_auto-update-checking
690 user_pref("browser.search.update", false);
692 // PREF: Disable automatic captive portal detection (Firefox >= 52.0)
693 // https://support.mozilla.org/en-US/questions/1157121
694 user_pref("network.captive-portal-service.enabled", false);
696 /******************************************************************************
698 ******************************************************************************/
700 // PREF: Disallow NTLMv1
701 // https://bugzilla.mozilla.org/show_bug.cgi?id=828183
702 user_pref("network.negotiate-auth.allow-insecure-ntlm-v1", false);
703 // it is still allowed through HTTPS. uncomment the following to disable it completely.
704 //user_pref("network.negotiate-auth.allow-insecure-ntlm-v1-https", false);
706 // PREF: Enable CSP 1.1 script-nonce directive support
707 // https://bugzilla.mozilla.org/show_bug.cgi?id=855326
708 user_pref("security.csp.experimentalEnabled", true);
710 // PREF: Enable Content Security Policy (CSP)
711 // https://developer.mozilla.org/en-US/docs/Web/Security/CSP/Introducing_Content_Security_Policy
712 // https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
713 user_pref("security.csp.enable", true);
715 // PREF: Enable Subresource Integrity
716 // https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity
717 // https://wiki.mozilla.org/Security/Subresource_Integrity
718 user_pref("security.sri.enable", true);
720 // PREF: DNT HTTP header (disabled)
721 // https://www.mozilla.org/en-US/firefox/dnt/
722 // https://en.wikipedia.org/wiki/Do_not_track_header
723 // https://dnt-dashboard.mozilla.org
724 // https://github.com/pyllyukko/user.js/issues/11
725 // NOTICE: Do No Track must be enabled manually
726 //user_pref("privacy.donottrackheader.enabled", true);
728 // PREF: Send a referer header with the target URI as the source (disabled)
729 // https://bugzilla.mozilla.org/show_bug.cgi?id=822869
730 // https://github.com/pyllyukko/user.js/issues/227
731 // NOTICE-DISABLED: Spoofing referers breaks functionality on websites relying on authentic referer headers
732 // NOTICE-DISABLED: Spoofing referers breaks visualisation of 3rd-party sites on the Lightbeam addon
733 // NOTICE-DISABLED: Spoofing referers disables CSRF protection on some login pages not implementing origin-header/cookie+token based CSRF protection
734 // TODO: https://github.com/pyllyukko/user.js/issues/94, commented-out XOriginPolicy/XOriginTrimmingPolicy = 2 prefs
735 //user_pref("network.http.referer.spoofSource", true);
737 // PREF: Don't send referer headers when following links across different domains
738 // https://github.com/pyllyukko/user.js/issues/227
739 // https://github.com/pyllyukko/user.js/issues/328
740 // https://feeding.cloud.geek.nz/posts/tweaking-referrer-for-privacy-in-firefox/
741 user_pref("network.http.referer.XOriginPolicy", 2);
743 // PREF: Accept Only 1st Party Cookies
744 // http://kb.mozillazine.org/Network.cookie.cookieBehavior#1
745 // NOTICE: Blocking 3rd-party cookies breaks a number of payment gateways
747 user_pref("network.cookie.cookieBehavior", 1);
749 // PREF: Enable first-party isolation
750 // https://bugzilla.mozilla.org/show_bug.cgi?id=1299996
751 // https://bugzilla.mozilla.org/show_bug.cgi?id=1260931
752 // https://wiki.mozilla.org/Security/FirstPartyIsolation
753 // NOTICE: First-party isolation breaks Microsoft Teams
754 // NOTICE: First-party isolation causes HTTP basic auth to ask for credentials for every new tab (see #425)
755 user_pref("privacy.firstparty.isolate", true);
757 // PREF: Make sure that third-party cookies (if enabled) never persist beyond the session.
758 // https://feeding.cloud.geek.nz/posts/tweaking-cookies-for-privacy-in-firefox/
759 // http://kb.mozillazine.org/Network.cookie.thirdparty.sessionOnly
760 // https://developer.mozilla.org/en-US/docs/Cookies_Preferences_in_Mozilla#network.cookie.thirdparty.sessionOnly
761 user_pref("network.cookie.thirdparty.sessionOnly", true);
763 // PREF: Spoof User-agent (disabled)
764 //user_pref("general.useragent.override", "Mozilla/5.0 (Windows NT 6.1; rv:45.0) Gecko/20100101 Firefox/45.0");
765 //user_pref("general.appname.override", "Netscape");
766 //user_pref("general.appversion.override", "5.0 (Windows)");
767 //user_pref("general.platform.override", "Win32");
768 //user_pref("general.oscpu.override", "Windows NT 6.1");
770 /*******************************************************************************
772 ******************************************************************************/
774 // PREF: Permanently enable private browsing mode
775 // https://support.mozilla.org/en-US/kb/Private-Browsing
776 // https://wiki.mozilla.org/PrivateBrowsing
777 // NOTICE: You can not view or inspect cookies when in private browsing: https://bugzilla.mozilla.org/show_bug.cgi?id=823941
778 // NOTICE: When Javascript is enabled, Websites can detect use of Private Browsing mode
779 // NOTICE: Private browsing breaks Kerberos authentication
780 // NOTICE: Disables "Containers" functionality (see below)
781 // NOTICE: "Always use private browsing mode" (browser.privatebrowsing.autostart) disables the possibility to use password manager: https://support.mozilla.org/en-US/kb/usernames-and-passwords-are-not-saved#w_private-browsing
782 user_pref("browser.privatebrowsing.autostart", true);
784 // PREF: Do not download URLs for the offline cache
785 // http://kb.mozillazine.org/Browser.cache.offline.enable
786 user_pref("browser.cache.offline.enable", false);
788 // PREF: Clear history when Firefox closes
789 // https://support.mozilla.org/en-US/kb/Clear%20Recent%20History#w_how-do-i-make-firefox-clear-my-history-automatically
790 // NOTICE: Installing user.js will remove your browsing history, caches and local storage.
791 // NOTICE: Installing user.js **will remove your saved passwords** (https://github.com/pyllyukko/user.js/issues/27)
792 // NOTICE: Clearing open windows on Firefox exit causes 2 windows to open when Firefox starts https://bugzilla.mozilla.org/show_bug.cgi?id=1334945
793 user_pref("privacy.sanitize.sanitizeOnShutdown", true);
794 user_pref("privacy.clearOnShutdown.cache", true);
795 user_pref("privacy.clearOnShutdown.cookies", true);
796 user_pref("privacy.clearOnShutdown.downloads", true);
797 user_pref("privacy.clearOnShutdown.formdata", true);
798 user_pref("privacy.clearOnShutdown.history", true);
799 user_pref("privacy.clearOnShutdown.offlineApps", true);
800 user_pref("privacy.clearOnShutdown.sessions", true);
801 user_pref("privacy.clearOnShutdown.openWindows", true);
803 // PREF: Set time range to "Everything" as default in "Clear Recent History"
804 user_pref("privacy.sanitize.timeSpan", 0);
806 // PREF: Clear everything but "Site Preferences" in "Clear Recent History"
807 user_pref("privacy.cpd.offlineApps", true);
808 user_pref("privacy.cpd.cache", true);
809 user_pref("privacy.cpd.cookies", true);
810 user_pref("privacy.cpd.downloads", true);
811 user_pref("privacy.cpd.formdata", true);
812 user_pref("privacy.cpd.history", true);
813 user_pref("privacy.cpd.sessions", true);
815 // PREF: Don't remember browsing history
816 user_pref("places.history.enabled", false);
818 // PREF: Disable disk cache
819 // http://kb.mozillazine.org/Browser.cache.disk.enable
820 user_pref("browser.cache.disk.enable", false);
822 // PREF: Disable memory cache (disabled)
823 // http://kb.mozillazine.org/Browser.cache.memory.enable
824 //user_pref("browser.cache.memory.enable", false);
826 // PREF: Disable Caching of SSL Pages
827 // CIS Version 1.2.0 October 21st, 2011 2.5.8
828 // http://kb.mozillazine.org/Browser.cache.disk_cache_ssl
829 user_pref("browser.cache.disk_cache_ssl", false);
831 // PREF: Disable download history
832 // CIS Version 1.2.0 October 21st, 2011 2.5.5
833 user_pref("browser.download.manager.retention", 0);
835 // PREF: Disable password manager (use an external password manager!)
836 // CIS Version 1.2.0 October 21st, 2011 2.5.2
837 user_pref("signon.rememberSignons", false);
839 // PREF: Disable form autofill, don't save information entered in web page forms and the Search Bar
840 user_pref("browser.formfill.enable", false);
842 // PREF: Cookies expires at the end of the session (when the browser closes)
843 // http://kb.mozillazine.org/Network.cookie.lifetimePolicy#2
844 user_pref("network.cookie.lifetimePolicy", 2);
846 // PREF: Require manual intervention to autofill known username/passwords sign-in forms
847 // http://kb.mozillazine.org/Signon.autofillForms
848 // https://www.torproject.org/projects/torbrowser/design/#identifier-linkability
849 user_pref("signon.autofillForms", false);
851 // PREF: Disable formless login capture
852 // https://bugzilla.mozilla.org/show_bug.cgi?id=1166947
853 user_pref("signon.formlessCapture.enabled", false);
855 // PREF: When username/password autofill is enabled, still disable it on non-HTTPS sites
856 // https://hg.mozilla.org/integration/mozilla-inbound/rev/f0d146fe7317
857 user_pref("signon.autofillForms.http", false);
859 // PREF: Show in-content login form warning UI for insecure login fields
860 // https://hg.mozilla.org/integration/mozilla-inbound/rev/f0d146fe7317
861 user_pref("security.insecure_field_warning.contextual.enabled", true);
863 // PREF: Disable the password manager for pages with autocomplete=off (disabled)
864 // https://bugzilla.mozilla.org/show_bug.cgi?id=956906
866 // Does not prevent any kind of auto-completion (see browser.formfill.enable, signon.autofillForms)
867 //user_pref("signon.storeWhenAutocompleteOff", false);
869 // PREF: Delete Search and Form History
870 // CIS Version 1.2.0 October 21st, 2011 2.5.6
871 user_pref("browser.formfill.expire_days", 0);
873 // PREF: Clear SSL Form Session Data
874 // http://kb.mozillazine.org/Browser.sessionstore.privacy_level#2
875 // Store extra session data for unencrypted (non-HTTPS) sites only.
876 // CIS Version 1.2.0 October 21st, 2011 2.5.7
877 // NOTE: CIS says 1, we use 2
878 user_pref("browser.sessionstore.privacy_level", 2);
880 // PREF: Delete temporary files on exit
881 // https://bugzilla.mozilla.org/show_bug.cgi?id=238789
882 user_pref("browser.helperApps.deleteTempFileOnExit", true);
884 // PREF: Do not create screenshots of visited pages (relates to the "new tab page" feature)
885 // https://support.mozilla.org/en-US/questions/973320
886 // https://developer.mozilla.org/en-US/docs/Mozilla/Preferences/Preference_reference/browser.pagethumbnails.capturing_disabled
887 user_pref("browser.pagethumbnails.capturing_disabled", true);
889 // PREF: Don't fetch and permanently store favicons for Windows .URL shortcuts created by drag and drop
890 // NOTICE: .URL shortcut files will be created with a generic icon
891 // Favicons are stored as .ico files in $profile_dir\shortcutCache
892 user_pref("browser.shell.shortcutFavicons", false);
894 // PREF: Disable bookmarks backups (default: 15)
895 // http://kb.mozillazine.org/Browser.bookmarks.max_backups
896 user_pref("browser.bookmarks.max_backups", 0);
898 // PREF: Export bookmarks to HTML automatically when closing Firefox (disabled)
899 // https://support.mozilla.org/en-US/questions/1176242
900 //user_pref("browser.bookmarks.autoExportHTML", true);
901 //user_pref("browser.bookmarks.file", '/path/to/bookmarks-export.html');
903 // PREF: Disable downloading of favicons in response to favicon fingerprinting techniques
904 // https://github.com/jonasstrehle/supercookie
905 // http://kb.mozillazine.org/Browser.chrome.site_icons
906 // https://blog.mozilla.org/security/2021/01/26/supercookie-protections/
907 user_pref("browser.chrome.site_icons", false);
909 /*******************************************************************************
910 * SECTION: UI related *
911 *******************************************************************************/
913 // PREF: Enable insecure password warnings (login forms in non-HTTPS pages)
914 // https://blog.mozilla.org/tanvi/2016/01/28/no-more-passwords-over-http-please/
915 // https://bugzilla.mozilla.org/show_bug.cgi?id=1319119
916 // https://bugzilla.mozilla.org/show_bug.cgi?id=1217156
917 user_pref("security.insecure_password.ui.enabled", true);
919 // PREF: Disable right-click menu manipulation via JavaScript (disabled)
920 //user_pref("dom.event.contextmenu.enabled", false);
922 // PREF: Disable "Are you sure you want to leave this page?" popups on page close
923 // https://support.mozilla.org/en-US/questions/1043508
924 // NOTICE: disabling "beforeunload" events may lead to losing data entered in web forms
925 // Does not prevent JS leaks of the page close event.
926 // https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload
927 //user_pref("dom.disable_beforeunload", true);
929 // PREF: Disable Downloading on Desktop
931 user_pref("browser.download.folderList", 2);
933 // PREF: Always ask the user where to download
934 // https://developer.mozilla.org/en/Download_Manager_preferences (obsolete)
935 user_pref("browser.download.useDownloadDir", false);
937 // PREF: Disable the "new tab page" feature and show a blank tab instead
938 // https://wiki.mozilla.org/Privacy/Reviews/New_Tab
939 // https://support.mozilla.org/en-US/kb/new-tab-page-show-hide-and-customize-top-sites#w_how-do-i-turn-the-new-tab-page-off
940 user_pref("browser.newtabpage.enabled", false);
941 user_pref("browser.newtab.url", "about:blank");
943 // PREF: Disable Snippets
944 // https://wiki.mozilla.org/Firefox/Projects/Firefox_Start/Snippet_Service
945 // https://support.mozilla.org/en-US/kb/snippets-firefox-faq
946 user_pref("browser.newtabpage.activity-stream.feeds.snippets", false);
948 // PREF: Disable Activity Stream
949 // https://wiki.mozilla.org/Firefox/Activity_Stream
950 user_pref("browser.newtabpage.activity-stream.enabled", false);
952 // PREF: Disable new tab tile ads & preload
953 // http://www.thewindowsclub.com/disable-remove-ad-tiles-from-firefox
954 // http://forums.mozillazine.org/viewtopic.php?p=13876331#p13876331
955 // https://wiki.mozilla.org/Tiles/Technical_Documentation#Ping
956 // https://gecko.readthedocs.org/en/latest/browser/browser/DirectoryLinksProvider.html#browser-newtabpage-directory-source
957 // https://gecko.readthedocs.org/en/latest/browser/browser/DirectoryLinksProvider.html#browser-newtabpage-directory-ping
958 // TODO: deprecated? not in DXR, some dead links
959 user_pref("browser.newtabpage.enhanced", false);
960 user_pref("browser.newtab.preload", false);
961 user_pref("browser.newtabpage.directory.ping", "");
962 user_pref("browser.newtabpage.directory.source", "data:text/plain,{}");
964 // PREF: Enable Auto Notification of Outdated Plugins (Firefox < 50)
965 // https://wiki.mozilla.org/Firefox3.6/Plugin_Update_Awareness_Security_Review
966 // CIS Version 1.2.0 October 21st, 2011 2.1.2
967 // https://hg.mozilla.org/mozilla-central/rev/304560
968 user_pref("plugins.update.notifyUser", true);
970 // PREF: Force Punycode for Internationalized Domain Names
971 // http://kb.mozillazine.org/Network.IDN_show_punycode
972 // https://www.xudongz.com/blog/2017/idn-phishing/
973 // https://wiki.mozilla.org/IDN_Display_Algorithm
974 // https://en.wikipedia.org/wiki/IDN_homograph_attack
975 // https://www.mozilla.org/en-US/security/advisories/mfsa2017-02/
976 // CIS Mozilla Firefox 24 ESR v1.0.0 - 3.6
977 user_pref("network.IDN_show_punycode", true);
979 // PREF: Disable inline autocomplete in URL bar
980 // http://kb.mozillazine.org/Inline_autocomplete
981 user_pref("browser.urlbar.autoFill", false);
982 user_pref("browser.urlbar.autoFill.typed", false);
984 // PREF: Disable CSS :visited selectors
985 // https://blog.mozilla.org/security/2010/03/31/plugging-the-css-history-leak/
986 // https://dbaron.org/mozilla/visited-privacy
987 user_pref("layout.css.visited_links_enabled", false);
989 // PREF: Disable URL bar autocomplete and history/bookmarks suggestions dropdown
990 // http://kb.mozillazine.org/Disabling_autocomplete_-_Firefox#Firefox_3.5
991 user_pref("browser.urlbar.autocomplete.enabled", false);
993 // PREF: Do not check if Firefox is the default browser
994 user_pref("browser.shell.checkDefaultBrowser", false);
996 // PREF: When password manager is enabled, lock the password storage periodically
997 // CIS Version 1.2.0 October 21st, 2011 2.5.3 Disable Prompting for Credential Storage
998 user_pref("security.ask_for_password", 2);
1000 // PREF: Lock the password storage every 1 minutes (default: 30)
1001 user_pref("security.password_lifetime", 1);
1003 // PREF: Display a notification bar when websites offer data for offline use
1004 // http://kb.mozillazine.org/Browser.offline-apps.notify
1005 user_pref("browser.offline-apps.notify", true);
1007 /******************************************************************************
1008 * SECTION: Cryptography *
1009 ******************************************************************************/
1011 // PREF: Enable HTTPS-Only Mode
1012 // https://blog.mozilla.org/security/2020/11/17/firefox-83-introduces-https-only-mode/
1013 // https://www.feistyduck.com/bulletproof-tls-newsletter/issue_71_firefox_introduces_https_only_mode
1014 user_pref("dom.security.https_only_mode", true);
1016 // PREF: Enable HSTS preload list (pre-set HSTS sites list provided by Mozilla)
1017 // https://blog.mozilla.org/security/2012/11/01/preloading-hsts/
1018 // https://wiki.mozilla.org/Privacy/Features/HSTS_Preload_List
1019 // https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security
1020 user_pref("network.stricttransportsecurity.preloadlist", true);
1022 // PREF: Enable Online Certificate Status Protocol
1023 // https://en.wikipedia.org/wiki/Online_Certificate_Status_Protocol
1024 // https://www.imperialviolet.org/2014/04/19/revchecking.html
1025 // https://www.maikel.pro/blog/current-state-certificate-revocation-crls-ocsp/
1026 // https://wiki.mozilla.org/CA:RevocationPlan
1027 // https://wiki.mozilla.org/CA:ImprovingRevocation
1028 // https://wiki.mozilla.org/CA:OCSP-HardFail
1029 // https://news.netcraft.com/archives/2014/04/24/certificate-revocation-why-browsers-remain-affected-by-heartbleed.html
1030 // https://news.netcraft.com/archives/2013/04/16/certificate-revocation-and-the-performance-of-ocsp.html
1031 // NOTICE: OCSP leaks your IP and domains you visit to the CA when OCSP Stapling is not available on visited host
1032 // NOTICE: OCSP is vulnerable to replay attacks when nonce is not configured on the OCSP responder
1033 // NOTICE: OCSP adds latency (performance)
1034 // NOTICE: Short-lived certificates are not checked for revocation (security.pki.cert_short_lifetime_in_days, default:10)
1035 // CIS Version 1.2.0 October 21st, 2011 2.2.4
1036 user_pref("security.OCSP.enabled", 1);
1038 // PREF: Enable OCSP Stapling support
1039 // https://en.wikipedia.org/wiki/OCSP_stapling
1040 // https://blog.mozilla.org/security/2013/07/29/ocsp-stapling-in-firefox/
1041 // https://www.digitalocean.com/community/tutorials/how-to-configure-ocsp-stapling-on-apache-and-nginx
1042 user_pref("security.ssl.enable_ocsp_stapling", true);
1044 // PREF: Enable OCSP Must-Staple support (Firefox >= 45)
1045 // https://blog.mozilla.org/security/2015/11/23/improving-revocation-ocsp-must-staple-and-short-lived-certificates/
1046 // https://www.entrust.com/ocsp-must-staple/
1047 // https://github.com/schomery/privacy-settings/issues/40
1048 // NOTICE: Firefox falls back on plain OCSP when must-staple is not configured on the host certificate
1049 user_pref("security.ssl.enable_ocsp_must_staple", true);
1051 // PREF: Require a valid OCSP response for OCSP enabled certificates
1052 // https://groups.google.com/forum/#!topic/mozilla.dev.security/n1G-N2-HTVA
1053 // Disabling this will make OCSP bypassable by MitM attacks suppressing OCSP responses
1054 // NOTICE: `security.OCSP.require` will make the connection fail when the OCSP responder is unavailable
1055 // NOTICE: `security.OCSP.require` is known to break browsing on some [captive portals](https://en.wikipedia.org/wiki/Captive_portal)
1056 user_pref("security.OCSP.require", true);
1058 // PREF: Disable TLS Session Tickets
1059 // https://www.blackhat.com/us-13/briefings.html#NextGen
1060 // https://media.blackhat.com/us-13/US-13-Daigniere-TLS-Secrets-Slides.pdf
1061 // https://media.blackhat.com/us-13/US-13-Daigniere-TLS-Secrets-WP.pdf
1062 // https://bugzilla.mozilla.org/show_bug.cgi?id=917049
1063 // https://bugzilla.mozilla.org/show_bug.cgi?id=967977
1064 user_pref("security.ssl.disable_session_identifiers", true);
1066 // PREF: Only allow TLS 1.[0-3]
1067 // http://kb.mozillazine.org/Security.tls.version.*
1068 // 1 = TLS 1.0 is the minimum required / maximum supported encryption protocol. (This is the current default for the maximum supported version.)
1069 // 2 = TLS 1.1 is the minimum required / maximum supported encryption protocol.
1070 // 3 = TLS 1.2 is the minimum required / maximum supported encryption protocol.
1071 // 4 = TLS 1.3 is the minimum required / maximum supported encryption protocol.
1072 user_pref("security.tls.version.min", 1);
1073 user_pref("security.tls.version.max", 4);
1075 // PREF: Disable insecure TLS version fallback
1076 // https://bugzilla.mozilla.org/show_bug.cgi?id=1084025
1077 // https://github.com/pyllyukko/user.js/pull/206#issuecomment-280229645
1078 user_pref("security.tls.version.fallback-limit", 3);
1080 // PREF: Enforce Public Key Pinning
1081 // https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning
1082 // https://wiki.mozilla.org/SecurityEngineering/Public_Key_Pinning
1083 // "2. Strict. Pinning is always enforced."
1084 user_pref("security.cert_pinning.enforcement_level", 2);
1086 // PREF: Disallow SHA-1
1087 // https://bugzilla.mozilla.org/show_bug.cgi?id=1302140
1088 // https://shattered.io/
1089 user_pref("security.pki.sha1_enforcement_level", 1);
1091 // PREF: Warn the user when server doesn't support RFC 5746 ("safe" renegotiation)
1092 // https://wiki.mozilla.org/Security:Renegotiation#security.ssl.treat_unsafe_negotiation_as_broken
1093 // https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2009-3555
1094 user_pref("security.ssl.treat_unsafe_negotiation_as_broken", true);
1096 // PREF: Disallow connection to servers not supporting safe renegotiation (disabled)
1097 // https://wiki.mozilla.org/Security:Renegotiation#security.ssl.require_safe_negotiation
1098 // https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2009-3555
1099 // TODO: `security.ssl.require_safe_negotiation` is more secure but makes browsing next to impossible (2012-2014-... - `ssl_error_unsafe_negotiation` errors), so is left disabled
1100 //user_pref("security.ssl.require_safe_negotiation", true);
1102 // PREF: Disable automatic reporting of TLS connection errors
1103 // https://support.mozilla.org/en-US/kb/certificate-pinning-reports
1104 // we could also disable security.ssl.errorReporting.enabled, but I think it's
1105 // good to leave the option to report potentially malicious sites if the user
1106 // chooses to do so.
1107 // you can test this at https://pinningtest.appspot.com/
1108 user_pref("security.ssl.errorReporting.automatic", false);
1110 // PREF: Pre-populate the current URL but do not pre-fetch the certificate in the "Add Security Exception" dialog
1111 // http://kb.mozillazine.org/Browser.ssl_override_behavior
1112 // https://github.com/pyllyukko/user.js/issues/210
1113 user_pref("browser.ssl_override_behavior", 1);
1115 // PREF: Encrypted SNI (when TRR is enabled)
1116 // https://www.cloudflare.com/ssl/encrypted-sni/
1117 // https://wiki.mozilla.org/Trusted_Recursive_Resolver#ESNI
1118 // https://en.wikipedia.org/wiki/Server_Name_Indication#Security_implications_(ESNI)
1119 user_pref("network.security.esni.enabled", true);
1121 /******************************************************************************
1122 * SECTION: Cipher suites *
1123 ******************************************************************************/
1125 // PREF: Disable null ciphers
1126 user_pref("security.ssl3.rsa_null_sha", false);
1127 user_pref("security.ssl3.rsa_null_md5", false);
1128 user_pref("security.ssl3.ecdhe_rsa_null_sha", false);
1129 user_pref("security.ssl3.ecdhe_ecdsa_null_sha", false);
1130 user_pref("security.ssl3.ecdh_rsa_null_sha", false);
1131 user_pref("security.ssl3.ecdh_ecdsa_null_sha", false);
1133 // PREF: Disable SEED cipher
1134 // https://en.wikipedia.org/wiki/SEED
1135 user_pref("security.ssl3.rsa_seed_sha", false);
1137 // PREF: Disable 40/56/128-bit ciphers
1139 user_pref("security.ssl3.rsa_rc4_40_md5", false);
1140 user_pref("security.ssl3.rsa_rc2_40_md5", false);
1142 user_pref("security.ssl3.rsa_1024_rc4_56_sha", false);
1144 user_pref("security.ssl3.rsa_camellia_128_sha", false);
1145 user_pref("security.ssl3.ecdhe_rsa_aes_128_sha", false);
1146 user_pref("security.ssl3.ecdhe_ecdsa_aes_128_sha", false);
1147 user_pref("security.ssl3.ecdh_rsa_aes_128_sha", false);
1148 user_pref("security.ssl3.ecdh_ecdsa_aes_128_sha", false);
1149 user_pref("security.ssl3.dhe_rsa_camellia_128_sha", false);
1150 user_pref("security.ssl3.dhe_rsa_aes_128_sha", false);
1152 // PREF: Disable RC4
1153 // https://developer.mozilla.org/en-US/Firefox/Releases/38#Security
1154 // https://bugzilla.mozilla.org/show_bug.cgi?id=1138882
1156 // https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2013-2566
1157 user_pref("security.ssl3.ecdh_ecdsa_rc4_128_sha", false);
1158 user_pref("security.ssl3.ecdh_rsa_rc4_128_sha", false);
1159 user_pref("security.ssl3.ecdhe_ecdsa_rc4_128_sha", false);
1160 user_pref("security.ssl3.ecdhe_rsa_rc4_128_sha", false);
1161 user_pref("security.ssl3.rsa_rc4_128_md5", false);
1162 user_pref("security.ssl3.rsa_rc4_128_sha", false);
1163 user_pref("security.tls.unrestricted_rc4_fallback", false);
1165 // PREF: Disable 3DES (effective key size is < 128)
1166 // https://en.wikipedia.org/wiki/3des#Security
1167 // http://en.citizendium.org/wiki/Meet-in-the-middle_attack
1168 // http://www-archive.mozilla.org/projects/security/pki/nss/ssl/fips-ssl-ciphersuites.html
1169 user_pref("security.ssl3.dhe_dss_des_ede3_sha", false);
1170 user_pref("security.ssl3.dhe_rsa_des_ede3_sha", false);
1171 user_pref("security.ssl3.ecdh_ecdsa_des_ede3_sha", false);
1172 user_pref("security.ssl3.ecdh_rsa_des_ede3_sha", false);
1173 user_pref("security.ssl3.ecdhe_ecdsa_des_ede3_sha", false);
1174 user_pref("security.ssl3.ecdhe_rsa_des_ede3_sha", false);
1175 user_pref("security.ssl3.rsa_des_ede3_sha", false);
1176 user_pref("security.ssl3.rsa_fips_des_ede3_sha", false);
1178 // PREF: Disable ciphers with ECDH (non-ephemeral)
1179 user_pref("security.ssl3.ecdh_rsa_aes_256_sha", false);
1180 user_pref("security.ssl3.ecdh_ecdsa_aes_256_sha", false);
1182 // PREF: Disable 256 bits ciphers without PFS
1183 user_pref("security.ssl3.rsa_camellia_256_sha", false);
1185 // PREF: Enable GCM ciphers (TLSv1.2 only)
1186 // https://en.wikipedia.org/wiki/Galois/Counter_Mode
1187 user_pref("security.ssl3.ecdhe_ecdsa_aes_128_gcm_sha256", true); // 0xc02b
1188 user_pref("security.ssl3.ecdhe_rsa_aes_128_gcm_sha256", true); // 0xc02f
1190 // PREF: Enable ChaCha20 and Poly1305 (Firefox >= 47)
1191 // https://www.mozilla.org/en-US/firefox/47.0/releasenotes/
1192 // https://tools.ietf.org/html/rfc7905
1193 // https://bugzilla.mozilla.org/show_bug.cgi?id=917571
1194 // https://bugzilla.mozilla.org/show_bug.cgi?id=1247860
1195 // https://cr.yp.to/chacha.html
1196 user_pref("security.ssl3.ecdhe_ecdsa_chacha20_poly1305_sha256", true);
1197 user_pref("security.ssl3.ecdhe_rsa_chacha20_poly1305_sha256", true);
1199 // PREF: Disable ciphers susceptible to the logjam attack
1200 // https://weakdh.org/
1201 user_pref("security.ssl3.dhe_rsa_camellia_256_sha", false);
1202 user_pref("security.ssl3.dhe_rsa_aes_256_sha", false);
1204 // PREF: Disable ciphers with DSA (max 1024 bits)
1205 user_pref("security.ssl3.dhe_dss_aes_128_sha", false);
1206 user_pref("security.ssl3.dhe_dss_aes_256_sha", false);
1207 user_pref("security.ssl3.dhe_dss_camellia_128_sha", false);
1208 user_pref("security.ssl3.dhe_dss_camellia_256_sha", false);
1210 // PREF: Ciphers with CBC & SHA-1 (disabled)
1211 //user_pref("security.ssl3.rsa_aes_256_sha", false); // 0x35
1212 //user_pref("security.ssl3.rsa_aes_128_sha", false); // 0x2f
1213 //user_pref("security.ssl3.ecdhe_rsa_aes_256_sha", false); // 0xc014
1214 //user_pref("security.ssl3.ecdhe_ecdsa_aes_256_sha", false); // 0xc00a