Browse code

Add pluggable transport information to docs/bridges.

George Kadianakis authored on 06/11/2012 23:40:33
Showing 2 changed files
... ...
@@ -13,6 +13,15 @@
13 13
     <a id="BridgeIntroduction"></a>
14 14
     <h2><a class="anchor" href="#BridgeIntroduction">Tor: Bridges</a></h2>
15 15
     <hr>
16
+
17
+    <p>
18
+    <img width="7%" height="7%" style="float: left;" src="$(IMGROOT)/icon-Obfsproxy.jpg">
19
+    <b>Tip:</b>
20
+    Having trouble connecting to Tor even when using bridges? You will
21
+    need to use <b>pluggable transports</b> and <b>obfuscated
22
+    bridges</b>. <a class="anchor" href="#PluggableTransports">Click
23
+    here for more information</a>.
24
+    </p>
16 25
     
17 26
     <p>
18 27
     Bridge relays (or "bridges" for short) are Tor relays that aren't listed in
... ...
@@ -70,10 +79,29 @@
70 79
     href="#FindingMore">other ways to find bridges</a> too.
71 80
     </p>
72 81
     
73
-    <a id="Understanding"></a>
74
-    <h2><a class="anchor" href="#Understanding">Understanding bridges</a></h2>
82
+    <a id="PluggableTransports"></a>
83
+    <h2><a class="anchor" href="#PluggableTransports">Obfuscated Bridges and Pluggable Transports</a></h2>
75 84
     <hr>
76 85
     
86
+    <p> Lately, censors have found ways to block Tor even when clients
87
+    are using bridges. They usually do this by installing boxes in
88
+    ISPs that peek at network traffic and detect Tor; when Tor is
89
+    detected they block the traffic flow.
90
+    </p>
91
+
92
+    <p>To circumvent such sophisicated censorship Tor introduced
93
+    <i>obfuscated bridges</i>. These bridges use special plugins
94
+    called <i>pluggable transports</i> which obfuscate the traffic
95
+    flow of Tor, making its detection harder.
96
+
97
+    To connect to obfuscated bridges you need to use the <a
98
+    href=https://www.torproject.org/projects/obfsproxy.html.en#download>Obfproxy
99
+    Tor Browser Bundle</a>. The bundle includes some pre-configured
100
+    obfsproxy bridges and you can get more off <a
101
+    href=https://bridges.torproject.org/?transport=obfs2>BridgeDB</a>
102
+
103
+    <a id="Understanding"></a>
104
+    <h2><a class="anchor" href="#Understanding">Understanding bridges</a></h2><hr>
77 105
     <p>
78 106
     As an example, you'll get a bridge entry that looks like the
79 107
     following:
... ...
@@ -90,8 +118,23 @@
90 118
     The second element is the port: <tt>'443'</tt><br>
91 119
     The third element, the fingerprint, is optional:
92 120
     <tt>'4352e58420e68f5e40bf7c74faddccd9d1349413'</tt><br>
121
+
122
+    <p>
123
+    <img width="7%" height="7%" style="vertical-align:middle" src="$(IMGROOT)/icon-Obfsproxy.jpg">
124
+         <span><b>Pluggable transports tip:</b></span>
93 125
     </p>
94
-    
126
+    <p>
127
+    If your bridge line looks like this:
128
+    <pre><samp>
129
+    bridge obfs2 141.201.27.48:420 4352e58420e68f5e40bf7c74faddccd9d1349413
130
+    </samp>
131
+    </pre>
132
+
133
+    The second element is the name of the pluggable transport
134
+    technology used by the bridge. For example, in the case above, the
135
+    bridge is using the <i>obfs2</i> pluggable transport.
136
+    </p>
137
+
95 138
     <a id="UsingBridges"></a>
96 139
     <h2><a class="anchor" href="#UsingBridges">Using bridges with Tor and
97 140
     Vidalia</a></h2>
... ...
@@ -115,6 +158,21 @@
115 158
     to reach the Tor network, but if you only have one bridge and it goes
116 159
     down, you will be cut off from the Tor network.
117 160
     </p>
161
+
162
+    <p>
163
+    <img width="7%" height="7%" style="vertical-align:middle" src="$(IMGROOT)/icon-Obfsproxy.jpg">
164
+         <span><b>Pluggable transports tip:</b></span>
165
+    </p>
166
+    <p>
167
+
168
+    If you have managed to get hold of some obfuscated bridge
169
+    addresses, you should add them in Vidalia in the same fashion that
170
+    you add normal bridges. Just paste the bridge line into the "Add a
171
+    bridge" window:
172
+
173
+    <br><br>
174
+    <img src="$(IMGROOT)/vidalia_add_obfsbridge.png" alt="Add obfuscated bridge in Vidalia">
175
+    <br><br>
118 176
     
119 177
     <a id="FindingMore"></a>
120 178
     <h2><a class="anchor" href="#FindingMore">Finding more bridges for Tor</a></h2>
121 179
new file mode 100644
122 180
Binary files /dev/null and b/images/vidalia_add_obfsbridge.png differ