ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2024-12-23 14:52:26 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Minor corrections of index and indention

Browse Source
This commit is contained in:
David Stainton 2014-08-31 23:03:40 +00:00 committed by Brian Warner
parent 856f4ce266
commit 9a6fe0edbd
1 changed files with 20 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/tor.rst
View File

@ -7,9 +7,8 @@ Using Tahoe-LAFS with Tor
1. `Use cases`_ 1. `Use cases`_
2. `Native Tor integration for Tahoe-LAFS`_ 2. `Native Tor integration for Tahoe-LAFS`_
3. `Software Dependencies`_ 3. `Software Dependencies`_
4. `Client Configuration`_ 4. `Configuration`_
5. `Storage Server Configuration`_ 5. `Performance and security issues of Tor Hidden Services`_
6. `Performance and security issues of Tor Hidden Services`_
Use cases Use cases
@ -94,9 +93,8 @@ Software Dependencies
pip install txtorcon pip install txtorcon
Once these software dependencies are installed and the Tahoe-LAFS node Once these software dependencies are installed and the Tahoe-LAFS node
is restarted, then no further configuration is necessary in order for is restarted, then no further configuration is necessary for "unsafe"
it to connect to other Tahoe-LAFS nodes via Tor (client use-case 2 from Tor connectivity to other Tahoe-LAFS nodes (client use-case 2 from `Use cases`_, above).
`Use cases`_, above).
In order to implement client use-case 3 or server use-cases 2 or 3, further In order to implement client use-case 3 or server use-cases 2 or 3, further
configuration is necessary. configuration is necessary.
@ -108,26 +106,26 @@ Configuration
``[node]`` ``[node]``
``tor_only.enabled = (boolean, optional)`` ``tor_only.enabled = (boolean, optional)``
This specifies two changes in behavior: This specifies two changes in behavior:
1. Transform all non-Tor client endpoints into Tor client endpoints. 1. Transform all non-Tor client endpoints into Tor client endpoints.
2. Force ``tub.location`` to be set to "safe" values. 2. Force ``tub.location`` to be set to "safe" values.
This option is necessary to preserve the client's anonymity (client This option is **critical** to preserving the client's anonymity (client
use-case 3 from `Use cases`_, above). It is also necessary to use-case 3 from `Use cases`_, above). It is also necessary to
preserve a server's anonymity (server use-case 3). preserve a server's anonymity (server use-case 3).
When ``tor_only.enabled`` is specified then ``tub.location`` does not need When ``tor_only.enabled`` is specified then ``tub.location`` does not need
to be specified... and it is an error to specify a ``tub.location`` value to be specified... and it is an error to specify a ``tub.location`` value
that contains anything other than "UNREACHABLE" or a Tor Hidden Service that contains anything other than "UNREACHABLE" or a Tor Hidden Service
Twisted endpoint descriptor string. Twisted endpoint descriptor string.
If server use-case 2 from `Use cases`_ above is desired then you can set If server use-case 2 from `Use cases`_ above is desired then you can set
``tub.location`` to a Tor Hidden Service endpoint string AND "AUTODETECT" ``tub.location`` to a Tor Hidden Service endpoint string AND "AUTODETECT"
like this:: like this::
tub.location = "AUTODETECT,onion:80:hiddenServiceDir=/var/lib/tor/my_service" tub.location = "AUTODETECT,onion:80:hiddenServiceDir=/var/lib/tor/my_service"
It is an error to specify a ``tub.location`` value that contains "AUTODETECT" It is an error to specify a ``tub.location`` value that contains "AUTODETECT"
when ``tor_only.enabled`` is also set to ``true``. when ``tor_only.enabled`` is also set to ``true``.
Operators of Tahoe-LAFS storage servers wishing to protect the identity of their Operators of Tahoe-LAFS storage servers wishing to protect the identity of their
storage server should set ``tor_only.enabled`` to ``true`` and specify a storage server should set ``tor_only.enabled`` to ``true`` and specify a