11/******
2- * name: arkenfox user.js
3- * date: 21 January 2022
4- * version 96
5- * url: https://github.com/arkenfox/user.js
2+ * name: arkenfox user.js
3+ * date: 12 February 2022
4+ * version: 97
5+ * url: https://github.com/arkenfox/user.js
66* license: MIT: https://github.com/arkenfox/user.js/blob/master/LICENSE.txt
77
88* README:
99
1010 1. Consider using Tor Browser if it meets your needs or fits your threat model
1111 * https://2019.www.torproject.org/about/torusers.html
12- 2. Required reading: Overview, Backing Up, Implementing, and Maintenance entries
12+ 2. Read the entire wiki
1313 * https://github.com/arkenfox/user.js/wiki
1414 3. If you skipped step 2, return to step 2
15- 4. Make changes
15+ 4. Make changes in a user-overrides.js
1616 * There are often trade-offs and conflicts between security vs privacy vs anti-tracking
1717 and these need to be balanced against functionality & convenience & breakage
1818 * Some site breakage and unintended consequences will happen. Everyone's experience will differ
1919 e.g. some user data is erased on exit (section 2800), change this to suit your needs
2020 * While not 100% definitive, search for "[SETUP" tags
2121 e.g. third party images/videos not loading on some sites? check 1601
22- * Take the wiki link in step 2 and read the Troubleshooting entry
2322 5. Some tag info
2423 [SETUP-SECURITY] it's one item, read it
2524 [SETUP-WEB] can cause some websites to break
@@ -159,7 +158,7 @@ user_pref("datareporting.policy.dataSubmissionEnabled", false);
159158 * [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to send technical... data ***/
160159user_pref ( "datareporting.healthreport.uploadEnabled" , false ) ;
161160/* 0332: disable telemetry
162- * The "unified" pref affects the behaviour of the "enabled" pref
161+ * The "unified" pref affects the behavior of the "enabled" pref
163162 * - If "unified" is false then "enabled" controls the telemetry module
164163 * - If "unified" is true then "enabled" only controls whether to record extended data
165164 * [NOTE] "toolkit.telemetry.enabled" is now LOCKED to reflect prerelease (true) or release builds (false) [2]
@@ -235,16 +234,16 @@ user_pref("_user.js.parrot", "0400 syntax error: the parrot's passed on!");
235234 * To verify the safety of certain executable files, Firefox may submit some information about the
236235 * file, including the name, origin, size and a cryptographic hash of the contents, to the Google
237236 * Safe Browsing service which helps Firefox determine whether or not the file should be blocked
238- * [SETUP-SECURITY] If you do not understand this, or you want this protection, then override it ***/
237+ * [SETUP-SECURITY] If you do not understand this, or you want this protection, then override this ***/
239238user_pref ( "browser.safebrowsing.downloads.remote.enabled" , false ) ;
240- user_pref ( "browser.safebrowsing.downloads.remote.url" , "" ) ;
239+ // user_pref("browser.safebrowsing.downloads.remote.url", ""); // Defense-in-depth
241240/* 0404: disable SB checks for unwanted software
242241 * [SETTING] Privacy & Security>Security>... "Warn you about unwanted and uncommon software" ***/
243242 // user_pref("browser.safebrowsing.downloads.remote.block_potentially_unwanted", false);
244243 // user_pref("browser.safebrowsing.downloads.remote.block_uncommon", false);
245244/* 0405: disable "ignore this warning" on SB warnings [FF45+]
246245 * If clicked, it bypasses the block for that session. This is a means for admins to enforce SB
247- * [TEST] see github wiki APPENDIX A: Test Sites: Section 5
246+ * [TEST] see https:// github.com/arkenfox/user.js/ wiki/Appendix-A- Test- Sites#-mozilla
248247 * [1] https://bugzilla.mozilla.org/1226490 ***/
249248 // user_pref("browser.safebrowsing.allowOverride", false);
250249
@@ -263,7 +262,9 @@ user_pref("network.predictor.enable-prefetch", false); // [FF48+] [DEFAULT: fals
263262/* 0604: disable link-mouseover opening connection to linked server
264263 * [1] https://news.slashdot.org/story/15/08/14/2321202/how-to-quash-firefoxs-silent-requests ***/
265264user_pref ( "network.http.speculative-parallel-limit" , 0 ) ;
266- /* 0605: enforce no "Hyperlink Auditing" (click tracking)
265+ /* 0605: disable mousedown speculative connections on bookmarks and history [FF98+] ***/
266+ user_pref ( "browser.places.speculativeConnect.enabled" , false ) ;
267+ /* 0610: enforce no "Hyperlink Auditing" (click tracking)
267268 * [1] https://www.bleepingcomputer.com/news/software/major-browsers-to-prevent-disabling-of-click-tracking-privacy-risk/ ***/
268269 // user_pref("browser.send_pings", false); // [DEFAULT: false]
269270
@@ -306,7 +307,7 @@ user_pref("network.gio.supported-protocols", ""); // [HIDDEN PREF]
306307 * [WARNING] If false, this will break the fallback for some security features
307308 * [SETUP-CHROME] If you use a proxy and you understand the security impact
308309 * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1732792,1733994,1733481 ***/
309- // user_pref("network.proxy.allow_bypass", false); // [HIDDEN PREF]
310+ // user_pref("network.proxy.allow_bypass", false); // [HIDDEN PREF FF95-96 ]
310311/* 0710: disable DNS-over-HTTPS (DoH) rollout [FF60+]
311312 * 0=off by default, 2=TRR (Trusted Recursive Resolver) first, 3=TRR only, 5=explicitly off
312313 * see "doh-rollout.home-region": USA Feb 2020, Canada July 2021 [3]
@@ -323,8 +324,7 @@ user_pref("_user.js.parrot", "0800 syntax error: the parrot's ceased to be!");
323324 * Examples: "secretplace,com", "secretplace/com", "secretplace com", "secret place.com"
324325 * [NOTE] This does not affect explicit user action such as using search buttons in the
325326 * dropdown, or using keyword search shortcuts you configure in options (e.g. "d" for DuckDuckGo)
326- * [SETUP-CHROME] If you don't, or rarely, type URLs, or you use a default search
327- * engine that respects privacy, then you probably don't need this ***/
327+ * [SETUP-CHROME] Override this if you trust and use a privacy respecting search engine ***/
328328user_pref ( "keyword.enabled" , false ) ;
329329/* 0802: disable location bar domain guessing
330330 * domain guessing intercepts DNS "hostname not found errors" and resends a
@@ -338,7 +338,7 @@ user_pref("browser.fixup.alternate.enabled", false);
338338user_pref ( "browser.urlbar.trimURLs" , false ) ;
339339/* 0804: disable live search suggestions
340340 * [NOTE] Both must be true for the location bar to work
341- * [SETUP-CHROME] Change these if you trust and use a privacy respecting search engine
341+ * [SETUP-CHROME] Override these if you trust and use a privacy respecting search engine
342342 * [SETTING] Search>Provide search suggestions | Show search suggestions in address bar results ***/
343343user_pref ( "browser.search.suggest.enabled" , false ) ;
344344user_pref ( "browser.urlbar.suggest.searches" , false ) ;
@@ -452,11 +452,11 @@ user_pref("browser.shell.shortcutFavicons", false);
452452user_pref ( "_user.js.parrot" , "1200 syntax error: the parrot's a stiff!" ) ;
453453/** SSL (Secure Sockets Layer) / TLS (Transport Layer Security) ***/
454454/* 1201: require safe negotiation
455- * Blocks connections (SSL_ERROR_UNSAFE_NEGOTIATION) to servers that don't support RFC 5746 [2]
456- * as they're potentially vulnerable to a MiTM attack [3]. A server without RFC 5746 can be
457- * safe from the attack if it disables renegotiations but the problem is that the browser can't
458- * know that. Setting this pref to true is the only way for the browser to ensure there will be
459- * no unsafe renegotiations on the channel between the browser and the server.
455+ * Blocks connections to servers that don't support RFC 5746 [2] as they're potentially vulnerable to a
456+ * MiTM attack [3]. A server without RFC 5746 can be safe from the attack if it disables renegotiations
457+ * but the problem is that the browser can't know that. Setting this pref to true is the only way for the
458+ * browser to ensure there will be no unsafe renegotiations on the channel between the browser and the server
459+ * [SETUP-WEB] SSL_ERROR_UNSAFE_NEGOTIATION: is it worth overriding this for that one site?
460460 * [STATS] SSL Labs (July 2021) reports over 99% of top sites have secure renegotiation [4]
461461 * [1] https://wiki.mozilla.org/Security:Renegotiation
462462 * [2] https://datatracker.ietf.org/doc/html/rfc5746
@@ -580,7 +580,7 @@ user_pref("_user.js.parrot", "1600 syntax error: the parrot rests in peace!");
580580/* 1601: control when to send a cross-origin referer
581581 * 0=always (default), 1=only if base domains match, 2=only if hosts match
582582 * [SETUP-WEB] Breakage: older modems/routers and some sites e.g banks, vimeo, icloud, instagram
583- * If "2" is too strict, then override to "0" and use Smart Referer (Strict mode + add exceptions) ***/
583+ * If "2" is too strict, then override to "0" and use Smart Referer extension (Strict mode + add exceptions) ***/
584584user_pref ( "network.http.referer.XOriginPolicy" , 2 ) ;
585585/* 1602: control the amount of cross-origin information to send [FF52+]
586586 * 0=send full URI (default), 1=scheme+host+port+path, 2=scheme+host+port ***/
@@ -598,7 +598,7 @@ user_pref("_user.js.parrot", "1700 syntax error: the parrot's bit the dust!");
598598 * [SETTING] General>Tabs>Enable Container Tabs ***/
599599user_pref ( "privacy.userContext.enabled" , true ) ;
600600user_pref ( "privacy.userContext.ui.enabled" , true ) ;
601- /* 1702: set behaviour on "+ Tab" button to display container menu on left click [FF74+]
601+ /* 1702: set behavior on "+ Tab" button to display container menu on left click [FF74+]
602602 * [NOTE] The menu is always shown on long press and right click
603603 * [SETTING] General>Tabs>Enable Container Tabs>Settings>Select a container for each new tab ***/
604604 // user_pref("privacy.userContext.newTabContainerOnLeftClick.enabled", true);
@@ -766,8 +766,10 @@ user_pref("_user.js.parrot", "2700 syntax error: the parrot's joined the bleedin
766766user_pref ( "browser.contentblocking.category" , "strict" ) ;
767767/* 2702: disable ETP web compat features [FF93+]
768768 * [SETUP-HARDEN] Includes skip lists, heuristics (SmartBlock) and automatic grants
769+ * Opener Heuristics are granted for 30 days and Redirect Heuristics for 15 minutes, see [3]
769770 * [1] https://blog.mozilla.org/security/2021/07/13/smartblock-v2/
770- * [2] https://hg.mozilla.org/mozilla-central/rev/e5483fd469ab#l4.12 ***/
771+ * [2] https://hg.mozilla.org/mozilla-central/rev/e5483fd469ab#l4.12
772+ * [3] https://developer.mozilla.org/en-US/docs/Web/Privacy/State_Partitioning#storage_access_heuristics ***/
771773 // user_pref("privacy.antitracking.enableWebcompat", false);
772774/* 2710: enable state partitioning of service workers [FF96+] ***/
773775user_pref ( "privacy.partition.serviceWorkers" , true ) ;
@@ -781,7 +783,6 @@ user_pref("_user.js.parrot", "2800 syntax error: the parrot's bleedin' demised!"
781783 * sharedWorkers and serviceWorkers. serviceWorkers require an "Allow" permission
782784 * [SETTING] Privacy & Security>Cookies and Site Data>Delete cookies and site data when Firefox is closed
783785 * [SETTING] to add site exceptions: Ctrl+I>Permissions>Cookies>Allow
784- * If using FPI the syntax must be https://example.com/^firstPartyDomain=example.com
785786 * [SETTING] to manage site exceptions: Options>Privacy & Security>Permissions>Settings ***/
786787user_pref ( "network.cookie.lifetimePolicy" , 2 ) ;
787788/* 2802: delete cache on exit [FF96+]
@@ -952,7 +953,7 @@ user_pref("browser.link.open_newwindow", 3); // [DEFAULT: 3]
952953 * [1] https://searchfox.org/mozilla-central/source/dom/tests/browser/browser_test_new_window_from_content.js ***/
953954user_pref ( "browser.link.open_newwindow.restriction" , 0 ) ;
954955/* 4520: disable WebGL (Web Graphics Library)
955- * [SETUP-WEB] If you need it then enable it. RFP still randomizes canvas for naive scripts ***/
956+ * [SETUP-WEB] If you need it then override it. RFP still randomizes canvas for naive scripts ***/
956957user_pref ( "webgl.disabled" , true ) ;
957958
958959/*** [SECTION 5000]: OPTIONAL OPSEC
@@ -1029,8 +1030,8 @@ user_pref("_user.js.parrot", "5000 syntax error: the parrot's taken 'is last bow
10291030 // user_pref("browser.download.folderList", 2);
10301031
10311032/*** [SECTION 5500]: OPTIONAL HARDENING
1032- Not recommended. Keep in mind that these can cause breakage and performance
1033- issues, are mostly fingerpintable , and the threat model is practically zero
1033+ Not recommended. Overriding these can cause breakage and performance issues,
1034+ they are mostly fingerprintable , and the threat model is practically nonexistent
10341035***/
10351036user_pref ( "_user.js.parrot" , "5500 syntax error: this is an ex-parrot!" ) ;
10361037/* 5501: disable MathML (Mathematical Markup Language) [FF51+]
@@ -1125,7 +1126,7 @@ user_pref("_user.js.parrot", "7000 syntax error: the parrot's pushing up daisies
11251126 // user_pref("geo.enabled", false);
11261127 // user_pref("full-screen-api.enabled", false);
11271128 // user_pref("browser.cache.offline.enable", false);
1128- // user_pref("dom.vr.enabled", false);
1129+ // user_pref("dom.vr.enabled", false); // [DEFAULT: false FF97+]
11291130/* 7002: set default permissions
11301131 * Location, Camera, Microphone, Notifications [FF58+] Virtual Reality [FF73+]
11311132 * 0=always ask (default), 1=allow, 2=block
@@ -1159,7 +1160,6 @@ user_pref("_user.js.parrot", "7000 syntax error: the parrot's pushing up daisies
11591160 // user_pref("security.ssl.disable_session_identifiers", true); // [HIDDEN PREF]
11601161/* 7006: onions
11611162 * [WHY] Firefox doesn't support hidden services. Use Tor Browser ***/
1162- // user_pref("dom.securecontext.whitelist_onions", true); // 1382359
11631163 // user_pref("dom.securecontext.allowlist_onions", true); // [FF97+] 1382359/1744006
11641164 // user_pref("network.http.referer.hideOnionSource", true); // 1305144
11651165/* 7007: referers
@@ -1344,6 +1344,10 @@ user_pref("browser.urlbar.suggest.quicksuggest", false);
13441344 // [1] https://support.mozilla.org/kb/enable-background-updates-firefox-windows
13451345 // [-] https://bugzilla.mozilla.org/1738983
13461346user_pref("app.update.background.scheduling.enabled", false);
1347+ // FF97
1348+ // 7006: onions - replaced by new 7006 "allowlist"
1349+ // [-] https://bugzilla.mozilla.org/1744006
1350+ // user_pref("dom.securecontext.whitelist_onions", true); // 1382359
13471351// ***/
13481352
13491353/* END: internal custom pref to test for syntax errors ***/
0 commit comments