GitLab is used only for code review, issue tracking and project management. Canonical locations for source code are still https://gitweb.torproject.org/ https://git.torproject.org/ and git-rw.torproject.org.

Commit b27d54ad authored by traumschule's avatar traumschule

bridges/transports: remove no longer needed anchors

parent 3314f3df
......@@ -29,24 +29,22 @@ When Tor fails to bootsrap (when connecting hangs for several minutes) you will
To [use a bridge](#UsingBridges), you have several options.
Tor Browser now provides some bridges by default.
You can enable these easily.
* [When Tor *does* work](#AddTorWorks)
* [When Tor *doesn't* work](#AddTorNotWorks)
* [When Tor works](#when-tor-works)
* [When Tor *doesn't* work](#when-tor-does-not-work)
If you are using Tails you need to [configure the bridges when starting](https://tails.boum.org/doc/first_steps/startup_options/bridge_mode/), you cannot do it after you connect to Internet.
Unfortunately, because these bridges are publically distributed, it is easy for censors to block some of them, so some of them may not work.
In this case, you'll need to locate different bridges.
Once you have obtained some bridge addresses, you will need to enter them into Tor Launcher.
* [Finding more bridges for Tor](#FindingMore)
* [Finding more bridges for Tor](#getting-bridge-addresses)
Give it a try and if you have issues, see the [troubleshooting](#Troubleshooting) section.
Give it a try and if you have issues, see the [troubleshooting](#troubleshooting) section.
If you want to contribute see [running a bridge](#RunningABridge).
If you want to contribute see [running a bridge](#running-a-tor-bridge).
----
<a id="Understanding"></a>
##### Understanding A Bridge Configuration Line
As an example, when you obtain a bridge from https://bridges.torproject.org, you'll get a bridge entry that looks like the following:
......@@ -74,12 +72,11 @@ For example, in the case above, the bridge is using the *obfs4* pluggable transp
----
<!-- TODO some screenshots in this section show Tor Launcher instead of Tor Browser's network settings -->
<a id="AddTorWorks"></a>
##### Using bridges in Tor Browser when Tor *does* work
##### When Tor works
The following instructions assume Tor Browser successfully loads and you are able to surf the web.
If you do not see the web browser when you run Tor Browser (like in step (1) below), you may need to follow the instructions for [when Tor *doesn't* work](#AddTorNotWorks)
If you do not see the web browser when you run Tor Browser (like in step (1) below), you may need to follow the instructions for [when Tor *doesn't* work](#when-tor-does-not-work)
##### 1) Start Tor Browser
......@@ -127,7 +124,7 @@ If none of the provided bridges works for you, try "Request a bridge from torpro
##### 5c) Use custom bridge
To use a [custom bridge](#FindingMore) select "Provide a bridge I know".
To use a [custom bridge](#getting-bridge-addresses) select "Provide a bridge I know".
![Tor Browser's Bridge Configuration page - provide bridges](../static/images/bridges/tor-launcher-provide-bridge.png "Tor Browser's Bridge Configuration page - provide bridges")
......@@ -140,9 +137,7 @@ If this does not work, see the [troubleshooting section](#Troubleshooting) below
----
<a id="AddTorNotWorks"></a>
##### Using bridges in Tor Browser when Tor *does not* work
##### When Tor *does not* work
First, you should read the [FAQ about problems with running Tor properly](https://www.torproject.org/docs/faq.html.en#DoesntWork) when you have issues.
Sometimes Tor does not work due to a silly mistake rather than your ISP interfering with your Internet connection.
......@@ -199,7 +194,7 @@ If none of the provided bridges works for you, try to request one:
###### 5c) Use custom bridge
To use a [custom bridge](#FindingMore) select "Provide a bridge I know".
To use a [custom bridge](#getting-bridge-addresses) select "Provide a bridge I know".
![Tor Browser's Bridge Configuration page - provide bridge(s)](../static/images/bridges/tor-launcher-provide-bridge.png "Tor Browser's Bridge Configuration page - provide bridge(s)")
......@@ -211,8 +206,6 @@ After you decide which bridges you want to use, click "Connect". Tor should now
----
<a id="Troubleshooting"></a>
##### Troubleshooting
Sometimes the bootstrapping gets stuck at some point, for example when a bridge went offline, the connection is blocked, or when the Pluggable Transport is hit by a bug.
......@@ -236,8 +229,6 @@ If you have any questions, please [contact us](https://www.torproject.org/about/
----
<a id="FindingMore"></a>
##### Getting bridge addresses
Because bridge addresses are not public, you will need to request them yourself. You have two options:
......@@ -274,7 +265,6 @@ Once you've received the email with bridge information, you can continue the con
----
<!-- TODO this section may be out of date and should be checked against the current relay guide -->
<a id="RunningABridge"></a>
##### Running a Tor Bridge
......
......@@ -2,13 +2,16 @@ _model: topic
---
title: Pluggable transports
---
description: Pluggable transports are tools that Tor can use to disguise the traffic it sends out.
description: Pluggable transports are used to prevent recognition of tor traffic to a bridge.
---
seo_slug: plugable-transports
---
key: 4
---
body:
A pluggable transport is a program that is used between the user’s Tor client, such as Tor Browser, and a Tor bridge.
The pluggable transport’s job is to change the appearance of the data that flows between itself and the bridge so that a censor won’t be able to recognize it as Tor traffic.
Over the last few years, censors have found ways to block Tor even when clients are using bridges.
They usually do this by installing special boxes at ISPs that peek into network traffic and detect Tor;
when Tor is detected they block the traffic flow.
......@@ -17,7 +20,7 @@ To circumvent such sophisticated censorship Tor introduced pluggable transports.
These transports manipulate all Tor traffic between the client and its first hop such that it is not identifiable as a Tor connection.
If the censor can't decide if the connection is a Tor connection, then they are less likely to block it.
Tor Browser includes some pre-configured [bridges](../bridges) and you can get more from [BridgeDB](#FindingMore), if those don't work.
Tor Browser includes some pre-configured [bridges](../bridges) and you can get more from [BridgeDB](../bridges#getting-bridge-addresses), if those don't work.
Sadly, pluggable transports are not immune to detection, if a censor is given enough time.
In the past, we promoted obfs and obfs2 as safe transports.
......@@ -25,7 +28,7 @@ These are now deprecated and were replaced by obfs3, scramblesuit, fte, and obfs
----
##### Types of pluggable transport
##### Types of Pluggable Transports
Most pluggable transports, such as obfs3 and obfs4, rely on the use of “bridge” relays. Like ordinary Tor relays, bridges are run by volunteers; unlike ordinary relays, however, they are not listed publicly, so an adversary cannot identify them easily. Using bridges in combination with pluggable transports helps to disguise the fact that you are using Tor.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment