user.js 115 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850
  1. /******
  2. * name: ghacks user.js
  3. * date: 15 April 2019
  4. * version 67-alpha: Barbie Pants
  5. * "I'm a Barbie pants in a Barbie world. Life in plastic, it's fantastic"
  6. * authors: v52+ github | v51- www.ghacks.net
  7. * url: https://github.com/ghacksuserjs/ghacks-user.js
  8. * license: MIT: https://github.com/ghacksuserjs/ghacks-user.js/blob/master/LICENSE.txt
  9. * releases: These are end-of-stable-life-cycle legacy archives.
  10. *Always* use the master branch user.js for a current up-to-date version.
  11. url: https://github.com/ghacksuserjs/ghacks-user.js/releases
  12. * README:
  13. 0. Consider using Tor Browser if it meets your needs or fits your threat model better
  14. * https://www.torproject.org/about/torusers.html.en
  15. 1. READ the full README
  16. * https://github.com/ghacksuserjs/ghacks-user.js/blob/master/README.md
  17. 2. READ this
  18. * https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation
  19. 3. If you skipped steps 1 and 2 above (shame on you), then here is the absolute minimum
  20. * Real time binary checks with Google services are disabled (0402)
  21. * You will still get prompts to update Firefox, but auto-installing them is disabled (0302a)
  22. * Some user data is erased on close (section 2800). Change this to suit your needs
  23. * EACH RELEASE check:
  24. - 4600s: reset prefs made redundant due to privacy.resistFingerprinting (RPF)
  25. or enable them as an alternative to RFP or for ESR users
  26. - 9999s: reset deprecated prefs in about:config or enable relevant section(s) for ESR
  27. * Site breakage WILL happen
  28. - There are often trade-offs and conflicts between Security vs Privacy vs Anti-Fingerprinting
  29. and these need to be balanced against Functionality & Convenience & Breakage
  30. * You will need to make changes, and to troubleshoot at times (choose wisely, there is always a trade-off).
  31. While not 100% definitive, search for "[SETUP". If required, add each pref to your overrides section at
  32. default values (or comment them out and reset them in about:config). Here are the main ones:
  33. [SETUP-SECURITY] it's one item, read it
  34. [SETUP-WEB] can cause some websites to break
  35. [SETUP-CHROME] changes how Firefox itself behaves (i.e. NOT directly website related)
  36. [SETUP-PERF] may impact performance
  37. [SETUP-HARDEN] maybe you should consider using the Tor Browser
  38. * [WARNING] tags are extra special and used sparingly, so heed them
  39. 4. BACKUP your profile folder before implementing (and/or test in a new/cloned profile)
  40. 5. KEEP UP TO DATE: https://github.com/ghacksuserjs/ghacks-user.js/wiki#small_orange_diamond-maintenance
  41. * INDEX:
  42. 0100: STARTUP
  43. 0200: GEOLOCATION
  44. 0300: QUIET FOX
  45. 0400: BLOCKLISTS / SAFE BROWSING
  46. 0500: SYSTEM ADD-ONS / EXPERIMENTS
  47. 0600: BLOCK IMPLICIT OUTBOUND
  48. 0700: HTTP* / TCP/IP / DNS / PROXY / SOCKS etc
  49. 0800: LOCATION BAR / SEARCH BAR / SUGGESTIONS / HISTORY / FORMS
  50. 0900: PASSWORDS
  51. 1000: CACHE / SESSION (RE)STORE / FAVICONS
  52. 1200: HTTPS (SSL/TLS / OCSP / CERTS / HPKP / CIPHERS)
  53. 1400: FONTS
  54. 1600: HEADERS / REFERERS
  55. 1700: CONTAINERS
  56. 1800: PLUGINS
  57. 2000: MEDIA / CAMERA / MIC
  58. 2200: WINDOW MEDDLING & LEAKS / POPUPS
  59. 2300: WEB WORKERS
  60. 2400: DOM (DOCUMENT OBJECT MODEL) & JAVASCRIPT
  61. 2500: HARDWARE FINGERPRINTING
  62. 2600: MISCELLANEOUS
  63. 2700: PERSISTENT STORAGE
  64. 2800: SHUTDOWN
  65. 4000: FPI (FIRST PARTY ISOLATION)
  66. 4500: RFP (RESIST FINGERPRINTING)
  67. 4600: RFP ALTERNATIVES
  68. 4700: RFP ALTERNATIVES (NAVIGATOR / USER AGENT (UA) SPOOFING)
  69. 5000: PERSONAL
  70. 9999: DEPRECATED / REMOVED / LEGACY / RENAMED
  71. ******/
  72. /* START: internal custom pref to test for syntax errors
  73. * [NOTE] In FF60+, not all syntax errors cause parsing to abort i.e. reaching the last debug
  74. * pref no longer necessarily means that all prefs have been applied. Check the console right
  75. * after startup for any warnings/error messages related to non-applied prefs
  76. * [1] https://blog.mozilla.org/nnethercote/2018/03/09/a-new-preferences-parser-for-firefox/ ***/
  77. user_pref("_user.js.parrot", "START: Oh yes, the Norwegian Blue... what's wrong with it?");
  78. /*** [SECTION 0100]: STARTUP ***/
  79. user_pref("_user.js.parrot", "0100 syntax error: the parrot's dead!");
  80. /* 0101: disable default browser check
  81. * [SETTING] General>Startup>Always check if Firefox is your default browser ***/
  82. user_pref("browser.shell.checkDefaultBrowser", false);
  83. /* 0102: set START page (0=blank, 1=home, 2=last visited page, 3=resume previous session)
  84. * [NOTE] Session Restore is not used in PB mode (0110) and is cleared with history (2803, 2804)
  85. * [SETTING] General>Startup>Restore previous session ***/
  86. user_pref("browser.startup.page", 0);
  87. /* 0103: set HOME+NEWWINDOW page
  88. * about:home=Activity Stream (default, see 0105), custom URL, about:blank
  89. * [SETTING] Home>New Windows and Tabs>Homepage and new windows ***/
  90. user_pref("browser.startup.homepage", "about:blank");
  91. /* 0104: set NEWTAB page
  92. * true=Activity Stream (default, see 0105), false=blank page
  93. * [SETTING] Home>New Windows and Tabs>New tabs ***/
  94. user_pref("browser.newtabpage.enabled", false);
  95. user_pref("browser.newtab.preload", false);
  96. /* 0105: disable Activity Stream stuff (AS)
  97. * AS is the default homepage/newtab in FF57+, based on metadata and browsing behavior.
  98. * **NOT LISTING ALL OF THESE: USE THE PREFERENCES UI**
  99. * [SETTING] Home>Firefox Home Content>... to show/hide what you want ***/
  100. /* 0105a: disable Activity Stream telemetry ***/
  101. user_pref("browser.newtabpage.activity-stream.feeds.telemetry", false);
  102. user_pref("browser.newtabpage.activity-stream.telemetry", false);
  103. user_pref("browser.newtabpage.activity-stream.telemetry.ping.endpoint", "");
  104. /* 0105b: disable Activity Stream Snippets
  105. * Runs code received from a server (aka Remote Code Execution) and sends information back to a metrics server
  106. * [1] https://abouthome-snippets-service.readthedocs.io/ ***/
  107. user_pref("browser.aboutHomeSnippets.updateUrl", "");
  108. user_pref("browser.newtabpage.activity-stream.asrouter.providers.snippets", "");
  109. user_pref("browser.newtabpage.activity-stream.disableSnippets", true);
  110. user_pref("browser.newtabpage.activity-stream.feeds.snippets", false);
  111. /* 0105c: disable Activity Stream Top Stories, Pocket-based and/or sponsored content ***/
  112. user_pref("browser.newtabpage.activity-stream.feeds.section.topstories", false);
  113. user_pref("browser.newtabpage.activity-stream.section.highlights.includePocket", false);
  114. user_pref("browser.newtabpage.activity-stream.showSponsored", false);
  115. user_pref("browser.newtabpage.activity-stream.feeds.discoverystreamfeed", false); // [FF66+]
  116. /* 0105d: disable Activity Stream recent Highlights in the Library [FF57+] ***/
  117. // user_pref("browser.library.activity-stream.enabled", false);
  118. /* 0110: start Firefox in PB (Private Browsing) mode
  119. * [NOTE] In this mode *all* windows are "private windows" and the PB mode icon is not displayed
  120. * [WARNING] The P in PB mode is misleading: it means no "persistent" local storage of history,
  121. * caches, searches or cookies (which you can achieve in normal mode). In fact, it limits or
  122. * removes the ability to control these, and you need to quit Firefox to clear them. PB is best
  123. * used as a one off window (File>New Private Window) to provide a temporary self-contained
  124. * new instance. Closing all Private Windows clears all traces. Repeat as required. PB also does
  125. * not allow indexedDB which breaks many Extensions that use it including uBlock Origin and uMatrix
  126. * [SETTING] Privacy & Security>History>Custom Settings>Always use private browsing mode
  127. * [1] https://wiki.mozilla.org/Private_Browsing
  128. * [2] https://spreadprivacy.com/is-private-browsing-really-private/ ***/
  129. // user_pref("browser.privatebrowsing.autostart", true);
  130. /*** [SECTION 0200]: GEOLOCATION ***/
  131. user_pref("_user.js.parrot", "0200 syntax error: the parrot's definitely deceased!");
  132. /* 0201: disable Location-Aware Browsing
  133. * [1] https://www.mozilla.org/firefox/geolocation/ ***/
  134. // user_pref("geo.enabled", false);
  135. /* 0201b: set a default permission for Location [FF58+]
  136. * 0=always ask (default), 1=allow, 2=block
  137. * [NOTE] Best left at default "always ask", fingerprintable via Permissions API
  138. * [SETTING] to add site exceptions: Page Info>Permissions>Access Your Location
  139. * [SETTING] to manage site exceptions: Options>Privacy & Security>Permissions>Location>Settings ***/
  140. // user_pref("permissions.default.geo", 2);
  141. /* 0202: disable GeoIP-based search results
  142. * [NOTE] May not be hidden if Firefox has changed your settings due to your locale
  143. * [1] https://trac.torproject.org/projects/tor/ticket/16254
  144. * [2] https://support.mozilla.org/en-US/kb/how-stop-firefox-making-automatic-connections#w_geolocation-for-default-search-engine ***/
  145. user_pref("browser.search.region", "US"); // [HIDDEN PREF]
  146. user_pref("browser.search.geoip.url", "");
  147. /* 0205: set OS & APP locale [FF59+]
  148. * If set to empty, the OS locales are used. If not set at all, default locale is used ***/
  149. user_pref("intl.locale.requested", "en-US"); // [HIDDEN PREF]
  150. /* 0206: disable geographically specific results/search engines e.g. "browser.search.*.US"
  151. * i.e. ignore all of Mozilla's various search engines in multiple locales ***/
  152. user_pref("browser.search.geoSpecificDefaults", false);
  153. user_pref("browser.search.geoSpecificDefaults.url", "");
  154. /* 0207: set language to match ***/
  155. user_pref("intl.accept_languages", "en-US, en");
  156. /* 0208: enforce US English locale regardless of the system locale
  157. * [1] https://bugzilla.mozilla.org/867501 ***/
  158. user_pref("javascript.use_us_english_locale", true); // [HIDDEN PREF]
  159. /* 0209: use APP locale over OS locale in regional preferences [FF56+]
  160. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1379420,1364789 ***/
  161. user_pref("intl.regional_prefs.use_os_locales", false);
  162. /* 0210: use Mozilla geolocation service instead of Google when geolocation is enabled
  163. * Optionally enable logging to the console (defaults to false) ***/
  164. user_pref("geo.wifi.uri", "https://location.services.mozilla.com/v1/geolocate?key=%MOZILLA_API_KEY%");
  165. // user_pref("geo.wifi.logging.enabled", true); // [HIDDEN PREF]
  166. /* 0211: disable using the OS's geolocation service ***/
  167. user_pref("geo.provider.ms-windows-location", false); // [WINDOWS]
  168. user_pref("geo.provider.use_corelocation", false); // [MAC]
  169. user_pref("geo.provider.use_gpsd", false); // [LINUX]
  170. /*** [SECTION 0300]: QUIET FOX
  171. Starting in user.js v67, we only disable the auto-INSTALL of Firefox. You still get prompts
  172. to update, in one click. We have NEVER disabled auto-CHECKING, and highly discourage that.
  173. Previously we also disabled auto-INSTALLING of extensions (302b).
  174. There are many legitimate reasons to turn off auto-INSTALLS, including hijacked or monetized
  175. extensions, time constraints, legacy issues, dev/testing, and fear of breakage/bugs. It is
  176. still important to do updates for security reasons, please do so manually if you make changes.
  177. ***/
  178. user_pref("_user.js.parrot", "0300 syntax error: the parrot's not pinin' for the fjords!");
  179. /* 0301b: disable auto-CHECKING for extension and theme updates ***/
  180. // user_pref("extensions.update.enabled", false);
  181. /* 0302a: disable auto-INSTALLING Firefox updates [NON-WINDOWS FF65+]
  182. * [NOTE] In FF65+ on Windows this SETTING (below) is now stored in a file and the pref was removed
  183. * [SETTING] General>Firefox Updates>Check for updates but let you choose... ***/
  184. user_pref("app.update.auto", false);
  185. /* 0302b: disable auto-INSTALLING extension and theme updates (after the check in 0301b)
  186. * [SETTING] about:addons>Extensions>[cog-wheel-icon]>Update Add-ons Automatically (toggle) ***/
  187. // user_pref("extensions.update.autoUpdateDefault", false);
  188. /* 0306: disable extension metadata
  189. * used when installing/updating an extension, and in daily background update checks: if false, it
  190. * hides the expanded text description (if it exists) when you "show more details about an addon" ***/
  191. // user_pref("extensions.getAddons.cache.enabled", false);
  192. /* 0307: disable auto updating of lightweight themes (LWT)
  193. * Not to be confused with themes in 0301* + 0302*, which use the FF55+ Theme API
  194. * Mozilla plan to convert existing LWTs and remove LWT support in the future, see [1]
  195. * [1] https://blog.mozilla.org/addons/2018/09/20/future-themes-here/ ***/
  196. user_pref("lightweightThemes.update.enabled", false);
  197. /* 0308: disable search update
  198. * [SETTING] General>Firefox Updates>Automatically update search engines ***/
  199. user_pref("browser.search.update", false);
  200. /* 0309: disable sending Flash crash reports ***/
  201. user_pref("dom.ipc.plugins.flash.subprocess.crashreporter.enabled", false);
  202. /* 0310: disable sending the URL of the website where a plugin crashed ***/
  203. user_pref("dom.ipc.plugins.reportCrashURL", false);
  204. /* 0320: disable about:addons' Get Add-ons panel (uses Google Analytics) ***/
  205. user_pref("extensions.getAddons.showPane", false); // [HIDDEN PREF]
  206. user_pref("extensions.webservice.discoverURL", "");
  207. /* 0330: disable telemetry
  208. * the pref (.unified) affects the behaviour of the pref (.enabled)
  209. * IF unified=false then .enabled controls the telemetry module
  210. * IF unified=true then .enabled ONLY controls whether to record extended data
  211. * so make sure to have both set as false
  212. * [NOTE] FF58+ `toolkit.telemetry.enabled` is now LOCKED to reflect prerelease
  213. * or release builds (true and false respectively), see [2]
  214. * [1] https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/telemetry/internals/preferences.html
  215. * [2] https://medium.com/georg-fritzsche/data-preference-changes-in-firefox-58-2d5df9c428b5 ***/
  216. user_pref("toolkit.telemetry.unified", false);
  217. user_pref("toolkit.telemetry.enabled", false); // see [NOTE] above FF58+
  218. user_pref("toolkit.telemetry.server", "data:,");
  219. user_pref("toolkit.telemetry.archive.enabled", false);
  220. user_pref("toolkit.telemetry.cachedClientID", "");
  221. user_pref("toolkit.telemetry.newProfilePing.enabled", false); // [FF55+]
  222. user_pref("toolkit.telemetry.shutdownPingSender.enabled", false); // [FF55+]
  223. user_pref("toolkit.telemetry.updatePing.enabled", false); // [FF56+]
  224. user_pref("toolkit.telemetry.bhrPing.enabled", false); // [FF57+] Background Hang Reporter
  225. user_pref("toolkit.telemetry.firstShutdownPing.enabled", false); // [FF57+]
  226. user_pref("toolkit.telemetry.hybridContent.enabled", false); // [FF59+]
  227. /* 0331: disable Telemetry Coverage
  228. * [1] https://blog.mozilla.org/data/2018/08/20/effectively-measuring-search-in-firefox/ ***/
  229. user_pref("toolkit.telemetry.coverage.opt-out", true); // [HIDDEN PREF]
  230. user_pref("toolkit.coverage.opt-out", true); // [FF64+] [HIDDEN PREF]
  231. user_pref("toolkit.coverage.endpoint.base", "");
  232. /* 0340: disable Health Reports
  233. * [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to send technical... data ***/
  234. user_pref("datareporting.healthreport.uploadEnabled", false);
  235. /* 0341: disable new data submission, master kill switch [FF41+]
  236. * If disabled, no policy is shown or upload takes place, ever
  237. * [1] https://bugzilla.mozilla.org/1195552 ***/
  238. user_pref("datareporting.policy.dataSubmissionEnabled", false);
  239. /* 0342: disable Studies (see 0503)
  240. * [NOTE] This pref has no effect when Health Reports (0340) are disabled
  241. * [SETTING] Privacy & Security>Firefox Data Collection & Use>...>Allow Firefox to install and run studies ***/
  242. user_pref("app.shield.optoutstudies.enabled", false);
  243. /* 0343: disable personalized Extension Recommendations in about:addons and AMO [FF65+]
  244. * [NOTE] This pref has no effect when Health Reports (0340) are disabled
  245. * [SETTING] Privacy & Security>Firefox Data Collection & Use>...>Allow Firefox to make personalized extension rec.
  246. * [1] https://support.mozilla.org/kb/personalized-extension-recommendations ***/
  247. user_pref("browser.discovery.enabled", false);
  248. /* 0350: disable Crash Reports ***/
  249. user_pref("breakpad.reportURL", "");
  250. user_pref("browser.tabs.crashReporting.sendReport", false); // [FF44+]
  251. user_pref("browser.crashReports.unsubmittedCheck.enabled", false); // [FF51+]
  252. /* 0351: disable backlogged Crash Reports
  253. * [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to send backlogged crash reports ***/
  254. user_pref("browser.crashReports.unsubmittedCheck.autoSubmit2", false); // [FF58+]
  255. /* 0370: disable Pocket [FF46+]
  256. * Pocket is a third party (now owned by Mozilla) "save for later" cloud service
  257. * [1] https://en.wikipedia.org/wiki/Pocket_(application)
  258. * [2] https://www.gnu.gl/blog/Posts/multiple-vulnerabilities-in-pocket/ ***/
  259. user_pref("extensions.pocket.enabled", false);
  260. /* 0390: disable Captive Portal detection
  261. * [1] https://en.wikipedia.org/wiki/Captive_portal
  262. * [2] https://wiki.mozilla.org/Necko/CaptivePortal
  263. * [3] https://trac.torproject.org/projects/tor/ticket/21790 ***/
  264. user_pref("captivedetect.canonicalURL", "");
  265. user_pref("network.captive-portal-service.enabled", false); // [FF52+]
  266. /* 0391: disable Network Connectivity checks [FF65+]
  267. * [1] https://bugzilla.mozilla.org/1460537 ***/
  268. user_pref("network.connectivity-service.enabled", false);
  269. /*** [SECTION 0400]: BLOCKLISTS / SAFE BROWSING (SB)
  270. Safe Browsing has taken many steps to preserve privacy. *IF* required, a full url is never
  271. sent to Google, only a PART-hash of the prefix, and this is hidden with noise of other real
  272. PART-hashes. Google also swear it is anonymized and only used to flag malicious sites.
  273. Firefox also takes measures such as striping out identifying parameters and since SBv4 (FF57+)
  274. doesn't even use cookies. (#Turn on browser.safebrowsing.debug to monitor this activity)
  275. #Required reading [#] https://feeding.cloud.geek.nz/posts/how-safe-browsing-works-in-firefox/
  276. [1] https://wiki.mozilla.org/Security/Safe_Browsing
  277. ***/
  278. user_pref("_user.js.parrot", "0400 syntax error: the parrot's passed on!");
  279. /* 0401: enforce Firefox blocklist, but sanitize blocklist url
  280. * [NOTE] It includes updates for "revoked certificates"
  281. * [1] https://blog.mozilla.org/security/2015/03/03/revoking-intermediate-certificates-introducing-onecrl/
  282. * [2] https://trac.torproject.org/projects/tor/ticket/16931 ***/
  283. user_pref("extensions.blocklist.enabled", true); // [DEFAULT: true]
  284. user_pref("extensions.blocklist.url", "https://blocklists.settings.services.mozilla.com/v1/blocklist/3/%APP_ID%/%APP_VERSION%/");
  285. /* 0402: disable binaries NOT in Safe Browsing local lists being checked
  286. * This is a real-time check with Google services.
  287. * [SETUP-SECURITY] If you do not understand this, or if you want this protection, then override it ***/
  288. user_pref("browser.safebrowsing.downloads.remote.enabled", false);
  289. /* 0403: disable reporting URLs ***/
  290. user_pref("browser.safebrowsing.provider.google.reportURL", "");
  291. user_pref("browser.safebrowsing.reportPhishURL", "");
  292. user_pref("browser.safebrowsing.provider.google4.reportURL", ""); // [FF50+]
  293. user_pref("browser.safebrowsing.provider.google.reportMalwareMistakeURL", ""); // [FF54+]
  294. user_pref("browser.safebrowsing.provider.google.reportPhishMistakeURL", ""); // [FF54+]
  295. user_pref("browser.safebrowsing.provider.google4.reportMalwareMistakeURL", ""); // [FF54+]
  296. user_pref("browser.safebrowsing.provider.google4.reportPhishMistakeURL", ""); // [FF54+]
  297. /* 0404: disable 'ignore this warning' on Safe Browsing warnings
  298. * If clicked, it bypasses the block for that session. This is a means for admins to enforce SB
  299. * [TEST] see github wiki APPENDIX A: Test Sites: Section 5
  300. * [1] https://bugzilla.mozilla.org/1226490 ***/
  301. // user_pref("browser.safebrowsing.allowOverride", false);
  302. /* 0405: disable data sharing [FF58+] ***/
  303. user_pref("browser.safebrowsing.provider.google4.dataSharing.enabled", false);
  304. user_pref("browser.safebrowsing.provider.google4.dataSharingURL", "");
  305. /*** [SECTION 0500]: SYSTEM ADD-ONS / EXPERIMENTS
  306. System Add-ons are a method for shipping extensions, considered to be
  307. built-in features to Firefox, that are hidden from the about:addons UI.
  308. To view your System Add-ons go to about:support, they are listed under "Firefox Features"
  309. Some System Add-ons have no on-off prefs. Instead you can manually remove them. Note that app
  310. updates will restore them. They may also be updated and possibly restored automatically (see 0505)
  311. * Portable: "...\App\Firefox64\browser\features\" (or "App\Firefox\etc" for 32bit)
  312. * Windows: "...\Program Files\Mozilla\browser\features" (or "Program Files (X86)\etc" for 32bit)
  313. * Mac: "...\Applications\Firefox\Contents\Resources\browser\features\"
  314. [NOTE] On Mac you can right-click on the application and select "Show Package Contents"
  315. * Linux: "/usr/lib/firefox/browser/features" (or similar)
  316. [1] https://firefox-source-docs.mozilla.org/toolkit/mozapps/extensions/addon-manager/SystemAddons.html
  317. [2] https://dxr.mozilla.org/mozilla-central/source/browser/extensions
  318. ***/
  319. user_pref("_user.js.parrot", "0500 syntax error: the parrot's cashed in 'is chips!");
  320. /* 0503: disable Normandy/Shield [FF60+]
  321. * Shield is an telemetry system (including Heartbeat) that can also push and test "recipes"
  322. * [1] https://wiki.mozilla.org/Firefox/Shield
  323. * [2] https://github.com/mozilla/normandy ***/
  324. user_pref("app.normandy.enabled", false);
  325. user_pref("app.normandy.api_url", "");
  326. /* 0505: disable System Add-on updates ***/
  327. user_pref("extensions.systemAddon.update.enabled", false); // [FF62+]
  328. user_pref("extensions.systemAddon.update.url", ""); // [FF44+]
  329. /* 0506: disable PingCentre telemetry (used in several System Add-ons) [FF57+]
  330. * Currently blocked by 'datareporting.healthreport.uploadEnabled' (see 0340) ***/
  331. user_pref("browser.ping-centre.telemetry", false);
  332. /* 0515: disable Screenshots
  333. * alternatively in FF60+, disable uploading to the Screenshots server
  334. * [1] https://github.com/mozilla-services/screenshots
  335. * [2] https://www.ghacks.net/2017/05/28/firefox-screenshots-integrated-in-firefox-nightly/ ***/
  336. // user_pref("extensions.screenshots.disabled", true); // [FF55+]
  337. // user_pref("extensions.screenshots.upload-disabled", true); // [FF60+]
  338. /* 0517: disable Form Autofill
  339. * [NOTE] Stored data is NOT secure (uses a JSON file)
  340. * [NOTE] Heuristics controls Form Autofill on forms without @autocomplete attributes
  341. * [SETTING] Privacy & Security>Forms & Passwords>Autofill addresses
  342. * [1] https://wiki.mozilla.org/Firefox/Features/Form_Autofill
  343. * [2] https://www.ghacks.net/2017/05/24/firefoxs-new-form-autofill-is-awesome/ ***/
  344. user_pref("extensions.formautofill.addresses.enabled", false); // [FF55+]
  345. user_pref("extensions.formautofill.available", "off"); // [FF56+]
  346. user_pref("extensions.formautofill.creditCards.enabled", false); // [FF56+]
  347. user_pref("extensions.formautofill.heuristics.enabled", false); // [FF55+]
  348. /* 0518: disable Web Compatibility Reporter [FF56+]
  349. * Web Compatibility Reporter adds a "Report Site Issue" button to send data to Mozilla ***/
  350. user_pref("extensions.webcompat-reporter.enabled", false);
  351. /*** [SECTION 0600]: BLOCK IMPLICIT OUTBOUND [not explicitly asked for - e.g. clicked on] ***/
  352. user_pref("_user.js.parrot", "0600 syntax error: the parrot's no more!");
  353. /* 0601: disable link prefetching
  354. * [1] https://developer.mozilla.org/docs/Web/HTTP/Link_prefetching_FAQ ***/
  355. user_pref("network.prefetch-next", false);
  356. /* 0602: disable DNS prefetching
  357. * [1] https://www.ghacks.net/2013/04/27/firefox-prefetching-what-you-need-to-know/
  358. * [2] https://developer.mozilla.org/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control ***/
  359. user_pref("network.dns.disablePrefetch", true);
  360. user_pref("network.dns.disablePrefetchFromHTTPS", true); // [HIDDEN PREF]
  361. /* 0603: disable Seer/Necko
  362. * [1] https://developer.mozilla.org/docs/Mozilla/Projects/Necko ***/
  363. user_pref("network.predictor.enabled", false);
  364. /* 0605: disable link-mouseover opening connection to linked server
  365. * [1] https://news.slashdot.org/story/15/08/14/2321202/how-to-quash-firefoxs-silent-requests
  366. * [2] https://www.ghacks.net/2015/08/16/block-firefox-from-connecting-to-sites-when-you-hover-over-links/ ***/
  367. user_pref("network.http.speculative-parallel-limit", 0);
  368. /* 0606: disable pings (but enforce same host in case)
  369. * [1] http://kb.mozillazine.org/Browser.send_pings
  370. * [2] http://kb.mozillazine.org/Browser.send_pings.require_same_host ***/
  371. user_pref("browser.send_pings", false); // [DEFAULT: false]
  372. user_pref("browser.send_pings.require_same_host", true);
  373. /* 0608: disable predictor / prefetching [FF48+] ***/
  374. user_pref("network.predictor.enable-prefetch", false);
  375. /*** [SECTION 0700]: HTTP* / TCP/IP / DNS / PROXY / SOCKS etc ***/
  376. user_pref("_user.js.parrot", "0700 syntax error: the parrot's given up the ghost!");
  377. /* 0701: disable IPv6
  378. * IPv6 can be abused, especially regarding MAC addresses. They also do not play nice
  379. * with VPNs. That's even assuming your ISP and/or router and/or website can handle it
  380. * [NOTE] This is just an application level fallback. Disabling IPv6 is best done
  381. * at an OS/network level, and/or configured properly in VPN setups
  382. * [TEST] http://ipv6leak.com/
  383. * [1] https://github.com/ghacksuserjs/ghacks-user.js/issues/437#issuecomment-403740626
  384. * [2] https://www.internetsociety.org/tag/ipv6-security/ (see Myths 2,4,5,6) ***/
  385. user_pref("network.dns.disableIPv6", true);
  386. /* 0702: disable HTTP2
  387. * HTTP2 raises concerns with "multiplexing" and "server push", does nothing to
  388. * enhance privacy, and opens up a number of server-side fingerprinting opportunities.
  389. * [WARNING] Disabling this made sense in the past, and doesn't break anything, but HTTP2 is
  390. * at 35% (April 2019) and growing [5]. Don't be that one person using HTTP1.1 on HTTP2 sites
  391. * [1] https://http2.github.io/faq/
  392. * [2] https://blog.scottlogic.com/2014/11/07/http-2-a-quick-look.html
  393. * [3] https://http2.github.io/http2-spec/#rfc.section.10.8
  394. * [4] https://queue.acm.org/detail.cfm?id=2716278
  395. * [5] https://w3techs.com/technologies/details/ce-http2/all/all ***/
  396. // user_pref("network.http.spdy.enabled", false);
  397. // user_pref("network.http.spdy.enabled.deps", false);
  398. // user_pref("network.http.spdy.enabled.http2", false);
  399. // user_pref("network.http.spdy.websockets", false); // [FF65+]
  400. /* 0703: disable HTTP Alternative Services [FF37+]
  401. * [SETUP-PERF] Relax this if you have FPI enabled (see 4000) *AND* you understand the
  402. * consequences. FPI isolates these, but it was designed with the Tor protocol in mind,
  403. * and the Tor Browser has extra protection, including enhanced sanitizing per Identity.
  404. * [1] https://tools.ietf.org/html/rfc7838#section-9
  405. * [2] https://www.mnot.net/blog/2016/03/09/alt-svc ***/
  406. user_pref("network.http.altsvc.enabled", false);
  407. user_pref("network.http.altsvc.oe", false);
  408. /* 0704: enforce the proxy server to do any DNS lookups when using SOCKS
  409. * e.g. in Tor, this stops your local DNS server from knowing your Tor destination
  410. * as a remote Tor node will handle the DNS request
  411. * [1] http://kb.mozillazine.org/Network.proxy.socks_remote_dns
  412. * [2] https://trac.torproject.org/projects/tor/wiki/doc/TorifyHOWTO/WebBrowsers ***/
  413. user_pref("network.proxy.socks_remote_dns", true);
  414. /* 0706: remove paths when sending URLs to PAC scripts [FF51+]
  415. * CVE-2017-5384: Information disclosure via Proxy Auto-Config (PAC)
  416. * [1] https://bugzilla.mozilla.org/1255474 ***/
  417. user_pref("network.proxy.autoconfig_url.include_path", false); // [DEFAULT: false]
  418. /* 0707: disable (or setup) DNS-over-HTTPS (DoH) [FF60+]
  419. * TRR = Trusted Recursive Resolver
  420. * .mode: 0=off, 1=race, 2=TRR first, 3=TRR only, 4=race for stats but always use native result
  421. * [WARNING] DoH bypasses hosts and gives info to yet another party (e.g. Cloudflare)
  422. * [1] https://www.ghacks.net/2018/04/02/configure-dns-over-https-in-firefox/
  423. * [2] https://hacks.mozilla.org/2018/05/a-cartoon-intro-to-dns-over-https/ ***/
  424. // user_pref("network.trr.mode", 0);
  425. // user_pref("network.trr.bootstrapAddress", "");
  426. // user_pref("network.trr.uri", "");
  427. /* 0708: disable FTP [FF60+]
  428. * [1] https://www.ghacks.net/2018/02/20/firefox-60-with-new-preference-to-disable-ftp/ ***/
  429. // user_pref("network.ftp.enabled", false);
  430. /* 0709: disable using UNC (Uniform Naming Convention) paths [FF61+]
  431. * [SETUP-CHROME] Can break extensions for profiles on network shares
  432. * [1] https://trac.torproject.org/projects/tor/ticket/26424 ***/
  433. user_pref("network.file.disable_unc_paths", true); // [HIDDEN PREF]
  434. /* 0710: disable GIO as a potential proxy bypass vector
  435. * Gvfs/GIO has a set of supported protocols like obex, network, archive, computer, dav, cdda,
  436. * gphoto2, trash, etc. By default only smb and sftp protocols are accepted so far (as of FF64)
  437. * [1] https://bugzilla.mozilla.org/1433507
  438. * [2] https://trac.torproject.org/23044
  439. * [3] https://en.wikipedia.org/wiki/GVfs
  440. * [4] https://en.wikipedia.org/wiki/GIO_(software) ***/
  441. user_pref("network.gio.supported-protocols", ""); // [HIDDEN PREF]
  442. /*** [SECTION 0800]: LOCATION BAR / SEARCH BAR / SUGGESTIONS / HISTORY / FORMS
  443. Change items 0850 and above to suit for privacy vs convenience and functionality. Consider
  444. your environment (no unwanted eyeballs), your device (restricted access), your device's
  445. unattended state (locked, encrypted, forensic hardened). Likewise, you may want to check
  446. the items cleared on shutdown in section 2800.
  447. [NOTE] The urlbar is also commonly referred to as the location bar and address bar
  448. #Required reading [#] https://xkcd.com/538/
  449. ***/
  450. user_pref("_user.js.parrot", "0800 syntax error: the parrot's ceased to be!");
  451. /* 0801: disable location bar using search
  452. * Don't leak URL typos to a search engine, give an error message instead.
  453. * Examples: "secretplace,com", "secretplace/com", "secretplace com", "secret place.com"
  454. * [NOTE] Search buttons in the dropdown work, but hitting 'enter' in the location bar will fail
  455. * [TIP] You can add keywords to search engines in options (e.g. 'd' for DuckDuckGo) and
  456. * the dropdown will now auto-select it and you can then hit 'enter' and it will work
  457. * [SETUP-CHROME] If you don't, or rarely, type URLs, or you use a default search
  458. * engine that respects privacy, then you probably don't need this ***/
  459. user_pref("keyword.enabled", false);
  460. /* 0802: disable location bar domain guessing
  461. * domain guessing intercepts DNS "hostname not found errors" and resends a
  462. * request (e.g. by adding www or .com). This is inconsistent use (e.g. FQDNs), does not work
  463. * via Proxy Servers (different error), is a flawed use of DNS (TLDs: why treat .com
  464. * as the 411 for DNS errors?), privacy issues (why connect to sites you didn't
  465. * intend to), can leak sensitive data (e.g. query strings: e.g. Princeton attack),
  466. * and is a security risk (e.g. common typos & malicious sites set up to exploit this) ***/
  467. user_pref("browser.fixup.alternate.enabled", false);
  468. /* 0803: display all parts of the url in the location bar ***/
  469. user_pref("browser.urlbar.trimURLs", false);
  470. /* 0804: limit history leaks via enumeration (PER TAB: back/forward)
  471. * This is a PER TAB session history. You still have a full history stored under all history
  472. * default=50, minimum=1=currentpage, 2 is the recommended minimum as some pages
  473. * use it as a means of referral (e.g. hotlinking), 4 or 6 or 10 may be more practical ***/
  474. user_pref("browser.sessionhistory.max_entries", 10);
  475. /* 0805: disable CSS querying page history - CSS history leak
  476. * [NOTE] This has NEVER been fully "resolved": in Mozilla/docs it is stated it's
  477. * only in 'certain circumstances', also see latest comments in [2]
  478. * [TEST] http://lcamtuf.coredump.cx/yahh/ (see github wiki APPENDIX C on how to use)
  479. * [1] https://dbaron.org/mozilla/visited-privacy
  480. * [2] https://bugzilla.mozilla.org/147777
  481. * [3] https://developer.mozilla.org/docs/Web/CSS/Privacy_and_the_:visited_selector ***/
  482. user_pref("layout.css.visited_links_enabled", false);
  483. /* 0806: disable displaying javascript in history URLs ***/
  484. user_pref("browser.urlbar.filter.javascript", true); // [DEFAULT: true]
  485. /* 0807: disable search bar LIVE search suggestions
  486. * [SETTING] Search>Provide search suggestions ***/
  487. user_pref("browser.search.suggest.enabled", false);
  488. /* 0808: disable location bar LIVE search suggestions (requires 0807 = true)
  489. * Also disable the location bar prompt to enable/disable or learn more about it.
  490. * [SETTING] Search>Show search suggestions in address bar results ***/
  491. user_pref("browser.urlbar.suggest.searches", false);
  492. user_pref("browser.urlbar.userMadeSearchSuggestionsChoice", true); // [FF41+]
  493. /* 0809: disable location bar suggesting "preloaded" top websites [FF54+]
  494. * [1] https://bugzilla.mozilla.org/1211726 ***/
  495. user_pref("browser.urlbar.usepreloadedtopurls.enabled", false);
  496. /* 0810: disable location bar making speculative connections [FF56+]
  497. * [1] https://bugzilla.mozilla.org/1348275 ***/
  498. user_pref("browser.urlbar.speculativeConnect.enabled", false);
  499. /* 0850a: disable location bar suggestion types
  500. * If all three suggestion types are false, search engine keywords are disabled
  501. * [SETTING] Privacy & Security>Address Bar>When using the address bar, suggest ***/
  502. // user_pref("browser.urlbar.suggest.history", false);
  503. // user_pref("browser.urlbar.suggest.bookmark", false);
  504. // user_pref("browser.urlbar.suggest.openpage", false);
  505. /* 0850c: disable location bar dropdown
  506. * This value controls the total number of entries to appear in the location bar dropdown
  507. * [NOTE] Items (bookmarks/history/openpages) with a high "frecency"/"bonus" will always
  508. * be displayed (no we do not know how these are calculated or what the threshold is),
  509. * and this does not affect the search by search engine suggestion (see 0808)
  510. * [NOTE] This setting is only useful if you want to enable search engine keywords
  511. * (i.e. at least one of 0850a suggestion types must be true) but you want to *limit* suggestions shown ***/
  512. // user_pref("browser.urlbar.maxRichResults", 0);
  513. /* 0850d: disable location bar autofill
  514. * [1] http://kb.mozillazine.org/Inline_autocomplete ***/
  515. // user_pref("browser.urlbar.autoFill", false);
  516. /* 0850e: disable location bar one-off searches [FF51+]
  517. * [1] https://www.ghacks.net/2016/08/09/firefox-one-off-searches-address-bar/ ***/
  518. // user_pref("browser.urlbar.oneOffSearches", false);
  519. /* 0860: disable search and form history [SETUP-WEB]
  520. * [WARNING] Autocomplete form data is still (in April 2019) easily read by third parties, see [1]
  521. * [NOTE] We also clear formdata on exiting Firefox (see 2803)
  522. * [SETTING] Privacy & Security>History>Custom Settings>Remember search and form history
  523. * [1] https://blog.mindedsecurity.com/2011/10/autocompleteagain.html ***/
  524. user_pref("browser.formfill.enable", false);
  525. /* 0862: disable browsing and download history
  526. * [NOTE] We also clear history and downloads on exiting Firefox (see 2803)
  527. * [SETTING] Privacy & Security>History>Custom Settings>Remember browsing and download history ***/
  528. // user_pref("places.history.enabled", false);
  529. /* 0864: disable date/time picker
  530. * This can leak your locale if not en-US
  531. * [1] https://trac.torproject.org/projects/tor/ticket/21787 ***/
  532. user_pref("dom.forms.datetime", false);
  533. /* 0870: disable Windows jumplist [WINDOWS] ***/
  534. user_pref("browser.taskbar.lists.enabled", false);
  535. user_pref("browser.taskbar.lists.frequent.enabled", false);
  536. user_pref("browser.taskbar.lists.recent.enabled", false);
  537. user_pref("browser.taskbar.lists.tasks.enabled", false);
  538. /* 0871: disable Windows taskbar preview [WINDOWS] ***/
  539. user_pref("browser.taskbar.previews.enable", false);
  540. /*** [SECTION 0900]: PASSWORDS ***/
  541. user_pref("_user.js.parrot", "0900 syntax error: the parrot's expired!");
  542. /* 0901: disable saving passwords
  543. * [NOTE] This does not clear any passwords already saved
  544. * [SETTING] Privacy & Security>Forms & Passwords>Ask to save logins and passwords for websites ***/
  545. // user_pref("signon.rememberSignons", false);
  546. /* 0902: use a master password (recommended if you save passwords)
  547. * There are no preferences for this. It is all handled internally.
  548. * [SETTING] Privacy & Security>Forms & Passwords>Use a master password
  549. * [1] https://support.mozilla.org/kb/use-master-password-protect-stored-logins ***/
  550. /* 0903: set how often Firefox should ask for the master password
  551. * 0=the first time (default), 1=every time it's needed, 2=every n minutes (see 0904) ***/
  552. user_pref("security.ask_for_password", 2);
  553. /* 0904: set how often in minutes Firefox should ask for the master password (see 0903)
  554. * in minutes, default is 30 ***/
  555. user_pref("security.password_lifetime", 5);
  556. /* 0905: disable auto-filling username & password form fields
  557. * can leak in cross-site forms AND be spoofed
  558. * [NOTE] Password will still be auto-filled after a user name is manually entered
  559. * [1] http://kb.mozillazine.org/Signon.autofillForms ***/
  560. user_pref("signon.autofillForms", false);
  561. /* 0906: disable websites' autocomplete="off" [FF30+]
  562. * Don't let sites dictate use of saved logins and passwords. Increase security through
  563. * stronger password use. The trade-off is the convenience. Some sites should never be
  564. * saved (such as banking sites). Set at true, informed users can make their own choice. ***/
  565. user_pref("signon.storeWhenAutocompleteOff", true); // [DEFAULT: true]
  566. /* 0907: display warnings for logins on non-secure (non HTTPS) pages
  567. * [1] https://bugzilla.mozilla.org/1217156 ***/
  568. user_pref("security.insecure_password.ui.enabled", true);
  569. /* 0909: disable formless login capture for Password Manager [FF51+] ***/
  570. user_pref("signon.formlessCapture.enabled", false);
  571. /* 0910: disable autofilling saved passwords on HTTP pages and show warning [FF52+]
  572. * [1] https://www.fxsitecompat.com/en-CA/docs/2017/insecure-login-forms-now-disable-autofill-show-warning-beneath-input-control/
  573. * [2] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1217152,1319119 ***/
  574. user_pref("signon.autofillForms.http", false);
  575. user_pref("security.insecure_field_warning.contextual.enabled", true);
  576. /* 0912: limit (or disable) HTTP authentication credentials dialogs triggered by sub-resources [FF41+]
  577. * hardens against potential credentials phishing
  578. * 0=don't allow sub-resources to open HTTP authentication credentials dialogs
  579. * 1=don't allow cross-origin sub-resources to open HTTP authentication credentials dialogs
  580. * 2=allow sub-resources to open HTTP authentication credentials dialogs (default)
  581. * [1] https://www.fxsitecompat.com/en-CA/docs/2015/http-auth-dialog-can-no-longer-be-triggered-by-cross-origin-resources/ ***/
  582. user_pref("network.auth.subresource-http-auth-allow", 1);
  583. /*** [SECTION 1000]: CACHE / SESSION (RE)STORE / FAVICONS
  584. ETAG [1] and other [2][3] cache tracking/fingerprinting techniques can be averted by
  585. disabling *BOTH* disk (1001) and memory (1003) cache. ETAGs can also be neutralized
  586. by modifying response headers [4]. Another solution is to use a hardened configuration
  587. with Temporary Containers [5]. Alternatively, you can *LIMIT* exposure by clearing
  588. cache on close (2803). or on a regular basis manually or with an extension.
  589. [1] https://en.wikipedia.org/wiki/HTTP_ETag#Tracking_using_ETags
  590. [2] https://robertheaton.com/2014/01/20/cookieless-user-tracking-for-douchebags/
  591. [3] https://www.grepular.com/Preventing_Web_Tracking_via_the_Browser_Cache
  592. [4] https://github.com/ghacksuserjs/ghacks-user.js/wiki/4.2.4-Header-Editor
  593. [5] https://medium.com/@stoically/enhance-your-privacy-in-firefox-with-temporary-containers-33925cd6cd21
  594. ***/
  595. user_pref("_user.js.parrot", "1000 syntax error: the parrot's gone to meet 'is maker!");
  596. /** CACHE ***/
  597. /* 1001: disable disk cache
  598. * [SETUP-PERF] If you think disk cache may help (heavy tab user, high-res video),
  599. * or you use a hardened Temporary Containers, then feel free to override this
  600. * [NOTE] We also clear cache on exiting Firefox (see 2803) ***/
  601. user_pref("browser.cache.disk.enable", false);
  602. /* 1002: disable disk cache for SSL pages
  603. * [1] http://kb.mozillazine.org/Browser.cache.disk_cache_ssl ***/
  604. user_pref("browser.cache.disk_cache_ssl", false);
  605. /* 1003: disable memory cache
  606. * [NOTE] Not recommended due to performance issues ***/
  607. // user_pref("browser.cache.memory.enable", false);
  608. // user_pref("browser.cache.memory.capacity", 0); // [HIDDEN PREF]
  609. /* 1005: disable fastback cache
  610. * To improve performance when pressing back/forward Firefox stores visited pages
  611. * so they don't have to be re-parsed. This is not the same as memory cache.
  612. * 0=none, -1=auto (that's minus 1), or for other values see [1]
  613. * [WARNING] Not recommended unless you know what you're doing
  614. * [1] http://kb.mozillazine.org/Browser.sessionhistory.max_total_viewers ***/
  615. // user_pref("browser.sessionhistory.max_total_viewers", 0);
  616. /* 1006: disable permissions manager from writing to disk [RESTART]
  617. * [NOTE] This means any permission changes are session only
  618. * [1] https://bugzilla.mozilla.org/967812 ***/
  619. // user_pref("permissions.memory_only", true); // [HIDDEN PREF]
  620. /* 1008: set DNS cache and expiration time (default 400 and 60, same as Tor Browser) ***/
  621. // user_pref("network.dnsCacheEntries", 400);
  622. // user_pref("network.dnsCacheExpiration", 60);
  623. /** SESSIONS & SESSION RESTORE ***/
  624. /* 1020: exclude "Undo Closed Tabs" in Session Restore ***/
  625. // user_pref("browser.sessionstore.max_tabs_undo", 0);
  626. /* 1021: disable storing extra session data [SETUP-CHROME]
  627. * extra session data contains contents of forms, scrollbar positions, cookies and POST data
  628. * define on which sites to save extra session data:
  629. * 0=everywhere, 1=unencrypted sites, 2=nowhere ***/
  630. user_pref("browser.sessionstore.privacy_level", 2);
  631. /* 1022: disable resuming session from crash ***/
  632. // user_pref("browser.sessionstore.resume_from_crash", false);
  633. /* 1023: set the minimum interval between session save operations
  634. * Increasing this can help on older machines and some websites, as well as reducing writes, see [1]
  635. * Default is 15000 (15 secs). Try 30000 (30 secs), 60000 (1 min) etc
  636. * [SETUP-CHROME] This can also affect entries in the "Recently Closed Tabs" feature:
  637. * i.e. the longer the interval the more chance a quick tab open/close won't be captured.
  638. * This longer interval *may* affect history but we cannot replicate any history not recorded
  639. * [1] https://bugzilla.mozilla.org/1304389 ***/
  640. user_pref("browser.sessionstore.interval", 30000);
  641. /* 1024: disable automatic Firefox start and session restore after reboot [FF62+] [WINDOWS]
  642. * [1] https://bugzilla.mozilla.org/603903 ***/
  643. user_pref("toolkit.winRegisterApplicationRestart", false);
  644. /** FAVICONS ***/
  645. /* 1030: disable favicons in shortcuts
  646. * URL shortcuts use a cached randomly named .ico file which is stored in your
  647. * profile/shortcutCache directory. The .ico remains after the shortcut is deleted.
  648. * If set to false then the shortcuts use a generic Firefox icon ***/
  649. user_pref("browser.shell.shortcutFavicons", false);
  650. /* 1031: disable favicons in tabs and new bookmarks
  651. * bookmark favicons are stored as data blobs in favicons.sqlite ***/
  652. // user_pref("browser.chrome.site_icons", false);
  653. /* 1032: disable favicons in web notifications ***/
  654. user_pref("alerts.showFavicons", false); // [DEFAULT: false]
  655. /*** [SECTION 1200]: HTTPS (SSL/TLS / OCSP / CERTS / HPKP / CIPHERS)
  656. Note that your cipher and other settings can be used server side as a fingerprint attack
  657. vector, see [1] (It's quite technical but the first part is easy to understand
  658. and you can stop reading when you reach the second section titled "Enter Bro")
  659. Option 1: Use defaults for ciphers (1260's). There is nothing *weak* about these, but
  660. due to breakage, browsers can't deprecate them until the web stops using them
  661. Option 2: Disable the ciphers in 1261, 1262 and 1263. These shouldn't break anything.
  662. Optionally, disable the ciphers in 1264.
  663. [1] https://www.securityartwork.es/2017/02/02/tls-client-fingerprinting-with-bro/
  664. ***/
  665. user_pref("_user.js.parrot", "1200 syntax error: the parrot's a stiff!");
  666. /** SSL (Secure Sockets Layer) / TLS (Transport Layer Security) ***/
  667. /* 1201: disable old SSL/TLS "insecure" renegotiation (vulnerable to a MiTM attack)
  668. * [SETUP-WEB] <2% of secure sites do NOT support the newer "secure" renegotiation, see [2]
  669. * [1] https://wiki.mozilla.org/Security:Renegotiation
  670. * [2] https://www.ssllabs.com/ssl-pulse/ ***/
  671. user_pref("security.ssl.require_safe_negotiation", true);
  672. /* 1202: control TLS versions with min and max
  673. * 1=TLS 1.0, 2=TLS 1.1, 3=TLS 1.2, 4=TLS 1.3
  674. * [NOTE] Jul-2017: Telemetry indicates approx 2% of TLS web traffic uses 1.0 or 1.1
  675. * [1] http://kb.mozillazine.org/Security.tls.version.*
  676. * [2] https://www.ssl.com/how-to/turn-off-ssl-3-0-and-tls-1-0-in-your-browser/
  677. * [2] archived: https://archive.is/hY2Mm ***/
  678. // user_pref("security.tls.version.min", 3);
  679. user_pref("security.tls.version.max", 4);
  680. /* 1203: disable SSL session tracking [FF36+]
  681. * SSL Session IDs are unique, last up to 24hrs in Firefox, and can be used for tracking
  682. * [SETUP-PERF] Relax this if you have FPI enabled (see 4000) *AND* you understand the
  683. * consequences. FPI isolates these, but it was designed with the Tor protocol in mind,
  684. * and the Tor Browser has extra protection, including enhanced sanitizing per Identity.
  685. * [1] https://tools.ietf.org/html/rfc5077
  686. * [2] https://bugzilla.mozilla.org/967977
  687. * [3] https://arxiv.org/abs/1810.07304 ***/
  688. user_pref("security.ssl.disable_session_identifiers", true); // [HIDDEN PREF]
  689. /* 1204: disable SSL Error Reporting
  690. * [1] https://firefox-source-docs.mozilla.org/browser/base/sslerrorreport/preferences.html ***/
  691. user_pref("security.ssl.errorReporting.automatic", false);
  692. user_pref("security.ssl.errorReporting.enabled", false);
  693. user_pref("security.ssl.errorReporting.url", "");
  694. /* 1205: disable TLS1.3 0-RTT (round-trip time) [FF51+]
  695. * [1] https://github.com/tlswg/tls13-spec/issues/1001
  696. * [2] https://blog.cloudflare.com/tls-1-3-overview-and-q-and-a/ ***/
  697. user_pref("security.tls.enable_0rtt_data", false);
  698. /** OCSP (Online Certificate Status Protocol)
  699. #Required reading [#] https://scotthelme.co.uk/revocation-is-broken/ ***/
  700. /* 1210: enable OCSP Stapling
  701. * [1] https://blog.mozilla.org/security/2013/07/29/ocsp-stapling-in-firefox/ ***/
  702. user_pref("security.ssl.enable_ocsp_stapling", true);
  703. /* 1211: control when to use OCSP fetching (to confirm current validity of certificates)
  704. * 0=disabled, 1=enabled (default), 2=enabled for EV certificates only
  705. * OCSP (non-stapled) leaks information about the sites you visit to the CA (cert authority)
  706. * It's a trade-off between security (checking) and privacy (leaking info to the CA)
  707. * [NOTE] This pref only controls OCSP fetching and does not affect OCSP stapling
  708. * [1] https://en.wikipedia.org/wiki/Ocsp ***/
  709. user_pref("security.OCSP.enabled", 1);
  710. /* 1212: set OCSP fetch failures (non-stapled, see 1211) to hard-fail [SETUP-WEB]
  711. * When a CA cannot be reached to validate a cert, Firefox just continues the connection (=soft-fail)
  712. * Setting this pref to true tells Firefox to instead terminate the connection (=hard-fail)
  713. * It is pointless to soft-fail when an OCSP fetch fails: you cannot confirm a cert is still valid (it
  714. * could have been revoked) and/or you could be under attack (e.g. malicious blocking of OCSP servers)
  715. * [1] https://blog.mozilla.org/security/2013/07/29/ocsp-stapling-in-firefox/
  716. * [2] https://www.imperialviolet.org/2014/04/19/revchecking.html ***/
  717. user_pref("security.OCSP.require", true);
  718. /** CERTS / HPKP (HTTP Public Key Pinning) ***/
  719. /* 1220: disable or limit SHA-1 certificates
  720. * 0=all SHA1 certs are allowed
  721. * 1=all SHA1 certs are blocked
  722. * 2=deprecated option that now maps to 1
  723. * 3=only allowed for locally-added roots (e.g. anti-virus)
  724. * 4=only allowed for locally-added roots or for certs in 2015 and earlier
  725. * [SETUP-CHROME] When disabled, some man-in-the-middle devices (e.g. security scanners and
  726. * antivirus products, may fail to connect to HTTPS sites. SHA-1 is *almost* obsolete.
  727. * [1] https://blog.mozilla.org/security/2016/10/18/phasing-out-sha-1-on-the-public-web/ ***/
  728. user_pref("security.pki.sha1_enforcement_level", 1);
  729. /* 1221: disable Windows 8.1's Microsoft Family Safety cert [FF50+] [WINDOWS]
  730. * 0=disable detecting Family Safety mode and importing the root
  731. * 1=only attempt to detect Family Safety mode (don't import the root)
  732. * 2=detect Family Safety mode and import the root
  733. * [1] https://trac.torproject.org/projects/tor/ticket/21686 ***/
  734. user_pref("security.family_safety.mode", 0);
  735. /* 1222: disable intermediate certificate caching (fingerprinting attack vector) [RESTART]
  736. * [NOTE] This affects login/cert/key dbs. The effect is all credentials are session-only.
  737. * Saved logins and passwords are not available. Reset the pref and restart to return them.
  738. * [TEST] https://fiprinca.0x90.eu/poc/
  739. * [1] https://bugzilla.mozilla.org/1334485 - related bug
  740. * [2] https://bugzilla.mozilla.org/1216882 - related bug (see comment 9) ***/
  741. // user_pref("security.nocertdb", true); // [HIDDEN PREF]
  742. /* 1223: enforce strict pinning
  743. * PKP (Public Key Pinning) 0=disabled 1=allow user MiTM (such as your antivirus), 2=strict
  744. * [WARNING] If you rely on an AV (antivirus) to protect your web browsing
  745. * by inspecting ALL your web traffic, then leave at current default=1
  746. * [1] https://trac.torproject.org/projects/tor/ticket/16206 ***/
  747. user_pref("security.cert_pinning.enforcement_level", 2);
  748. /** MIXED CONTENT ***/
  749. /* 1240: disable insecure active content on https pages
  750. * [1] https://trac.torproject.org/projects/tor/ticket/21323 ***/
  751. user_pref("security.mixed_content.block_active_content", true); // [DEFAULT: true]
  752. /* 1241: disable insecure passive content (such as images) on https pages [SETUP-WEB] ***/
  753. user_pref("security.mixed_content.block_display_content", true);
  754. /* 1243: block unencrypted requests from Flash on encrypted pages to mitigate MitM attacks [FF59+]
  755. * [1] https://bugzilla.mozilla.org/1190623 ***/
  756. user_pref("security.mixed_content.block_object_subrequest", true);
  757. /** CIPHERS [see the section 1200 intro] ***/
  758. /* 1261: disable 3DES (effective key size < 128)
  759. * [1] https://en.wikipedia.org/wiki/3des#Security
  760. * [2] http://en.citizendium.org/wiki/Meet-in-the-middle_attack
  761. * [3] https://www-archive.mozilla.org/projects/security/pki/nss/ssl/fips-ssl-ciphersuites.html ***/
  762. // user_pref("security.ssl3.rsa_des_ede3_sha", false);
  763. /* 1262: disable 128 bits ***/
  764. // user_pref("security.ssl3.ecdhe_ecdsa_aes_128_sha", false);
  765. // user_pref("security.ssl3.ecdhe_rsa_aes_128_sha", false);
  766. /* 1263: disable DHE (Diffie-Hellman Key Exchange)
  767. * [1] https://www.eff.org/deeplinks/2015/10/how-to-protect-yourself-from-nsa-attacks-1024-bit-DH ***/
  768. // user_pref("security.ssl3.dhe_rsa_aes_128_sha", false);
  769. // user_pref("security.ssl3.dhe_rsa_aes_256_sha", false);
  770. /* 1264: disable the remaining non-modern cipher suites as of FF52 ***/
  771. // user_pref("security.ssl3.rsa_aes_128_sha", false);
  772. // user_pref("security.ssl3.rsa_aes_256_sha", false);
  773. /** UI (User Interface) ***/
  774. /* 1270: display warning (red padlock) for "broken security" (see 1201)
  775. * [1] https://wiki.mozilla.org/Security:Renegotiation ***/
  776. user_pref("security.ssl.treat_unsafe_negotiation_as_broken", true);
  777. /* 1271: control "Add Security Exception" dialog on SSL warnings
  778. * 0=do neither 1=pre-populate url 2=pre-populate url + pre-fetch cert (default)
  779. * [1] https://github.com/pyllyukko/user.js/issues/210 ***/
  780. user_pref("browser.ssl_override_behavior", 1);
  781. /* 1272: display advanced information on Insecure Connection warning pages
  782. * only works when it's possible to add an exception
  783. * i.e. it doesn't work for HSTS discrepancies (https://subdomain.preloaded-hsts.badssl.com/)
  784. * [TEST] https://expired.badssl.com/ ***/
  785. user_pref("browser.xul.error_pages.expert_bad_cert", true);
  786. /* 1273: display "insecure" icon and "Not Secure" text on HTTP sites ***/
  787. user_pref("security.insecure_connection_icon.enabled", true); // [FF59+]
  788. user_pref("security.insecure_connection_text.enabled", true); // [FF60+]
  789. // user_pref("security.insecure_connection_icon.pbmode.enabled", true); // [FF59+] private windows only
  790. // user_pref("security.insecure_connection_text.pbmode.enabled", true); // [FF60+] private windows only
  791. /*** [SECTION 1400]: FONTS ***/
  792. user_pref("_user.js.parrot", "1400 syntax error: the parrot's bereft of life!");
  793. /* 1401: disable websites choosing fonts (0=block, 1=allow)
  794. * [WARNING] Blocking fonts can *sometimes* reduce JS font enumeration, but not entropy.
  795. * There are also other methods to fingerprint fonts. Wait for RFP (4500) to cover this.
  796. * [SETTING] General>Language and Appearance>Fonts & Colors>Advanced>Allow pages to choose... ***/
  797. // user_pref("browser.display.use_document_fonts", 0);
  798. /* 1402: set more legible default fonts
  799. * [NOTE] Example below for Windows/Western only
  800. * [SETTING] General>Language and Appearance>Fonts & Colors>Advanced>Serif|Sans-serif|Monospace ***/
  801. // user_pref("font.name.serif.x-unicode", "Georgia");
  802. // user_pref("font.name.serif.x-western", "Georgia"); // default: Times New Roman
  803. // user_pref("font.name.sans-serif.x-unicode", "Arial");
  804. // user_pref("font.name.sans-serif.x-western", "Arial"); // default: Arial
  805. // user_pref("font.name.monospace.x-unicode", "Lucida Console");
  806. // user_pref("font.name.monospace.x-western", "Lucida Console"); // default: Courier New
  807. /* 1403: disable icon fonts (glyphs) and local fallback rendering
  808. * [1] https://bugzilla.mozilla.org/789788
  809. * [2] https://trac.torproject.org/projects/tor/ticket/8455 ***/
  810. // user_pref("gfx.downloadable_fonts.enabled", false); // [FF41+]
  811. // user_pref("gfx.downloadable_fonts.fallback_delay", -1);
  812. /* 1404: disable rendering of SVG OpenType fonts
  813. * [1] https://wiki.mozilla.org/SVGOpenTypeFonts - iSECPartnersReport recommends to disable this ***/
  814. user_pref("gfx.font_rendering.opentype_svg.enabled", false);
  815. /* 1405: disable WOFF2 (Web Open Font Format) [FF35+] ***/
  816. // user_pref("gfx.downloadable_fonts.woff2.enabled", false);
  817. /* 1406: disable CSS Font Loading API
  818. * [NOTE] Disabling fonts can uglify the web a fair bit. ***/
  819. user_pref("layout.css.font-loading-api.enabled", false);
  820. /* 1407: disable special underline handling for a few fonts which you will probably never use [RESTART]
  821. * Any of these fonts on your system can be enumerated for fingerprinting.
  822. * [1] http://kb.mozillazine.org/Font.blacklist.underline_offset ***/
  823. user_pref("font.blacklist.underline_offset", "");
  824. /* 1408: disable graphite which FF49 turned back on by default
  825. * In the past it had security issues. Update: This continues to be the case, see [1]
  826. * [1] https://www.mozilla.org/security/advisories/mfsa2017-15/#CVE-2017-7778 ***/
  827. user_pref("gfx.font_rendering.graphite.enabled", false);
  828. /* 1409: limit system font exposure to a whitelist [FF52+] [RESTART]
  829. * If the whitelist is empty, then whitelisting is considered disabled and all fonts are allowed.
  830. * [WARNING] Creating your own probably highly-unique whitelist will raise your entropy.
  831. * Eventually privacy.resistFingerprinting (see 4500) will cover this (and 1401 can be relaxed)
  832. * [1] https://bugzilla.mozilla.org/1121643 ***/
  833. // user_pref("font.system.whitelist", ""); // [HIDDEN PREF]
  834. /*** [SECTION 1600]: HEADERS / REFERERS
  835. Only *cross domain* referers need controlling and XOriginPolicy (1603) is perfect for that. Thus we enforce
  836. the default values for 1601, 1602, 1605 and 1606 to minimize breakage, and only tweak 1603 and 1604.
  837. Our default settings provide the best balance between protection and amount of breakage.
  838. To harden it a bit more you can set XOriginPolicy (1603) to 2 (+ optionally 1604 to 1 or 2).
  839. To fix broken sites (including your modem/router), temporarily set XOriginPolicy=0 and XOriginTrimmingPolicy=2 in about:config,
  840. use the site and then change the values back. If you visit those sites regularly (e.g. vimeo), use an extension.
  841. full URI: https://example.com:8888/foo/bar.html?id=1234
  842. scheme+host+port+path: https://example.com:8888/foo/bar.html
  843. scheme+host+port: https://example.com:8888
  844. #Required reading [#] https://feeding.cloud.geek.nz/posts/tweaking-referrer-for-privacy-in-firefox/
  845. ***/
  846. user_pref("_user.js.parrot", "1600 syntax error: the parrot rests in peace!");
  847. /* 1601: ALL: control when images/links send a referer
  848. * 0=never, 1=send only when links are clicked, 2=for links and images (default) ***/
  849. user_pref("network.http.sendRefererHeader", 2);
  850. /* 1602: ALL: control the amount of information to send
  851. * 0=send full URI (default), 1=scheme+host+port+path, 2=scheme+host+port ***/
  852. user_pref("network.http.referer.trimmingPolicy", 0);
  853. /* 1603: CROSS ORIGIN: control when to send a referer [SETUP-WEB]
  854. * 0=always (default), 1=only if base domains match, 2=only if hosts match ***/
  855. user_pref("network.http.referer.XOriginPolicy", 1);
  856. /* 1604: CROSS ORIGIN: control the amount of information to send [FF52+]
  857. * 0=send full URI (default), 1=scheme+host+port+path, 2=scheme+host+port ***/
  858. user_pref("network.http.referer.XOriginTrimmingPolicy", 0);
  859. /* 1605: ALL: disable spoofing a referer
  860. * [WARNING] Do not set this to true, as spoofing effectively disables the anti-CSRF
  861. * (Cross-Site Request Forgery) protections that some sites may rely on ***/
  862. user_pref("network.http.referer.spoofSource", false); // [DEFAULT: false]
  863. /* 1606: ALL: set the default Referrer Policy [FF59+]
  864. * 0=no-referer, 1=same-origin, 2=strict-origin-when-cross-origin, 3=no-referrer-when-downgrade
  865. * [NOTE] This is only a default, it can be overridden by a site-controlled Referrer Policy
  866. * [1] https://www.w3.org/TR/referrer-policy/
  867. * [2] https://developer.mozilla.org/docs/Web/HTTP/Headers/Referrer-Policy
  868. * [3] https://blog.mozilla.org/security/2018/01/31/preventing-data-leaks-by-stripping-path-information-in-http-referrers/ ***/
  869. user_pref("network.http.referer.defaultPolicy", 3); // [DEFAULT: 3]
  870. user_pref("network.http.referer.defaultPolicy.pbmode", 2); // [DEFAULT: 2]
  871. /* 1607: TOR: hide (not spoof) referrer when leaving a .onion domain [FF54+]
  872. * [NOTE] Firefox cannot access .onion sites by default. We recommend you use
  873. * the Tor Browser which is specifically designed for hidden services
  874. * [1] https://bugzilla.mozilla.org/1305144 ***/
  875. user_pref("network.http.referer.hideOnionSource", true);
  876. /* 1610: ALL: enable the DNT (Do Not Track) HTTP header
  877. * [NOTE] DNT is enforced with Tracking Protection regardless of this pref
  878. * [SETTING] Privacy & Security>Content Blocking>Send websites a "Do Not Track"... ***/
  879. user_pref("privacy.donottrackheader.enabled", true);
  880. /*** [SECTION 1700]: CONTAINERS
  881. If you want to *really* leverage containers, we highly recommend Temporary Containers [2].
  882. Read the article by the extension author [3], and check out the github wiki/repo [4].
  883. [1] https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers
  884. [2] https://addons.mozilla.org/firefox/addon/temporary-containers/
  885. [3] https://medium.com/@stoically/enhance-your-privacy-in-firefox-with-temporary-containers-33925cd6cd21
  886. [4] https://github.com/stoically/temporary-containers/wiki
  887. ***/
  888. user_pref("_user.js.parrot", "1700 syntax error: the parrot's bit the dust!");
  889. /* 1701: enable Container Tabs setting in preferences (see 1702) [FF50+]
  890. * [1] https://bugzilla.mozilla.org/1279029 ***/
  891. user_pref("privacy.userContext.ui.enabled", true);
  892. /* 1702: enable Container Tabs [FF50+]
  893. * [SETTING] General>Tabs>Enable Container Tabs ***/
  894. user_pref("privacy.userContext.enabled", true);
  895. /* 1703: enable a private container for thumbnail loads [FF51+] ***/
  896. user_pref("privacy.usercontext.about_newtab_segregation.enabled", true); // [DEFAULT: true in FF61+]
  897. /* 1704: set behaviour on "+ Tab" button to display container menu [FF53+] [SETUP-CHROME]
  898. * 0=no menu (default), 1=show when clicked, 2=show on long press
  899. * [NOTE] The menu does not contain a non-container tab option (use Ctrl+T to open non-container tab)
  900. * [1] https://bugzilla.mozilla.org/1328756 ***/
  901. user_pref("privacy.userContext.longPressBehavior", 2);
  902. /*** [SECTION 1800]: PLUGINS ***/
  903. user_pref("_user.js.parrot", "1800 syntax error: the parrot's pushing up daisies!");
  904. /* 1801: set default plugin state (i.e. new plugins on discovery) to never activate
  905. * 0=disabled, 1=ask to activate, 2=active - you can override individual plugins ***/
  906. user_pref("plugin.default.state", 0);
  907. user_pref("plugin.defaultXpi.state", 0);
  908. /* 1802: enable click to play and set to 0 minutes ***/
  909. user_pref("plugins.click_to_play", true);
  910. user_pref("plugin.sessionPermissionNow.intervalInMinutes", 0);
  911. /* 1803: disable Flash plugin (Add-ons>Plugins)
  912. * 0=deactivated, 1=ask, 2=enabled
  913. * ESR52.x is the last branch to *fully* support NPAPI, FF52+ stable only supports Flash
  914. * [NOTE] You can still override individual sites via site permissions
  915. * [1] https://www.ghacks.net/2013/07/09/how-to-make-sure-that-a-firefox-plugin-never-activates-again/ ***/
  916. user_pref("plugin.state.flash", 0);
  917. /* 1805: disable scanning for plugins [WINDOWS]
  918. * [1] http://kb.mozillazine.org/Plugin_scanning
  919. * plid.all = whether to scan the directories specified in the Windows registry for PLIDs.
  920. * Used to detect RealPlayer, Java, Antivirus etc, but since FF52 only covers Flash ***/
  921. user_pref("plugin.scan.plid.all", false);
  922. /* 1820: disable all GMP (Gecko Media Plugins) [SETUP-WEB]
  923. * [1] https://wiki.mozilla.org/GeckoMediaPlugins ***/
  924. user_pref("media.gmp-provider.enabled", false);
  925. // user_pref("media.gmp-manager.updateEnabled", false); // [HIDDEN PREF]
  926. /* 1825: disable widevine CDM (Content Decryption Module) [SETUP-WEB] ***/
  927. user_pref("media.gmp-widevinecdm.visible", false);
  928. user_pref("media.gmp-widevinecdm.enabled", false);
  929. // user_pref("media.gmp-widevinecdm.autoupdate", false);
  930. /* 1830: disable all DRM content (EME: Encryption Media Extension) [SETUP-WEB]
  931. * [SETTING] General>DRM Content>Play DRM-controlled content
  932. * [1] https://www.eff.org/deeplinks/2017/10/drms-dead-canary-how-we-just-lost-web-what-we-learned-it-and-what-we-need-do-next ***/
  933. user_pref("media.eme.enabled", false);
  934. /* 1840: disable the OpenH264 Video Codec by Cisco to "Never Activate" [SETUP-HARDEN]
  935. * This is the bundled codec used for video chat in WebRTC ***/
  936. // user_pref("media.gmp-gmpopenh264.enabled", false);
  937. // user_pref("media.gmp-gmpopenh264.autoupdate", false);
  938. /*** [SECTION 2000]: MEDIA / CAMERA / MIC ***/
  939. user_pref("_user.js.parrot", "2000 syntax error: the parrot's snuffed it!");
  940. /* 2001: disable WebRTC (Web Real-Time Communication)
  941. * [1] https://www.privacytools.io/#webrtc ***/
  942. user_pref("media.peerconnection.enabled", false);
  943. /* 2002: limit WebRTC IP leaks if using WebRTC
  944. * [TEST] https://browserleaks.com/webrtc
  945. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1189041,1297416
  946. * [2] https://wiki.mozilla.org/Media/WebRTC/Privacy ***/
  947. user_pref("media.peerconnection.ice.default_address_only", true);
  948. user_pref("media.peerconnection.ice.no_host", true); // [FF51+]
  949. /* 2010: disable WebGL (Web Graphics Library)
  950. * [1] https://www.contextis.com/resources/blog/webgl-new-dimension-browser-exploitation/
  951. * [2] https://security.stackexchange.com/questions/13799/is-webgl-a-security-concern ***/
  952. user_pref("webgl.disabled", true);
  953. user_pref("webgl.dxgl.enabled", false); // [WINDOWS]
  954. user_pref("webgl.enable-webgl2", false);
  955. /* 2012: limit WebGL ***/
  956. user_pref("webgl.min_capability_mode", true);
  957. user_pref("webgl.disable-extensions", true);
  958. user_pref("webgl.disable-fail-if-major-performance-caveat", true);
  959. /* 2022: disable screensharing ***/
  960. user_pref("media.getusermedia.screensharing.enabled", false);
  961. user_pref("media.getusermedia.browser.enabled", false);
  962. user_pref("media.getusermedia.audiocapture.enabled", false);
  963. /* 2024: set a default permission for Camera/Microphone [FF58+]
  964. * 0=always ask (default), 1=allow, 2=block
  965. * [SETTING] to add site exceptions: Page Info>Permissions>Use the Camera/Microphone
  966. * [SETTING] to manage site exceptions: Options>Privacy & Security>Permissions>Camera/Microphone>Settings ***/
  967. // user_pref("permissions.default.camera", 2);
  968. // user_pref("permissions.default.microphone", 2);
  969. /* 2027: disable camera image capture [FF35+]
  970. * [1] https://trac.torproject.org/projects/tor/ticket/16339 ***/
  971. user_pref("dom.imagecapture.enabled", false); // [DEFAULT: false]
  972. /* 2028: disable offscreen canvas [FF44+]
  973. * [1] https://developer.mozilla.org/docs/Web/API/OffscreenCanvas ***/
  974. user_pref("gfx.offscreencanvas.enabled", false); // [DEFAULT: false]
  975. /* 2030: disable autoplay of HTML5 media [FF63+]
  976. * 0=Allowed, 1=Blocked (2=Prompt - removed in FF66)
  977. * [NOTE] You can set exceptions under site permissions
  978. * [SETTING] Privacy & Security>Permissions>Block websites from automatically playing sound ***/
  979. user_pref("media.autoplay.default", 1);
  980. /* 2031: disable autoplay of HTML5 media if you interacted with the site [FF66+] ***/
  981. user_pref("media.autoplay.enabled.user-gestures-needed", false);
  982. /* 2032: disable audio autoplay in non-active tabs [FF51+]
  983. * [1] https://www.ghacks.net/2016/11/14/firefox-51-blocks-automatic-audio-playback-in-non-active-tabs/ ***/
  984. user_pref("media.block-autoplay-until-in-foreground", true);
  985. /*** [SECTION 2200]: WINDOW MEDDLING & LEAKS / POPUPS ***/
  986. user_pref("_user.js.parrot", "2200 syntax error: the parrot's 'istory!");
  987. /* 2201: prevent websites from disabling new window features
  988. * [1] http://kb.mozillazine.org/Prevent_websites_from_disabling_new_window_features ***/
  989. user_pref("dom.disable_window_open_feature.close", true);
  990. user_pref("dom.disable_window_open_feature.location", true); // [DEFAULT: true]
  991. user_pref("dom.disable_window_open_feature.menubar", true);
  992. user_pref("dom.disable_window_open_feature.minimizable", true);
  993. user_pref("dom.disable_window_open_feature.personalbar", true); // bookmarks toolbar
  994. user_pref("dom.disable_window_open_feature.resizable", true); // [DEFAULT: true]
  995. user_pref("dom.disable_window_open_feature.status", true); // [DEFAULT: true]
  996. user_pref("dom.disable_window_open_feature.titlebar", true);
  997. user_pref("dom.disable_window_open_feature.toolbar", true);
  998. /* 2202: prevent scripts from moving and resizing open windows ***/
  999. user_pref("dom.disable_window_move_resize", true);
  1000. /* 2203: open links targeting new windows in a new tab instead
  1001. * This stops malicious window sizes and some screen resolution leaks.
  1002. * You can still right-click a link and open in a new window.
  1003. * [TEST] https://people.torproject.org/~gk/misc/entire_desktop.html
  1004. * [1] https://trac.torproject.org/projects/tor/ticket/9881 ***/
  1005. user_pref("browser.link.open_newwindow", 3);
  1006. user_pref("browser.link.open_newwindow.restriction", 0);
  1007. /* 2204: disable Fullscreen API (requires user interaction) to prevent screen-resolution leaks
  1008. * [NOTE] You can still manually toggle the browser's fullscreen state (F11),
  1009. * but this pref will disable embedded video/game fullscreen controls, e.g. youtube
  1010. * [TEST] https://developer.mozilla.org/samples/domref/fullscreen.html ***/
  1011. // user_pref("full-screen-api.enabled", false);
  1012. /* 2210: block popup windows
  1013. * [SETTING] Privacy & Security>Permissions>Block pop-up windows ***/
  1014. user_pref("dom.disable_open_during_load", true);
  1015. /* 2211: set max popups from a single non-click event - default is 20! ***/
  1016. user_pref("dom.popup_maximum", 3);
  1017. /* 2212: limit events that can cause a popup [SETUP-WEB]
  1018. * default is "change click dblclick mouseup pointerup notificationclick reset submit touchend contextmenu"
  1019. * [1] http://kb.mozillazine.org/Dom.popup_allowed_events ***/
  1020. user_pref("dom.popup_allowed_events", "click dblclick");
  1021. /*** [SECTION 2300]: WEB WORKERS
  1022. A worker is a JS "background task" running in a global context, i.e. it is different from
  1023. the current window. Workers can spawn new workers (must be the same origin & scheme),
  1024. including service and shared workers. Shared workers can be utilized by multiple scripts and
  1025. communicate between browsing contexts (windows/tabs/iframes) and can even control your cache.
  1026. [NOTE] uMatrix 1.2.0+ allows a per-scope control for workers (2301-deprecated) and service workers (2302)
  1027. #Required reading [#] https://github.com/gorhill/uMatrix/releases/tag/1.2.0
  1028. [1] Web Workers: https://developer.mozilla.org/docs/Web/API/Web_Workers_API
  1029. [2] Worker: https://developer.mozilla.org/docs/Web/API/Worker
  1030. [3] Service Worker: https://developer.mozilla.org/docs/Web/API/Service_Worker_API
  1031. [4] SharedWorker: https://developer.mozilla.org/docs/Web/API/SharedWorker
  1032. [5] ChromeWorker: https://developer.mozilla.org/docs/Web/API/ChromeWorker
  1033. [6] Notifications: https://support.mozilla.org/questions/1165867#answer-981820
  1034. ***/
  1035. user_pref("_user.js.parrot", "2300 syntax error: the parrot's off the twig!");
  1036. /* 2302: disable service workers [FF32, FF44-compat]
  1037. * Service workers essentially act as proxy servers that sit between web apps, and the browser
  1038. * and network, are event driven, and can control the web page/site it is associated with,
  1039. * intercepting and modifying navigation and resource requests, and caching resources.
  1040. * [SETUP-WEB] Disabling service workers will break some sites. This pref is a master switch, and controls
  1041. * notifications (2304, 2305) and service worker cache (2740) - all three are inactive. Notifications are
  1042. * behind a prompt (2306). If you enable service workers, then you may want to look at these prefs as well.
  1043. * [NOTE] Service worker APIs are hidden (in Firefox) and cannot be used when in PB mode.
  1044. * [NOTE] Service workers only run over HTTPS. Service workers have no DOM access. ***/
  1045. user_pref("dom.serviceWorkers.enabled", false);
  1046. /* 2304: disable Web Notifications
  1047. * [NOTE] Web Notifications require service workers (2302) and are behind a prompt (2306)
  1048. * [1] https://developer.mozilla.org/docs/Web/API/Notifications_API ***/
  1049. // user_pref("dom.webnotifications.enabled", false); // [FF22+]
  1050. // user_pref("dom.webnotifications.serviceworker.enabled", false); // [FF44+]
  1051. /* 2305: disable Push Notifications [FF44+]
  1052. * web apps can receive messages pushed to them from a server, whether or
  1053. * not the web app is in the foreground, or even currently loaded
  1054. * [NOTE] Push Notifications require service workers (2302) and are behind a prompt (2306)
  1055. * [1] https://developer.mozilla.org/docs/Web/API/Push_API ***/
  1056. // user_pref("dom.push.enabled", false);
  1057. // user_pref("dom.push.connection.enabled", false);
  1058. // user_pref("dom.push.serverURL", "");
  1059. // user_pref("dom.push.userAgentID", "");
  1060. /* 2306: set a default permission for Notifications (both 2305 and 2306) [FF58+]
  1061. * 0=always ask (default), 1=allow, 2=block
  1062. * [NOTE] Best left at default "always ask", fingerprintable via Permissions API
  1063. * [SETTING] to add site exceptions: Page Info>Permissions>Receive Notifications
  1064. * [SETTING] to manage site exceptions: Options>Privacy & Security>Permissions>Notifications>Settings ***/
  1065. // user_pref("permissions.default.desktop-notification", 2);
  1066. /*** [SECTION 2400]: DOM (DOCUMENT OBJECT MODEL) & JAVASCRIPT ***/
  1067. user_pref("_user.js.parrot", "2400 syntax error: the parrot's kicked the bucket!");
  1068. /* 2401: disable website control over browser right-click context menu
  1069. * [NOTE] Shift-Right-Click will always bring up the browser right-click context menu ***/
  1070. // user_pref("dom.event.contextmenu.enabled", false);
  1071. /* 2402: disable website access to clipboard events/content
  1072. * [SETUP-WEB] This will break some sites functionality such as pasting into facebook, wordpress
  1073. * this applies to onCut, onCopy, onPaste events - i.e. you have to interact with
  1074. * the website for it to look at the clipboard
  1075. * [1] https://www.ghacks.net/2014/01/08/block-websites-reading-modifying-clipboard-contents-firefox/ ***/
  1076. user_pref("dom.event.clipboardevents.enabled", false);
  1077. /* 2403: disable clipboard commands (cut/copy) from "non-privileged" content [FF41+]
  1078. * this disables document.execCommand("cut"/"copy") to protect your clipboard
  1079. * [1] https://bugzilla.mozilla.org/1170911 ***/
  1080. user_pref("dom.allow_cut_copy", false); // [HIDDEN PREF]
  1081. /* 2404: disable "Confirm you want to leave" dialog on page close
  1082. * Does not prevent JS leaks of the page close event.
  1083. * [1] https://developer.mozilla.org/docs/Web/Events/beforeunload
  1084. * [2] https://support.mozilla.org/questions/1043508 ***/
  1085. user_pref("dom.disable_beforeunload", true);
  1086. /* 2414: disable shaking the screen ***/
  1087. user_pref("dom.vibrator.enabled", false);
  1088. /* 2420: disable asm.js [FF22+] [SETUP-PERF]
  1089. * [1] http://asmjs.org/
  1090. * [2] https://www.mozilla.org/security/advisories/mfsa2015-29/
  1091. * [3] https://www.mozilla.org/security/advisories/mfsa2015-50/
  1092. * [4] https://www.mozilla.org/security/advisories/mfsa2017-01/#CVE-2017-5375
  1093. * [5] https://www.mozilla.org/security/advisories/mfsa2017-05/#CVE-2017-5400
  1094. * [6] https://rh0dev.github.io/blog/2017/the-return-of-the-jit/ ***/
  1095. user_pref("javascript.options.asmjs", false);
  1096. /* 2421: disable Ion and baseline JIT to help harden JS against exploits
  1097. * [WARNING] If false, causes the odd site issue and there is also a performance loss
  1098. * [1] https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-0817 ***/
  1099. // user_pref("javascript.options.ion", false);
  1100. // user_pref("javascript.options.baselinejit", false);
  1101. /* 2422: disable WebAssembly [FF52+] [SETUP-PERF]
  1102. * [1] https://developer.mozilla.org/docs/WebAssembly ***/
  1103. user_pref("javascript.options.wasm", false);
  1104. /* 2426: disable Intersection Observer API [FF53+]
  1105. * Almost a year to complete, three versions late to stable (as default false),
  1106. * number #1 cause of crashes in nightly numerous times, and is (primarily) an
  1107. * ad network API for "ad viewability checks" down to a pixel level
  1108. * [1] https://developer.mozilla.org/docs/Web/API/Intersection_Observer_API
  1109. * [2] https://w3c.github.io/IntersectionObserver/
  1110. * [3] https://bugzilla.mozilla.org/1243846 ***/
  1111. user_pref("dom.IntersectionObserver.enabled", false);
  1112. /* 2427: disable Shared Memory (Spectre mitigation)
  1113. * [1] https://github.com/tc39/ecmascript_sharedmem/blob/master/TUTORIAL.md
  1114. * [2] https://blog.mozilla.org/security/2018/01/03/mitigations-landing-new-class-timing-attack/ ***/
  1115. user_pref("javascript.options.shared_memory", false);
  1116. /* 2428: enforce DOMHighResTimeStamp API
  1117. * [WARNING] Required for normalization of timestamps and any timer resolution mitigations ***/
  1118. user_pref("dom.event.highrestimestamp.enabled", true); // [DEFAULT: true]
  1119. /* 2429: enable (limited but sufficient) window.opener protection [FF65+]
  1120. * Makes rel=noopener implicit for target=_blank in anchor and area elements when no rel attribute is set ***/
  1121. user_pref("dom.targetBlankNoOpener.enabled", true); // [DEFAULT: true]
  1122. /*** [SECTION 2500]: HARDWARE FINGERPRINTING ***/
  1123. user_pref("_user.js.parrot", "2500 syntax error: the parrot's shuffled off 'is mortal coil!");
  1124. /* 2502: disable Battery Status API
  1125. * Initially a Linux issue (high precision readout) that was fixed.
  1126. * However, it is still another metric for fingerprinting, used to raise entropy.
  1127. * e.g. do you have a battery or not, current charging status, charge level, times remaining etc
  1128. * [NOTE] From FF52+ Battery Status API is only available in chrome/privileged code. see [1]
  1129. * [1] https://bugzilla.mozilla.org/1313580 ***/
  1130. // user_pref("dom.battery.enabled", false);
  1131. /* 2504: disable virtual reality devices
  1132. * Optional protection depending on your connected devices
  1133. * [1] https://developer.mozilla.org/docs/Web/API/WebVR_API ***/
  1134. // user_pref("dom.vr.enabled", false);
  1135. /* 2505: disable media device enumeration [FF29+]
  1136. * [NOTE] media.peerconnection.enabled should also be set to false (see 2001)
  1137. * [1] https://wiki.mozilla.org/Media/getUserMedia
  1138. * [2] https://developer.mozilla.org/docs/Web/API/MediaDevices/enumerateDevices ***/
  1139. user_pref("media.navigator.enabled", false);
  1140. /* 2508: disable hardware acceleration to reduce graphics fingerprinting [SETUP-HARDEN]
  1141. * [WARNING] Affects text rendering (fonts will look different), impacts video performance,
  1142. * and parts of Quantum that utilize the GPU will also be affected as they are rolled out
  1143. * [SETTING] General>Performance>Custom>Use hardware acceleration when available
  1144. * [1] https://wiki.mozilla.org/Platform/GFX/HardwareAcceleration ***/
  1145. // user_pref("gfx.direct2d.disabled", true); // [WINDOWS]
  1146. // user_pref("layers.acceleration.disabled", true);
  1147. /* 2510: disable Web Audio API [FF51+]
  1148. * [1] https://bugzilla.mozilla.org/1288359 ***/
  1149. user_pref("dom.webaudio.enabled", false);
  1150. /* 2517: disable Media Capabilities API [FF63+]
  1151. * [WARNING] This *may* affect media performance if disabled, no one is sure
  1152. * [1] https://github.com/WICG/media-capabilities
  1153. * [2] https://wicg.github.io/media-capabilities/#security-privacy-considerations ***/
  1154. // user_pref("media.media-capabilities.enabled", false);
  1155. /*** [SECTION 2600]: MISCELLANEOUS ***/
  1156. user_pref("_user.js.parrot", "2600 syntax error: the parrot's run down the curtain!");
  1157. /* 2601: prevent accessibility services from accessing your browser [RESTART]
  1158. * [SETTING] Privacy & Security>Permissions>Prevent accessibility services from accessing your browser
  1159. * [1] https://support.mozilla.org/kb/accessibility-services ***/
  1160. user_pref("accessibility.force_disabled", 1);
  1161. /* 2602: disable sending additional analytics to web servers
  1162. * [1] https://developer.mozilla.org/docs/Web/API/Navigator/sendBeacon ***/
  1163. user_pref("beacon.enabled", false);
  1164. /* 2603: remove temp files opened with an external application
  1165. * [1] https://bugzilla.mozilla.org/302433 ***/
  1166. user_pref("browser.helperApps.deleteTempFileOnExit", true);
  1167. /* 2604: disable page thumbnail collection
  1168. * look in profile/thumbnails directory - you may want to clean that out ***/
  1169. user_pref("browser.pagethumbnails.capturing_disabled", true); // [HIDDEN PREF]
  1170. /* 2605: block web content in file processes [FF55+]
  1171. * [SETUP-WEB] You may want to disable this for corporate or developer environments
  1172. * [1] https://bugzilla.mozilla.org/1343184 ***/
  1173. user_pref("browser.tabs.remote.allowLinkedWebInFileUriProcess", false);
  1174. /* 2606: disable UITour backend so there is no chance that a remote page can use it ***/
  1175. user_pref("browser.uitour.enabled", false);
  1176. user_pref("browser.uitour.url", "");
  1177. /* 2607: disable various developer tools in browser context
  1178. * [SETTING] Devtools>Advanced Settings>Enable browser chrome and add-on debugging toolboxes
  1179. * [1] https://github.com/pyllyukko/user.js/issues/179#issuecomment-246468676 ***/
  1180. user_pref("devtools.chrome.enabled", false);
  1181. /* 2608: disable WebIDE to prevent remote debugging and ADB extension download
  1182. * [1] https://trac.torproject.org/projects/tor/ticket/16222 ***/
  1183. user_pref("devtools.debugger.remote-enabled", false);
  1184. user_pref("devtools.webide.enabled", false);
  1185. user_pref("devtools.webide.autoinstallADBExtension", false); // [FF64+]
  1186. /* 2609: disable MathML (Mathematical Markup Language) [FF51+] [SETUP-HARDEN]
  1187. * [TEST] https://ghacksuserjs.github.io/TorZillaPrint/TorZillaPrint.html#misc
  1188. * [1] https://bugzilla.mozilla.org/1173199 ***/
  1189. // user_pref("mathml.disabled", true);
  1190. /* 2610: disable in-content SVG (Scalable Vector Graphics) [FF53+]
  1191. * [WARNING] Expect breakage incl. youtube player controls. Best left for a "hardened" profile.
  1192. * [1] https://bugzilla.mozilla.org/1216893 ***/
  1193. // user_pref("svg.disabled", true);
  1194. /* 2611: disable middle mouse click opening links from clipboard
  1195. * [1] https://trac.torproject.org/projects/tor/ticket/10089
  1196. * [2] http://kb.mozillazine.org/Middlemouse.contentLoadURL ***/
  1197. user_pref("middlemouse.contentLoadURL", false);
  1198. /* 2614: limit HTTP redirects (this does not control redirects with HTML meta tags or JS)
  1199. * [NOTE] A low setting of 5 or under will probably break some sites (e.g. gmail logins)
  1200. * To control HTML Meta tag and JS redirects, use an extension. Default is 20 ***/
  1201. user_pref("network.http.redirection-limit", 10);
  1202. /* 2615: disable websites overriding Firefox's keyboard shortcuts [FF58+]
  1203. * 0 (default) or 1=allow, 2=block
  1204. * [NOTE] In FF65 and under, causes issues with delete and backspace keys (see 1445942)
  1205. * [SETTING] to add site exceptions: Page Info>Permissions>Override Keyboard Shortcuts ***/
  1206. // user_pref("permissions.default.shortcuts", 2);
  1207. /* 2616: remove special permissions for certain mozilla domains [FF35+]
  1208. * [1] resource://app/defaults/permissions ***/
  1209. user_pref("permissions.manager.defaultsUrl", "");
  1210. /* 2617: remove webchannel whitelist ***/
  1211. user_pref("webchannel.allowObject.urlWhitelist", "");
  1212. /* 2618: disable exposure of system colors to CSS or canvas [FF44+]
  1213. * [NOTE] See second listed bug: may cause black on black for elements with undefined colors
  1214. * [SETUP-CHROME] Might affect CSS in themes and extensions
  1215. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=232227,1330876 ***/
  1216. user_pref("ui.use_standins_for_native_colors", true);
  1217. /* 2619: enforce Punycode for Internationalized Domain Names to eliminate possible spoofing
  1218. * Firefox has *some* protections, but it is better to be safe than sorry. The downside: it will also
  1219. * display legitimate IDN's punycoded, which might be undesirable for users of non-latin alphabets
  1220. * [TEST] https://www.xn--80ak6aa92e.com/ (www.apple.com)
  1221. * [1] https://wiki.mozilla.org/IDN_Display_Algorithm
  1222. * [2] https://en.wikipedia.org/wiki/IDN_homograph_attack
  1223. * [3] CVE-2017-5383: https://www.mozilla.org/security/advisories/mfsa2017-02/
  1224. * [4] https://www.xudongz.com/blog/2017/idn-phishing/ ***/
  1225. user_pref("network.IDN_show_punycode", true);
  1226. /* 2620: enable Firefox's built-in PDF reader [SETUP-CHROME]
  1227. * This setting controls if the option "Display in Firefox" is available in the setting below
  1228. * and by effect controls whether PDFs are handled in-browser or externally ("Ask" or "Open With")
  1229. * PROS: pdfjs is lightweight, open source, and as secure/vetted as any pdf reader out there (more than most)
  1230. * Exploits are rare (1 serious case in 4 yrs), treated seriously and patched quickly.
  1231. * It doesn't break "state separation" of browser content (by not sharing with OS, independent apps).
  1232. * It maintains disk avoidance and application data isolation. It's convenient. You can still save to disk.
  1233. * CONS: You may prefer a different pdf reader for security reasons
  1234. * CAVEAT: JS can still force a pdf to open in-browser by bundling its own code (rare)
  1235. * [SETTING] General>Applications>Portable Document Format (PDF) ***/
  1236. user_pref("pdfjs.disabled", false); // [DEFAULT: false]
  1237. /* 2621: disable links launching Windows Store on Windows 8/8.1/10 [WINDOWS]
  1238. * [1] https://www.ghacks.net/2016/03/25/block-firefox-chrome-windows-store/ ***/
  1239. user_pref("network.protocol-handler.external.ms-windows-store", false);
  1240. /** DOWNLOADS ***/
  1241. /* 2650: discourage downloading to desktop
  1242. * 0=desktop 1=downloads 2=last used
  1243. * [SETTING] To set your default "downloads": General>Downloads>Save files to ***/
  1244. // user_pref("browser.download.folderList", 2);
  1245. /* 2651: enforce user interaction for security by always asking where to download [SETUP-CHROME]
  1246. * [SETTING] General>Downloads>Always ask you where to save files ***/
  1247. user_pref("browser.download.useDownloadDir", false);
  1248. /* 2652: disable adding downloads to the system's "recent documents" list ***/
  1249. user_pref("browser.download.manager.addToRecentDocs", false);
  1250. /* 2653: disable hiding mime types (Options>General>Applications) not associated with a plugin ***/
  1251. user_pref("browser.download.hide_plugins_without_extensions", false);
  1252. /* 2654: disable "open with" in download dialog [FF50+] [SETUP-HARDEN]
  1253. * This is very useful to enable when the browser is sandboxed (e.g. via AppArmor)
  1254. * in such a way that it is forbidden to run external applications.
  1255. * [WARNING] This may interfere with some users' workflow or methods
  1256. * [1] https://bugzilla.mozilla.org/1281959 ***/
  1257. // user_pref("browser.download.forbid_open_with", true);
  1258. /** EXTENSIONS ***/
  1259. /* 2660: lock down allowed extension directories
  1260. * [SETUP-CHROME] This will break extensions, language packs, themes and any other XPI files which are
  1261. * installed outside of profile directories (see GitHub issue #674 for an issue with language packs in Linux)
  1262. * [1] https://mike.kaply.com/2012/02/21/understanding-add-on-scopes/
  1263. * [1] archived: https://archive.is/DYjAM ***/
  1264. user_pref("extensions.enabledScopes", 1); // [HIDDEN PREF]
  1265. user_pref("extensions.autoDisableScopes", 15);
  1266. /* 2662: disable webextension restrictions on certain mozilla domains (also see 4503) [FF60+]
  1267. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1384330,1406795,1415644,1453988 ***/
  1268. // user_pref("extensions.webextensions.restrictedDomains", "");
  1269. /* 2663: enable warning when websites try to install add-ons
  1270. * [SETTING] Privacy & Security>Permissions>Warn you when websites try to install add-ons ***/
  1271. user_pref("xpinstall.whitelist.required", true); // [DEFAULT: true]
  1272. /** SECURITY ***/
  1273. /* 2680: enable CSP (Content Security Policy)
  1274. * [1] https://developer.mozilla.org/docs/Web/HTTP/CSP ***/
  1275. user_pref("security.csp.enable", true); // [DEFAULT: true]
  1276. /* 2682: enable CSP 1.1 experimental hash-source directive [FF29+]
  1277. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=855326,883975 ***/
  1278. user_pref("security.csp.experimentalEnabled", true);
  1279. /* 2683: block top level window data: URIs [FF56+]
  1280. * [1] https://bugzilla.mozilla.org/1331351
  1281. * [2] https://www.wordfence.com/blog/2017/01/gmail-phishing-data-uri/
  1282. * [3] https://www.fxsitecompat.com/en-CA/docs/2017/data-url-navigations-on-top-level-window-will-be-blocked/ ***/
  1283. user_pref("security.data_uri.block_toplevel_data_uri_navigations", true); // [DEFAULT: true]
  1284. /* 2684: enforce a security delay on some confirmation dialogs such as install, open/save
  1285. * [1] http://kb.mozillazine.org/Disable_extension_install_delay_-_Firefox
  1286. * [2] https://www.squarefree.com/2004/07/01/race-conditions-in-security-dialogs/ ***/
  1287. user_pref("security.dialog_enable_delay", 700);
  1288. /*** [SECTION 2700]: PERSISTENT STORAGE
  1289. Data SET by websites including
  1290. cookies : profile\cookies.sqlite
  1291. localStorage : profile\webappsstore.sqlite
  1292. indexedDB : profile\storage\default
  1293. appCache : profile\OfflineCache
  1294. serviceWorkers :
  1295. [NOTE] indexedDB and serviceWorkers are not available in Private Browsing Mode
  1296. [NOTE] Blocking cookies also blocks websites access to: localStorage (incl. sessionStorage),
  1297. indexedDB, sharedWorker, and serviceWorker (and therefore service worker cache and notifications)
  1298. If you set a site exception for cookies (either "Allow" or "Allow for Session") then they become
  1299. accessible to websites except shared/service workers where the cookie setting *must* be "Allow"
  1300. ***/
  1301. user_pref("_user.js.parrot", "2700 syntax error: the parrot's joined the bleedin' choir invisible!");
  1302. /* 2701: disable 3rd-party cookies and site-data [SETUP-WEB]
  1303. * 0=Accept cookies and site data (default), 1=(Block) All third-party cookies, 2=(Block) All cookies,
  1304. * 3=(Block) Cookies from unvisited sites, 4=(Block) Third-party trackers (FF63+)
  1305. * [NOTE] Value 4 is tied to the Tracking Protection lists
  1306. * [NOTE] You can set exceptions under site permissions or use an extension
  1307. * [SETTING] Privacy & Security>Content Blocking>Custom>Choose what to block>Cookies ***/
  1308. user_pref("network.cookie.cookieBehavior", 1);
  1309. /* 2702: set third-party cookies (i.e ALL) (if enabled, see 2701) to session-only
  1310. and (FF58+) set third-party non-secure (i.e HTTP) cookies to session-only
  1311. [NOTE] .sessionOnly overrides .nonsecureSessionOnly except when .sessionOnly=false and
  1312. .nonsecureSessionOnly=true. This allows you to keep HTTPS cookies, but session-only HTTP ones
  1313. * [1] https://feeding.cloud.geek.nz/posts/tweaking-cookies-for-privacy-in-firefox/
  1314. * [2] http://kb.mozillazine.org/Network.cookie.thirdparty.sessionOnly ***/
  1315. user_pref("network.cookie.thirdparty.sessionOnly", true);
  1316. user_pref("network.cookie.thirdparty.nonsecureSessionOnly", true); // [FF58+]
  1317. /* 2703: delete cookies and site data on close
  1318. * 0=keep until they expire (default), 2=keep until you close Firefox
  1319. * [NOTE] The setting below is disabled (but not changed) if you block all cookies (2701 = 2)
  1320. * [SETTING] Privacy & Security>Cookies and Site Data>Delete cookies and site data when Firefox is closed ***/
  1321. // user_pref("network.cookie.lifetimePolicy", 2);
  1322. /* 2705: disable HTTP sites setting cookies with the "secure" directive [FF52+]
  1323. * [1] https://developer.mozilla.org/Firefox/Releases/52#HTTP ***/
  1324. user_pref("network.cookie.leave-secure-alone", true); // [DEFAULT: true]
  1325. /* 2706: enable support for same-site cookies [FF60+]
  1326. * [1] https://bugzilla.mozilla.org/795346
  1327. * [2] https://blog.mozilla.org/security/2018/04/24/same-site-cookies-in-firefox-60/
  1328. * [3] https://www.sjoerdlangkemper.nl/2016/04/14/preventing-csrf-with-samesite-cookie-attribute/ ***/
  1329. // user_pref("network.cookie.same-site.enabled", true); // [DEFAULT: true]
  1330. /* 2710: disable DOM (Document Object Model) Storage
  1331. * [WARNING] This will break a LOT of sites' functionality AND extensions!
  1332. * You are better off using an extension for more granular control ***/
  1333. // user_pref("dom.storage.enabled", false);
  1334. /* 2720: enforce IndexedDB (IDB) as enabled
  1335. * IDB is required for extensions and Firefox internals (even before FF63 in [1])
  1336. * To control *website* IDB data, control allowing cookies and service workers, or use
  1337. * Temporary Containers. To mitigate *website* IDB, FPI helps (4001), and/or sanitize
  1338. * on close (Offline Website Data, see 2800) or on-demand (Ctrl-Shift-Del), or automatically
  1339. * via an extension. Note that IDB currently cannot be sanitized by host.
  1340. * [1] https://blog.mozilla.org/addons/2018/08/03/new-backend-for-storage-local-api/ ***/
  1341. user_pref("dom.indexedDB.enabled", true); // [DEFAULT: true]
  1342. /* 2730: disable offline cache ***/
  1343. user_pref("browser.cache.offline.enable", false);
  1344. /* 2730b: disable offline cache on insecure sites [FF60+]
  1345. * [1] https://blog.mozilla.org/security/2018/02/12/restricting-appcache-secure-contexts/ ***/
  1346. user_pref("browser.cache.offline.insecure.enable", false); // [DEFAULT: false in FF62+]
  1347. /* 2731: enforce websites to ask to store data for offline use
  1348. * [1] https://support.mozilla.org/questions/1098540
  1349. * [2] https://bugzilla.mozilla.org/959985 ***/
  1350. user_pref("offline-apps.allow_by_default", false);
  1351. /* 2740: disable service worker cache and cache storage
  1352. * [NOTE] We clear service worker cache on exiting Firefox (see 2803)
  1353. * [1] https://w3c.github.io/ServiceWorker/#privacy ***/
  1354. // user_pref("dom.caches.enabled", false);
  1355. /* 2750: disable Storage API [FF51+]
  1356. * The API gives sites the ability to find out how much space they can use, how much
  1357. * they are already using, and even control whether or not they need to be alerted
  1358. * before the user agent disposes of site data in order to make room for other things.
  1359. * [1] https://developer.mozilla.org/docs/Web/API/StorageManager
  1360. * [2] https://developer.mozilla.org/docs/Web/API/Storage_API
  1361. * [3] https://blog.mozilla.org/l10n/2017/03/07/firefox-l10n-report-aurora-54/ ***/
  1362. // user_pref("dom.storageManager.enabled", false);
  1363. /* 2755: disable Storage Access API [FF65+]
  1364. * [1] https://developer.mozilla.org/en-US/docs/Web/API/Storage_Access_API ***/
  1365. // user_pref("dom.storage_access.enabled", false);
  1366. /*** [SECTION 2800]: SHUTDOWN
  1367. You should set the values to what suits you best.
  1368. - "Offline Website Data" includes appCache (2730), localStorage (2710),
  1369. service worker cache (2740), and QuotaManager (IndexedDB (2720), asm-cache)
  1370. - In both 2803 + 2804, the 'download' and 'history' prefs are combined in the
  1371. Firefox interface as "Browsing & Download History" and their values will be synced
  1372. ***/
  1373. user_pref("_user.js.parrot", "2800 syntax error: the parrot's bleedin' demised!");
  1374. /* 2802: enable Firefox to clear items on shutdown (see 2803)
  1375. * [SETTING] Privacy & Security>History>Custom Settings>Clear history when Firefox closes ***/
  1376. user_pref("privacy.sanitize.sanitizeOnShutdown", true);
  1377. /* 2803: set what items to clear on shutdown (if 2802 is true) [SETUP-CHROME]
  1378. * [NOTE] If 'history' is true, downloads will also be cleared regardless of the value
  1379. * but if 'history' is false, downloads can still be cleared independently
  1380. * However, this may not always be the case. The interface combines and syncs these
  1381. * prefs when set from there, and the sanitize code may change at any time
  1382. * [SETTING] Privacy & Security>History>Custom Settings>Clear history when Firefox closes>Settings ***/
  1383. user_pref("privacy.clearOnShutdown.cache", true);
  1384. user_pref("privacy.clearOnShutdown.cookies", true);
  1385. user_pref("privacy.clearOnShutdown.downloads", true); // see note above
  1386. user_pref("privacy.clearOnShutdown.formdata", true); // Form & Search History
  1387. user_pref("privacy.clearOnShutdown.history", true); // Browsing & Download History
  1388. user_pref("privacy.clearOnShutdown.offlineApps", true); // Offline Website Data
  1389. user_pref("privacy.clearOnShutdown.sessions", true); // Active Logins
  1390. user_pref("privacy.clearOnShutdown.siteSettings", false); // Site Preferences
  1391. /* 2804: reset default items to clear with Ctrl-Shift-Del (to match 2803) [SETUP-CHROME]
  1392. * This dialog can also be accessed from the menu History>Clear Recent History
  1393. * Firefox remembers your last choices. This will reset them when you start Firefox.
  1394. * [NOTE] Regardless of what you set privacy.cpd.downloads to, as soon as the dialog
  1395. * for "Clear Recent History" is opened, it is synced to the same as 'history' ***/
  1396. user_pref("privacy.cpd.cache", true);
  1397. user_pref("privacy.cpd.cookies", true);
  1398. // user_pref("privacy.cpd.downloads", true); // not used, see note above
  1399. user_pref("privacy.cpd.formdata", true); // Form & Search History
  1400. user_pref("privacy.cpd.history", true); // Browsing & Download History
  1401. user_pref("privacy.cpd.offlineApps", true); // Offline Website Data
  1402. user_pref("privacy.cpd.passwords", false); // this is not listed
  1403. user_pref("privacy.cpd.sessions", true); // Active Logins
  1404. user_pref("privacy.cpd.siteSettings", false); // Site Preferences
  1405. /* 2805: privacy.*.openWindows (clear session restore data) [FF34+]
  1406. * [NOTE] There is a years-old bug that these cause two windows when Firefox restarts.
  1407. * You do not need these anyway if session restore is cleared with history (see 2803) ***/
  1408. // user_pref("privacy.clearOnShutdown.openWindows", true);
  1409. // user_pref("privacy.cpd.openWindows", true);
  1410. /* 2806: reset default 'Time range to clear' for 'Clear Recent History' (see 2804)
  1411. * Firefox remembers your last choice. This will reset the value when you start Firefox.
  1412. * 0=everything, 1=last hour, 2=last two hours, 3=last four hours,
  1413. * 4=today, 5=last five minutes, 6=last twenty-four hours
  1414. * [NOTE] The values 5 + 6 are not listed in the dropdown, which will display a
  1415. * blank value if they are used, but they do work as advertised ***/
  1416. user_pref("privacy.sanitize.timeSpan", 0);
  1417. /*** [SECTION 4000]: FPI (FIRST PARTY ISOLATION)
  1418. ** 1278037 - isolate indexedDB (FF51+)
  1419. ** 1277803 - isolate favicons (FF52+)
  1420. ** 1264562 - isolate OCSP cache (FF52+)
  1421. ** 1268726 - isolate Shared Workers (FF52+)
  1422. ** 1316283 - isolate SSL session cache (FF52+)
  1423. ** 1317927 - isolate media cache (FF53+)
  1424. ** 1323644 - isolate HSTS and HPKP (FF54+)
  1425. ** 1334690 - isolate HTTP Alternative Services (FF54+)
  1426. ** 1334693 - isolate SPDY/HTTP2 (FF55+)
  1427. ** 1337893 - isolate DNS cache (FF55+)
  1428. ** 1344170 - isolate blob: URI (FF55+)
  1429. ** 1300671 - isolate data:, about: URLs (FF55+)
  1430. ** 1473247 - isolate IP addresses (FF63+)
  1431. ** 1492607 - isolate postMessage with targetOrigin "*" (requires 4002) (FF65+)
  1432. ** 1542309 - isolate top-level domain URLs (FF68+)
  1433. ***/
  1434. user_pref("_user.js.parrot", "4000 syntax error: the parrot's pegged out");
  1435. /* 4001: enable First Party Isolation [FF51+]
  1436. * [SETUP-WEB] May break cross-domain logins and site functionality until perfected
  1437. * [1] https://bugzilla.mozilla.org/1260931 ***/
  1438. user_pref("privacy.firstparty.isolate", true);
  1439. /* 4002: enforce FPI restriction for window.opener [FF54+]
  1440. * [NOTE] Setting this to false may reduce the breakage in 4001
  1441. * FF65+ blocks postMessage with targetOrigin "*" if originAttributes don't match. But
  1442. * to reduce breakage it ignores the 1st-party domain (FPD) originAttribute. (see [2],[3])
  1443. * The 2nd pref removes that limitation and will only allow communication if FPDs also match.
  1444. * [1] https://bugzilla.mozilla.org/1319773#c22
  1445. * [2] https://bugzilla.mozilla.org/1492607
  1446. * [3] https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage ***/
  1447. user_pref("privacy.firstparty.isolate.restrict_opener_access", true); // [DEFAULT: true]
  1448. // user_pref("privacy.firstparty.isolate.block_post_message", true); // [HIDDEN PREF]
  1449. /*** [SECTION 4500]: RFP (RESIST FINGERPRINTING)
  1450. This master switch will be used for a wide range of items, many of which will
  1451. **override** existing prefs from FF55+, often providing a **better** solution
  1452. IMPORTANT: As existing prefs become redundant, and some of them WILL interfere
  1453. with how RFP works, they will be moved to section 4600 and made inactive
  1454. ** 418986 - limit window.screen & CSS media queries leaking identifiable info (FF41+)
  1455. [NOTE] Info only: To set a size, open a XUL (chrome) page (such as about:config) which is at
  1456. 100% zoom, hit Shift+F4 to open the scratchpad, type window.resizeTo(1366,768), hit Ctrl+R to run.
  1457. Test your window size, do some math, resize to allow for all the non inner window elements
  1458. [TEST] https://ghacksuserjs.github.io/TorZillaPrint/TorZillaPrint.html#screen
  1459. ** 1281949 - spoof screen orientation (FF50+)
  1460. ** 1281963 - hide the contents of navigator.plugins and navigator.mimeTypes (FF50+)
  1461. FF53: Fixes GetSupportedNames in nsMimeTypeArray and nsPluginArray (1324044)
  1462. ** 1330890 - spoof timezone as UTC 0 (FF55+)
  1463. FF58: Date.toLocaleFormat deprecated (818634)
  1464. FF60: Date.toLocaleDateString and Intl.DateTimeFormat fixed (1409973)
  1465. ** 1360039 - spoof navigator.hardwareConcurrency as 2 (see 4601) (FF55+)
  1466. This spoof *shouldn't* affect core chrome/Firefox performance
  1467. ** 1217238 - reduce precision of time exposed by javascript (FF55+)
  1468. ** 1369303 - spoof/disable performance API (see 2410-deprecated, 4602, 4603) (FF56+)
  1469. ** 1333651 & 1383495 & 1396468 - spoof Navigator API (see section 4700) (FF56+)
  1470. FF56: The version number will be rounded down to the nearest multiple of 10
  1471. FF57: The version number will match current ESR (1393283, 1418672, 1418162, 1511763)
  1472. FF59: The OS will be reported as Windows, OSX, Android, or Linux (to reduce breakage) (1404608)
  1473. FF66: The OS in HTTP Headers will be reduced to Windows or Android (1509829)
  1474. ** 1369319 - disable device sensor API (see 4604) (FF56+)
  1475. ** 1369357 - disable site specific zoom (see 4605) (FF56+)
  1476. ** 1337161 - hide gamepads from content (see 4606) (FF56+)
  1477. ** 1372072 - spoof network information API as "unknown" when dom.netinfo.enabled = true (see 4607) (FF56+)
  1478. ** 1333641 - reduce fingerprinting in WebSpeech API (see 4608) (FF56+)
  1479. ** 1372069 & 1403813 & 1441295 - block geolocation requests (same as denying a site permission) (see 0201, 0201b) (FF56-62)
  1480. ** 1369309 - spoof media statistics (see 4610) (FF57+)
  1481. ** 1382499 - reduce screen co-ordinate fingerprinting in Touch API (see 4611) (FF57+)
  1482. ** 1217290 & 1409677 - enable fingerprinting resistance for WebGL (see 2010-12) (FF57+)
  1483. ** 1382545 - reduce fingerprinting in Animation API (FF57+)
  1484. ** 1354633 - limit MediaError.message to a whitelist (FF57+)
  1485. ** 1382533 - enable fingerprinting resistance for Presentation API (FF57+)
  1486. This blocks exposure of local IP Addresses via mDNS (Multicast DNS)
  1487. ** 967895 - enable site permission prompt before allowing canvas data extraction (FF58+)
  1488. FF59: Added to site permissions panel (1413780) Only prompt when triggered by user input (1376865)
  1489. ** 1372073 - spoof/block fingerprinting in MediaDevices API (FF59+)
  1490. Spoof: enumerate devices reports one "Internal Camera" and one "Internal Microphone" if
  1491. media.navigator.enabled is true (see 2505 which we chose to keep disabled)
  1492. Block: suppresses the ondevicechange event (see 4612)
  1493. ** 1039069 - warn when language prefs are set to non en-US (see 0207, 0208) (FF59+)
  1494. ** 1222285 & 1433592 - spoof keyboard events and suppress keyboard modifier events (FF59+)
  1495. Spoofing mimics the content language of the document. Currently it only supports en-US.
  1496. Modifier events suppressed are SHIFT and both ALT keys. Chrome is not affected.
  1497. FF60: Fix keydown/keyup events (1438795)
  1498. ** 1337157 - disable WebGL debug renderer info (see 4613) (FF60+)
  1499. ** 1459089 - disable OS locale in HTTP Accept-Language headers (ANDROID) (FF62+)
  1500. ** 1363508 - spoof/suppress Pointer Events (see 4614) (FF64+)
  1501. FF65: pointerEvent.pointerid (1492766)
  1502. ** 1485266 - disable exposure of system colors to CSS or canvas (see 2618) (FF67+)
  1503. ** 1407366 - enable inner window letterboxing (see 4504) (FF67+)
  1504. ** 1540726 - enforce "light" with prefers-color-scheme (FF67+)
  1505. [1] https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
  1506. ***/
  1507. user_pref("_user.js.parrot", "4500 syntax error: the parrot's popped 'is clogs");
  1508. /* 4501: enable privacy.resistFingerprinting [FF41+]
  1509. * This pref is the master switch for all other privacy.resist* prefs unless stated
  1510. * [SETUP-WEB] RFP is not ready for the masses, so expect some website breakage
  1511. * [1] https://bugzilla.mozilla.org/418986 ***/
  1512. user_pref("privacy.resistFingerprinting", true);
  1513. /* 4502: set new window sizes to round to hundreds [FF55+] [SETUP-CHROME]
  1514. * Width will round down to multiples of 200s and height to 100s, to fit your screen.
  1515. * The override values are a starting point to round from if you want some control
  1516. * [1] https://bugzilla.mozilla.org/1330882
  1517. * [2] https://hardware.metrics.mozilla.com/ ***/
  1518. // user_pref("privacy.window.maxInnerWidth", 1600); // [HIDDEN PREF]
  1519. // user_pref("privacy.window.maxInnerHeight", 900); // [HIDDEN PREF]
  1520. /* 4503: disable mozAddonManager Web API [FF57+]
  1521. * [NOTE] As a side-effect in FF57-59 this allowed extensions to work on AMO. In FF60+ you also need
  1522. * to sanitize or clear extensions.webextensions.restrictedDomains (see 2662) to keep that side-effect
  1523. * [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1384330,1406795,1415644,1453988 ***/
  1524. user_pref("privacy.resistFingerprinting.block_mozAddonManager", true); // [HIDDEN PREF]
  1525. /* 4504: enable RFP letterboxing [FF67+]
  1526. * Dynamically resizes the inner window in 200w x100h steps by applying letterboxing, using dimensions
  1527. * which waste the least content area, If you use the dimension pref, then it will only apply those
  1528. * resolutions. The format is "width1xheight1, width2xheight2, ..." (e.g. "800x600, 1000x1000, 1600x900")
  1529. * [NOTE] This does NOT require RFP (see 4501) **for now**
  1530. * [WARNING] The dimension pref is only meant for testing, and we recommend you DO NOT USE it
  1531. * [1] https://bugzilla.mozilla.org/1407366 ***/
  1532. user_pref("privacy.resistFingerprinting.letterboxing", true); // [HIDDEN PREF]
  1533. // user_pref("privacy.resistFingerprinting.letterboxing.dimensions", ""); // [HIDDEN PREF]
  1534. /* 4510: disable showing about:blank as soon as possible during startup [FF60+]
  1535. * When default true (FF62+) this no longer masks the RFP chrome resizing activity
  1536. * [1] https://bugzilla.mozilla.org/1448423 ***/
  1537. user_pref("browser.startup.blankWindow", false);
  1538. /*** [SECTION 4600]: RFP ALTERNATIVES
  1539. * IF you DO use RFP (see 4500) then you DO NOT need these redundant prefs. In fact,
  1540. some even cause RFP to not behave as you would expect and alter your fingerprint.
  1541. Make sure they are RESET in about:config as per your Firefox version
  1542. * IF you DO NOT use RFP or are on ESR... then turn on each ESR section below
  1543. ***/
  1544. user_pref("_user.js.parrot", "4600 syntax error: the parrot's crossed the Jordan");
  1545. /* [SETUP-non-RFP] Non-RFP users replace the * with a slash on this line to enable these
  1546. // FF55+
  1547. // 4601: [2514] spoof (or limit?) number of CPU cores [FF48+]
  1548. // [NOTE] *may* affect core chrome/Firefox performance, will affect content.
  1549. // [1] https://bugzilla.mozilla.org/1008453
  1550. // [2] https://trac.torproject.org/projects/tor/ticket/21675
  1551. // [3] https://trac.torproject.org/projects/tor/ticket/22127
  1552. // [4] https://html.spec.whatwg.org/multipage/workers.html#navigator.hardwareconcurrency
  1553. // user_pref("dom.maxHardwareConcurrency", 2);
  1554. // * * * /
  1555. // FF56+
  1556. // 4602: [2411] disable resource/navigation timing
  1557. user_pref("dom.enable_resource_timing", false);
  1558. // 4603: [2412] disable timing attacks
  1559. // [1] https://wiki.mozilla.org/Security/Reviews/Firefox/NavigationTimingAPI
  1560. user_pref("dom.enable_performance", false);
  1561. // 4604: [2512] disable device sensor API
  1562. // Optional protection depending on your device
  1563. // [1] https://trac.torproject.org/projects/tor/ticket/15758
  1564. // [2] https://blog.lukaszolejnik.com/stealing-sensitive-browser-data-with-the-w3c-ambient-light-sensor-api/
  1565. // [3] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1357733,1292751
  1566. // user_pref("device.sensors.enabled", false);
  1567. // 4605: [2515] disable site specific zoom
  1568. // Zoom levels affect screen res and are highly fingerprintable. This does not stop you using
  1569. // zoom, it will just not use/remember any site specific settings. Zoom levels on new tabs
  1570. // and new windows are reset to default and only the current tab retains the current zoom
  1571. user_pref("browser.zoom.siteSpecific", false);
  1572. // 4606: [2501] disable gamepad API - USB device ID enumeration
  1573. // Optional protection depending on your connected devices
  1574. // [1] https://trac.torproject.org/projects/tor/ticket/13023
  1575. // user_pref("dom.gamepad.enabled", false);
  1576. // 4607: [2503] disable giving away network info [FF31+]
  1577. // e.g. bluetooth, cellular, ethernet, wifi, wimax, other, mixed, unknown, none
  1578. // [1] https://developer.mozilla.org/docs/Web/API/Network_Information_API
  1579. // [2] https://wicg.github.io/netinfo/
  1580. // [3] https://bugzilla.mozilla.org/960426
  1581. user_pref("dom.netinfo.enabled", false); // [DEFAULT: true on Android]
  1582. // 4608: [2021] disable the SpeechSynthesis (Text-to-Speech) part of the Web Speech API
  1583. // [1] https://developer.mozilla.org/docs/Web/API/Web_Speech_API
  1584. // [2] https://developer.mozilla.org/docs/Web/API/SpeechSynthesis
  1585. // [3] https://wiki.mozilla.org/HTML5_Speech_API
  1586. user_pref("media.webspeech.synth.enabled", false);
  1587. // * * * /
  1588. // FF57+
  1589. // 4610: [2506] disable video statistics - JS performance fingerprinting [FF25+]
  1590. // [1] https://trac.torproject.org/projects/tor/ticket/15757
  1591. // [2] https://bugzilla.mozilla.org/654550
  1592. user_pref("media.video_stats.enabled", false);
  1593. // 4611: [2509] disable touch events
  1594. // fingerprinting attack vector - leaks screen res & actual screen coordinates
  1595. // 0=disabled, 1=enabled, 2=autodetect
  1596. // Optional protection depending on your device
  1597. // [1] https://developer.mozilla.org/docs/Web/API/Touch_events
  1598. // [2] https://trac.torproject.org/projects/tor/ticket/10286
  1599. // user_pref("dom.w3c_touch_events.enabled", 0);
  1600. // * * * /
  1601. // FF59+
  1602. // 4612: [2511] disable MediaDevices change detection [FF51+]
  1603. // [1] https://developer.mozilla.org/docs/Web/Events/devicechange
  1604. // [2] https://developer.mozilla.org/docs/Web/API/MediaDevices/ondevicechange
  1605. user_pref("media.ondevicechange.enabled", false);
  1606. // * * * /
  1607. // FF60+
  1608. // 4613: [2011] disable WebGL debug info being available to websites
  1609. // [1] https://bugzilla.mozilla.org/1171228
  1610. // [2] https://developer.mozilla.org/docs/Web/API/WEBGL_debug_renderer_info
  1611. user_pref("webgl.enable-debug-renderer-info", false);
  1612. // * * * /
  1613. // FF65+
  1614. // 4614: [2516] disable PointerEvents
  1615. // [1] https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent
  1616. user_pref("dom.w3c_pointer_events.enabled", false);
  1617. // * * * /
  1618. // ***/
  1619. /*** [SECTION 4700]: RFP ALTERNATIVES (NAVIGATOR / USER AGENT (UA) SPOOFING)
  1620. This is FYI ONLY. These prefs are INSUFFICIENT(a) on their own, you need
  1621. to use RFP (4500) or an extension, in which case they become POINTLESS.
  1622. (a) Many of the components that make up your UA can be derived by other means.
  1623. And when those values differ, you provide more bits and raise entropy.
  1624. Examples of leaks include navigator objects, date locale/formats, iframes,
  1625. headers, tcp/ip attributes, feature detection, and **many** more.
  1626. ALL values below intentionally left blank - use RFP, or get a vetted, tested
  1627. extension and mimic RFP values to *lower* entropy, or randomize to *raise* it
  1628. ***/
  1629. user_pref("_user.js.parrot", "4700 syntax error: the parrot's taken 'is last bow");
  1630. /* 4701: navigator.userAgent ***/
  1631. // user_pref("general.useragent.override", ""); // [HIDDEN PREF]
  1632. /* 4702: navigator.buildID
  1633. * Revealed build time down to the second. In FF64+ it now returns a fixed timestamp
  1634. * [1] https://bugzilla.mozilla.org/583181
  1635. * [2] https://www.fxsitecompat.com/en-CA/docs/2018/navigator-buildid-now-returns-a-fixed-timestamp/ ***/
  1636. // user_pref("general.buildID.override", ""); // [HIDDEN PREF]
  1637. /* 4703: navigator.appName ***/
  1638. // user_pref("general.appname.override", ""); // [HIDDEN PREF]
  1639. /* 4704: navigator.appVersion ***/
  1640. // user_pref("general.appversion.override", ""); // [HIDDEN PREF]
  1641. /* 4705: navigator.platform ***/
  1642. // user_pref("general.platform.override", ""); // [HIDDEN PREF]
  1643. /* 4706: navigator.oscpu ***/
  1644. // user_pref("general.oscpu.override", ""); // [HIDDEN PREF]
  1645. /*** [SECTION 5000]: PERSONAL
  1646. Non-project related but useful. If any of these interest you, add them to your overrides ***/
  1647. user_pref("_user.js.parrot", "5000 syntax error: this is an ex-parrot!");
  1648. /* WELCOME & WHAT's NEW NOTICES ***/
  1649. // user_pref("browser.startup.homepage_override.mstone", "ignore"); // master switch
  1650. // user_pref("startup.homepage_welcome_url", "");
  1651. // user_pref("startup.homepage_welcome_url.additional", "");
  1652. // user_pref("startup.homepage_override_url", ""); // What's New page after updates
  1653. /* WARNINGS ***/
  1654. // user_pref("browser.tabs.warnOnClose", false);
  1655. // user_pref("browser.tabs.warnOnCloseOtherTabs", false);
  1656. // user_pref("browser.tabs.warnOnOpen", false);
  1657. // user_pref("full-screen-api.warning.delay", 0);
  1658. // user_pref("full-screen-api.warning.timeout", 0);
  1659. // user_pref("general.warnOnAboutConfig", false);
  1660. // user_pref("browser.aboutConfig.showWarning", false); // [FF67+]
  1661. /* APPEARANCE ***/
  1662. // user_pref("browser.download.autohideButton", false); // [FF57+]
  1663. // user_pref("toolkit.cosmeticAnimations.enabled", false); // [FF55+]
  1664. /* CONTENT BEHAVIOR ***/
  1665. // user_pref("accessibility.typeaheadfind", true); // enable "Find As You Type"
  1666. // user_pref("clipboard.autocopy", false); // disable autocopy default [LINUX]
  1667. // user_pref("layout.spellcheckDefault", 2); // 0=none, 1-multi-line, 2=multi-line & single-line
  1668. /* UX BEHAVIOR ***/
  1669. // user_pref("browser.backspace_action", 2); // 0=previous page, 1=scroll up, 2=do nothing
  1670. // user_pref("browser.tabs.closeWindowWithLastTab", false);
  1671. // user_pref("browser.tabs.loadBookmarksInTabs", true); // open bookmarks in a new tab [FF57+]
  1672. // user_pref("browser.urlbar.decodeURLsOnCopy", true); // see bugzilla 1320061 [FF53+]
  1673. // user_pref("general.autoScroll", false); // middle-click enabling auto-scrolling [WINDOWS] [MAC]
  1674. // user_pref("ui.key.menuAccessKey", 0); // disable alt key toggling the menu bar [RESTART]
  1675. /* OTHER ***/
  1676. // user_pref("browser.bookmarks.max_backups", 2);
  1677. // user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr", false); // disable CFR [FF64+]
  1678. // [SETTING] General>Browsing>Recommend extensions as you browse
  1679. // [1] https://support.mozilla.org/en-US/kb/extension-recommendations
  1680. // user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons", false); // disable CFR [FF67+]
  1681. // [SETTING] General>Browsing>Recommend extensions as you browse
  1682. // user_pref("browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features", false); // disable CFR [FF67+]
  1683. // [SETTING] General>Browsing>Recommend features as you browse
  1684. // user_pref("identity.fxaccounts.enabled", false); // disable and hide Firefox Accounts and Sync [FF60+] [RESTART]
  1685. // user_pref("network.manage-offline-status", false); // see bugzilla 620472
  1686. // user_pref("reader.parse-on-load.enabled", false); // "Reader View"
  1687. // user_pref("xpinstall.signatures.required", false); // enforced extension signing (Nightly/ESR)
  1688. /*** [SECTION 9999]: DEPRECATED / REMOVED / LEGACY / RENAMED
  1689. Documentation denoted as [-]. Items deprecated prior to FF61 have been archived at [1], which
  1690. also provides a link-clickable, viewer-friendly version of the deprecated bugzilla tickets
  1691. [1] https://github.com/ghacksuserjs/ghacks-user.js/issues/123
  1692. ***/
  1693. user_pref("_user.js.parrot", "9999 syntax error: the parrot's deprecated!");
  1694. /* ESR60.x still uses all the following prefs
  1695. // [NOTE] replace the * with a slash in the line above to re-enable them
  1696. // FF61
  1697. // 0501: disable experiments
  1698. // [1] https://wiki.mozilla.org/Telemetry/Experiments
  1699. // [-] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1420908,1450801
  1700. user_pref("experiments.enabled", false);
  1701. user_pref("experiments.manifest.uri", "");
  1702. user_pref("experiments.supported", false);
  1703. user_pref("experiments.activeExperiment", false);
  1704. // 2612: disable remote JAR files being opened, regardless of content type [FF42+]
  1705. // [1] https://bugzilla.mozilla.org/1173171
  1706. // [2] https://www.fxsitecompat.com/en-CA/docs/2015/jar-protocol-support-has-been-disabled-by-default/
  1707. // [-] https://bugzilla.mozilla.org/1427726
  1708. user_pref("network.jar.block-remote-files", true);
  1709. // 2613: disable JAR from opening Unsafe File Types
  1710. // [-] https://bugzilla.mozilla.org/1427726
  1711. user_pref("network.jar.open-unsafe-types", false);
  1712. // * * * /
  1713. // FF62
  1714. // 1803: disable Java plugin
  1715. // [-] (part5) https://bugzilla.mozilla.org/1461243
  1716. user_pref("plugin.state.java", 0);
  1717. // * * * /
  1718. // FF63
  1719. // 0202: disable GeoIP-based search results
  1720. // [NOTE] May not be hidden if Firefox has changed your settings due to your locale
  1721. // [-] https://bugzilla.mozilla.org/1462015
  1722. user_pref("browser.search.countryCode", "US"); // [HIDDEN PREF]
  1723. // 0301a: disable auto-update checks for Firefox
  1724. // [SETTING] General>Firefox Updates>Never check for updates
  1725. // [-] https://bugzilla.mozilla.org/1420514
  1726. // user_pref("app.update.enabled", false);
  1727. // 0503: disable "Savant" Shield study [FF61+]
  1728. // [-] https://bugzilla.mozilla.org/1457226
  1729. user_pref("shield.savant.enabled", false);
  1730. // 1031: disable favicons in tabs and new bookmarks - merged into browser.chrome.site_icons
  1731. // [-] https://bugzilla.mozilla.org/1453751
  1732. // user_pref("browser.chrome.favicons", false);
  1733. // 2030: disable autoplay of HTML5 media - replaced by media.autoplay.default
  1734. // This may break video playback on various sites
  1735. // [-] https://bugzilla.mozilla.org/1470082
  1736. user_pref("media.autoplay.enabled", false);
  1737. // 2704: set cookie lifetime in days (see 2703)
  1738. // [-] https://bugzilla.mozilla.org/1457170
  1739. // user_pref("network.cookie.lifetime.days", 90); // [DEFAULT: 90]
  1740. // 5000's: enable "Ctrl+Tab cycles through tabs in recently used order" - replaced by browser.ctrlTab.recentlyUsedOrder
  1741. // [-] https://bugzilla.mozilla.org/1473595
  1742. // user_pref("browser.ctrlTab.previews", true);
  1743. // * * * /
  1744. // FF64
  1745. // 0516: disable Onboarding [FF55+]
  1746. // Onboarding is an interactive tour/setup for new installs/profiles and features. Every time
  1747. // about:home or about:newtab is opened, the onboarding overlay is injected into that page
  1748. // [NOTE] Onboarding uses Google Analytics [2], and leaks resource://URIs [3]
  1749. // [1] https://wiki.mozilla.org/Firefox/Onboarding
  1750. // [2] https://github.com/mozilla/onboard/commit/db4d6c8726c89a5d6a241c1b1065827b525c5baf
  1751. // [3] https://bugzilla.mozilla.org/863246#c154
  1752. // [-] https://bugzilla.mozilla.org/1462415
  1753. user_pref("browser.onboarding.enabled", false);
  1754. // 2608: disable WebIDE ADB extension downloads - both renamed
  1755. // [1] https://trac.torproject.org/projects/tor/ticket/16222
  1756. // [-] https://bugzilla.mozilla.org/1491315
  1757. user_pref("devtools.webide.autoinstallADBHelper", false);
  1758. user_pref("devtools.webide.adbAddonURL", "");
  1759. // 2681: disable CSP violation events [FF59+]
  1760. // [1] https://developer.mozilla.org/docs/Web/API/SecurityPolicyViolationEvent
  1761. // [-] https://bugzilla.mozilla.org/1488165
  1762. user_pref("security.csp.enable_violation_events", false);
  1763. // * * * /
  1764. // FF65
  1765. // 0850a: disable location bar autocomplete and suggestion types
  1766. // If you enforce any of the suggestion types (see the other 0850a), you MUST enforce 'autocomplete'
  1767. // - If *ALL* of the suggestion types are false, 'autocomplete' must also be false
  1768. // - If *ANY* of the suggestion types are true, 'autocomplete' must also be true
  1769. // [-] https://bugzilla.mozilla.org/1502392
  1770. user_pref("browser.urlbar.autocomplete.enabled", false);
  1771. // 0908: remove user & password info when attempting to fix an entered URL (i.e. 0802 is true)
  1772. // e.g. //user:password@foo -> //user@(prefix)foo(suffix) NOT //user:password@(prefix)foo(suffix)
  1773. // [-] https://bugzilla.mozilla.org/1510580
  1774. user_pref("browser.fixup.hide_user_pass", true); // [DEFAULT: true]
  1775. // * * * /
  1776. // FF66
  1777. // 0380: disable Browser Error Reporter [FF60+]
  1778. // [1] https://support.mozilla.org/en-US/kb/firefox-nightly-error-collection
  1779. // [2] https://firefox-source-docs.mozilla.org/browser/browser/BrowserErrorReporter.html
  1780. // [-] https://bugzilla.mozilla.org/1509888
  1781. user_pref("browser.chrome.errorReporter.enabled", false);
  1782. user_pref("browser.chrome.errorReporter.submitUrl", "");
  1783. // 0502: disable Mozilla permission to silently opt you into tests
  1784. // [-] https://bugzilla.mozilla.org/1415625
  1785. user_pref("network.allow-experiments", false);
  1786. // * * * /
  1787. // ***/
  1788. /* END: internal custom pref to test for syntax errors ***/
  1789. user_pref("_user.js.parrot", "SUCCESS: No no he's not dead, he's, he's restin'!");