[tor-bugs] #11159 [Website]: Document deploying a scramblesuit bridge on the website.

[Tor Bug Tracker & Wiki]

#11159: Document deploying a scramblesuit bridge on the website.
-------------------------+-------------------------------------------------
     Reporter:  mttp     |      Owner:  phw
         Type:  defect   |     Status:  assigned
     Priority:  normal   |  Milestone:
    Component:  Website  |    Version:
   Resolution:           |   Keywords:  documentation, scramblesuit,
Actual Points:           |  pluggable-transports
       Points:           |  Parent ID:
-------------------------+-------------------------------------------------
Changes (by phw):

 * status:  new => assigned
 * owner:   => phw


Comment:

 > These two pages have instructions for setting up an obfs2/obfs3 bridge.
 Is changing the ServerTransportPlugin line and adding a note about using
 tor 0.2.5 enough to introduce bridge operators to scramblesuit?

 Yes, that should be enough.  Note however, that ScrambleSuit requires at
 least version 0.2.5.1-alpha.  That version started supporting the
 configuration option `ServerTransportOptions`.

 > It might make sense for scramblesuit to get its own project page
 (#5192). Should scramblesuit get it's own installation page too?

 I don't think that's necessary.  After all, it's part of obfsproxy and the
 path of least confusion might be to document it on the same page.

 > What other information should be included?

 We should probably mention how one can get the bridge descriptor.  If you
 don't specify the shared secret (for example, by adding
 `ServerTransportOptions scramblesuit
 password=3X5BIA2MIHLZ55UV4VAEGKZIQPPZ4QT3`), ScrambleSuit automatically
 generates a shared secret and stores the bridge descriptor in
 `DATADIR/pt_state/scramblesuit/server_descriptor`.

 Another thing worth pointing out is how to generate your own shared
 secret.  We don't want people to come up with their own silly passwords,
 so we will soon add the script generate_password.py to obfsproxy which,
 when executed, gives you a copy & pastable shared secret for your torrc.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/11159#comment:1>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online