ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2025-04-07 10:56:49 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Expanded explanation of [node]anonymize

Browse Source
This commit is contained in:
str4d 2014-09-08 03:26:55 +00:00 committed by Brian Warner
parent 8cc2307d80
commit d09173cbf7
1 changed files with 21 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/anonymity-configuration.rst
View File

@ -186,14 +186,31 @@ configuration is necessary.
Configuration
=============
::
Tahoe-LAFS provides a configuration flag for explicitly stating whether or not
anonymity is required for a node::
[node]
anonymize = (boolean, optional)
This specifies two changes in behavior:
1. Transform all non-Tor client endpoints into Tor client endpoints.
2. Force ``tub.location`` to be set to "safe" values.
Setting ``anonymize = True`` causes several changes in the behavior of
Tahoe-LAFS:
1. Tahoe-LAFS will not start if any of the configuration options in ``tahoe.cfg``
would compromise the identity of the node. In particular, ``tub.location``
is forced to have "safe" values.
2. Tahoe-LAFS will not make any outgoing connections that are not over a
supported anonymizing network.
* If a server's FURL contains one or more location hints for anonymizing
networks, Tahoe-LAFS will prefer those hints to connect to the server.
An anonymizing network location hint will only be used if the correct
modules are installed.
* If a server's FURL contains no location hints for anonymizing networks
(or Tahoe-LAFS could not contact the server via any of the provided
anonymizing network location hints), and the user has the required modules
for Tor installed, Tahoe-LAFS will connect to the server using Tor as an
anonymizing proxy.
* In all other cases, Tahoe-LAFS will never connect to the server.
This option is **critical** to preserving the client's anonymity (client
use-case 3 from `Use cases`_, above). It is also necessary to