projects/torbrowser/design/index.html.en (7b0613573) - tor-webwml.git

7b06135737d39fe1a1e1a5cb67a2461d22ab571a

Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1) <?xml version="1.0" encoding="UTF-8"?>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 2) <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Design and Implementation of the Tor Browser [DRAFT]</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /></head><body><div class="article"><div class="titlepage"><div><div><h2 class="title"><a id="design"></a>The Design and Implementation of the Tor Browser [DRAFT]</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Mike</span> <span class="surname">Perry</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:mikeperry#torproject org">mikeperry#torproject org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Erinn</span> <span class="surname">Clark</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:erinn#torproject org">erinn#torproject org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Steven</span> <span class="surname">Murdoch</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:sjmurdoch#torproject org">sjmurdoch#torproject org</a>></code></p></div></div></div></div><div><p class="pubdate">October 30th, 2014</p></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="#idp35210336">1. Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#components">1.1. Browser Component Overview</a></span></dt></dl></dd><dt><span class="sect1"><a href="#DesignRequirements">2. Design Requirements and Philosophy</a></span></dt><dd><dl><dt><span class="sect2"><a href="#security">2.1. Security Requirements</a></span></dt><dt><span class="sect2"><a href="#privacy">2.2. Privacy Requirements</a></span></dt><dt><span class="sect2"><a href="#philosophy">2.3. Philosophy</a></span></dt></dl></dd><dt><span class="sect1"><a href="#adversary">3. Adversary Model</a></span></dt><dd><dl><dt><span class="sect2"><a href="#adversary-goals">3.1. Adversary Goals</a></span></dt><dt><span class="sect2"><a href="#adversary-positioning">3.2. Adversary Capabilities - Positioning</a></span></dt><dt><span class="sect2"><a href="#attacks">3.3. Adversary Capabilities - Attacks</a></span></dt></dl></dd><dt><span class="sect1"><a href="#Implementation">4. Implementation</a></span></dt><dd><dl><dt><span class="sect2"><a href="#proxy-obedience">4.1. Proxy Obedience</a></span></dt><dt><span class="sect2"><a href="#state-separation">4.2. State Separation</a></span></dt><dt><span class="sect2"><a href="#disk-avoidance">4.3. Disk Avoidance</a></span></dt><dt><span class="sect2"><a href="#app-data-isolation">4.4. Application Data Isolation</a></span></dt><dt><span class="sect2"><a href="#identifier-linkability">4.5. Cross-Origin Identifier Unlinkability</a></span></dt><dt><span class="sect2"><a href="#fingerprinting-linkability">4.6. Cross-Origin Fingerprinting Unlinkability</a></span></dt><dt><span class="sect2"><a href="#new-identity">4.7. Long-Term Unlinkability via "New Identity" button</a></span></dt><dt><span class="sect2"><a href="#other-security">4.8. Other Security Measures</a></span></dt></dl></dd><dt><span class="sect1"><a href="#BuildSecurity">5. Build Security and Package Integrity</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp37001088">5.1. Achieving Binary Reproducibility</a></span></dt><dt><span class="sect2"><a href="#idp37036336">5.2. Package Signatures and Verification</a></span></dt><dt><span class="sect2"><a href="#idp37040272">5.3. Anonymous Verification</a></span></dt></dl></dd><dt><span class="appendix"><a href="#Transparency">A. Towards Transparency in Navigation Tracking</a></span></dt><dd><dl><dt><span class="sect1"><a href="#deprecate">A.1. Deprecation Wishlist</a></span></dt><dt><span class="sect1"><a href="#idp37071376">A.2. Promising Standards</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp35210336"></a>1. Introduction</h2></div></div></div><p>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 3)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 4) This document describes the <a class="link" href="#adversary" title="3. Adversary Model">adversary model</a>,`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 5) <a class="link" href="#DesignRequirements" title="2. Design Requirements and Philosophy">design requirements</a>, and <a class="link" href="#Implementation" title="4. Implementation">implementation</a> of the Tor Browser. It is current as of Tor Browser`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 6) 4.0.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 7) projects/en/torbrowser/design/index.html.en 8) </p><p> projects/en/torbrowser/design/index.html.en 9) projects/en/torbrowser/design/index.html.en 10) This document is also meant to serve as a set of design requirements and to projects/en/torbrowser/design/index.html.en 11) describe a reference implementation of a Private Browsing Mode that defends`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 12) against active network adversaries, in addition to the passive forensic local projects/torbrowser/design/index.html.en 13) adversary currently addressed by the major browsers.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 14)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 15) </p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="components"></a>1.1. Browser Component Overview</h3></div></div></div><p>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 16)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 17) The Tor Browser is based on <a class="ulink" href="https://www.mozilla.org/en-US/firefox/organizations/" target="_top">Mozilla's Extended`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 18) Support Release (ESR) Firefox branch</a>. We have a <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git" target="_top">series of patches</a> projects/torbrowser/design/index.html.en 19) against this browser to enhance privacy and security. Browser behavior is projects/torbrowser/design/index.html.en 20) additionally augmented through the <a class="ulink" href="https://gitweb.torproject.org/torbutton.git/tree/master" target="_top">Torbutton projects/torbrowser/design/index.html.en 21) extension</a>, though we are in the process of moving this functionality projects/torbrowser/design/index.html.en 22) into direct Firefox patches. We also <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/blob/refs/heads/tor-browser-31.2.0esr-4.x-1:/browser/app/profile/000-tor-browser.js" target="_top">change
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 23) a number of Firefox preferences</a> from their defaults.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 24)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 25) </p><p>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 26) Tor process management and configuration is accomplished through the <a class="ulink" href="https://gitweb.torproject.org/tor-launcher.git" target="_top">Tor Launcher</a> projects/torbrowser/design/index.html.en 27) addon, which provides the initial Tor configuration splash screen and projects/torbrowser/design/index.html.en 28) bootstrap progress bar. Tor Launcher is also compatible with Thunderbird, projects/torbrowser/design/index.html.en 29) InstantBird, and XULRunner. projects/torbrowser/design/index.html.en 30) projects/torbrowser/design/index.html.en 31) </p><p>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 32)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 33) To help protect against potential Tor Exit Node eavesdroppers, we include`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 34) <a class="ulink" href="https://www.eff.org/https-everywhere" target="_top">HTTPS-Everywhere</a>. To`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 35) provide users with optional defense-in-depth against Javascript and other`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 36) potential exploit vectors, we also include <a class="ulink" href="http://noscript.net/" target="_top">NoScript</a>. We also modify <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/refs/heads/master:/Bundle-Data/linux/Data/Browser/profile.default/preferences/extension-overrides.js" target="_top">several`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 37) extension preferences</a> from their defaults.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 38)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 39) </p><p> projects/torbrowser/design/index.html.en 40) projects/torbrowser/design/index.html.en 41) To provide censorship circumvention in areas where the public Tor network is projects/torbrowser/design/index.html.en 42) blocked either by IP, or by protocol fingerprint, we include several <a class="ulink" href="https://trac.torproject.org/projects/tor/wiki/doc/AChildsGardenOfPluggableTransports" target="_top">Pluggable projects/torbrowser/design/index.html.en 43) Transports</a> in the distribution. As of this writing, we include <a class="ulink" href="https://gitweb.torproject.org/pluggable-transports/obfsproxy.git/blob/HEAD:/doc/obfs3/obfs3-protocol-spec.txt" target="_top">Obfsproxy</a>, projects/torbrowser/design/index.html.en 44) <a class="ulink" href="https://trac.torproject.org/projects/tor/wiki/doc/meek" target="_top">meek</a>, projects/torbrowser/design/index.html.en 45) <a class="ulink" href="https://fteproxy.org/" target="_top">FTE</a>, and <a class="ulink" href="https://crypto.stanford.edu/flashproxy/" target="_top">FlashProxy</a>. projects/torbrowser/design/index.html.en 46) projects/torbrowser/design/index.html.en 47) </p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="DesignRequirements"></a>2. Design Requirements and Philosophy</h2></div></div></div><p>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 48) projects/en/torbrowser/design/index.html.en 49) The Tor Browser Design Requirements are meant to describe the properties of a`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 50) Private Browsing Mode that defends against both network and local forensic projects/torbrowser/design/index.html.en 51) adversaries.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 52) projects/en/torbrowser/design/index.html.en 53) </p><p> projects/en/torbrowser/design/index.html.en 54) projects/en/torbrowser/design/index.html.en 55) There are two main categories of requirements: <a class="link" href="#security" title="2.1. Security Requirements">Security Requirements</a>, and <a class="link" href="#privacy" title="2.2. Privacy Requirements">Privacy Requirements</a>. Security Requirements are the`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 56) minimum properties in order for a browser to be able to support Tor and projects/torbrowser/design/index.html.en 57) similar privacy proxies safely. Privacy requirements are the set of properties`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 58) that cause us to prefer one browser over another.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 59) projects/en/torbrowser/design/index.html.en 60) </p><p> projects/en/torbrowser/design/index.html.en 61)`
Update TBB design doc with... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 62) While we will endorse the use of browsers that meet the security requirements, projects/torbrowser/design/index.html.en 63) it is primarily the privacy requirements that cause us to maintain our own projects/torbrowser/design/index.html.en 64) browser distribution. projects/torbrowser/design/index.html.en 65) projects/torbrowser/design/index.html.en 66) </p><p> projects/torbrowser/design/index.html.en 67) projects/torbrowser/design/index.html.en 68) The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL projects/torbrowser/design/index.html.en 69) NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and projects/torbrowser/design/index.html.en 70) "OPTIONAL" in this document are to be interpreted as described in
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 71) <a class="ulink" href="https://www.ietf.org/rfc/rfc2119.txt" target="_top">RFC 2119</a>.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 72)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 73) </p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="security"></a>2.1. Security Requirements</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 74) projects/en/torbrowser/design/index.html.en 75) The security requirements are primarily concerned with ensuring the safe use projects/en/torbrowser/design/index.html.en 76) of Tor. Violations in these properties typically result in serious risk for`
Add a couple extra sentence... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 77) the user in terms of immediate deanonymization and/or observability. With`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 78) respect to browser support, security requirements are the minimum properties projects/torbrowser/design/index.html.en 79) in order for Tor to support the use of a particular browser.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 80)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 81) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><a class="link" href="#proxy-obedience" title="4.1. Proxy Obedience"><span class="command"><strong>Proxy`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 82) Obedience</strong></span></a><p>The browser`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 83) MUST NOT bypass Tor proxy settings for any content.</p></li><li class="listitem"><a class="link" href="#state-separation" title="4.2. State Separation"><span class="command"><strong>State`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 84) Separation</strong></span></a><p> projects/torbrowser/design/index.html.en 85) projects/torbrowser/design/index.html.en 86) The browser MUST NOT provide the content window with any state from any other projects/torbrowser/design/index.html.en 87) browsers or any non-Tor browsing modes. This includes shared state from projects/torbrowser/design/index.html.en 88) independent plugins, and shared state from Operating System implementations of projects/torbrowser/design/index.html.en 89) TLS and other support libraries. projects/torbrowser/design/index.html.en 90)
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 91) </p></li><li class="listitem"><a class="link" href="#disk-avoidance" title="4.3. Disk Avoidance"><span class="command"><strong>Disk`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 92) Avoidance</strong></span></a><p>`
Update TBB design doc with... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 93) projects/torbrowser/design/index.html.en 94) The browser MUST NOT write any information that is derived from or that projects/torbrowser/design/index.html.en 95) reveals browsing activity to the disk, or store it in memory beyond the projects/torbrowser/design/index.html.en 96) duration of one browsing session, unless the user has explicitly opted to projects/torbrowser/design/index.html.en 97) store their browsing history information to disk. projects/torbrowser/design/index.html.en 98)
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 99) </p></li><li class="listitem"><a class="link" href="#app-data-isolation" title="4.4. Application Data Isolation"><span class="command"><strong>Application Data`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 100) Isolation</strong></span></a><p>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 101)`
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 102) The components involved in providing private browsing MUST be self-contained,`
Update TBB design doc with... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 103) or MUST provide a mechanism for rapid, complete removal of all evidence of the projects/torbrowser/design/index.html.en 104) use of the mode. In other words, the browser MUST NOT write or cause the projects/torbrowser/design/index.html.en 105) operating system to write <span class="emphasis"><em>any information</em></span> about the use projects/torbrowser/design/index.html.en 106) of private browsing to disk outside of the application's control. The user
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 107) must be able to ensure that secure deletion of the software is sufficient to`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 108) remove evidence of the use of the software. All exceptions and shortcomings`
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 109) due to operating system behavior MUST be wiped by an uninstaller. However, due`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 110) to permissions issues with access to swap, implementations MAY choose to leave`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 111) it out of scope, and/or leave it to the Operating System/platform to implement projects/torbrowser/design/index.html.en 112) ephemeral-keyed encrypted swap.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 113)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 114) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="privacy"></a>2.2. Privacy Requirements</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 115) projects/en/torbrowser/design/index.html.en 116) The privacy requirements are primarily concerned with reducing linkability:`
Add a couple extra sentence... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 117) the ability for a user's activity on one site to be linked with their activity projects/torbrowser/design/index.html.en 118) on another site without their knowledge or explicit consent. With respect to`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 119) browser support, privacy requirements are the set of properties that cause us projects/torbrowser/design/index.html.en 120) to prefer one browser over another.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 121)`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 122) </p><p> projects/torbrowser/design/index.html.en 123) projects/torbrowser/design/index.html.en 124) For the purposes of the unlinkability requirements of this section as well as`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 125) the descriptions in the <a class="link" href="#Implementation" title="4. Implementation">implementation`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 126) section</a>, a <span class="command"><strong>url bar origin</strong></span> means at least the projects/torbrowser/design/index.html.en 127) second-level DNS name. For example, for mail.google.com, the origin would be projects/torbrowser/design/index.html.en 128) google.com. Implementations MAY, at their option, restrict the url bar origin`
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 129) to be the entire fully qualified domain name.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 130)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 131) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><a class="link" href="#identifier-linkability" title="4.5. Cross-Origin Identifier Unlinkability"><span class="command"><strong>Cross-Origin`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 132) Identifier Unlinkability</strong></span></a><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 133)`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 134) User activity on one url bar origin MUST NOT be linkable to their activity in`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 135) any other url bar origin by any third party automatically or without user projects/torbrowser/design/index.html.en 136) interaction or approval. This requirement specifically applies to linkability projects/torbrowser/design/index.html.en 137) from stored browser identifiers, authentication tokens, and shared state. The projects/torbrowser/design/index.html.en 138) requirement does not apply to linkable information the user manually submits`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 139) to sites, or due to information submitted during manual link traversal. This`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 140) functionality SHOULD NOT interfere with interactive, click-driven federated projects/torbrowser/design/index.html.en 141) login in a substantial way.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 142)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 143) </p></li><li class="listitem"><a class="link" href="#fingerprinting-linkability" title="4.6. Cross-Origin Fingerprinting Unlinkability"><span class="command"><strong>Cross-Origin`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 144) Fingerprinting Unlinkability</strong></span></a><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 145)`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 146) User activity on one url bar origin MUST NOT be linkable to their activity in projects/torbrowser/design/index.html.en 147) any other url bar origin by any third party. This property specifically applies to`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 148) linkability from fingerprinting browser behavior. projects/en/torbrowser/design/index.html.en 149)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 150) </p></li><li class="listitem"><a class="link" href="#new-identity" title="4.7. Long-Term Unlinkability via "New Identity" button"><span class="command"><strong>Long-Term`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 151) Unlinkability</strong></span></a><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 152)`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 153) The browser MUST provide an obvious, easy way for the user to remove all of projects/torbrowser/design/index.html.en 154) its authentication tokens and browser state and obtain a fresh identity.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 155) Additionally, the browser SHOULD clear linkable state by default automatically projects/torbrowser/design/index.html.en 156) upon browser restart, except at user option.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 157)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 158) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="philosophy"></a>2.3. Philosophy</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 159) projects/en/torbrowser/design/index.html.en 160) In addition to the above design requirements, the technology decisions about projects/en/torbrowser/design/index.html.en 161) Tor Browser are also guided by some philosophical positions about technology. projects/en/torbrowser/design/index.html.en 162)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 163) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><span class="command"><strong>Preserve existing user model</strong></span><p>`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 164) projects/en/torbrowser/design/index.html.en 165) The existing way that the user expects to use a browser must be preserved. If projects/en/torbrowser/design/index.html.en 166) the user has to maintain a different mental model of how the sites they are projects/en/torbrowser/design/index.html.en 167) using behave depending on tab, browser state, or anything else that would not projects/en/torbrowser/design/index.html.en 168) normally be what they experience in their default browser, the user will projects/en/torbrowser/design/index.html.en 169) inevitably be confused. They will make mistakes and reduce their privacy as a projects/en/torbrowser/design/index.html.en 170) result. Worse, they may just stop using the browser, assuming it is broken. projects/en/torbrowser/design/index.html.en 171) projects/en/torbrowser/design/index.html.en 172) </p><p> projects/en/torbrowser/design/index.html.en 173)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 174) User model breakage was one of the <a class="ulink" href="https://blog.torproject.org/blog/toggle-or-not-toggle-end-torbutton" target="_top">failures`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 175) of Torbutton</a>: Even if users managed to install everything properly, projects/en/torbrowser/design/index.html.en 176) the toggle model was too hard for the average user to understand, especially projects/en/torbrowser/design/index.html.en 177) in the face of accumulating tabs from multiple states crossed with the current`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 178) Tor-state of the browser.`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 179) projects/en/torbrowser/design/index.html.en 180) </p></li><li class="listitem"><span class="command"><strong>Favor the implementation mechanism least likely to projects/en/torbrowser/design/index.html.en 181) break sites</strong></span><p> projects/en/torbrowser/design/index.html.en 182) projects/en/torbrowser/design/index.html.en 183) In general, we try to find solutions to privacy issues that will not induce projects/en/torbrowser/design/index.html.en 184) site breakage, though this is not always possible. projects/en/torbrowser/design/index.html.en 185) projects/en/torbrowser/design/index.html.en 186) </p></li><li class="listitem"><span class="command"><strong>Plugins must be restricted</strong></span><p> projects/en/torbrowser/design/index.html.en 187) projects/en/torbrowser/design/index.html.en 188) Even if plugins always properly used the browser proxy settings (which none of projects/en/torbrowser/design/index.html.en 189) them do) and could not be induced to bypass them (which all of them can), the projects/en/torbrowser/design/index.html.en 190) activities of closed-source plugins are very difficult to audit and control. projects/en/torbrowser/design/index.html.en 191) They can obtain and transmit all manner of system information to websites, projects/en/torbrowser/design/index.html.en 192) often have their own identifier storage for tracking users, and also projects/en/torbrowser/design/index.html.en 193) contribute to fingerprinting. projects/en/torbrowser/design/index.html.en 194) projects/en/torbrowser/design/index.html.en 195) </p><p> projects/en/torbrowser/design/index.html.en 196) projects/en/torbrowser/design/index.html.en 197) Therefore, if plugins are to be enabled in private browsing modes, they must projects/en/torbrowser/design/index.html.en 198) be restricted from running automatically on every page (via click-to-play projects/en/torbrowser/design/index.html.en 199) placeholders), and/or be sandboxed to restrict the types of system calls they
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 200) can execute. If the user agent allows the user to craft an exemption to allow projects/torbrowser/design/index.html.en 201) a plugin to be used automatically, it must only apply to the top level url bar projects/torbrowser/design/index.html.en 202) domain, and not to all sites, to reduce cross-origin fingerprinting projects/torbrowser/design/index.html.en 203) linkability.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 204) projects/en/torbrowser/design/index.html.en 205) </p></li><li class="listitem"><span class="command"><strong>Minimize Global Privacy Options</strong></span><p> projects/en/torbrowser/design/index.html.en 206)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 207) <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3100" target="_top">Another`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 208) failure of Torbutton</a> was the options panel. Each option`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 209) that detectably alters browser behavior can be used as a fingerprinting tool.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 210) Similarly, all extensions <a class="ulink" href="http://blog.chromium.org/2010/06/extensions-in-incognito.html" target="_top">should be projects/torbrowser/design/index.html.en 211) disabled in the mode</a> except as an opt-in basis. We should not load`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 212) system-wide and/or Operating System provided addons or plugins.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 213) projects/en/torbrowser/design/index.html.en 214) </p><p>`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 215) Instead of global browser privacy options, privacy decisions should be made`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 216) <a class="ulink" href="https://wiki.mozilla.org/Privacy/Features/Site-based_data_management_UI" target="_top">per`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 217) url bar origin</a> to eliminate the possibility of linkability`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 218) between domains. For example, when a plugin object (or a Javascript access of projects/en/torbrowser/design/index.html.en 219) window.plugins) is present in a page, the user should be given the choice of`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 220) allowing that plugin object for that url bar origin only. The same`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 221) goes for exemptions to third party cookie policy, geolocation, and any other`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 222) privacy permissions. projects/en/torbrowser/design/index.html.en 223) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 224) If the user has indicated they wish to record local history storage, these`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 225) permissions can be written to disk. Otherwise, they should remain memory-only.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 226) </p></li><li class="listitem"><span class="command"><strong>No filters</strong></span><p> projects/en/torbrowser/design/index.html.en 227)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 228) Site-specific or filter-based addons such as <a class="ulink" href="https://addons.mozilla.org/en-US/firefox/addon/adblock-plus/" target="_top">AdBlock projects/torbrowser/design/index.html.en 229) Plus</a>, <a class="ulink" href="http://requestpolicy.com/" target="_top">Request Policy</a>, projects/torbrowser/design/index.html.en 230) <a class="ulink" href="http://www.ghostery.com/about" target="_top">Ghostery</a>, <a class="ulink" href="http://priv3.icsi.berkeley.edu/" target="_top">Priv3</a>, and <a class="ulink" href="http://sharemenot.cs.washington.edu/" target="_top">Sharemenot</a> are to be
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 231) avoided. We believe that these addons do not add any real privacy to a proper`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 232) <a class="link" href="#Implementation" title="4. Implementation">implementation</a> of the above <a class="link" href="#privacy" title="2.2. Privacy Requirements">privacy requirements</a>, and that development efforts projects/torbrowser/design/index.html.en 233) should be focused on general solutions that prevent tracking by all projects/torbrowser/design/index.html.en 234) third parties, rather than a list of specific URLs or hosts. projects/torbrowser/design/index.html.en 235) </p><p>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 236) Filter-based addons can also introduce strange breakage and cause usability projects/en/torbrowser/design/index.html.en 237) nightmares, and will also fail to do their job if an adversary simply projects/en/torbrowser/design/index.html.en 238) registers a new domain or creates a new url path. Worse still, the unique`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 239) filter sets that each user creates or installs will provide a wealth of projects/torbrowser/design/index.html.en 240) fingerprinting targets.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 241) </p><p> projects/en/torbrowser/design/index.html.en 242) projects/en/torbrowser/design/index.html.en 243) As a general matter, we are also generally opposed to shipping an always-on Ad projects/en/torbrowser/design/index.html.en 244) blocker with Tor Browser. We feel that this would damage our credibility in projects/en/torbrowser/design/index.html.en 245) terms of demonstrating that we are providing privacy through a sound design`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 246) alone, as well as damage the acceptance of Tor users by sites that support`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 247) themselves through advertising revenue. projects/en/torbrowser/design/index.html.en 248) projects/en/torbrowser/design/index.html.en 249) </p><p> projects/en/torbrowser/design/index.html.en 250) Users are free to install these addons if they wish, but doing projects/en/torbrowser/design/index.html.en 251) so is not recommended, as it will alter the browser request fingerprint. projects/en/torbrowser/design/index.html.en 252) </p></li><li class="listitem"><span class="command"><strong>Stay Current</strong></span><p> projects/en/torbrowser/design/index.html.en 253) We believe that if we do not stay current with the support of new web projects/en/torbrowser/design/index.html.en 254) technologies, we cannot hope to substantially influence or be involved in projects/en/torbrowser/design/index.html.en 255) their proper deployment or privacy realization. However, we will likely disable
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 256) high-risk features pending analysis, audit, and mitigation.`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 257) </p></li></ol></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="adversary"></a>3. Adversary Model</h2></div></div></div><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 258) projects/torbrowser/design/index.html.en 259) A Tor web browser adversary has a number of goals, capabilities, and attack projects/torbrowser/design/index.html.en 260) types that can be used to illustrate the design requirements for the projects/torbrowser/design/index.html.en 261) Tor Browser. Let's start with the goals. projects/torbrowser/design/index.html.en 262)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 263) </p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="adversary-goals"></a>3.1. Adversary Goals</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><span class="command"><strong>Bypassing proxy settings</strong></span><p>The adversary's primary goal is direct compromise and bypass of`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 264) Tor, causing the user to directly connect to an IP of the adversary's projects/torbrowser/design/index.html.en 265) choosing.</p></li><li class="listitem"><span class="command"><strong>Correlation of Tor vs Non-Tor Activity</strong></span><p>If direct proxy bypass is not possible, the adversary will likely projects/torbrowser/design/index.html.en 266) happily settle for the ability to correlate something a user did via Tor with projects/torbrowser/design/index.html.en 267) their non-Tor activity. This can be done with cookies, cache identifiers,
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 268) Javascript events, and even CSS. Sometimes the fact that a user uses Tor may`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 269) be enough for some authorities.</p></li><li class="listitem"><span class="command"><strong>History disclosure</strong></span><p> projects/torbrowser/design/index.html.en 270) The adversary may also be interested in history disclosure: the ability to projects/torbrowser/design/index.html.en 271) query a user's history to see if they have issued certain censored search projects/torbrowser/design/index.html.en 272) queries, or visited censored sites. projects/torbrowser/design/index.html.en 273) </p></li><li class="listitem"><span class="command"><strong>Correlate activity across multiple sites</strong></span><p> projects/torbrowser/design/index.html.en 274) projects/torbrowser/design/index.html.en 275) The primary goal of the advertising networks is to know that the user who projects/torbrowser/design/index.html.en 276) visited siteX.com is the same user that visited siteY.com to serve them projects/torbrowser/design/index.html.en 277) targeted ads. The advertising networks become our adversary insofar as they projects/torbrowser/design/index.html.en 278) attempt to perform this correlation without the user's explicit consent. projects/torbrowser/design/index.html.en 279) projects/torbrowser/design/index.html.en 280) </p></li><li class="listitem"><span class="command"><strong>Fingerprinting/anonymity set reduction</strong></span><p> projects/torbrowser/design/index.html.en 281) projects/torbrowser/design/index.html.en 282) Fingerprinting (more generally: "anonymity set reduction") is used to attempt
TBB design doc: More review... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 283) to gather identifying information on a particular individual without the use projects/torbrowser/design/index.html.en 284) of tracking identifiers. If the dissident or whistleblower's timezone is projects/torbrowser/design/index.html.en 285) available, and they are using a rare build of Firefox for an obscure operating projects/torbrowser/design/index.html.en 286) system, and they have a specific display resolution only used on one type of projects/torbrowser/design/index.html.en 287) laptop, this can be very useful information for tracking them down, or at projects/torbrowser/design/index.html.en 288) least <a class="link" href="#fingerprinting">tracking their activities</a>.
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 289) projects/torbrowser/design/index.html.en 290) </p></li><li class="listitem"><span class="command"><strong>History records and other on-disk projects/torbrowser/design/index.html.en 291) information</strong></span><p> projects/torbrowser/design/index.html.en 292) In some cases, the adversary may opt for a heavy-handed approach, such as projects/torbrowser/design/index.html.en 293) seizing the computers of all Tor users in an area (especially after narrowing projects/torbrowser/design/index.html.en 294) the field by the above two pieces of information). History records and cache projects/torbrowser/design/index.html.en 295) data are the primary goals here.
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 296) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="adversary-positioning"></a>3.2. Adversary Capabilities - Positioning</h3></div></div></div><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 297) The adversary can position themselves at a number of different locations in projects/torbrowser/design/index.html.en 298) order to execute their attacks.`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 299) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><span class="command"><strong>Exit Node or Upstream Router</strong></span><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 300) The adversary can run exit nodes, or alternatively, they may control routers projects/torbrowser/design/index.html.en 301) upstream of exit nodes. Both of these scenarios have been observed in the projects/torbrowser/design/index.html.en 302) wild. projects/torbrowser/design/index.html.en 303) </p></li><li class="listitem"><span class="command"><strong>Ad servers and/or Malicious Websites</strong></span><p> projects/torbrowser/design/index.html.en 304) The adversary can also run websites, or more likely, they can contract out projects/torbrowser/design/index.html.en 305) ad space from a number of different ad servers and inject content that way. For projects/torbrowser/design/index.html.en 306) some users, the adversary may be the ad servers themselves. It is not projects/torbrowser/design/index.html.en 307) inconceivable that ad servers may try to subvert or reduce a user's anonymity projects/torbrowser/design/index.html.en 308) through Tor for marketing purposes. projects/torbrowser/design/index.html.en 309) </p></li><li class="listitem"><span class="command"><strong>Local Network/ISP/Upstream Router</strong></span><p> projects/torbrowser/design/index.html.en 310) The adversary can also inject malicious content at the user's upstream router projects/torbrowser/design/index.html.en 311) when they have Tor disabled, in an attempt to correlate their Tor and Non-Tor projects/torbrowser/design/index.html.en 312) activity.
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 313) </p><p> projects/torbrowser/design/index.html.en 314) projects/torbrowser/design/index.html.en 315) Additionally, at this position the adversary can block Tor, or attempt to projects/torbrowser/design/index.html.en 316) recognize the traffic patterns of specific web pages at the entrance to the Tor projects/torbrowser/design/index.html.en 317) network. projects/torbrowser/design/index.html.en 318)`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 319) </p></li><li class="listitem"><span class="command"><strong>Physical Access</strong></span><p> projects/torbrowser/design/index.html.en 320) Some users face adversaries with intermittent or constant physical access. projects/torbrowser/design/index.html.en 321) Users in Internet cafes, for example, face such a threat. In addition, in projects/torbrowser/design/index.html.en 322) countries where simply using tools like Tor is illegal, users may face projects/torbrowser/design/index.html.en 323) confiscation of their computer equipment for excessive Tor usage or just projects/torbrowser/design/index.html.en 324) general suspicion.
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 325) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attacks"></a>3.3. Adversary Capabilities - Attacks</h3></div></div></div><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 326) projects/torbrowser/design/index.html.en 327) The adversary can perform the following attacks from a number of different projects/torbrowser/design/index.html.en 328) positions to accomplish various aspects of their goals. It should be noted projects/torbrowser/design/index.html.en 329) that many of these attacks (especially those involving IP address leakage) are projects/torbrowser/design/index.html.en 330) often performed by accident by websites that simply have Javascript, dynamic projects/torbrowser/design/index.html.en 331) CSS elements, and plugins. Others are performed by ad servers seeking to projects/torbrowser/design/index.html.en 332) correlate users' activity across different IP addresses, and still others are projects/torbrowser/design/index.html.en 333) performed by malicious agents on the Tor network and at national firewalls. projects/torbrowser/design/index.html.en 334)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 335) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><span class="command"><strong>Read and insert identifiers</strong></span><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 336) projects/torbrowser/design/index.html.en 337) The browser contains multiple facilities for storing identifiers that the projects/torbrowser/design/index.html.en 338) adversary creates for the purposes of tracking users. These identifiers are projects/torbrowser/design/index.html.en 339) most obviously cookies, but also include HTTP auth, DOM storage, cached projects/torbrowser/design/index.html.en 340) scripts and other elements with embedded identifiers, client certificates, and projects/torbrowser/design/index.html.en 341) even TLS Session IDs. projects/torbrowser/design/index.html.en 342) projects/torbrowser/design/index.html.en 343) </p><p> projects/torbrowser/design/index.html.en 344) projects/torbrowser/design/index.html.en 345) An adversary in a position to perform MITM content alteration can inject projects/torbrowser/design/index.html.en 346) document content elements to both read and inject cookies for arbitrary projects/torbrowser/design/index.html.en 347) domains. In fact, even many "SSL secured" websites are vulnerable to this sort of
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 348) <a class="ulink" href="http://seclists.org/bugtraq/2007/Aug/0070.html" target="_top">active`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 349) sidejacking</a>. In addition, the ad networks of course perform tracking projects/torbrowser/design/index.html.en 350) with cookies as well. projects/torbrowser/design/index.html.en 351) projects/torbrowser/design/index.html.en 352) </p><p> projects/torbrowser/design/index.html.en 353)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 354) These types of attacks are attempts at subverting our <a class="link" href="#identifier-linkability" title="4.5. Cross-Origin Identifier Unlinkability">Cross-Origin Identifier Unlinkability</a> and <a class="link" href="#new-identity" title="4.7. Long-Term Unlinkability via "New Identity" button">Long-Term Unlinkability</a> design requirements.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 355)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 356) </p></li><li class="listitem"><a id="fingerprinting"></a><span class="command"><strong>Fingerprint users based on browser`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 357) attributes</strong></span><p> projects/torbrowser/design/index.html.en 358) projects/torbrowser/design/index.html.en 359) There is an absurd amount of information available to websites via attributes projects/torbrowser/design/index.html.en 360) of the browser. This information can be used to reduce anonymity set, or even projects/torbrowser/design/index.html.en 361) uniquely fingerprint individual users. Attacks of this nature are typically projects/torbrowser/design/index.html.en 362) aimed at tracking users across sites without their consent, in an attempt to projects/torbrowser/design/index.html.en 363) subvert our <a class="link" href="#fingerprinting-linkability" title="4.6. Cross-Origin Fingerprinting Unlinkability">Cross-Origin
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 364) Fingerprinting Unlinkability</a> and <a class="link" href="#new-identity" title="4.7. Long-Term Unlinkability via "New Identity" button">Long-Term Unlinkability</a> design requirements.`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 365) projects/torbrowser/design/index.html.en 366) </p><p> projects/torbrowser/design/index.html.en 367) projects/torbrowser/design/index.html.en 368) Fingerprinting is an intimidating projects/torbrowser/design/index.html.en 369) problem to attempt to tackle, especially without a metric to determine or at projects/torbrowser/design/index.html.en 370) least intuitively understand and estimate which features will most contribute projects/torbrowser/design/index.html.en 371) to linkability between visits. projects/torbrowser/design/index.html.en 372) projects/torbrowser/design/index.html.en 373) </p><p> projects/torbrowser/design/index.html.en 374)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 375) The <a class="ulink" href="https://panopticlick.eff.org/about.php" target="_top">Panopticlick study projects/torbrowser/design/index.html.en 376) done</a> by the EFF uses the <a class="ulink" href="https://en.wikipedia.org/wiki/Entropy_%28information_theory%29" target="_top">Shannon`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 377) entropy</a> - the number of identifying bits of information encoded in`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 378) browser properties - as this metric. Their <a class="ulink" href="https://wiki.mozilla.org/Fingerprinting#Data" target="_top">result data</a> is`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 379) definitely useful, and the metric is probably the appropriate one for projects/torbrowser/design/index.html.en 380) determining how identifying a particular browser property is. However, some projects/torbrowser/design/index.html.en 381) quirks of their study means that they do not extract as much information as projects/torbrowser/design/index.html.en 382) they could from display information: they only use desktop resolution and do projects/torbrowser/design/index.html.en 383) not attempt to infer the size of toolbars. In the other direction, they may be projects/torbrowser/design/index.html.en 384) over-counting in some areas, as they did not compute joint entropy over projects/torbrowser/design/index.html.en 385) multiple attributes that may exhibit a high degree of correlation. Also, new projects/torbrowser/design/index.html.en 386) browser features are added regularly, so the data should not be taken as projects/torbrowser/design/index.html.en 387) final. projects/torbrowser/design/index.html.en 388) projects/torbrowser/design/index.html.en 389) </p><p> projects/torbrowser/design/index.html.en 390) projects/torbrowser/design/index.html.en 391) Despite the uncertainty, all fingerprinting attacks leverage the following projects/torbrowser/design/index.html.en 392) attack vectors: projects/torbrowser/design/index.html.en 393)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 394) </p><div class="orderedlist"><ol class="orderedlist" type="a"><li class="listitem"><span class="command"><strong>Observing Request Behavior</strong></span><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 395) projects/torbrowser/design/index.html.en 396) Properties of the user's request behavior comprise the bulk of low-hanging projects/torbrowser/design/index.html.en 397) fingerprinting targets. These include: User agent, Accept-* headers, pipeline projects/torbrowser/design/index.html.en 398) usage, and request ordering. Additionally, the use of custom filters such as projects/torbrowser/design/index.html.en 399) AdBlock and other privacy filters can be used to fingerprint request patterns projects/torbrowser/design/index.html.en 400) (as an extreme example). projects/torbrowser/design/index.html.en 401) projects/torbrowser/design/index.html.en 402) </p></li><li class="listitem"><span class="command"><strong>Inserting Javascript</strong></span><p> projects/torbrowser/design/index.html.en 403) projects/torbrowser/design/index.html.en 404) Javascript can reveal a lot of fingerprinting information. It provides DOM projects/torbrowser/design/index.html.en 405) objects such as window.screen and window.navigator to extract information projects/torbrowser/design/index.html.en 406) about the useragent. projects/torbrowser/design/index.html.en 407) projects/torbrowser/design/index.html.en 408) Also, Javascript can be used to query the user's timezone via the
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 409) <code class="function">Date()</code> object, <a class="ulink" href="https://www.khronos.org/registry/webgl/specs/1.0/#5.13" target="_top">WebGL</a> can`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 410) reveal information about the video card in use, and high precision timing`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 411) information can be used to <a class="ulink" href="http://w2spconf.com/2011/papers/jspriv.pdf" target="_top">fingerprint the CPU and`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 412) interpreter speed</a>. In the future, new JavaScript features such as`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 413) <a class="ulink" href="http://w3c-test.org/webperf/specs/ResourceTiming/" target="_top">Resource`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 414) Timing</a> may leak an unknown amount of network timing related projects/torbrowser/design/index.html.en 415) information. projects/torbrowser/design/index.html.en 416) projects/torbrowser/design/index.html.en 417) projects/torbrowser/design/index.html.en 418) projects/torbrowser/design/index.html.en 419) </p></li><li class="listitem"><span class="command"><strong>Inserting Plugins</strong></span><p> projects/torbrowser/design/index.html.en 420) projects/torbrowser/design/index.html.en 421) The Panopticlick project found that the mere list of installed plugins (in projects/torbrowser/design/index.html.en 422) navigator.plugins) was sufficient to provide a large degree of projects/torbrowser/design/index.html.en 423) fingerprintability. Additionally, plugins are capable of extracting font lists, projects/torbrowser/design/index.html.en 424) interface addresses, and other machine information that is beyond what the projects/torbrowser/design/index.html.en 425) browser would normally provide to content. In addition, plugins can be used to projects/torbrowser/design/index.html.en 426) store unique identifiers that are more difficult to clear than standard
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 427) cookies. <a class="ulink" href="http://epic.org/privacy/cookies/flash.html" target="_top">Flash-based`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 428) cookies</a> fall into this category, but there are likely numerous other projects/torbrowser/design/index.html.en 429) examples. Beyond fingerprinting, plugins are also abysmal at obeying the proxy projects/torbrowser/design/index.html.en 430) settings of the browser. projects/torbrowser/design/index.html.en 431) projects/torbrowser/design/index.html.en 432) projects/torbrowser/design/index.html.en 433) </p></li><li class="listitem"><span class="command"><strong>Inserting CSS</strong></span><p> projects/torbrowser/design/index.html.en 434)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 435) <a class="ulink" href="https://developer.mozilla.org/En/CSS/Media_queries" target="_top">CSS media`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 436) queries</a> can be inserted to gather information about the desktop size, projects/torbrowser/design/index.html.en 437) widget size, display type, DPI, user agent type, and other information that projects/torbrowser/design/index.html.en 438) was formerly available only to Javascript. projects/torbrowser/design/index.html.en 439)`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 440) </p></li></ol></div></li><li class="listitem"><a id="website-traffic-fingerprinting"></a><span class="command"><strong>Website traffic fingerprinting</strong></span><p> projects/torbrowser/design/index.html.en 441) projects/torbrowser/design/index.html.en 442) Website traffic fingerprinting is an attempt by the adversary to recognize the`
TBB design doc: More review... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 443) encrypted traffic patterns of specific websites. In the case of Tor, this projects/torbrowser/design/index.html.en 444) attack would take place between the user and the Guard node, or at the Guard projects/torbrowser/design/index.html.en 445) node itself. projects/torbrowser/design/index.html.en 446) </p><p> The most comprehensive study of the statistical properties of this projects/torbrowser/design/index.html.en 447) attack against Tor was done by <a class="ulink" href="http://lorre.uni.lu/~andriy/papers/acmccs-wpes11-fingerprinting.pdf" target="_top">Panchenko
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 448) et al</a>. Unfortunately, the publication bias in academia has encouraged projects/torbrowser/design/index.html.en 449) the production of a number of follow-on attack papers claiming "improved"`
TBB design doc: More review... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 450) success rates, in some cases even claiming to completely invalidate any projects/torbrowser/design/index.html.en 451) attempt at defense. These "improvements" are actually enabled primarily by projects/torbrowser/design/index.html.en 452) taking a number of shortcuts (such as classifying only very small numbers of projects/torbrowser/design/index.html.en 453) web pages, neglecting to publish ROC curves or at least false positive rates, projects/torbrowser/design/index.html.en 454) and/or omitting the effects of dataset size on their results). Despite these projects/torbrowser/design/index.html.en 455) subsequent "improvements", we are skeptical of the efficacy of this attack in projects/torbrowser/design/index.html.en 456) a real world scenario, <span class="emphasis"><em>especially</em></span> in the face of any
TBB design doc: Clarify web... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 457) defenses.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 458) projects/torbrowser/design/index.html.en 459) </p><p> projects/torbrowser/design/index.html.en 460)`
TBB design doc: Clarify web... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 461) In general, with machine learning, as you increase the <a class="ulink" href="https://en.wikipedia.org/wiki/VC_dimension" target="_top">number and/or complexity of projects/torbrowser/design/index.html.en 462) categories to classify</a> while maintaining a limit on reliable feature projects/torbrowser/design/index.html.en 463) information you can extract, you eventually run out of descriptive feature projects/torbrowser/design/index.html.en 464) information, and either true positive accuracy goes down or the false positive projects/torbrowser/design/index.html.en 465) rate goes up. This error is called the <a class="ulink" href="http://www.cs.washington.edu/education/courses/csep573/98sp/lectures/lecture8/sld050.htm" target="_top">bias projects/torbrowser/design/index.html.en 466) in your hypothesis space</a>. In fact, even for unbiased hypothesis projects/torbrowser/design/index.html.en 467) spaces, the number of training examples required to achieve a reasonable error projects/torbrowser/design/index.html.en 468) bound is <a class="ulink" href="https://en.wikipedia.org/wiki/Probably_approximately_correct_learning#Equivalence" target="_top">a
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 469) function of the complexity of the categories</a> you need to classify.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 470) projects/torbrowser/design/index.html.en 471) </p><p> projects/torbrowser/design/index.html.en 472) projects/torbrowser/design/index.html.en 473) projects/torbrowser/design/index.html.en 474) In the case of this attack, the key factors that increase the classification`
TBB design doc: Clarify web... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 475) complexity (and thus hinder a real world adversary who attempts this attack)`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 476) are large numbers of dynamically generated pages, partially cached content,`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 477) and also the non-web activity of entire Tor network. This yields an effective projects/torbrowser/design/index.html.en 478) number of "web pages" many orders of magnitude larger than even <a class="ulink" href="http://lorre.uni.lu/~andriy/papers/acmccs-wpes11-fingerprinting.pdf" target="_top">Panchenko's`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 479) "Open World" scenario</a>, which suffered continuous near-constant decline`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 480) in the true positive rate as the "Open World" size grew (see figure 4). This projects/torbrowser/design/index.html.en 481) large level of classification complexity is further confounded by a noisy and`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 482) low resolution featureset - one which is also relatively easy for the defender`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 483) to manipulate at low cost.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 484) projects/torbrowser/design/index.html.en 485) </p><p> projects/torbrowser/design/index.html.en 486)`
TBB Design Doc: Mention use... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 487) To make matters worse for a real-world adversary, the ocean of Tor Internet projects/torbrowser/design/index.html.en 488) activity (at least, when compared to a lab setting) makes it a certainty that projects/torbrowser/design/index.html.en 489) an adversary attempting examine large amounts of Tor traffic will ultimately projects/torbrowser/design/index.html.en 490) be overwhelmed by false positives (even after making heavy tradeoffs on the projects/torbrowser/design/index.html.en 491) ROC curve to minimize false positives to below 0.01%). This problem is known projects/torbrowser/design/index.html.en 492) in the IDS literature as the <a class="ulink" href="http://www.raid-symposium.org/raid99/PAPERS/Axelsson.pdf" target="_top">Base Rate
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 493) Fallacy</a>, and it is the primary reason that anomaly and activity projects/torbrowser/design/index.html.en 494) classification-based IDS and antivirus systems have failed to materialize in`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 495) the marketplace (despite early success in academic literature).`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 496) projects/torbrowser/design/index.html.en 497) </p><p> projects/torbrowser/design/index.html.en 498) projects/torbrowser/design/index.html.en 499) Still, we do not believe that these issues are enough to dismiss the attack projects/torbrowser/design/index.html.en 500) outright. But we do believe these factors make it both worthwhile and projects/torbrowser/design/index.html.en 501) effective to <a class="link" href="#traffic-fingerprinting-defenses">deploy projects/torbrowser/design/index.html.en 502) light-weight defenses</a> that reduce the accuracy of this attack by projects/torbrowser/design/index.html.en 503) further contributing noise to hinder successful feature extraction. projects/torbrowser/design/index.html.en 504) projects/torbrowser/design/index.html.en 505) </p></li><li class="listitem"><span class="command"><strong>Remotely or locally exploit browser and/or
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 506) OS</strong></span><p> projects/torbrowser/design/index.html.en 507) projects/torbrowser/design/index.html.en 508) Last, but definitely not least, the adversary can exploit either general projects/torbrowser/design/index.html.en 509) browser vulnerabilities, plugin vulnerabilities, or OS vulnerabilities to projects/torbrowser/design/index.html.en 510) install malware and surveillance software. An adversary with physical access`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 511) can perform similar actions. projects/torbrowser/design/index.html.en 512) projects/torbrowser/design/index.html.en 513) </p><p> projects/torbrowser/design/index.html.en 514) projects/torbrowser/design/index.html.en 515) For the purposes of the browser itself, we limit the scope of this adversary projects/torbrowser/design/index.html.en 516) to one that has passive forensic access to the disk after browsing activity projects/torbrowser/design/index.html.en 517) has taken place. This adversary motivates our
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 518) <a class="link" href="#disk-avoidance" title="4.3. Disk Avoidance">Disk Avoidance</a> defenses.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 519)`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 520) </p><p> projects/torbrowser/design/index.html.en 521) projects/torbrowser/design/index.html.en 522) An adversary with arbitrary code execution typically has more power, though. projects/torbrowser/design/index.html.en 523) It can be quite hard to really significantly limit the capabilities of such an`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 524) adversary. <a class="ulink" href="http://tails.boum.org/contribute/design/" target="_top">The Tails system</a> can`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 525) provide some defense against this adversary through the use of readonly media projects/torbrowser/design/index.html.en 526) and frequent reboots, but even this can be circumvented on machines without projects/torbrowser/design/index.html.en 527) Secure Boot through the use of BIOS rootkits. projects/torbrowser/design/index.html.en 528)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 529) </p></li></ol></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Implementation"></a>4. Implementation</h2></div></div></div><p>`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 530) projects/torbrowser/design/index.html.en 531) The Implementation section is divided into subsections, each of which projects/torbrowser/design/index.html.en 532) corresponds to a <a class="link" href="#DesignRequirements" title="2. Design Requirements and Philosophy">Design Requirement</a>. projects/torbrowser/design/index.html.en 533) Each subsection is divided into specific web technologies or properties. The projects/torbrowser/design/index.html.en 534) implementation is then described for that property. projects/torbrowser/design/index.html.en 535) projects/torbrowser/design/index.html.en 536) </p><p> projects/torbrowser/design/index.html.en 537) projects/torbrowser/design/index.html.en 538) In some cases, the implementation meets the design requirements in a non-ideal projects/torbrowser/design/index.html.en 539) way (for example, by disabling features). In rare cases, there may be no projects/torbrowser/design/index.html.en 540) implementation at all. Both of these cases are denoted by differentiating projects/torbrowser/design/index.html.en 541) between the <span class="command"><strong>Design Goal</strong></span> and the <span class="command"><strong>Implementation
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 542) Status</strong></span> for each property. Corresponding bugs in the <a class="ulink" href="https://trac.torproject.org/projects/tor/report" target="_top">Tor bug tracker</a>`
Update TBB design doc w/ an... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 543) are typically linked for these cases. projects/torbrowser/design/index.html.en 544)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 545) </p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="proxy-obedience"></a>4.1. Proxy Obedience</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 546) projects/en/torbrowser/design/index.html.en 547) Proxy obedience is assured through the following:`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 548) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">Firefox proxy settings, patches, and build flags`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 549) <p>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 550) projects/torbrowser/design/index.html.en 551) Our <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/blob/refs/heads/tor-browser-31.2.0esr-4.x-1:/browser/app/profile/000-tor-browser.js" target="_top">Firefox projects/torbrowser/design/index.html.en 552) preferences file</a> sets the Firefox proxy settings to use Tor directly projects/torbrowser/design/index.html.en 553) as a SOCKS proxy. It sets <span class="command"><strong>network.proxy.socks_remote_dns</strong></span>,
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 554) <span class="command"><strong>network.proxy.socks_version</strong></span>, projects/torbrowser/design/index.html.en 555) <span class="command"><strong>network.proxy.socks_port</strong></span>, and projects/torbrowser/design/index.html.en 556) <span class="command"><strong>network.dns.disablePrefetch</strong></span>.`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 557)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 558) </p><p> projects/torbrowser/design/index.html.en 559)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 560) To prevent proxy bypass by WebRTC calls, we disable WebRTC at compile time projects/torbrowser/design/index.html.en 561) with the <span class="command"><strong>--disable-webrtc</strong></span> configure switch, as well projects/torbrowser/design/index.html.en 562) as set the pref <span class="command"><strong>media.peerconnection.enabled</strong></span> to false.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 563) projects/torbrowser/design/index.html.en 564) </p><p> projects/torbrowser/design/index.html.en 565)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 566) We also patch Firefox in order to provide several defense-in-depth mechanisms projects/torbrowser/design/index.html.en 567) for proxy safety. Notably, we <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/8527bec0ad59fb3d885c5639735fb188eefa336f" target="_top">patch projects/torbrowser/design/index.html.en 568) the DNS service</a> to prevent any browser or addon DNS resolution, and we projects/torbrowser/design/index.html.en 569) also <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/04c046e11f6622f44ca010bcb8ecf68cf470a4c0" target="_top">patch projects/torbrowser/design/index.html.en 570) OCSP and PKIX code</a> to prevent any use of the non-proxied command-line projects/torbrowser/design/index.html.en 571) tool utility functions from being functional while linked in to the browser. projects/torbrowser/design/index.html.en 572) In both cases, we could find no direct paths to these routines in the browser, projects/torbrowser/design/index.html.en 573) but it seemed better safe than sorry.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 574)`
Comments from Georg + proxy... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 575) </p><p> projects/torbrowser/design/index.html.en 576)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 577) During every Extended Support Release transition, we perform <a class="ulink" href="https://gitweb.torproject.org/tor-browser-spec.git/tree/HEAD:/audits" target="_top">in-depth projects/torbrowser/design/index.html.en 578) code audits</a> to verify that there were no system calls or XPCOM projects/torbrowser/design/index.html.en 579) activity in the source tree that did not use the browser proxy settings. projects/torbrowser/design/index.html.en 580) </p><p> projects/torbrowser/design/index.html.en 581)
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 582) We have verified that these settings and patches properly proxy HTTPS, OCSP,`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 583) HTTP, FTP, gopher (now defunct), DNS, SafeBrowsing Queries, all JavaScript`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 584) activity, including HTML5 audio and video objects, addon updates, wifi projects/torbrowser/design/index.html.en 585) geolocation queries, searchbox queries, XPCOM addon HTTPS/HTTP activity, projects/torbrowser/design/index.html.en 586) WebSockets, and live bookmark updates. We have also verified that IPv6 projects/torbrowser/design/index.html.en 587) connections are not attempted, through the proxy or otherwise (Tor does not projects/torbrowser/design/index.html.en 588) yet support IPv6). We have also verified that external protocol helpers, such projects/torbrowser/design/index.html.en 589) as smb urls and other custom protocol handlers are all blocked.
Comments from Georg + proxy... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 590) projects/torbrowser/design/index.html.en 591) </p><p> projects/torbrowser/design/index.html.en 592)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 593) Numerous other third parties have also reviewed and tested the proxy settings`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 594) and have provided test cases based on their work. See in particular <a class="ulink" href="http://decloak.net/" target="_top">decloak.net</a>.`
Comments from Georg + proxy... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 595)`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 596) </p></li><li class="listitem">Disabling plugins`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 597)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 598) <p>Plugins have the ability to make arbitrary OS system calls and <a class="ulink" href="http://decloak.net/" target="_top">bypass proxy settings</a>. This includes`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 599) the ability to make UDP sockets and send arbitrary data independent of the projects/en/torbrowser/design/index.html.en 600) browser proxy settings. projects/en/torbrowser/design/index.html.en 601) </p><p> projects/en/torbrowser/design/index.html.en 602) Torbutton disables plugins by using the projects/en/torbrowser/design/index.html.en 603) <span class="command"><strong>@mozilla.org/plugin/host;1</strong></span> service to mark the plugin tags`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 604) as disabled. This block can be undone through both the Torbutton Security UI, projects/torbrowser/design/index.html.en 605) and the Firefox Plugin Preferences.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 606) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 607) If the user does enable plugins in this way, plugin-handled objects are still projects/torbrowser/design/index.html.en 608) restricted from automatic load through Firefox's click-to-play preference projects/torbrowser/design/index.html.en 609) <span class="command"><strong>plugins.click_to_play</strong></span>.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 610) </p><p>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 611)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 612) In addition, to reduce any unproxied activity by arbitrary plugins at load projects/torbrowser/design/index.html.en 613) time, and to reduce the fingerprintability of the installed plugin list, we`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 614) also patch the Firefox source code to <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/2ecf6c33618ecee554155f735a3e92860f519f9c" target="_top"> projects/torbrowser/design/index.html.en 615) prevent the load of any plugins except for Flash and Gnash</a>.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 616)`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 617) </p></li><li class="listitem">External App Blocking and Drag Event Filtering`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 618) <p>`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 619) projects/torbrowser/design/index.html.en 620) External apps can be induced to load files that perform network activity. projects/torbrowser/design/index.html.en 621) Unfortunately, there are cases where such apps can be launched automatically projects/torbrowser/design/index.html.en 622) with little to no user input. In order to prevent this, Torbutton installs a projects/torbrowser/design/index.html.en 623) component to <a class="ulink" href="https://gitweb.torproject.org/torbutton.git/blob_plain/HEAD:/src/components/external-app-blocker.js" target="_top"> projects/torbrowser/design/index.html.en 624) provide the user with a popup</a> whenever the browser attempts to launch projects/torbrowser/design/index.html.en 625) a helper app. projects/torbrowser/design/index.html.en 626) projects/torbrowser/design/index.html.en 627) </p><p> projects/torbrowser/design/index.html.en 628) projects/torbrowser/design/index.html.en 629) Additionally, modern desktops now pre-emptively fetch any URLs in Drag and projects/torbrowser/design/index.html.en 630) Drop events as soon as the drag is initiated. This download happens projects/torbrowser/design/index.html.en 631) independent of the browser's Tor settings, and can be triggered by something projects/torbrowser/design/index.html.en 632) as simple as holding the mouse button down for slightly too long while
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 633) clicking on an image link. We filter drag and drop events events <a class="ulink" href="https://gitweb.torproject.org/torbutton.git/blob_plain/HEAD:/src/components/external-app-blocker.js" target="_top">from projects/torbrowser/design/index.html.en 634) Torbutton</a> before the OS downloads the URLs the events contained.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 635)`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 636) </p></li><li class="listitem">Disabling system extensions and clearing the addon whitelist projects/torbrowser/design/index.html.en 637) <p> projects/torbrowser/design/index.html.en 638) projects/torbrowser/design/index.html.en 639) Firefox addons can perform arbitrary activity on your computer, including projects/torbrowser/design/index.html.en 640) bypassing Tor. It is for this reason we disable the addon whitelist projects/torbrowser/design/index.html.en 641) (<span class="command"><strong>xpinstall.whitelist.add</strong></span>), so that users are prompted projects/torbrowser/design/index.html.en 642) before installing addons regardless of the source. We also exclude projects/torbrowser/design/index.html.en 643) system-level addons from the browser through the use of projects/torbrowser/design/index.html.en 644) <span class="command"><strong>extensions.enabledScopes</strong></span> and projects/torbrowser/design/index.html.en 645) <span class="command"><strong>extensions.autoDisableScopes</strong></span>. projects/torbrowser/design/index.html.en 646)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 647) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="state-separation"></a>4.2. State Separation</h3></div></div></div><p>`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 648)`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 649) Tor Browser State is separated from existing browser state through use of a`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 650) custom Firefox profile, and by setting the $HOME environment variable to the projects/torbrowser/design/index.html.en 651) root of the bundle's directory. The browser also does not load any projects/torbrowser/design/index.html.en 652) system-wide extensions (through the use of projects/torbrowser/design/index.html.en 653) <span class="command"><strong>extensions.enabledScopes</strong></span> and`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 654) <span class="command"><strong>extensions.autoDisableScopes</strong></span>). Furthermore, plugins are`
TBB design doc: Fix typos,... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 655) disabled, which prevents Flash cookies from leaking from a pre-existing Flash projects/torbrowser/design/index.html.en 656) directory. projects/torbrowser/design/index.html.en 657)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 658) </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="disk-avoidance"></a>4.3. Disk Avoidance</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36779392"></a>Design Goal:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote">`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 659) projects/torbrowser/design/index.html.en 660) The User Agent MUST (at user option) prevent all disk records of browser activity.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 661) The user should be able to optionally enable URL history and other history`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 662) features if they so desire.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 663)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 664) </blockquote></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36780752"></a>Implementation Status:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote">`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 665)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 666) We achieve this goal through several mechanisms. First, we set the Firefox projects/torbrowser/design/index.html.en 667) Private Browsing preference projects/torbrowser/design/index.html.en 668) <span class="command"><strong>browser.privatebrowsing.autostart</strong></span>. In addition, four Firefox patches are needed to prevent disk writes, even if projects/torbrowser/design/index.html.en 669) Private Browsing Mode is enabled. We need to`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 670)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 671) <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/4ebc3cda4b704c0149fb9e0fdcbb6e5ee3a8e75c" target="_top">prevent projects/torbrowser/design/index.html.en 672) the permissions manager from recording HTTPS STS state</a>, <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/8904bfc10cd537bd35be5ddd23c58fdaa72baa21" target="_top">prevent projects/torbrowser/design/index.html.en 673) intermediate SSL certificates from being recorded</a>, <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/86f6bc9dc28b6f8d7eae7974c7e9b537c3a08e41" target="_top">prevent projects/torbrowser/design/index.html.en 674) the clipboard cache from being written to disk for large pastes</a>, and projects/torbrowser/design/index.html.en 675) <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/d5da6f8b7de089335e49e2f7dbd2b8d74e4cb613" target="_top">prevent projects/torbrowser/design/index.html.en 676) the content preferences service from recording site zoom</a>. We also had projects/torbrowser/design/index.html.en 677) to disable the media cache with the pref <span class="command"><strong>media.cache_size</strong></span>, projects/torbrowser/design/index.html.en 678) to prevent HTML5 videos from being written to the OS temporary directory, projects/torbrowser/design/index.html.en 679) which happened regardless of the private browsing mode setting.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 680) projects/torbrowser/design/index.html.en 681) </blockquote></div><div class="blockquote"><blockquote class="blockquote"> projects/torbrowser/design/index.html.en 682) projects/torbrowser/design/index.html.en 683) As an additional defense-in-depth measure, we set the following preferences:`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 684) <span class="command"><strong></strong></span>,`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 685) <span class="command"><strong>browser.cache.disk.enable</strong></span>, projects/en/torbrowser/design/index.html.en 686) <span class="command"><strong>browser.cache.offline.enable</strong></span>,`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 687) <span class="command"><strong>dom.indexedDB.enabled</strong></span>, projects/torbrowser/design/index.html.en 688) <span class="command"><strong>network.cookie.lifetimePolicy</strong></span>,`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 689) <span class="command"><strong>signon.rememberSignons</strong></span>,`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 690) <span class="command"><strong>browser.formfill.enable</strong></span>,`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 691) <span class="command"><strong>browser.download.manager.retention</strong></span>,`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 692) <span class="command"><strong>browser.sessionstore.privacy_level</strong></span>, projects/torbrowser/design/index.html.en 693) and <span class="command"><strong>network.cookie.lifetimePolicy</strong></span>. Many of these projects/torbrowser/design/index.html.en 694) preferences are likely redundant with projects/torbrowser/design/index.html.en 695) <span class="command"><strong>browser.privatebrowsing.autostart</strong></span>, but we have not done the projects/torbrowser/design/index.html.en 696) auditing work to ensure that yet.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 697)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 698) </blockquote></div><div class="blockquote"><blockquote class="blockquote">`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 699)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 700) For more details on disk leak bugs and enhancements, see the <a class="ulink" href="https://trac.torproject.org/projects/tor/query?keywords=~tbb-disk-leak&status=!closed" target="_top">tbb-disk-leak tag in our bugtracker</a></blockquote></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="app-data-isolation"></a>4.4. Application Data Isolation</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 701) projects/en/torbrowser/design/index.html.en 702) Tor Browser Bundle MUST NOT cause any information to be written outside of the projects/en/torbrowser/design/index.html.en 703) bundle directory. This is to ensure that the user is able to completely and projects/en/torbrowser/design/index.html.en 704) safely remove the bundle without leaving other traces of Tor usage on their projects/en/torbrowser/design/index.html.en 705) computer. projects/en/torbrowser/design/index.html.en 706)
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 707) </p><p> projects/torbrowser/design/index.html.en 708) projects/torbrowser/design/index.html.en 709) To ensure TBB directory isolation, we set projects/torbrowser/design/index.html.en 710) <span class="command"><strong>browser.download.useDownloadDir</strong></span>, projects/torbrowser/design/index.html.en 711) <span class="command"><strong>browser.shell.checkDefaultBrowser</strong></span>, and projects/torbrowser/design/index.html.en 712) <span class="command"><strong>browser.download.manager.addToRecentDocs</strong></span>. We also set the projects/torbrowser/design/index.html.en 713) $HOME environment variable to be the TBB extraction directory.
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 714) </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="identifier-linkability"></a>4.5. Cross-Origin Identifier Unlinkability</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 715) projects/en/torbrowser/design/index.html.en 716) The Tor Browser MUST prevent a user's activity on one site from being linked projects/en/torbrowser/design/index.html.en 717) to their activity on another site. When this goal cannot yet be met with an projects/en/torbrowser/design/index.html.en 718) existing web technology, that technology or functionality is disabled. Our projects/en/torbrowser/design/index.html.en 719) <a class="link" href="#privacy" title="2.2. Privacy Requirements">design goal</a> is to ultimately eliminate the need to disable arbitrary projects/en/torbrowser/design/index.html.en 720) technologies, and instead simply alter them in ways that allows them to projects/en/torbrowser/design/index.html.en 721) function in a backwards-compatible way while avoiding linkability. Users projects/en/torbrowser/design/index.html.en 722) should be able to use federated login of various kinds to explicitly inform projects/en/torbrowser/design/index.html.en 723) sites who they are, but that information should not transparently allow a projects/en/torbrowser/design/index.html.en 724) third party to record their activity from site to site without their prior projects/en/torbrowser/design/index.html.en 725) consent. projects/en/torbrowser/design/index.html.en 726) projects/en/torbrowser/design/index.html.en 727) </p><p> projects/en/torbrowser/design/index.html.en 728) projects/en/torbrowser/design/index.html.en 729) The benefit of this approach comes not only in the form of reduced projects/en/torbrowser/design/index.html.en 730) linkability, but also in terms of simplified privacy UI. If all stored browser
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 731) state and permissions become associated with the url bar origin, the six or projects/torbrowser/design/index.html.en 732) seven different pieces of privacy UI governing these identifiers and`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 733) permissions can become just one piece of UI. For instance, a window that lists`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 734) the url bar origin for which browser state exists, possibly with a projects/torbrowser/design/index.html.en 735) context-menu option to drill down into specific types of state or permissions. projects/torbrowser/design/index.html.en 736) An example of this simplification can be seen in Figure 1.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 737)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 738) </p><div class="figure"><a id="idp36803456"></a><p class="title"><strong>Figure 1. Improving the Privacy UI</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="NewCookieManager.png" align="middle" alt="Improving the Privacy UI" /></div><div class="caption"><p></p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 739)`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 740) This example UI is a mock-up of how isolating identifiers to the URL bar projects/torbrowser/design/index.html.en 741) origin can simplify the privacy UI for all data - not just cookies. Once projects/torbrowser/design/index.html.en 742) browser identifiers and site permissions operate on a url bar basis, the same projects/torbrowser/design/index.html.en 743) privacy window can represent browsing history, DOM Storage, HTTP Auth, search projects/torbrowser/design/index.html.en 744) form history, login values, and so on within a context menu for each site.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 745)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 746) </div></div></div><br class="figure-break" /><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">Cookies`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 747) <p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 748)`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 749) All cookies MUST be double-keyed to the url bar origin and third-party`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 750) origin. There exists a <a class="ulink" href="https://bugzilla.mozilla.org/show_bug.cgi?id=565965" target="_top">Mozilla bug</a>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 751) that contains a prototype patch, but it lacks UI, and does not apply to modern projects/torbrowser/design/index.html.en 752) Firefoxes.`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 753) projects/en/torbrowser/design/index.html.en 754) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 755) projects/en/torbrowser/design/index.html.en 756) As a stopgap to satisfy our design requirement of unlinkability, we currently projects/en/torbrowser/design/index.html.en 757) entirely disable 3rd party cookies by setting projects/en/torbrowser/design/index.html.en 758) <span class="command"><strong>network.cookie.cookieBehavior</strong></span> to 1. We would prefer that
Comments from Georg + proxy... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 759) third party content continue to function, but we believe the requirement for`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 760) unlinkability trumps that desire. projects/en/torbrowser/design/index.html.en 761) projects/en/torbrowser/design/index.html.en 762) </p></li><li class="listitem">Cache projects/en/torbrowser/design/index.html.en 763) <p>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 764) projects/torbrowser/design/index.html.en 765) Cache is isolated to the url bar origin by using a technique pioneered by`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 766) Colin Jackson et al, via their work on <a class="ulink" href="http://www.safecache.com/" target="_top">SafeCache</a>. The technique re-uses the projects/torbrowser/design/index.html.en 767) <a class="ulink" href="https://developer.mozilla.org/en/XPCOM_Interface_Reference/nsICachingChannel" target="_top">nsICachingChannel.cacheKey</a>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 768) attribute that Firefox uses internally to prevent improper caching and reuse projects/torbrowser/design/index.html.en 769) of HTTP POST data. projects/torbrowser/design/index.html.en 770)`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 771) </p><p>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 772)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 773) However, to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3666" target="_top">increase the projects/torbrowser/design/index.html.en 774) security of the isolation</a> and to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3754" target="_top">solve conflicts`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 775) with OCSP relying the cacheKey property for reuse of POST requests</a>, we`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 776) had to <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0004-Add-a-string-based-cacheKey.patch" target="_top">patch`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 777) Firefox to provide a cacheDomain cache attribute</a>. We use the fully`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 778) qualified url bar domain as input to this field, to avoid the complexities projects/torbrowser/design/index.html.en 779) of heuristically determining the second-level DNS name.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 780)`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 781) </p><p> projects/en/torbrowser/design/index.html.en 782)`
Update TBB design doc with... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 783) Furthermore, we chose a different projects/torbrowser/design/index.html.en 784) isolation scheme than the Stanford implementation. First, we decoupled the projects/torbrowser/design/index.html.en 785) cache isolation from the third party cookie attribute. Second, we use several projects/torbrowser/design/index.html.en 786) mechanisms to attempt to determine the actual location attribute of the projects/torbrowser/design/index.html.en 787) top-level window (to obtain the url bar FQDN) used to load the page, as
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 788) opposed to relying solely on the Referer property.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 789) projects/en/torbrowser/design/index.html.en 790) </p><p>`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 791)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 792) Therefore, <a class="ulink" href="http://crypto.stanford.edu/sameorigin/safecachetest.html" target="_top">the original`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 793) Stanford test cases</a> are expected to fail. Functionality can still be`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 794) verified by navigating to <a class="ulink" href="about:cache" target="_top">about:cache</a> and`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 795) viewing the key used for each cache entry. Each third party element should projects/torbrowser/design/index.html.en 796) have an additional "domain=string" property prepended, which will list the projects/torbrowser/design/index.html.en 797) FQDN that was used to source the third party element. projects/torbrowser/design/index.html.en 798)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 799) </p><p> projects/torbrowser/design/index.html.en 800) projects/torbrowser/design/index.html.en 801) Additionally, because the image cache is a separate entity from the content`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 802) cache, we had to patch Firefox to also <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0024-Isolate-the-Image-Cache-per-url-bar-domain.patch" target="_top">isolate`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 803) this cache per url bar domain</a>. projects/torbrowser/design/index.html.en 804)`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 805) </p></li><li class="listitem">HTTP Auth projects/en/torbrowser/design/index.html.en 806) <p> projects/en/torbrowser/design/index.html.en 807) projects/en/torbrowser/design/index.html.en 808) HTTP authentication tokens are removed for third party elements using the`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 809) <a class="ulink" href="https://developer.mozilla.org/en/Setting_HTTP_request_headers#Observers" target="_top">http-on-modify-request projects/torbrowser/design/index.html.en 810) observer</a> to remove the Authorization headers to prevent <a class="ulink" href="http://jeremiahgrossman.blogspot.com/2007/04/tracking-users-without-cookies.html" target="_top">silent`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 811) linkability between domains</a>.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 812) </p></li><li class="listitem">DOM Storage`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 813) <p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 814)`
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 815) DOM storage for third party domains MUST be isolated to the url bar origin,`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 816) to prevent linkability between sites. This functionality is provided through a`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 817) <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0026-Isolate-DOM-storage-to-first-party-URI.patch" target="_top">patch`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 818) to Firefox</a>.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 819)`
Describe our efforts agains... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 820) </p></li><li class="listitem">Flash cookies projects/torbrowser/design/index.html.en 821) <p><span class="command"><strong>Design Goal:</strong></span> projects/torbrowser/design/index.html.en 822) projects/torbrowser/design/index.html.en 823) Users should be able to click-to-play flash objects from trusted sites. To projects/torbrowser/design/index.html.en 824) make this behavior unlinkable, we wish to include a settings file for all platforms that disables flash
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 825) cookies using the <a class="ulink" href="http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager03.html" target="_top">Flash`
Describe our efforts agains... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 826) settings manager</a>.`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 827)`
Describe our efforts agains... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 828) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/torbrowser/design/index.html.en 829)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 830) We are currently <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3974" target="_top">having`
Describe our efforts agains... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 831) difficulties</a> causing Flash player to use this settings`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 832) file on Windows, so Flash remains difficult to enable.`
Describe our efforts agains... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 833)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 834) </p></li><li class="listitem">SSL+TLS session resumption, HTTP Keep-Alive and SPDY`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 835) <p><span class="command"><strong>Design Goal:</strong></span>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 836)`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 837) TLS session resumption tickets and SSL Session IDs MUST be limited to the url projects/torbrowser/design/index.html.en 838) bar origin. HTTP Keep-Alive connections from a third party in one url bar projects/torbrowser/design/index.html.en 839) origin MUST NOT be reused for that same third party in another url bar origin.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 840) projects/en/torbrowser/design/index.html.en 841) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 842)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 843) We currently clear SSL Session IDs upon <a class="link" href="#new-identity" title="4.7. Long-Term Unlinkability via "New Identity" button">New`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 844) Identity</a>, we disable TLS Session Tickets via the Firefox Pref projects/torbrowser/design/index.html.en 845) <span class="command"><strong>security.enable_tls_session_tickets</strong></span>. We disable SSL Session`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 846) IDs via a <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0008-Disable-SSL-Session-ID-tracking.patch" target="_top">patch`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 847) to Firefox</a>. To compensate for the increased round trip latency from disabling projects/torbrowser/design/index.html.en 848) these performance optimizations, we also enable`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 849) <a class="ulink" href="https://tools.ietf.org/html/draft-bmoeller-tls-falsestart-00" target="_top">TLS`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 850) False Start</a> via the Firefox Pref projects/torbrowser/design/index.html.en 851) <span class="command"><strong>security.ssl.enable_false_start</strong></span>. projects/torbrowser/design/index.html.en 852) </p><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 853)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 854) Because of the extreme performance benefits of HTTP Keep-Alive for interactive`
Update design doc. Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 855) web apps, and because of the difficulties of conveying urlbar origin projects/torbrowser/design/index.html.en 856) information down into the Firefox HTTP layer, as a compromise we currently projects/torbrowser/design/index.html.en 857) merely reduce the HTTP Keep-Alive timeout to 20 seconds (which is measured projects/torbrowser/design/index.html.en 858) from the last packet read on the connection) using the Firefox preference projects/torbrowser/design/index.html.en 859) <span class="command"><strong>network.http.keep-alive.timeout</strong></span>. projects/torbrowser/design/index.html.en 860)
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 861) </p><p> projects/torbrowser/design/index.html.en 862) However, because SPDY can store identifiers and has extremely long keepalive projects/torbrowser/design/index.html.en 863) duration, it is disabled through the Firefox preference projects/torbrowser/design/index.html.en 864) <span class="command"><strong>network.http.spdy.enabled</strong></span>.`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 865) </p></li><li class="listitem">Automated cross-origin redirects MUST NOT store identifiers`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 866) <p><span class="command"><strong>Design Goal:</strong></span> projects/torbrowser/design/index.html.en 867) projects/torbrowser/design/index.html.en 868) To prevent attacks aimed at subverting the Cross-Origin Identifier projects/torbrowser/design/index.html.en 869) Unlinkability <a class="link" href="#privacy" title="2.2. Privacy Requirements">privacy requirement</a>, the browser`
Update design doc. Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 870) MUST NOT store any identifiers (cookies, cache, DOM storage, HTTP auth, etc) projects/torbrowser/design/index.html.en 871) for cross-origin redirect intermediaries that do not prompt for user input. projects/torbrowser/design/index.html.en 872) For example, if a user clicks on a bit.ly url that redirects to a projects/torbrowser/design/index.html.en 873) doubleclick.net url that finally redirects to a cnn.com url, only cookies from projects/torbrowser/design/index.html.en 874) cnn.com should be retained after the redirect chain completes.
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 875) projects/torbrowser/design/index.html.en 876) </p><p> projects/torbrowser/design/index.html.en 877)`
Update design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 878) Non-automated redirect chains that require user input at some step (such as projects/torbrowser/design/index.html.en 879) federated login systems) SHOULD still allow identifiers to persist.`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 880)`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 881) </p><p><span class="command"><strong>Implementation status:</strong></span> projects/torbrowser/design/index.html.en 882) projects/torbrowser/design/index.html.en 883) There are numerous ways for the user to be redirected, and the Firefox API`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 884) support to detect each of them is poor. We have a <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3600" target="_top">trac bug`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 885) open</a> to implement what we can. projects/torbrowser/design/index.html.en 886)`
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 887) </p></li><li class="listitem">window.name`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 888) <p> projects/en/torbrowser/design/index.html.en 889)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 890) <a class="ulink" href="https://developer.mozilla.org/En/DOM/Window.name" target="_top">window.name</a> is`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 891) a magical DOM property that for some reason is allowed to retain a persistent value projects/en/torbrowser/design/index.html.en 892) for the lifespan of a browser tab. It is possible to utilize this property for`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 893) <a class="ulink" href="http://www.thomasfrank.se/sessionvars.html" target="_top">identifier`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 894) storage</a>. projects/en/torbrowser/design/index.html.en 895) projects/en/torbrowser/design/index.html.en 896) </p><p> projects/en/torbrowser/design/index.html.en 897)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 898) In order to eliminate non-consensual linkability but still allow for sites projects/torbrowser/design/index.html.en 899) that utilize this property to function, we reset the window.name property of`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 900) tabs in Torbutton every time we encounter a blank Referer. This behavior`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 901) allows window.name to persist for the duration of a click-driven navigation projects/torbrowser/design/index.html.en 902) session, but as soon as the user enters a new URL or navigates between projects/torbrowser/design/index.html.en 903) https/http schemes, the property is cleared.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 904)`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 905) </p></li><li class="listitem">Auto form-fill projects/torbrowser/design/index.html.en 906) <p> projects/torbrowser/design/index.html.en 907) projects/torbrowser/design/index.html.en 908) We disable the password saving functionality in the browser as part of our`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 909) <a class="link" href="#disk-avoidance" title="4.3. Disk Avoidance">Disk Avoidance</a> requirement. However,`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 910) since users may decide to re-enable disk history records and password saving,`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 911) we also set the <a class="ulink" href="http://kb.mozillazine.org/Signon.autofillForms" target="_top">signon.autofillForms</a>`
Update TBB design doc based... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 912) preference to false to prevent saved values from immediately populating projects/torbrowser/design/index.html.en 913) fields upon page load. Since Javascript can read these values as soon as they projects/torbrowser/design/index.html.en 914) appear, setting this preference prevents automatic linkability from stored passwords. projects/torbrowser/design/index.html.en 915) projects/torbrowser/design/index.html.en 916) </p></li><li class="listitem">HSTS supercookies projects/torbrowser/design/index.html.en 917) <p>
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 918)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 919) An extreme (but not impossible) attack to mount is the creation of <a class="ulink" href="http://www.leviathansecurity.com/blog/archives/12-The-Double-Edged-Sword-of-HSTS-Persistence-and-Privacy.html" target="_top">HSTS`
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 920) supercookies</a>. Since HSTS effectively stores one bit of information per domain`
Update TBB design doc based... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 921) name, an adversary in possession of numerous domains can use them to construct projects/torbrowser/design/index.html.en 922) cookies based on stored HSTS state. projects/torbrowser/design/index.html.en 923) projects/torbrowser/design/index.html.en 924) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/torbrowser/design/index.html.en 925) projects/torbrowser/design/index.html.en 926) There appears to be three options for us: 1. Disable HSTS entirely, and rely
Additional comments from Ge... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 927) instead on HTTPS-Everywhere to crawl and ship rules for HSTS sites. 2. projects/torbrowser/design/index.html.en 928) Restrict the number of HSTS-enabled third parties allowed per url bar origin. projects/torbrowser/design/index.html.en 929) 3. Prevent third parties from storing HSTS rules. We have not yet decided upon projects/torbrowser/design/index.html.en 930) the best approach.`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 931) projects/torbrowser/design/index.html.en 932) </p><p><span class="command"><strong>Implementation Status:</strong></span> Currently, HSTS state is`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 933) cleared by <a class="link" href="#new-identity" title="4.7. Long-Term Unlinkability via "New Identity" button">New Identity</a>, but we don't`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 934) defend against the creation of these cookies between <span class="command"><strong>New projects/torbrowser/design/index.html.en 935) Identity</strong></span> invocations. projects/torbrowser/design/index.html.en 936) </p></li><li class="listitem">Exit node usage`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 937) <p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 938)`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 939) Every distinct navigation session (as defined by a non-blank Referer header)`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 940) MUST exit through a fresh Tor circuit in Tor Browser to prevent exit node projects/en/torbrowser/design/index.html.en 941) observers from linking concurrent browsing activity. projects/en/torbrowser/design/index.html.en 942) projects/en/torbrowser/design/index.html.en 943) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 944) projects/en/torbrowser/design/index.html.en 945) The Tor feature that supports this ability only exists in the 0.2.3.x-alpha
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 946) series. <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3455" target="_top">Ticket`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 947) #3455</a> is the Torbutton ticket to make use of the new Tor projects/en/torbrowser/design/index.html.en 948) functionality. projects/en/torbrowser/design/index.html.en 949)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 950) </p></li></ol></div><p>`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 951) For more details on identifier linkability bugs and enhancements, see the <a class="ulink" href="https://trac.torproject.org/projects/tor/query?keywords=~tbb-linkability&status=!closed" target="_top">tbb-linkability tag in our bugtracker</a>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 952) </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fingerprinting-linkability"></a>4.6. Cross-Origin Fingerprinting Unlinkability</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 953) projects/en/torbrowser/design/index.html.en 954) In order to properly address the fingerprinting adversary on a technical projects/en/torbrowser/design/index.html.en 955) level, we need a metric to measure linkability of the various browser`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 956) properties beyond any stored origin-related state. <a class="ulink" href="https://panopticlick.eff.org/about.php" target="_top">The Panopticlick Project</a>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 957) by the EFF provides us with a prototype of such a metric. The researchers projects/torbrowser/design/index.html.en 958) conducted a survey of volunteers who were asked to visit an experiment page projects/torbrowser/design/index.html.en 959) that harvested many of the above components. They then computed the Shannon projects/torbrowser/design/index.html.en 960) Entropy of the resulting distribution of each of several key attributes to projects/torbrowser/design/index.html.en 961) determine how many bits of identifying information each attribute provided.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 962) projects/en/torbrowser/design/index.html.en 963) </p><p> projects/en/torbrowser/design/index.html.en 964)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 965) Because fingerprinting is problem that potentially touches every aspect of the projects/torbrowser/design/index.html.en 966) browser, we reduce the efforts for fingerprinting resistance by only projects/torbrowser/design/index.html.en 967) concerning ourselves with reducing the fingerprintable differences projects/torbrowser/design/index.html.en 968) <span class="emphasis"><em>among</em></span> Tor Browser users. We do not believe it is possible projects/torbrowser/design/index.html.en 969) to solve cross-browser fingerprinting issues. Similarly, we prioritize issues projects/torbrowser/design/index.html.en 970) that differentiate only MacOS, Windows, and Linux lower than those that projects/torbrowser/design/index.html.en 971) differentiate aspects of the hardware, third party installed software, and projects/torbrowser/design/index.html.en 972) configuration differences in those operating systems.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 973) projects/en/torbrowser/design/index.html.en 974) </p><p> projects/en/torbrowser/design/index.html.en 975)`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 976) Unfortunately, the unsolvable nature of the cross-browser fingerprinting projects/torbrowser/design/index.html.en 977) problem means that the Panopticlick test website itself is not useful for projects/torbrowser/design/index.html.en 978) evaluating the actual effectiveness of our defenses, or the fingerprinting projects/torbrowser/design/index.html.en 979) defenses of any other web browser. Because the Panopticlick dataset is based projects/torbrowser/design/index.html.en 980) on browser data spanning a number of widely deployed browsers over a number of projects/torbrowser/design/index.html.en 981) years, any fingerprinting defenses attempted by browsers today are very likely projects/torbrowser/design/index.html.en 982) to cause Panopticlick to report an <span class="emphasis"><em>increase</em></span> in projects/torbrowser/design/index.html.en 983) fingerprintability and entropy, because those defenses will stand out in sharp
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 984) contrast to historical data. We have been <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/6119" target="_top">working to convince`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 985) the EFF</a> that it is worthwhile to release the source code to projects/torbrowser/design/index.html.en 986) Panopticlick to allow us to run our own version for this reason. projects/torbrowser/design/index.html.en 987)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 988) </p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="fingerprinting-defenses"></a>Fingerprinting defenses in the Tor Browser</h4></div></div></div><p> projects/torbrowser/design/index.html.en 989) projects/torbrowser/design/index.html.en 990) The following defenses are listed roughly in order of most severe projects/torbrowser/design/index.html.en 991) fingerprinting threat first, though we are desperately in need of updated projects/torbrowser/design/index.html.en 992) measurements to determine this with certainty. Where our actual implementation projects/torbrowser/design/index.html.en 993) differs from an ideal solution, we separately describe our <span class="command"><strong>Design projects/torbrowser/design/index.html.en 994) Goal</strong></span> and our <span class="command"><strong>Implementation Status</strong></span>. projects/torbrowser/design/index.html.en 995) projects/torbrowser/design/index.html.en 996) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">Plugins
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 997) <p> projects/en/torbrowser/design/index.html.en 998) projects/en/torbrowser/design/index.html.en 999) Plugins add to fingerprinting risk via two main vectors: their mere presence in projects/en/torbrowser/design/index.html.en 1000) window.navigator.plugins, as well as their internal functionality. projects/en/torbrowser/design/index.html.en 1001) projects/en/torbrowser/design/index.html.en 1002) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 1003)
Update TBB design doc with... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1004) All plugins that have not been specifically audited or sandboxed MUST be`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1005) disabled. To reduce linkability potential, even sandboxed plugins should not projects/en/torbrowser/design/index.html.en 1006) be allowed to load objects until the user has clicked through a click-to-play projects/en/torbrowser/design/index.html.en 1007) barrier. Additionally, version information should be reduced or obfuscated`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1008) until the plugin object is loaded. For flash, we wish to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3974" target="_top">provide a`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1009) settings.sol file</a> to disable Flash cookies, and to restrict P2P`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1010) features that are likely to bypass proxy settings. We'd also like to restrict projects/torbrowser/design/index.html.en 1011) access to fonts and other system information (such as IP address and MAC projects/torbrowser/design/index.html.en 1012) address) in such a sandbox.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1013) projects/en/torbrowser/design/index.html.en 1014) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1015) projects/en/torbrowser/design/index.html.en 1016) Currently, we entirely disable all plugins in Tor Browser. However, as a`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1017) compromise due to the popularity of Flash, we allow users to re-enable Flash, projects/torbrowser/design/index.html.en 1018) and flash objects are blocked behind a click-to-play barrier that is available projects/torbrowser/design/index.html.en 1019) only after the user has specifically enabled plugins. Flash is the only plugin`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1020) available, the rest are <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0005-Block-all-plugins-except-flash.patch" target="_top">entirely`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1021) blocked from loading by a Firefox patch</a>. We also set the Firefox projects/torbrowser/design/index.html.en 1022) preference <span class="command"><strong>plugin.expose_full_path</strong></span> to false, to avoid projects/torbrowser/design/index.html.en 1023) leaking plugin installation information. projects/torbrowser/design/index.html.en 1024) projects/torbrowser/design/index.html.en 1025) </p></li><li class="listitem">HTML5 Canvas Image Extraction projects/torbrowser/design/index.html.en 1026) <p> projects/torbrowser/design/index.html.en 1027)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1028) The <a class="ulink" href="https://developer.mozilla.org/en-US/docs/HTML/Canvas" target="_top">HTML5`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1029) Canvas</a> is a feature that has been added to major browsers after the projects/torbrowser/design/index.html.en 1030) EFF developed their Panopticlick study. After plugins and plugin-provided projects/torbrowser/design/index.html.en 1031) information, we believe that the HTML5 Canvas is the single largest`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1032) fingerprinting threat browsers face today. <a class="ulink" href="http://www.w2spconf.com/2012/papers/w2sp12-final4.pdf" target="_top">Initial`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1033) studies</a> show that the Canvas can provide an easy-access fingerprinting projects/torbrowser/design/index.html.en 1034) target: The adversary simply renders WebGL, font, and named color data to a projects/torbrowser/design/index.html.en 1035) Canvas element, extracts the image buffer, and computes a hash of that image projects/torbrowser/design/index.html.en 1036) data. Subtle differences in the video card, font packs, and even font and projects/torbrowser/design/index.html.en 1037) graphics library versions allow the adversary to produce a stable, simple, projects/torbrowser/design/index.html.en 1038) high-entropy fingerprint of a computer. In fact, the hash of the rendered projects/torbrowser/design/index.html.en 1039) image can be used almost identically to a tracking cookie by the web server. projects/torbrowser/design/index.html.en 1040) projects/torbrowser/design/index.html.en 1041) </p><p> projects/torbrowser/design/index.html.en 1042)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1043) In some sense, the canvas can be seen as the union of many other projects/torbrowser/design/index.html.en 1044) fingerprinting vectors. If WebGL were normalized through software rendering, projects/torbrowser/design/index.html.en 1045) and the browser shipped a fixed collection of fonts, it might not be necessary projects/torbrowser/design/index.html.en 1046) to create a canvas permission. However, until then, to reduce the threat from projects/torbrowser/design/index.html.en 1047) this vector, we have patched Firefox to <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/3b53f525cfb68880e676e64f13cbc0b928ae3ecf" target="_top">prompt projects/torbrowser/design/index.html.en 1048) before returning valid image data</a> to the Canvas APIs, and for <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/fb9f463fe3a69499d6896c217786bafdf0cda62f" target="_top">access projects/torbrowser/design/index.html.en 1049) to isPointInPath and related functions</a>. If the user hasn't previously projects/torbrowser/design/index.html.en 1050) allowed the site in the URL bar to access Canvas image data, pure white image projects/torbrowser/design/index.html.en 1051) data is returned to the Javascript APIs. projects/torbrowser/design/index.html.en 1052) projects/torbrowser/design/index.html.en 1053) </p><p> projects/torbrowser/design/index.html.en 1054) </p></li><li class="listitem">Open TCP Port Fingerprinting projects/torbrowser/design/index.html.en 1055) <p> projects/torbrowser/design/index.html.en 1056) projects/torbrowser/design/index.html.en 1057) In Firefox, by using either WebSockets or XHR, it is possible for remote projects/torbrowser/design/index.html.en 1058) content to <a class="ulink" href="http://www.andlabs.org/tools/jsrecon.html" target="_top">enumerate projects/torbrowser/design/index.html.en 1059) the list of TCP ports open on 127.0.0.1</a>. In other browsers, this can projects/torbrowser/design/index.html.en 1060) be accomplished by DOM events on image or script tags. This open vs filtered projects/torbrowser/design/index.html.en 1061) vs closed port list can provide a very unique fingerprint of a machine. projects/torbrowser/design/index.html.en 1062) projects/torbrowser/design/index.html.en 1063) </p><p>In Tor Browser, we prevent access to projects/torbrowser/design/index.html.en 1064) 127.0.0.1/localhost by ensuring that even these requests are still sent by projects/torbrowser/design/index.html.en 1065) Firefox to our SOCKS proxy (ie we set projects/torbrowser/design/index.html.en 1066) <span class="command"><strong>network.proxy.no_proxies_on</strong></span> to the empty string). The local projects/torbrowser/design/index.html.en 1067) Tor client then rejects them, since it is configured to proxy for internal IP projects/torbrowser/design/index.html.en 1068) addresses by default. projects/torbrowser/design/index.html.en 1069) </p></li><li class="listitem">USB Device ID enumeration projects/torbrowser/design/index.html.en 1070) <p> projects/torbrowser/design/index.html.en 1071) projects/torbrowser/design/index.html.en 1072) The <a class="ulink" href="https://developer.mozilla.org/en-US/docs/Web/Guide/API/Gamepad" target="_top">GamePad projects/torbrowser/design/index.html.en 1073) API</a> provides web pages with the <a class="ulink" href="https://dvcs.w3.org/hg/gamepad/raw-file/default/gamepad.html#widl-Gamepad-id" target="_top">USB projects/torbrowser/design/index.html.en 1074) device id, product id, and driver name</a> of all connected game projects/torbrowser/design/index.html.en 1075) controllers, as well as detailed information about their capabilities. This API projects/torbrowser/design/index.html.en 1076) should be behind a site permission in Private Browsing Modes, or should present a generic projects/torbrowser/design/index.html.en 1077) controller type (perhaps a two button controller that can be mapped to the keyboard) in all cases. projects/torbrowser/design/index.html.en 1078) We simply disable it via the pref <span class="command"><strong>dom.gamepad.enabled</strong></span>.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1079)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1080) </p></li><li class="listitem">Invasive Authentication Mechanisms (NTLM and SPNEGO) projects/torbrowser/design/index.html.en 1081) <p> projects/torbrowser/design/index.html.en 1082) Both NTLM and SPNEGO authentication mechanisms can leak the hostname, and in projects/torbrowser/design/index.html.en 1083) some cases the machine username. These authentication mechanisms should either projects/torbrowser/design/index.html.en 1084) be disabled, or placed behind a site permission before their use. We simply projects/torbrowser/design/index.html.en 1085) disable them.
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1086) </p></li><li class="listitem">WebGL projects/torbrowser/design/index.html.en 1087) <p> projects/torbrowser/design/index.html.en 1088) projects/torbrowser/design/index.html.en 1089) WebGL is fingerprintable both through information that is exposed about the projects/torbrowser/design/index.html.en 1090) underlying driver and optimizations, as well as through performance projects/torbrowser/design/index.html.en 1091) fingerprinting. projects/torbrowser/design/index.html.en 1092) projects/torbrowser/design/index.html.en 1093) </p><p> projects/torbrowser/design/index.html.en 1094)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1095) Because of the large amount of potential fingerprinting vectors and the <a class="ulink" href="http://www.contextis.com/resources/blog/webgl/" target="_top">previously unexposed`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1096) vulnerability surface</a>, we deploy a similar strategy against WebGL as projects/torbrowser/design/index.html.en 1097) for plugins. First, WebGL Canvases have click-to-play placeholders (provided projects/torbrowser/design/index.html.en 1098) by NoScript), and do not run until authorized by the user. Second, we projects/torbrowser/design/index.html.en 1099) obfuscate driver information by setting the Firefox preferences projects/torbrowser/design/index.html.en 1100) <span class="command"><strong>webgl.disable-extensions</strong></span> and projects/torbrowser/design/index.html.en 1101) <span class="command"><strong>webgl.min_capability_mode</strong></span>, which reduce the information projects/torbrowser/design/index.html.en 1102) provided by the following WebGL API calls: <span class="command"><strong>getParameter()</strong></span>, projects/torbrowser/design/index.html.en 1103) <span class="command"><strong>getSupportedExtensions()</strong></span>, and projects/torbrowser/design/index.html.en 1104) <span class="command"><strong>getExtension()</strong></span>.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1105)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1106) </p><p> projects/torbrowser/design/index.html.en 1107) projects/torbrowser/design/index.html.en 1108) Another option for WebGL might be to use software-only rendering, using a projects/torbrowser/design/index.html.en 1109) library such as <a class="ulink" href="http://www.mesa3d.org/" target="_top">Mesa</a>. The use of projects/torbrowser/design/index.html.en 1110) such a library would avoid hardware-specific rendering differences. projects/torbrowser/design/index.html.en 1111)
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 1112) </p></li><li class="listitem">Fonts projects/en/torbrowser/design/index.html.en 1113) <p> projects/en/torbrowser/design/index.html.en 1114) projects/en/torbrowser/design/index.html.en 1115) According to the Panopticlick study, fonts provide the most linkability when projects/en/torbrowser/design/index.html.en 1116) they are provided as an enumerable list in filesystem order, via either the projects/en/torbrowser/design/index.html.en 1117) Flash or Java plugins. However, it is still possible to use CSS and/or projects/en/torbrowser/design/index.html.en 1118) Javascript to query for the existence of specific fonts. With a large enough projects/en/torbrowser/design/index.html.en 1119) pre-built list to query, a large amount of fingerprintable information may projects/en/torbrowser/design/index.html.en 1120) still be available. projects/en/torbrowser/design/index.html.en 1121)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1122) </p><p><span class="command"><strong>Design Goal:</strong></span> The sure-fire way to address font projects/torbrowser/design/index.html.en 1123) linkability is to ship the browser with a font for every language, typeface, projects/torbrowser/design/index.html.en 1124) and style, and to only use those fonts at the exclusion of system fonts. We are projects/torbrowser/design/index.html.en 1125) <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/13313" target="_top">currently projects/torbrowser/design/index.html.en 1126) investigating</a> this approach, and our current favorite font sets for projects/torbrowser/design/index.html.en 1127) this purpose are the <a class="ulink" href="http://www.droidfonts.com/droidfonts/" target="_top">Droid projects/torbrowser/design/index.html.en 1128) fonts</a>, the <a class="ulink" href="http://hangeul.naver.com/" target="_top">Nanum fonts</a>, projects/torbrowser/design/index.html.en 1129) and <a class="ulink" href="https://fedorahosted.org/lohit/" target="_top">Lohit fonts</a>. The Droid projects/torbrowser/design/index.html.en 1130) font set is fairly complete by itself, but Nanum and Lohit have smaller projects/torbrowser/design/index.html.en 1131) versions of many South Asian languages. When combined in a way that chooses the projects/torbrowser/design/index.html.en 1132) smallest font implementations for each locale, these three font sets provide projects/torbrowser/design/index.html.en 1133) which provide coverage for the all languages used on Wikipedia with more than projects/torbrowser/design/index.html.en 1134) 10,000 articles, and several others as well, in approximately 3MB of compressed projects/torbrowser/design/index.html.en 1135) overhead. The <a class="ulink" href="https://www.google.com/get/noto/" target="_top">Noto font projects/torbrowser/design/index.html.en 1136) set</a> is another font set that aims for complete coverage, but is projects/torbrowser/design/index.html.en 1137) considerably larger than the combination of the Droid, Nanum, and Lohit fonts.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1138) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1139)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1140) In the meantime while we investigate shipping our own fonts, we disable projects/torbrowser/design/index.html.en 1141) plugins, which prevents font enumeration. Additionally, we limit both the projects/torbrowser/design/index.html.en 1142) number of font queries from CSS, as well as the total number of fonts that can projects/torbrowser/design/index.html.en 1143) be used in a document <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0011-Limit-the-number-of-fonts-per-document.patch" target="_top">with
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1144) a Firefox patch</a>. We create two prefs,`
Update design doc to descri... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1145) <span class="command"><strong>browser.display.max_font_attempts</strong></span> and projects/torbrowser/design/index.html.en 1146) <span class="command"><strong>browser.display.max_font_count</strong></span> for this purpose. Once these projects/torbrowser/design/index.html.en 1147) limits are reached, the browser behaves as if`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1148) <span class="command"><strong>browser.display.use_document_fonts</strong></span> was set.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1149)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1150) </p><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1151)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1152) To improve rendering, we exempt remote <a class="ulink" href="https://developer.mozilla.org/en-US/docs/CSS/@font-face" target="_top">@font-face`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1153) fonts</a> from these counts, and if a font-family CSS rule lists a remote projects/torbrowser/design/index.html.en 1154) font (in any order), we use that font instead of any of the named local fonts.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1155)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1156) </p></li><li class="listitem">Monitor and Desktop resolution`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1157) <p> projects/en/torbrowser/design/index.html.en 1158)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1159) Both CSS and Javascript have access to a lot of information about the screen projects/torbrowser/design/index.html.en 1160) resolution, usable desktop size, OS widget size, toolbar size, title bar size,`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1161) screen orientation, and other desktop features that are not at all relevant`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1162) to rendering and serve only to provide information for fingerprinting.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1163) projects/en/torbrowser/design/index.html.en 1164) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 1165) projects/en/torbrowser/design/index.html.en 1166) Our design goal here is to reduce the resolution information down to the bare`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1167) minimum required for properly rendering inside a content window. We intend to`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1168) report all rendering information correctly with respect to the size and projects/en/torbrowser/design/index.html.en 1169) properties of the content window, but report an effective size of 0 for all`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1170) border material, and also report that the desktop is only as big as the inner projects/torbrowser/design/index.html.en 1171) content window. Additionally, new browser windows are sized such that their projects/torbrowser/design/index.html.en 1172) content windows are one of a few fixed sizes based on the user's desktop projects/torbrowser/design/index.html.en 1173) resolution. In addition, to further reduce resolution-based fingerprinting, we projects/torbrowser/design/index.html.en 1174) are <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/7256" target="_top">investigating projects/torbrowser/design/index.html.en 1175) zoom/viewport-based mechanisms</a> that might allow us to always report the projects/torbrowser/design/index.html.en 1176) same desktop resolution regardless of the actual size of the content window, projects/torbrowser/design/index.html.en 1177) and simply scale to make up the difference. Until then, the user should also projects/torbrowser/design/index.html.en 1178) be informed that maximizing their windows can lead to fingerprintability under projects/torbrowser/design/index.html.en 1179) this scheme.
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1180) projects/en/torbrowser/design/index.html.en 1181) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1182)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1183) projects/torbrowser/design/index.html.en 1184) We have implemented the above strategy using a window observer to <a class="ulink" href="https://gitweb.torproject.org/torbutton.git/blob/HEAD:/src/chrome/content/torbutton.js#l2960" target="_top">resize`
Update design doc to descri... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1185) new windows based on desktop resolution</a>. Additionally, we patch`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1186) Firefox to use the client content window size <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/8fc2421becd0ab0cfb5ebbc19af67469552202b2" target="_top">for projects/torbrowser/design/index.html.en 1187) window.screen</a>. Similarly, we <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/81e7fc3a10d27b1d8f0832faf1685899d21f6fef" target="_top">patch projects/torbrowser/design/index.html.en 1188) DOM events to return content window relative points</a>. We also force projects/torbrowser/design/index.html.en 1189) popups to open in new tabs (via projects/torbrowser/design/index.html.en 1190) <span class="command"><strong>browser.link.open_newwindow.restriction</strong></span>), to avoid projects/torbrowser/design/index.html.en 1191) full-screen popups inferring information about the browser resolution. In projects/torbrowser/design/index.html.en 1192) addition, we prevent auto-maximizing on browser start, and are investigating a projects/torbrowser/design/index.html.en 1193) user-friendly way of informing users that maximized windows are detrimental projects/torbrowser/design/index.html.en 1194) to privacy in this mode. projects/torbrowser/design/index.html.en 1195) projects/torbrowser/design/index.html.en 1196) </p></li><li class="listitem">CSS Media Queries projects/torbrowser/design/index.html.en 1197) <p>
Update design doc to descri... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1198)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1199) Even without Javascript, CSS has access to a lot of information about the screen projects/torbrowser/design/index.html.en 1200) resolution, usable desktop size, OS widget size, toolbar size, title bar size, projects/torbrowser/design/index.html.en 1201) system theme colors, and other desktop features that are not at all relevant projects/torbrowser/design/index.html.en 1202) to rendering and serve only to provide information for fingerprinting. Most of this information comes from projects/torbrowser/design/index.html.en 1203) <a class="ulink" href="https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Media_queries" target="_top">CSS Media Queries</a>, but projects/torbrowser/design/index.html.en 1204) Mozilla has exposed <a class="ulink" href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#System_Colors" target="_top">several user and OS theme defined color values</a> to CSS as well. projects/torbrowser/design/index.html.en 1205) projects/torbrowser/design/index.html.en 1206) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/torbrowser/design/index.html.en 1207) In Private Browsing Mode, CSS should not be able infer anything that the user projects/torbrowser/design/index.html.en 1208) has configured about their computer. Additionally, it should not be able to projects/torbrowser/design/index.html.en 1209) infer machine-specific details such as screen orientation or type. projects/torbrowser/design/index.html.en 1210) projects/torbrowser/design/index.html.en 1211) </p><p><span class="command"><strong>Implementation Status:</strong></span>
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1212)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1213) We patch projects/torbrowser/design/index.html.en 1214) Firefox to <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/30dc2c4290698af81ceafae9d628a34c53faabe1" target="_top">report projects/torbrowser/design/index.html.en 1215) a fixed set of system colors to content window CSS</a>, and <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/8f6e979d30598569dea14ac6f4eef4e96543b3d7" target="_top">prevent projects/torbrowser/design/index.html.en 1216) detection of font smoothing on OSX</a>. We also always projects/torbrowser/design/index.html.en 1217) <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/09561f0e5452305b9efcb4e6169c613c8db33246" target="_top">report projects/torbrowser/design/index.html.en 1218) landscape-primary</a> for the screen orientation.
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1219)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1220) </p></li><li class="listitem">User Agent and HTTP Headers projects/torbrowser/design/index.html.en 1221) <p><span class="command"><strong>Design Goal:</strong></span>`
Update design doc to descri... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1222)`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1223) All Tor Browser users MUST provide websites with an identical user agent and projects/torbrowser/design/index.html.en 1224) HTTP header set for a given request type. We omit the Firefox minor revision, projects/torbrowser/design/index.html.en 1225) and report a popular Windows platform. If the software is kept up to date, projects/torbrowser/design/index.html.en 1226) these headers should remain identical across the population even when updated. projects/torbrowser/design/index.html.en 1227) projects/torbrowser/design/index.html.en 1228) </p><p><span class="command"><strong>Implementation Status:</strong></span>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1229)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1230) Firefox provides several options for controlling the browser user agent string projects/torbrowser/design/index.html.en 1231) which we leverage. We also set similar prefs for controlling the projects/torbrowser/design/index.html.en 1232) Accept-Language and Accept-Charset headers, which we spoof to English by default. Additionally, we`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1233) <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0001-Block-Components.interfaces-from-content.patch" target="_top">remove projects/torbrowser/design/index.html.en 1234) content script access</a> to Components.interfaces, which <a class="ulink" href="http://pseudo-flaw.net/tor/torbutton/fingerprint-firefox.html" target="_top">can be`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1235) used</a> to fingerprint OS, platform, and Firefox minor version. </p></li><li class="listitem">Locale Fingerprinting projects/torbrowser/design/index.html.en 1236) <p> projects/torbrowser/design/index.html.en 1237) projects/torbrowser/design/index.html.en 1238) In Tor Browser, we provide non-English users the option of concealing their OS projects/torbrowser/design/index.html.en 1239) and browser locale from websites. It is debatable if this should be as high of projects/torbrowser/design/index.html.en 1240) a priority as information specific to the user's computer, but for projects/torbrowser/design/index.html.en 1241) completeness, we attempt to maintain this property. projects/torbrowser/design/index.html.en 1242) projects/torbrowser/design/index.html.en 1243) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/torbrowser/design/index.html.en 1244) projects/torbrowser/design/index.html.en 1245) We set the fallback character set to set to windows-1252 for all locales, via projects/torbrowser/design/index.html.en 1246) <span class="command"><strong>intl.charset.default</strong></span>. We also patch Firefox to allow us to projects/torbrowser/design/index.html.en 1247) <a class="ulink" href="https://gitweb.torproject.org/tor-browser.git/commitdiff/fe42a78575df7f460fa0ac48eabb57bc8812c23e" target="_top">instruct projects/torbrowser/design/index.html.en 1248) the JS engine</a> to use en-US as its internal C locale for all Date, Math, projects/torbrowser/design/index.html.en 1249) and exception handling. projects/torbrowser/design/index.html.en 1250) projects/torbrowser/design/index.html.en 1251) </p></li><li class="listitem">Timezone and clock offset projects/torbrowser/design/index.html.en 1252) <p> projects/torbrowser/design/index.html.en 1253) projects/torbrowser/design/index.html.en 1254) While the latency in Tor connections varies anywhere from milliseconds to projects/torbrowser/design/index.html.en 1255) several seconds, it is still possible for the remote site to detect large projects/torbrowser/design/index.html.en 1256) differences between the user's clock and an official reference timesource. projects/torbrowser/design/index.html.en 1257) </p><p><span class="command"><strong>Design Goal:</strong></span>
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1258)`
Update TBB design doc with... Mike Perry authored 12 years ago	projects/torbrowser/design/index.html.en 1259) All Tor Browser users MUST report the same timezone to websites. Currently, we projects/torbrowser/design/index.html.en 1260) choose UTC for this purpose, although an equally valid argument could be made projects/torbrowser/design/index.html.en 1261) for EDT/EST due to the large English-speaking population density (coupled with projects/torbrowser/design/index.html.en 1262) the fact that we spoof a US English user agent). Additionally, the Tor projects/torbrowser/design/index.html.en 1263) software should detect if the users clock is significantly divergent from the projects/torbrowser/design/index.html.en 1264) clocks of the relays that it connects to, and use this to reset the clock
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1265) values used in Tor Browser to something reasonably accurate. Alternatively, projects/torbrowser/design/index.html.en 1266) the browser can obtain this clock skew via a mechanism similar to that used in projects/torbrowser/design/index.html.en 1267) <a class="ulink" href="" target="_top">tlsdate</a>.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1268) projects/en/torbrowser/design/index.html.en 1269) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1270) projects/en/torbrowser/design/index.html.en 1271) We set the timezone using the TZ environment variable, which is supported on`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1272) all platforms. Additionally, we plan to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3652" target="_top">obtain a clock`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1273) offset from Tor</a>, but this won't be available until Tor 0.2.3.x is in projects/en/torbrowser/design/index.html.en 1274) use. projects/en/torbrowser/design/index.html.en 1275) projects/en/torbrowser/design/index.html.en 1276) </p></li><li class="listitem">Javascript performance fingerprinting projects/en/torbrowser/design/index.html.en 1277) <p> projects/en/torbrowser/design/index.html.en 1278)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1279) <a class="ulink" href="http://w2spconf.com/2011/papers/jspriv.pdf" target="_top">Javascript performance`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 1280) fingerprinting</a> is the act of profiling the performance projects/en/torbrowser/design/index.html.en 1281) of various Javascript functions for the purpose of fingerprinting the projects/en/torbrowser/design/index.html.en 1282) Javascript engine and the CPU. projects/en/torbrowser/design/index.html.en 1283) projects/en/torbrowser/design/index.html.en 1284) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 1285)
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1286) We have <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3059" target="_top">several potential`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1287) mitigation approaches</a> to reduce the accuracy of performance projects/en/torbrowser/design/index.html.en 1288) fingerprinting without risking too much damage to functionality. Our current projects/en/torbrowser/design/index.html.en 1289) favorite is to reduce the resolution of the Event.timeStamp and the Javascript projects/en/torbrowser/design/index.html.en 1290) Date() object, while also introducing jitter. Our goal is to increase the`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1291) amount of time it takes to mount a successful attack. <a class="ulink" href="http://w2spconf.com/2011/papers/jspriv.pdf" target="_top">Mowery et al</a> found that`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1292) even with the default precision in most browsers, they required up to 120 projects/en/torbrowser/design/index.html.en 1293) seconds of amortization and repeated trials to get stable results from their projects/en/torbrowser/design/index.html.en 1294) feature set. We intend to work with the research community to establish the`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1295) optimum trade-off between quantization+jitter and amortization time.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1296) projects/en/torbrowser/design/index.html.en 1297) projects/en/torbrowser/design/index.html.en 1298) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1299)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1300) Currently, the only mitigation against performance fingerprinting is to`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1301) disable <a class="ulink" href="http://www.w3.org/TR/navigation-timing/" target="_top">Navigation`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1302) Timing</a> through the Firefox preference projects/torbrowser/design/index.html.en 1303) <span class="command"><strong>dom.enable_performance</strong></span>. projects/torbrowser/design/index.html.en 1304) projects/torbrowser/design/index.html.en 1305) </p></li><li class="listitem">Non-Uniform HTML5 API Implementations projects/torbrowser/design/index.html.en 1306) <p> projects/torbrowser/design/index.html.en 1307) projects/torbrowser/design/index.html.en 1308) At least two HTML5 features have different implementation status across the
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1309) major OS vendors: the <a class="ulink" href="https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery" target="_top">Battery projects/torbrowser/design/index.html.en 1310) API</a> and the <a class="ulink" href="https://developer.mozilla.org/en-US/docs/DOM/window.navigator.connection" target="_top">Network`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1311) Connection API</a>. We disable these APIs projects/torbrowser/design/index.html.en 1312) through the Firefox preferences <span class="command"><strong>dom.battery.enabled</strong></span> and projects/torbrowser/design/index.html.en 1313) <span class="command"><strong>dom.network.enabled</strong></span>.`
Add design doc draft. Mike Perry authored 12 years ago	projects/en/torbrowser/design/index.html.en 1314) projects/en/torbrowser/design/index.html.en 1315) </p></li><li class="listitem">Keystroke fingerprinting projects/en/torbrowser/design/index.html.en 1316) <p> projects/en/torbrowser/design/index.html.en 1317) projects/en/torbrowser/design/index.html.en 1318) Keystroke fingerprinting is the act of measuring key strike time and key projects/en/torbrowser/design/index.html.en 1319) flight time. It is seeing increasing use as a biometric. projects/en/torbrowser/design/index.html.en 1320) projects/en/torbrowser/design/index.html.en 1321) </p><p><span class="command"><strong>Design Goal:</strong></span> projects/en/torbrowser/design/index.html.en 1322) projects/en/torbrowser/design/index.html.en 1323) We intend to rely on the same mechanisms for defeating Javascript performance projects/en/torbrowser/design/index.html.en 1324) fingerprinting: timestamp quantization and jitter. projects/en/torbrowser/design/index.html.en 1325) projects/en/torbrowser/design/index.html.en 1326) </p><p><span class="command"><strong>Implementation Status:</strong></span> projects/en/torbrowser/design/index.html.en 1327) We have no implementation as of yet.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1328) </p></li></ol></div></div><p>`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1329) For more details on identifier linkability bugs and enhancements, see the <a class="ulink" href="https://trac.torproject.org/projects/tor/query?keywords=~tbb-fingerprinting&status=!closed" target="_top">tbb-fingerprinting tag in our bugtracker</a>`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1330) </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="new-identity"></a>4.7. Long-Term Unlinkability via "New Identity" button</h3></div></div></div><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1331)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1332) In order to avoid long-term linkability, we provide a "New Identity" context projects/torbrowser/design/index.html.en 1333) menu option in Torbutton. This context menu option is active if Torbutton can projects/torbrowser/design/index.html.en 1334) read the environment variables $TOR_CONTROL_PASSWD and $TOR_CONTROL_PORT.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1335)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1336) </p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36963888"></a>Design Goal:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote">`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1337)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1338) All linkable identifiers and browser state MUST be cleared by this feature.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1339)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1340) </blockquote></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36965136"></a>Implementation Status:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote"><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1341)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1342) First, Torbutton disables Javascript in all open tabs and windows by using`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1343) both the <a class="ulink" href="https://developer.mozilla.org/en-US/docs/XPCOM_Interface_Reference/nsIDocShell#Attributes" target="_top">browser.docShell.allowJavascript</a> projects/torbrowser/design/index.html.en 1344) attribute as well as <a class="ulink" href="https://developer.mozilla.org/en-US/docs/XPCOM_Interface_Reference/nsIDOMWindowUtils#suppressEventHandling%28%29" target="_top">nsIDOMWindowUtil.suppressEventHandling()</a>. projects/torbrowser/design/index.html.en 1345) We then stop all page activity for each tab using <a class="ulink" href="https://developer.mozilla.org/en-US/docs/XPCOM_Interface_Reference/nsIWebNavigation#stop%28%29" target="_top">browser.webNavigation.stop(nsIWebNavigation.STOP_ALL)</a>.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1346) We then clear the site-specific Zoom by temporarily disabling the preference`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1347) <span class="command"><strong>browser.zoom.siteSpecific</strong></span>, and clear the GeoIP wifi token URL projects/torbrowser/design/index.html.en 1348) <span class="command"><strong>geo.wifi.access_token</strong></span> and the last opened URL prefs (if projects/torbrowser/design/index.html.en 1349) they exist). Each tab is then closed.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1350)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1351) </p><p>`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1352)`
TBB design doc: More review... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1353) After closing all tabs, we then emit "<a class="ulink" href="https://developer.mozilla.org/en-US/docs/Supporting_private_browsing_mode#Private_browsing_notifications" target="_top">browser:purge-session-history</a>" projects/torbrowser/design/index.html.en 1354) (which instructs addons and various Firefox components to clear their session projects/torbrowser/design/index.html.en 1355) state), and then manually clear the following state: searchbox and findbox projects/torbrowser/design/index.html.en 1356) text, HTTP auth, SSL state, OCSP state, site-specific content preferences projects/torbrowser/design/index.html.en 1357) (including HSTS state), content and image cache, offline cache, Cookies, DOM
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1358) storage, crypto tokens, DOM local storage, the safe browsing key, and the projects/torbrowser/design/index.html.en 1359) Google wifi geolocation token (if it exists). We also clear NoScript's site projects/torbrowser/design/index.html.en 1360) and temporary permissions.`
Add design doc draft. Mike Perry authored 12 years ago	`projects/en/torbrowser/design/index.html.en 1361)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1362) </p><p>`
Update TBB design doc based... Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1363)`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1364) After the state is cleared, we then close all remaining HTTP keep-alive projects/torbrowser/design/index.html.en 1365) connections and then send the NEWNYM signal to the Tor control port to cause a projects/torbrowser/design/index.html.en 1366) new circuit to be created. projects/torbrowser/design/index.html.en 1367) </p><p> projects/torbrowser/design/index.html.en 1368) Finally, a fresh browser window is opened, and the current browser window is`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1369) closed (this does not spawn a new Firefox process, only a new window).`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1370) </p></blockquote></div><div class="blockquote"><blockquote class="blockquote"> projects/torbrowser/design/index.html.en 1371) If the user chose to "protect" any cookies by using the Torbutton Cookie projects/torbrowser/design/index.html.en 1372) Protections UI, those cookies are not cleared as part of the above.`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1373) </blockquote></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="other-security"></a>4.8. Other Security Measures</h3></div></div></div><p>`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1374) projects/torbrowser/design/index.html.en 1375) In addition to the above mechanisms that are devoted to preserving privacy projects/torbrowser/design/index.html.en 1376) while browsing, we also have a number of technical mechanisms to address other projects/torbrowser/design/index.html.en 1377) privacy and security issues. projects/torbrowser/design/index.html.en 1378) projects/torbrowser/design/index.html.en 1379) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><a id="traffic-fingerprinting-defenses"></a><span class="command"><strong>Website Traffic Fingerprinting Defenses</strong></span><p> projects/torbrowser/design/index.html.en 1380) projects/torbrowser/design/index.html.en 1381) <a class="link" href="#website-traffic-fingerprinting">Website Traffic projects/torbrowser/design/index.html.en 1382) Fingerprinting</a> is a statistical attack to attempt to recognize specific projects/torbrowser/design/index.html.en 1383) encrypted website activity. projects/torbrowser/design/index.html.en 1384)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1385) </p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36979248"></a>Design Goal:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote"><p>`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1386)`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1387) We want to deploy a mechanism that reduces the accuracy of <a class="ulink" href="https://en.wikipedia.org/wiki/Feature_selection" target="_top">useful features</a> available`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1388) for classification. This mechanism would either impact the true and false projects/torbrowser/design/index.html.en 1389) positive accuracy rates, <span class="emphasis"><em>or</em></span> reduce the number of webpages projects/torbrowser/design/index.html.en 1390) that could be classified at a given accuracy rate. projects/torbrowser/design/index.html.en 1391) projects/torbrowser/design/index.html.en 1392) </p><p> projects/torbrowser/design/index.html.en 1393) projects/torbrowser/design/index.html.en 1394) Ideally, this mechanism would be as light-weight as possible, and would be projects/torbrowser/design/index.html.en 1395) tunable in terms of overhead. We suspect that it may even be possible to projects/torbrowser/design/index.html.en 1396) deploy a mechanism that reduces feature extraction resolution without any projects/torbrowser/design/index.html.en 1397) network overhead. In the no-overhead category, we have <a class="ulink" href="http://freehaven.net/anonbib/cache/LZCLCP_NDSS11.pdf" target="_top">HTTPOS</a> and projects/torbrowser/design/index.html.en 1398) <a class="ulink" href="https://blog.torproject.org/blog/experimental-defense-website-traffic-fingerprinting" target="_top">better
TBB Design Doc: Mention use... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1399) use of HTTP pipelining and/or SPDY</a>. projects/torbrowser/design/index.html.en 1400) In the tunable/low-overhead`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1401) category, we have <a class="ulink" href="http://freehaven.net/anonbib/cache/ShWa-Timing06.pdf" target="_top">Adaptive projects/torbrowser/design/index.html.en 1402) Padding</a> and <a class="ulink" href="http://www.cs.sunysb.edu/~xcai/fp.pdf" target="_top"> projects/torbrowser/design/index.html.en 1403) Congestion-Sensitive BUFLO</a>. It may be also possible to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/7028" target="_top">tune such projects/torbrowser/design/index.html.en 1404) defenses</a> such that they only use existing spare Guard bandwidth capacity in the Tor
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1405) network, making them also effectively no-overhead.`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1406)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1407) </p></blockquote></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp36986144"></a>Implementation Status:</h4></div></div></div><div class="blockquote"><blockquote class="blockquote"><p>`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1408) Currently, we patch Firefox to <a class="ulink" href="https://gitweb.torproject.org/torbrowser.git/blob/maint-2.4:/src/current-patches/firefox/0017-Randomize-HTTP-request-order-and-pipeline-depth.patch" target="_top">randomize projects/torbrowser/design/index.html.en 1409) pipeline order and depth</a>. Unfortunately, pipelining is very fragile. projects/torbrowser/design/index.html.en 1410) Many sites do not support it, and even sites that advertise support for projects/torbrowser/design/index.html.en 1411) pipelining may simply return error codes for successive requests, effectively projects/torbrowser/design/index.html.en 1412) forcing the browser into non-pipelined behavior. Firefox also has code to back projects/torbrowser/design/index.html.en 1413) off and reduce or eliminate the pipeline if this happens. These projects/torbrowser/design/index.html.en 1414) shortcomings and fallback behaviors are the primary reason that Google
TBB Design Doc: Mention use... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1415) developed SPDY as opposed simply extending HTTP to improve pipelining. It projects/torbrowser/design/index.html.en 1416) turns out that we could actually deploy exit-side proxies that allow us to projects/torbrowser/design/index.html.en 1417) <a class="ulink" href="https://gitweb.torproject.org/torspec.git/blob/HEAD:/proposals/ideas/xxx-using-spdy.txt" target="_top">use projects/torbrowser/design/index.html.en 1418) SPDY from the client to the exit node</a>. This would make our defense not projects/torbrowser/design/index.html.en 1419) only free, but one that actually <span class="emphasis"><em>improves</em></span> performance.
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1420) projects/torbrowser/design/index.html.en 1421) </p><p> projects/torbrowser/design/index.html.en 1422)`
TBB design doc: Clarify web... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1423) Knowing this, we created this defense as an <a class="ulink" href="https://blog.torproject.org/blog/experimental-defense-website-traffic-fingerprinting" target="_top">experimental`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1424) research prototype</a> to help evaluate what could be done in the best`
TBB design doc: Clarify web... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1425) case with full server support. Unfortunately, the bias in favor of compelling projects/torbrowser/design/index.html.en 1426) attack papers has caused academia to ignore this request thus far, instead projects/torbrowser/design/index.html.en 1427) publishing only cursory (yet "devastating") evaluations that fail to provide projects/torbrowser/design/index.html.en 1428) even simple statistics such as the rates of actual pipeline utilization during projects/torbrowser/design/index.html.en 1429) their evaluations, in addition to the other shortcomings and shortcuts <a class="link" href="#website-traffic-fingerprinting">mentioned earlier</a>. We can projects/torbrowser/design/index.html.en 1430) accept that our defense might fail to work as well as others (in fact we projects/torbrowser/design/index.html.en 1431) expect it), but unfortunately the very same shortcuts that provide excellent projects/torbrowser/design/index.html.en 1432) attack results also allow the conclusion that all defenses are broken forever. projects/torbrowser/design/index.html.en 1433) So sadly, we are still left in the dark on this point.
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1434) projects/torbrowser/design/index.html.en 1435) </p></blockquote></div></div></li><li class="listitem"><span class="command"><strong>Privacy-preserving update notification</strong></span><p> projects/torbrowser/design/index.html.en 1436) projects/torbrowser/design/index.html.en 1437) In order to inform the user when their Tor Browser is out of date, we perform a`
TBB design doc: Clarify web... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1438) privacy-preserving update check asynchronously in the background. The`
Update TBB design doc based... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1439) check uses Tor to download the file <a class="ulink" href="https://check.torproject.org/RecommendedTBBVersions" target="_top">https://check.torproject.org/RecommendedTBBVersions</a> projects/torbrowser/design/index.html.en 1440) and searches that version list for the current value for the local preference projects/torbrowser/design/index.html.en 1441) <span class="command"><strong>torbrowser.version</strong></span>. If the value from our preference is projects/torbrowser/design/index.html.en 1442) present in the recommended version list, the check is considered to have projects/torbrowser/design/index.html.en 1443) succeeded and the user is up to date. If not, it is considered to have failed projects/torbrowser/design/index.html.en 1444) and an update is needed. The check is triggered upon browser launch, new projects/torbrowser/design/index.html.en 1445) window, and new tab, but is rate limited so as to happen no more frequently projects/torbrowser/design/index.html.en 1446) than once every 1.5 hours. projects/torbrowser/design/index.html.en 1447) projects/torbrowser/design/index.html.en 1448) </p><p> projects/torbrowser/design/index.html.en 1449) projects/torbrowser/design/index.html.en 1450) If the check fails, we cache this fact, and update the Torbutton graphic to projects/torbrowser/design/index.html.en 1451) display a flashing warning icon and insert a menu option that provides a link projects/torbrowser/design/index.html.en 1452) to our download page. Additionally, we reset the value for the browser projects/torbrowser/design/index.html.en 1453) homepage to point to a <a class="ulink" href="https://check.torproject.org/?lang=en-US&small=1&uptodate=0" target="_top">page that projects/torbrowser/design/index.html.en 1454) informs the user</a> that their browser is out of projects/torbrowser/design/index.html.en 1455) date. projects/torbrowser/design/index.html.en 1456)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1457) </p></li></ol></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="BuildSecurity"></a>5. Build Security and Package Integrity</h2></div></div></div><p>`
Update TBB design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1458)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1459) In the age of state-sponsored malware, <a class="ulink" href="https://blog.torproject.org/blog/deterministic-builds-part-one-cyberwar-and-global-compromise" target="_top">we projects/torbrowser/design/index.html.en 1460) believe</a> it is impossible to expect to keep a single build machine or projects/torbrowser/design/index.html.en 1461) software signing key secure, given the class of adversaries that Tor has to projects/torbrowser/design/index.html.en 1462) contend with. For this reason, we have deployed a build system projects/torbrowser/design/index.html.en 1463) that allows anyone to use our source code to reproduce byte-for-byte identical projects/torbrowser/design/index.html.en 1464) binary packages to the ones that we distribute.
Update TBB design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1465)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1466) </p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp37001088"></a>5.1. Achieving Binary Reproducibility</h3></div></div></div><p>`
Update TBB design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1467)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1468) The GNU toolchain has been working on providing reproducible builds for some projects/torbrowser/design/index.html.en 1469) time, however a large software project such as Firefox typically ends up projects/torbrowser/design/index.html.en 1470) embedding a large number of details about the machine it was built on, both projects/torbrowser/design/index.html.en 1471) intentionally and inadvertently. Additionally, manual changes to the build projects/torbrowser/design/index.html.en 1472) machine configuration can accumulate over time and are difficult for others to projects/torbrowser/design/index.html.en 1473) replicate externally, which leads to difficulties with binary reproducibility.
Update TBB design doc. Mike Perry authored 12 years ago	`projects/torbrowser/design/index.html.en 1474)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1475) </p><p> projects/torbrowser/design/index.html.en 1476) For this reason, we decided to leverage the work done by the <a class="ulink" href="http://gitian.org/" target="_top">Gitian Project</a> from the Bitcoin community. projects/torbrowser/design/index.html.en 1477) Gitian is a wrapper around Ubuntu's virtualization tools that allows you to projects/torbrowser/design/index.html.en 1478) specify an Ubuntu version, architecture, a set of additional packages, a set projects/torbrowser/design/index.html.en 1479) of input files, and a bash build scriptlet in an YAML document called a projects/torbrowser/design/index.html.en 1480) "Gitian Descriptor". This document is used to install a qemu-kvm image, and projects/torbrowser/design/index.html.en 1481) execute your build scriptlet inside it. projects/torbrowser/design/index.html.en 1482) </p><p>
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1483)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1484) We have created a <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/tree/refs/heads/master" target="_top">set projects/torbrowser/design/index.html.en 1485) of wrapper scripts</a> around Gitian to automate dependency download and projects/torbrowser/design/index.html.en 1486) authentication, as well as transfer intermediate build outputs between the projects/torbrowser/design/index.html.en 1487) stages of the build process. Because Gitian creates an Ubuntu build projects/torbrowser/design/index.html.en 1488) environment, we must use cross-compilation to create packages for Windows and projects/torbrowser/design/index.html.en 1489) Mac OS. For Windows, we use mingw-w64 as our cross compiler. For Mac OS, we projects/torbrowser/design/index.html.en 1490) use toolchain4 in combination with a binary redistribution of the Mac OS 10.6 projects/torbrowser/design/index.html.en 1491) SDK.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1492)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1493) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1494)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1495) The use of the Gitian system eliminates build non-determinism by normalizing projects/torbrowser/design/index.html.en 1496) the build environment's hostname, username, build path, uname output, projects/torbrowser/design/index.html.en 1497) toolchain versions, and time. On top of what Gitian provides, we also had to projects/torbrowser/design/index.html.en 1498) address the following additional sources of non-determinism:`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1499)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1500) </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">Filesystem and archive reordering projects/torbrowser/design/index.html.en 1501) <p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1502)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1503) The most prevalent source of non-determinism in the components of Tor Browser projects/torbrowser/design/index.html.en 1504) by far was various ways that archives (such as zip, tar, jar/ja, DMG, and projects/torbrowser/design/index.html.en 1505) Firefox manifest lists) could be reordered. Many file archivers walk the projects/torbrowser/design/index.html.en 1506) filesystem in inode structure order by default, which will result in ordering projects/torbrowser/design/index.html.en 1507) differences between two different archive invocations, especially on machines projects/torbrowser/design/index.html.en 1508) of different disk and hardware configurations.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1509)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1510) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1511)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1512) The fix for this is to perform an additional sorting step on the input list projects/torbrowser/design/index.html.en 1513) for archives, but care must be taken to instruct libc and other sorting routines projects/torbrowser/design/index.html.en 1514) to use a fixed locale to determine lexicographic ordering, or machines with projects/torbrowser/design/index.html.en 1515) different locale settings will produce different sort results. We chose the projects/torbrowser/design/index.html.en 1516) 'C' locale for this purpose. We created wrapper scripts for <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/HEAD:/gitian/build-helpers/dtar.sh" target="_top">tar</a>, projects/torbrowser/design/index.html.en 1517) <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/HEAD:/gitian/build-helpers/dzip.sh" target="_top">zip</a>, projects/torbrowser/design/index.html.en 1518) and <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/HEAD:/gitian/build-helpers/ddmg.sh" target="_top">DMG</a> projects/torbrowser/design/index.html.en 1519) to aid in reproducible archive creation. projects/torbrowser/design/index.html.en 1520) projects/torbrowser/design/index.html.en 1521) </p></li><li class="listitem">Uninitialized memory in toolchain/archivers projects/torbrowser/design/index.html.en 1522) <p> projects/torbrowser/design/index.html.en 1523) projects/torbrowser/design/index.html.en 1524) We ran into difficulties with both binutils and the DMG archive script using projects/torbrowser/design/index.html.en 1525) uninitialized memory in certain data structures that ended up written to disk. projects/torbrowser/design/index.html.en 1526) Our binutils fixes were merged upstream, but the DMG archive fix remains an projects/torbrowser/design/index.html.en 1527) <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/HEAD:/gitian/patches/libdmg.patch" target="_top">independent projects/torbrowser/design/index.html.en 1528) patch</a>. projects/torbrowser/design/index.html.en 1529) projects/torbrowser/design/index.html.en 1530) </p></li><li class="listitem">Fine-grained timestamps and timezone leaks projects/torbrowser/design/index.html.en 1531) <p> projects/torbrowser/design/index.html.en 1532) projects/torbrowser/design/index.html.en 1533) The standard way of controlling timestamps in Gitian is to use libfaketime, projects/torbrowser/design/index.html.en 1534) which hooks time-related library calls to provide a fixed timestamp. However, projects/torbrowser/design/index.html.en 1535) libfaketime does not spoof the millisecond and microsecond components of projects/torbrowser/design/index.html.en 1536) timestamps, which found their way into pyc files and also in explicit Firefox projects/torbrowser/design/index.html.en 1537) build process timestamp embedding. projects/torbrowser/design/index.html.en 1538) </p><p>
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1539)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1540) We addressed the Firefox issues with direct patches to their build process, projects/torbrowser/design/index.html.en 1541) which have since been merged. However, pyc timestamps had to be address with projects/torbrowser/design/index.html.en 1542) an additional <a class="ulink" href="https://gitweb.torproject.org/builders/tor-browser-bundle.git/blob/HEAD:/gitian/build-helpers/pyc-timestamp.sh" target="_top">helper projects/torbrowser/design/index.html.en 1543) script</a>. projects/torbrowser/design/index.html.en 1544) </p><p>
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1545)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1546) The timezone leaks were addressed by setting the <span class="command"><strong>TZ</strong></span> projects/torbrowser/design/index.html.en 1547) environment variable to UTC in our descriptors.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1548)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1549) </p></li><li class="listitem">Deliberately generated entropy projects/torbrowser/design/index.html.en 1550) <p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1551)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1552) In two circumstances, deliberately generated entropy was introduced in various projects/torbrowser/design/index.html.en 1553) components of the build process. First, the BuildID Debuginfo identifier projects/torbrowser/design/index.html.en 1554) (which associates detached debug files with their corresponding stripped projects/torbrowser/design/index.html.en 1555) executables) was introducing entropy from some unknown source. We removed this projects/torbrowser/design/index.html.en 1556) header using objcopy invocations in our build scriptlets, and opted to use GNU projects/torbrowser/design/index.html.en 1557) DebugLink instead of BuildID for this association.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1558)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1559) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1560)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1561) Second, on Linux, Firefox builds detached signatures of its cryptographic projects/torbrowser/design/index.html.en 1562) libraries using a temporary key for FIPS-140 certification. A rather insane projects/torbrowser/design/index.html.en 1563) subsection of the FIPS-140 certification standard requires that you distribute projects/torbrowser/design/index.html.en 1564) signatures for all of your cryptographic libraries. The Firefox build process projects/torbrowser/design/index.html.en 1565) meets this requirement by generating a temporary key, using it to sign the projects/torbrowser/design/index.html.en 1566) libraries, and discarding the private portion of that key. Because there are projects/torbrowser/design/index.html.en 1567) many other ways to intercept the crypto outside of modifying the actual DLL projects/torbrowser/design/index.html.en 1568) images, we opted to simply remove these signature files from distribution. projects/torbrowser/design/index.html.en 1569) There simply is no way to verify code integrity on a running system without projects/torbrowser/design/index.html.en 1570) both OS and co-processor assistance. Download package signatures make sense of projects/torbrowser/design/index.html.en 1571) course, but we handle those another way (as mentioned above).
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1572) projects/torbrowser/design/index.html.en 1573)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1574) </p></li><li class="listitem">LXC-specific leaks projects/torbrowser/design/index.html.en 1575) <p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1576)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1577) Gitian provides an option to use LXC containers instead of full qemu-kvm projects/torbrowser/design/index.html.en 1578) virtualization. Unfortunately, these containers can allow additional details projects/torbrowser/design/index.html.en 1579) about the host OS to leak. In particular, umask settings as well as the projects/torbrowser/design/index.html.en 1580) hostname and Linux kernel version can leak from the host OS into the LXC projects/torbrowser/design/index.html.en 1581) container. We addressed umask by setting it explicitly in our Gitian projects/torbrowser/design/index.html.en 1582) descriptor scriptlet, and addressed the hostname and kernel version leaks by projects/torbrowser/design/index.html.en 1583) directly patching the aspects of the Firefox build process that included this projects/torbrowser/design/index.html.en 1584) information into the build. projects/torbrowser/design/index.html.en 1585) </p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp37036336"></a>5.2. Package Signatures and Verification</h3></div></div></div><p> projects/torbrowser/design/index.html.en 1586) projects/torbrowser/design/index.html.en 1587) The build process produces a single sha256sums.txt file that contains a sorted projects/torbrowser/design/index.html.en 1588) list the SHA-256 hashes of every package produced for that build version. Each projects/torbrowser/design/index.html.en 1589) official builder uploads this file and a GPG signature of it to a directory projects/torbrowser/design/index.html.en 1590) on a Tor Project's web server. The build scripts have an optional matching projects/torbrowser/design/index.html.en 1591) step that downloads these signatures, verifies them, and ensures that the projects/torbrowser/design/index.html.en 1592) local builds match this file.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1593)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1594) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1595)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1596) When builds are published officially, the single sha256sums.txt file is projects/torbrowser/design/index.html.en 1597) accompanied by a detached GPG signature from each official builder that projects/torbrowser/design/index.html.en 1598) produced a matching build. The packages are additionally signed with detached projects/torbrowser/design/index.html.en 1599) GPG signatures from an official signing key.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1600)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1601) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1602)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1603) The fact that the entire set of packages for a given version can be projects/torbrowser/design/index.html.en 1604) authenticated by a single hash of the sha256sums.txt file will also allow us projects/torbrowser/design/index.html.en 1605) to create a number of auxiliary authentication mechanisms for our packages, projects/torbrowser/design/index.html.en 1606) beyond just trusting a single offline build machine and a single cryptographic projects/torbrowser/design/index.html.en 1607) key's integrity. Interesting examples include providing multiple independent projects/torbrowser/design/index.html.en 1608) cryptographic signatures for packages, listing the package hashes in the Tor projects/torbrowser/design/index.html.en 1609) consensus, and encoding the package hashes in the Bitcoin blockchain.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1610)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1611) </p><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1612)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1613) At the time of this writing, we do not yet support native code signing for Mac projects/torbrowser/design/index.html.en 1614) OS or Windows. Because these signatures are embedded in the actual packages, projects/torbrowser/design/index.html.en 1615) and by their nature are based on non-public key material, providing native projects/torbrowser/design/index.html.en 1616) code-signed packages while still preserving ease of reproducibility projects/torbrowser/design/index.html.en 1617) verification has not yet been achieved.
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1618)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1619) </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp37040272"></a>5.3. Anonymous Verification</h3></div></div></div><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1620)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1621) Due to the fact that bit-identical packages can be produced by anyone, the projects/torbrowser/design/index.html.en 1622) security of this build system extends beyond the security of the official projects/torbrowser/design/index.html.en 1623) build machines. In fact, it is still possible for build integrity to be projects/torbrowser/design/index.html.en 1624) achieved even if all official build machines are compromised.`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1625)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1626) </p><p>`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1627)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	projects/torbrowser/design/index.html.en 1628) By default, all tor-specific dependencies and inputs to the build process are projects/torbrowser/design/index.html.en 1629) downloaded over Tor, which allows build verifiers to remain anonymous and projects/torbrowser/design/index.html.en 1630) hidden. Because of this, any individual can use our anonymity network to projects/torbrowser/design/index.html.en 1631) privately download our source code, verify it against public signed, audited, projects/torbrowser/design/index.html.en 1632) and mirrored git repositories, and reproduce our builds exactly, without being projects/torbrowser/design/index.html.en 1633) subject to targeted attacks. If they notice any differences, they can alert projects/torbrowser/design/index.html.en 1634) the public builders/signers, hopefully using a pseudonym or our anonymous projects/torbrowser/design/index.html.en 1635) bugtracker account, to avoid revealing the fact that they are a build projects/torbrowser/design/index.html.en 1636) verifier.
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1637)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1638) </p></div></div><div class="appendix"><h2 class="title" style="clear: both"><a id="Transparency"></a>A. Towards Transparency in Navigation Tracking</h2><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1639) projects/torbrowser/design/index.html.en 1640) The <a class="link" href="#privacy" title="2.2. Privacy Requirements">privacy properties</a> of Tor Browser are based projects/torbrowser/design/index.html.en 1641) upon the assumption that link-click navigation indicates user consent to projects/torbrowser/design/index.html.en 1642) tracking between the linking site and the destination site. While this projects/torbrowser/design/index.html.en 1643) definition is sufficient to allow us to eliminate cross-site third party projects/torbrowser/design/index.html.en 1644) tracking with only minimal site breakage, it is our long-term goal to further projects/torbrowser/design/index.html.en 1645) reduce cross-origin click navigation tracking to mechanisms that are projects/torbrowser/design/index.html.en 1646) detectable by attentive users, so they can alert the general public if projects/torbrowser/design/index.html.en 1647) cross-origin click navigation tracking is happening where it should not be. projects/torbrowser/design/index.html.en 1648) projects/torbrowser/design/index.html.en 1649) </p><p> projects/torbrowser/design/index.html.en 1650) projects/torbrowser/design/index.html.en 1651) In an ideal world, the mechanisms of tracking that can be employed during a projects/torbrowser/design/index.html.en 1652) link click would be limited to the contents of URL parameters and other projects/torbrowser/design/index.html.en 1653) properties that are fully visible to the user before they click. However, the projects/torbrowser/design/index.html.en 1654) entrenched nature of certain archaic web features make it impossible for us to projects/torbrowser/design/index.html.en 1655) achieve this transparency goal by ourselves without substantial site breakage. projects/torbrowser/design/index.html.en 1656) So, instead we maintain a <a class="link" href="#deprecate" title="A.1. Deprecation Wishlist">Deprecation projects/torbrowser/design/index.html.en 1657) Wishlist</a> of archaic web technologies that are currently being (ab)used projects/torbrowser/design/index.html.en 1658) to facilitate federated login and other legitimate click-driven cross-domain projects/torbrowser/design/index.html.en 1659) activity but that can one day be replaced with more privacy friendly, projects/torbrowser/design/index.html.en 1660) auditable alternatives. projects/torbrowser/design/index.html.en 1661) projects/torbrowser/design/index.html.en 1662) </p><p> projects/torbrowser/design/index.html.en 1663) projects/torbrowser/design/index.html.en 1664) Because the total elimination of side channels during cross-origin navigation projects/torbrowser/design/index.html.en 1665) will undoubtedly break federated login as well as destroy ad revenue, we projects/torbrowser/design/index.html.en 1666) also describe auditable alternatives and promising web draft standards that would projects/torbrowser/design/index.html.en 1667) preserve this functionality while still providing transparency when tracking is projects/torbrowser/design/index.html.en 1668) occurring. projects/torbrowser/design/index.html.en 1669)
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1670) </p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="deprecate"></a>A.1. Deprecation Wishlist</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">The Referer Header`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1671) <p> projects/torbrowser/design/index.html.en 1672)`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1673) We haven't disabled or restricted the Referer ourselves because of the projects/torbrowser/design/index.html.en 1674) non-trivial number of sites that rely on the Referer header to "authenticate"`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1675) image requests and deep-link navigation on their sites. Furthermore, there projects/torbrowser/design/index.html.en 1676) seems to be no real privacy benefit to taking this action by itself in a`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1677) vacuum, because many sites have begun encoding Referer URL information into`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1678) GET parameters when they need it to cross http to https scheme transitions. projects/torbrowser/design/index.html.en 1679) Google's +1 buttons are the best example of this activity. projects/torbrowser/design/index.html.en 1680) projects/torbrowser/design/index.html.en 1681) </p><p> projects/torbrowser/design/index.html.en 1682) projects/torbrowser/design/index.html.en 1683) Because of the availability of these other explicit vectors, we believe the`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1684) main risk of the Referer header is through inadvertent and/or covert data`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1685) leakage. In fact, <a class="ulink" href="http://www2.research.att.com/~bala/papers/wosn09.pdf" target="_top">a great deal of`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1686) personal data</a> is inadvertently leaked to third parties through the projects/torbrowser/design/index.html.en 1687) source URL parameters. projects/torbrowser/design/index.html.en 1688) projects/torbrowser/design/index.html.en 1689) </p><p> projects/torbrowser/design/index.html.en 1690) projects/torbrowser/design/index.html.en 1691) We believe the Referer header should be made explicit. If a site wishes to projects/torbrowser/design/index.html.en 1692) transmit its URL to third party content elements during load or during
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1693) link-click, it should have to specify this as a property of the associated HTML projects/torbrowser/design/index.html.en 1694) tag. With an explicit property, it would then be possible for the user agent to`
TBB design doc: More review... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1695) inform the user if they are about to click on a link that will transmit Referer`
Update TBB design doc based... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1696) information (perhaps through something as subtle as a different color in the projects/torbrowser/design/index.html.en 1697) lower toolbar for the destination URL). This same UI notification can also be projects/torbrowser/design/index.html.en 1698) used for links with the <a class="ulink" href="https://developer.mozilla.org/en-US/docs/HTML/Element/a#Attributes" target="_top">"ping"</a>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1699) attribute. projects/torbrowser/design/index.html.en 1700) projects/torbrowser/design/index.html.en 1701) </p></li><li class="listitem">window.name projects/torbrowser/design/index.html.en 1702) <p>`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1703) <a class="ulink" href="https://developer.mozilla.org/En/DOM/Window.name" target="_top">window.name</a> is`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1704) a DOM property that for some reason is allowed to retain a persistent value projects/torbrowser/design/index.html.en 1705) for the lifespan of a browser tab. It is possible to utilize this property for`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1706) <a class="ulink" href="http://www.thomasfrank.se/sessionvars.html" target="_top">identifier`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1707) storage</a> during click navigation. This is sometimes used for additional projects/torbrowser/design/index.html.en 1708) XSRF protection and federated login. projects/torbrowser/design/index.html.en 1709) </p><p> projects/torbrowser/design/index.html.en 1710) projects/torbrowser/design/index.html.en 1711) It's our opinion that the contents of window.name should not be preserved for projects/torbrowser/design/index.html.en 1712) cross-origin navigation, but doing so may break federated login for some sites. projects/torbrowser/design/index.html.en 1713) projects/torbrowser/design/index.html.en 1714) </p></li><li class="listitem">Javascript link rewriting projects/torbrowser/design/index.html.en 1715) <p> projects/torbrowser/design/index.html.en 1716) projects/torbrowser/design/index.html.en 1717) In general, it should not be possible for onclick handlers to alter the projects/torbrowser/design/index.html.en 1718) navigation destination of 'a' tags, silently transform them into POST projects/torbrowser/design/index.html.en 1719) requests, or otherwise create situations where a user believes they are projects/torbrowser/design/index.html.en 1720) clicking on a link leading to one URL that ends up on another. This projects/torbrowser/design/index.html.en 1721) functionality is deceptive and is frequently a vector for malware and phishing projects/torbrowser/design/index.html.en 1722) attacks. Unfortunately, many legitimate sites also employ such transparent projects/torbrowser/design/index.html.en 1723) link rewriting, and blanket disabling this functionality ourselves will simply projects/torbrowser/design/index.html.en 1724) cause Tor Browser to fail to navigate properly on these sites. projects/torbrowser/design/index.html.en 1725) projects/torbrowser/design/index.html.en 1726) </p><p> projects/torbrowser/design/index.html.en 1727) projects/torbrowser/design/index.html.en 1728) Automated cross-origin redirects are one form of this behavior that is
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1729) possible for us to <a class="ulink" href="https://trac.torproject.org/projects/tor/ticket/3600" target="_top">address`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1730) ourselves</a>, as they are comparatively rare and can be handled with site projects/torbrowser/design/index.html.en 1731) permissions. projects/torbrowser/design/index.html.en 1732)`
Update design doc for TBB 4.0. Mike Perry authored 9 years ago	`projects/torbrowser/design/index.html.en 1733) </p></li></ol></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp37071376"></a>A.2. Promising Standards</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><a class="ulink" href="http://web-send.org" target="_top">Web-Send Introducer</a><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1734) projects/torbrowser/design/index.html.en 1735) Web-Send is a browser-based link sharing and federated login widget that is projects/torbrowser/design/index.html.en 1736) designed to operate without relying on third-party tracking or abusing other`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1737) cross-origin link-click side channels. It has a compelling list of <a class="ulink" href="http://web-send.org/features.html" target="_top">privacy and security features</a>,`
Update design doc with FF17... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1738) especially if used as a "Like button" replacement. projects/torbrowser/design/index.html.en 1739)`
TBB design doc: Fix charset... Mike Perry authored 11 years ago	`projects/torbrowser/design/index.html.en 1740) </p></li><li class="listitem"><a class="ulink" href="https://developer.mozilla.org/en-US/docs/Persona" target="_top">Mozilla Persona</a><p>`
Update design doc with FF17... Mike Perry authored 11 years ago	projects/torbrowser/design/index.html.en 1741) projects/torbrowser/design/index.html.en 1742) Mozilla's Persona is designed to provide decentralized, cryptographically projects/torbrowser/design/index.html.en 1743) authenticated federated login in a way that does not expose the user to third projects/torbrowser/design/index.html.en 1744) party tracking or require browser redirects or side channels. While it does projects/torbrowser/design/index.html.en 1745) not directly provide the link sharing capabilities that Web-Send does, it is a projects/torbrowser/design/index.html.en 1746) better solution to the privacy issues associated with federated login than projects/torbrowser/design/index.html.en 1747) Web-Send is. projects/torbrowser/design/index.html.en 1748)