tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 4-optional
4) 
5) #include "head.wmi" TITLE="Tor: Volunteer" CHARSET="UTF-8"
6) <div id="content" class="clearfix">
7)   <div id="breadcrumbs">

8)     <a href="<page index>">Home &raquo; </a>

9)     <a href="<page getinvolved/volunteer>">Volunteer</a>
10)   </div>
11)   <div id="maincol"> 
12)     <!-- PUT CONTENT AFTER THIS TAG -->
13)     <h1>A few things everyone can do now:</h1>
14)     <ol>
15)     <li>Please consider <a href="<page docs/tor-doc-relay>">running
16)     a relay</a> to help the Tor network grow.</li>
17)     <li>Tell your friends! Get them to run relays. Get them to run hidden
18)     services. Get them to tell their friends.</li>
19)     <li>If you like Tor's goals, please <a href="<page donate/donate>">take a moment
20)     to donate to support further Tor development</a>. We're also looking
21)     for more sponsors &mdash; if you know any companies, NGOs, agencies,
22)     or other organizations that want anonymity / privacy / communications
23)     security, let them know about us.</li>
24)     <li>We're looking for more <a href="<page about/torusers>">good examples of Tor
25)     users and Tor use cases</a>. If you use Tor for a scenario or purpose not
26)     yet described on that page, and you're comfortable sharing it with us,
27)     we'd love to hear from you.</li>
28)     </ol>
29)     
30)     <p>Tor has <a href="<page getinvolved/open-positions>">two open positions</a>.
31)     Please <a href="<page about/contact>">contact us</a> if you are qualified!</p>
32)     
33)     <a id="Documentation"></a>
34)     <h2><a class="anchor" href="#Documentation">Documentation</a></h2>
35)     <ol>
36)     <li>Help translate the web page and documentation into other
37)     languages. See the <a href="<page getinvolved/translation>">translation
38)     guidelines</a> if you want to help out. We especially need Arabic or
39)     Farsi translations, for the many Tor users in censored areas.</li>
40)     <li>Evaluate and document
41)     <a href="https://trac.torproject.org/projects/tor/wiki/TheOnionRouter/TorifyHOWTO">our
42)     list of programs</a> that can be configured to use Tor.</li>
43)     <li>We have a huge list of <a
44)     href="https://trac.torproject.org/projects/tor/wiki/TheOnionRouter/SupportPrograms">potentially useful
45)     programs that interface to Tor</a>. Which ones are useful in which
46)     situations? Please help us test them out and document your results.</li>
47)     </ol>
48)     
49)     <a id="Advocacy"></a>
50)     <h2><a class="anchor" href="#Advocacy">Advocacy</a></h2>
51)     <ol>

52)     <li>Create a <a
53) href="https://trac.torproject.org/projects/tor/wiki/CommunityLogos">community
54) logo</a> under a Creative Commons license that all can use and modify.</li>
55)     <li>Create a presentation that can be used for various user group
56) meetings around the world.</li>

57)     <li>Create a video about the positive uses of Tor, what Tor is,
58)     or how to use it.  Some have already started on <a
59)     href="http://media.torproject.org/video/">Tor's Media server</a>,
60)     <a

61)     href="http://www.howcast.com/videos/90601-How-To-Circumvent-an-Internet-Proxy">Howcast</a>,

62)     and <a href="http://www.youtube.com/thetorproject">YouTube</a>.</li> 

63)     <li>Create a poster, or a set of posters, around a theme,

64)     such as "Tor for Freedom!".</li>

65)     <li>Create a t-shirt design that incorporates "Congratulations!
66)     You are using Tor!" in any language.</li>

67)     </ol>
68)     
69)     <a id="Coding"></a>
70)     <a id="Summer"></a>
71)     <a id="Projects"></a>
72)     <h2><a class="anchor" href="#Projects">Good Coding Projects</a></h2>
73)     
74)     <p>
75)     You may find some of these projects to be good <a href="<page

76)     about/gsoc>">Google Summer of Code 2011</a> ideas. We have labelled each idea

77)     with how useful it would be to the overall Tor project (priority), how
78)     much work we expect it would be (effort level), how much clue you should
79)     start with (skill level), and which of our <a href="<page

80)     about/corepeople>">core developers</a> would be good mentors.

81)     If one or more of these ideas looks promising to you, please <a
82)     href="<page about/contact>">contact us</a> to discuss your plans rather than
83)     sending blind applications. You may also want to propose your own project
84)     idea &mdash; which often results in the best applications.
85)     </p>
86)     
87)     <ol>
88)     
89)     <li>

90)     <b>Audit Tor Browser Bundles for data leaks</b>

91)     <br>

92)     Priority: <i>High</i>

93)     <br>

94)     Effort Level: <i>High</i>

95)     <br>

96)     Skill Level: <i>Medium</i>

97)     <br>

98)     Likely Mentors: <i>Steven, Erinn, Jacob, Andrew</i>

99)     <p>The Tor Browser Bundle incorporates Tor, Firefox, Polipo, and the Vidalia

100)     user interface (and optionally the <a href="http://pidgin.im/">Pidgin</a>
101)     Instant Messaging client). Components are pre-configured to operate in a
102)     secure way, and it has very few dependencies on the installed operating
103)     system. It has therefore become one of the most easy to use, and popular,

104)     ways to use Tor on Windows.</p>
105)     <p>This project is to identify all of the traces left behind by
106)     using a Tor Browser Bundle on Windows, Mac OS X, or Linux.  Developing
107)     ways to stop, counter, or remove these traces is a final step.</p>
108)     <p>Students should be familiar with operating system analysis,

109)     application development on one or preferably all of Windows, Linux,

110)     and Mac OS X, and be comfortable with C/C++ and shell scripting.</p>
111)     <p>If you would like to help extend or do security auditing for
112)     TBB, please contact Erinn.</p>

113)     </li>
114)     
115)     <li>
116)     <b>Help track the overall Tor Network status</b>

117)     <br>

118)     Priority: <i>Medium to High</i>

119)     <br>

120)     Effort Level: <i>Medium</i>

121)     <br>

122)     Skill Level: <i>Medium</i>

123)     <br>

124)     Likely Mentors: <i>Karsten, Roger</i>

125)     <p>It would be great to set up an automated system for tracking network

126)     health over time, graphing it, etc. Part of this project would involve
127)     inventing better metrics for assessing network health and growth. Is the
128)     average uptime of the network increasing? How many relays are qualifying
129)     for Guard status this month compared to last month? What's the turnover
130)     in terms of new relays showing up and relays shutting off? Periodically
131)     people collect brief snapshots, but where it gets really interesting is

132)     when we start tracking data points over time.</p>
133)     <p>Data could be collected from the Tor Network Scanners in <a

134)     href="https://svn.torproject.org/svn/torflow/trunk/README">TorFlow</a>, from
135)     the server descriptors that each relay publishes, and from other
136)     sources. Results over time could be integrated into one of the <a
137)     href="https://torstatus.blutmagie.de/">Tor Status</a> web pages, or be
138)     kept separate. Speaking of the Tor Status pages, take a look at Roger's
139)     <a href="http://archives.seul.org/or/talk/Jan-2008/msg00300.html">Tor

140)     Status wish list</a>.</p>

141)     </li>
142)     
143)     <li>
144)     <b>Improving Tor's ability to resist censorship</b>

145)     <br>

146)     Priority: <i>Medium to High</i>

147)     <br>

148)     Effort Level: <i>Medium to High</i>

149)     <br>

150)     Skill Level: <i>High</i>

151)     <br>

152)     Likely Mentors: <i>Roger, Nick, Steven</i>

153)     <p>The Tor 0.2.1.x series makes <a

154)     href="<svnprojects>design-paper/blocking.html">significant
155)     improvements</a> in resisting national and organizational censorship.
156)     But Tor still needs better mechanisms for some parts of its

157)     anti-censorship design.</p>
158)     <p>One huge category of work is adding features to our <a

159)     href="http://gitweb.torproject.org/bridgedb.git?a=tree">BridgeDB</a>

160)     service (Python). Tor aims to give out <a href="<page docs/bridges>">bridge
161)     relay addresses</a> to users that can't reach the Tor network
162)     directly, but there's an arms race between algorithms for distributing
163)     addresses and algorithms for gathering and blocking them. See <a

164)     href="<blog>bridge-distribution-strategies">our

165)     blog post on the topic</a> as an overview, and then look at <a
166)     href="http://archives.seul.org/or/dev/Dec-2009/msg00000.html">Roger's
167)     or-dev post</a> from December for more recent thoughts &mdash; lots of

168)     design work remains.</p>
169)     <p>If you want to get more into the guts of Tor itself (C), a more minor problem

170)     we should address is that current Tors can only listen on a single
171)     address/port combination at a time. There's
172)     <a href="<gitblob>doc/spec/proposals/118-multiple-orports.txt">a
173)     proposal to address this limitation</a> and allow clients to connect
174)     to any given Tor on multiple addresses and ports, but it needs more

175)     work.</p>
176)     <p>This project could involve a lot of research and design. One of the big

177)     challenges will be identifying and crafting approaches that can still
178)     resist an adversary even after the adversary knows the design, and

179)     then trading off censorship resistance with usability and
180)     robustness.</p>

181)     </li>
182)     

183)     <li>
184)     <b>Client Mode Use Cases for Arm</b>
185)     <br>
186)     Priority: <i>Medium</i>
187)     <br>
188)     Effort Level: <i>High</i>
189)     <br>
190)     Skill Level: <i>Medium</i>
191)     <br>
192)     Likely Mentors: <i>Damian</i>
193)     <p><a href="<page projects/arm>">Arm</a> is a Tor command line status
194)     monitor on *nix environments (Linux, Mac, and BSD). It functions much like
195)     top does, giving a CLI overlay of Tor's bandwidth usage, connections,
196)     configuration, log, etc. Thus far its design has been geared for Tor relay
197)     operators. However, this doesn't need to be the case. This project would be
198)     to expand and simplify arm to make it useful for Tor's client users
199)     too.</p>
200)     
201)     <p>This would include UI design, experimenting, and a lot of python
202)     hacking. Here's some ideas for client functionality arm could provide:</p>
203)     
204)     <ul>
205)       <li>A panel for client connections, showing each hop of the user's
206)       circuits with the ISP, country, and jurisdiction where those relays
207)       reside. Other interesting information would be the circuit's latency, how
208)       long its been around, and its possible exit ports. Some of this will be
209)       pretty tricky and require some experimentation to figure out what
210)       information can be fetched safely (for instance, scraping rdns and whois
211)       lookups could give hints about a relay's ISP, but we'd need to do it on
212)       all Tor relays to avoid leaking our connections to the resolver).</li>
213)       
214)       <li>Options to let the user request new circuits (the &quot;New
215)       Identity&quot; feature in Vidalia), select the exit country, etc.</li>
216)       
217)       <li>A panel showing Internet application and if their connections are
218)       being routed through Tor or not (giving a warning if there's leaks).</li>
219)       
220)       <li>The status of the bridges we're configured to use (ie, are they up?).
221)       This would include adding control port functionality to Tor for <a
222)       href="https://trac.torproject.org/projects/tor/ticket/2068">ticket
223)       2068</a>.</li>
224)       
225)       <li>A one click option to set Tor to be a client, relay, or bridge. The
226)       goal would be to make it trivial for users to voluntarily contribute to
227)       the Tor network.</li>
228)       
229)       <li>Menus as an alternative to hotkeys to make the interface more
230)       intuitive and usable for beginners (<a
231)       href="http://gnosis.cx/publish/programming/charming_python_6.html">example</a>).</li>
232)       
233)       <li>Look at Vidalia and TorK for ideas and solicit input from the Tor community.</li>
234)       
235)       <li>Make it easier for users to install arm by <a
236)       href="https://secure.wikimedia.org/wikipedia/en/wiki/Opkg">packaging for
237)       OpenWrt</a> (as a UI for the <a
238)       href="https://trac.torproject.org/projects/tor/wiki/TheOnionRouter/Torouter">Torouter
239)       project</a>) and Macs.</li>
240)     </ul>
241)     
242)     <p>For more project ideas see arm's <a
243)     href="https://svn.torproject.org/svn/arm/trunk/TODO">TODO</a>.</p>
244)     </li>
245)     

246)     <li>
247)     <b>Improve our unit testing process</b>

248)     <br>

249)     Priority: <i>Medium</i>

250)     <br>

251)     Effort Level: <i>Medium</i>

252)     <br>

253)     Skill Level: <i>Medium</i>

254)     <br>

255)     Likely Mentors: <i>Nick, Erinn</i>

256)     <p>Tor needs to be tested far more thoroughly. This is a
257)     multi-part effort. To start with, our unit test coverage should
258)     rise substantially, especially in the areas outside the utility
259)     functions. This will require significant refactoring of some parts
260)     of Tor, in order to dissociate as much logic as possible from
261)     globals.</p>

262)     <p>Additionally, we need to automate our performance testing. We've got

263)     buildbot to automate our regular integration and compile testing already
264)     (though we need somebody to set it up on Windows),
265)     but we need to get our network simulation tests (as built in <a
266)     href="https://svn.torproject.org/svn/torflow/trunk/README">TorFlow</a>)
267)     updated for more recent versions of Tor, and designed to launch a test
268)     network either on a single machine, or across several, so we can test

269)     changes in performance on machines in different roles automatically.</p>

270)     </li>
271)     
272)     <li>
273)     <b>More on Orbot &amp; Android OS-specific development</b>
274)     <br/>

275)     <br>

276)     Priority: <i>Medium</i>

277)     <br>

278)     Effort Level: <i>High</i>

279)     <br>

280)     Skill Level: <i>Medium to High</i>

281)     <br>

282)     Likely Mentors: <i>Nathan</i>

283)     <p><b>Android Java UI work:</b> Improved home screen to show better
284)     statistics about data transferred (up/down), number of circuits
285)     connected, quality of connection and so on. The "Tether Wifi"
286)     Android application is a good model to follow in how it shows
287)     a realtime count of bytes transferred as well as notifications

288)     when wifi clients connect. In addition, better display/handling

289)     of Tor system/error messages would also be very helpful. Finally,
290)     the addition of a wizard or tutorial walkthrough for novice

291)     users to explain to them exactly what is and what is not anonymized

292)     or protected would greatly improve the likelihood they will use
293)     Orbot correctly.</p>
294)     
295)     <p><b>Android Java OS/Core app work:</b> Better system-wide

296)     indication, either via the notification bar, "Toast" pop-up dialogs
297)     or some other indicator, that an application's traffic is indeed

298)     moving through Orbot/Tor. For instance, right now you need to
299)     first go to a torcheck web service to ensure your browser is
300)     routing via Tor. Orbot should be able to notify you that circuits
301)     are being opened, used, etc. The aforementioned data transfer
302)     tracker might provide this type of awareness as well.</p>
303)     
304)     <p><b>Android Java Library/Community Outreach work:</b> We need
305)     to package a simple library for use with third-party application

306)     to easily enable them to support "Torification" on non-rooted
307)     devices (i.e. w/o transparent proxying). This library should

308)     include a wrapper for the Apache HTTPClient library, a utility
309)     class for detecting the state of Orbot connectivity, and other
310)     relevant/useful things an Android app might need to anonymize
311)     itself. This work would include the creation of the library,
312)     documentation, and sample code. Outreach or effort to implement
313)     the library within other open-source apps would follow.</p>
314)     
315)     <p><b>Android OS/C/Linux work:</b> The port of Tor to Android
316)     is basically a straight cross-compile to Linux ARM. There has
317)     been no work done in looking the optimization of Tor within a
318)     mobile hardware environment, on the ARM processor or other
319)     Android hardware, or on mobile networks. It should be noted,
320)     that even without optimization, Tor is handling the mobile
321)     network environment very well, automatically detecting change

322)     in IP addresses, reconnecting circuits, etc. across switching

323)     from 2G to 3G to Wifi, and so forth.</p>

324)     </li>
325)     
326)     <li>
327)     <b>Simulator for slow Internet connections</b>

328)     <br>

329)     Priority: <i>Medium</i>

330)     <br>

331)     Effort Level: <i>Medium</i>

332)     <br>

333)     Skill Level: <i>Medium</i>

334)     <br>

335)     Likely Mentors: <i>Steven</i>

336)     <p>

337)     Many users of Tor have poor-quality Internet connections, giving low
338)     bandwidth, high latency, and high packet loss/re-ordering. User
339)     experience is that Tor reacts badly to these conditions, but it is
340)     difficult to improve the situation without being able to repeat the
341)     problems in the lab.

342)     </p>
343)     
344)     <p>

345)     This project would be to build a simulation environment which
346)     replicates the poor connectivity so that the effect on Tor performance
347)     can be measured. Other components would be a testing utility to
348)     establish what are the properties of connections available, and to
349)     measure the effect of performance-improving modifications to Tor.

350)     </p>
351)     
352)     <p>

353)     The tools used would be up to the student, but dummynet (for FreeBSD)
354)     and nistnet (for Linux) are two potential components on which this
355)     project could be built. Students should be experienced with network
356)     programming/debugging and TCP/IP, and preferably familiar with C and a
357)     scripting language.

358)     </p>

359)     </li>
360)     
361)     <li>
362)     <b>Torbutton equivalent for Thunderbird</b>

363)     <br>

364)     Priority: <i>Medium</i>

365)     <br>

366)     Effort Level: <i>High</i>

367)     <br>

368)     Skill Level: <i>High</i>

369)     <br>

370)     Likely Mentors: <i>Mike</i>

371)     <p>

372)     We're hearing from an increasing number of users that they want to use
373)     Thunderbird with Tor. However, there are plenty of application-level
374)     concerns, for example, by default Thunderbird will put your hostname in
375)     the outgoing mail that it sends. At some point we should start a new
376)     push to build a Thunderbird extension similar to Torbutton.

377)     </p>

378)     </li>
379)     
380)     <li>
381)     <b>Improvements for Tor+Vidalia interaction on Linux/Unix platforms</b>

382)     <br>

383)     Priority: <i>Medium</i>

384)     <br>

385)     Effort Level: <i>Medium</i>

386)     <br>

387)     Skill Level: <i>Medium</i>

388)     <br>

389)     Likely Mentors: <i>Erinn, Peter</i>

390)     <p>

391)     Vidalia currently doesn't play nicely with Tor on Linux and Unix platforms.
392)     Currently, on Debian and Ubuntu, there is a configuration mechanism which
393)     allows Vidalia to override Tor's ability to start on boot (by sourcing
394)     <code>/etc/default/tor.vidalia</code> which sets <code>RUN_DAEMON=no</code> at the user's
395)     request), but full implementation of <a href="<gitblob>doc/spec/control-spec.txt">ControlPort</a> 
396)     communication is still required.

397)     </p>
398)     
399)     <p>

400)     A better solution on Linux and Unix platforms would be to use Tor's
401)     ControlSocket, which allows Vidalia to talk to Tor via a Unix domain socket,
402)     and could possibly be enabled by default in Tor's distribution packages.
403)     Vidalia can then authenticate to Tor using filesystem-based (cookie)
404)     authentication if the user running Vidalia is also in the distribution-specific
405)     tor group.

406)     </p>
407)     
408)     <p>

409)     This project will first involve adding support for Tor's ControlSocket to
410)     Vidalia. The student will then develop and test this support on various
411)     distributions to make sure it behaves in a predictable and consistent manner on
412)     all of them.

413)     </p>
414)     
415)     <p>

416)     The next challenge would be to find an intuitive and usable way for Vidalia to be
417)     able to change Tor's configuration (torrc) even though it is located in
418)     <code>/etc/tor/torrc</code> and thus immutable. In Debian and Ubuntu we handle
419)     this with the aforementioned <code>/etc/default/tor.vidalia</code> but this

420)     functionality could (or should) be less distribution-specific.
421)     </p>
422)     
423)     <p>

424)     The best idea we've come up with so far is to feed Tor a new configuration via
425)     the ControlSocket when Vidalia starts, but that's bad because if the user is not
426)     using the latest Debian/Ubuntu packages, they may not have disabled Tor's
427)     ability to run on boot and will end up with a configuration that is different
428)     from what they want. The second best idea we've come up with is for Vidalia to
429)     write out a temporary torrc file and ask the user to manually move it to
430)     <code>/etc/tor/torrc</code>, but that's bad because users shouldn't have to
431)     mess with files directly.

432)     </p>
433)     
434)     <p>

435)     A person undertaking this project should have prior knowledge of various Linux
436)     distributions and their packaging mechanisms as well as some C++ development
437)     experience. Previous experience with Qt is helpful, but not required.

438)     </p>

439)     </li>
440)     
441)     
442)     <li>
443)     <b>Usability testing of Tor</b>

444)     <br>

445)     Priority: <i>Medium</i>

446)     <br>

447)     Effort Level: <i>Medium</i>

448)     <br>

449)     Skill Level: <i>Low to Medium</i>

450)     <br>

451)     Likely Mentors: <i>Andrew</i>

452)     <p>

453)     Especially the browser bundle, ideally amongst our target demographic.
454)     That would help a lot in knowing what needs to be done in terms of bug
455)     fixes or new features. We get this informally at the moment, but a more
456)     structured process would be better.

457)     </p>

458)     </li>

459)     
460)     <li>
461)     <b>An authenticating IRC proxy</b>

462)     <br>

463)     Priority: <i>Low</i>

464)     <br>

465)     Effort Level: <i>Medium to High</i>

466)     <br>

467)     Skill Level: <i>Medium to High</i>

468)     <br>

469)     Likely Mentors: <i>Sebastian, Peter, Roger</i>
470)     <p>

471)     The world needs an authenticating irc proxy. As we're periodically
472)     reminded from the Penny Arcade web comic, "Internet user + anonymity =
473)     jerk". With respect to websites we're actually doing ok, since websites
474)     can make their users log in and use other application-level authentication
475)     approaches. But IRC servers are much worse off, because most IRC server
476)     code is poorly written: hard to maintain, and harder to modify. Many
477)     IRC networks now block connections from Tor, and we're basically down to
478)     two holdouts (OFTC and Freenode). This state of affairs means that a lot
479)     of people around the world are thinking "I told you so" about anonymity
480)     online, when in fact the problem is simply lack of technology to make the
481)     problem manageable. We need some way to let the IRC networks distinguish
482)     which users have developed a reputation as not being jerks, so they can
483)     treat the two groups separately. There are some really cool research
484)     designs like <a href="http://www.cs.dartmouth.edu/~nymble/">Nymble</a>,
485)     which aim to let websites blacklist users without needing to learn who
486)     they are.  But Nymble is designed around web interactions. We need to
487)     build the glue around the IRC protocol that would let us plug in a project
488)     like Nymble (or a simpler one to start, as a proof-of-concept). One way
489)     to do that would be to build an IRC proxy that knows how to hear from
490)     IRC clients, knows how to talk to IRC servers, and has an additional
491)     layer that requires the users to authenticate.  Some work on this has
492)     begun by other volunteers, see their progress at <a
493)     href="http://github.com/anonirc/orc">http://github.com/anonirc/orc</a>.

494)     </p>

495)     </li>
496)     
497)     <li>
498)     <b>Make torsocks/dsocks work on OS X</b>

499)     <br>

500)     Priority: <i>Medium</i>

501)     <br>

502)     Effort Level: <i>Medium</i>

503)     <br>

504)     Skill Level: <i>Medium</i>

505)     <br>

506)     Likely Mentors: <i>?</i>

507)     <p>

508)     <a href="http://code.google.com/p/torsocks/">Torsocks</a> and <a
509)     href="http://code.google.com/p/dsocks/">dsocks</a> are wrappers that will
510)     run applications, intercept their outgoing network connections, and push
511)     those connections through Tor. The goal is to handle applications that
512)     don't support proxies (or don't supporting them well). To get it right,
513)     they need to intercept many system calls. The syscalls you need to
514)     intercept on Linux differ dramatically from those on BSD. So Torsocks
515)     works fine on Linux, dsocks works ok on BSD (though it may be less
516)     maintained and thus might miss more syscalls), and nothing works well
517)     on both. First, we should patch dsocks to use Tor's <i>mapaddress</i>
518)     commands from the controller interface, so we don't waste a whole
519)     round-trip inside Tor doing the resolve before connecting. Second,
520)     we should make our <i>torify</i> script detect which of torsocks or
521)     dsocks is installed, and call them appropriately. This probably means
522)     unifying their interfaces, and might involve sharing code between them
523)     or discarding one entirely.

524)     </p>
525)     </li>
526)     
527)     <li>
528)     <b>Tor Controller Status Event Interface for Vidalia</b>
529)     <br>
530)     Priority: <i>Medium</i>
531)     <br>
532)     Effort Level: <i>Medium</i>
533)     <br>
534)     Skill Level: <i>Low to Medium</i>
535)     <br>
536)     Likely Mentors: <i>Tomás?</i>
537)     <p>There are a number of status changes inside Tor of which the user may need
538)     to be informed. For example, if the user is trying to set up his Tor as a
539)     relay and Tor decides that its ports are not reachable from outside
540)     the user's network, we should alert the user. Currently, all the user
541)     gets is a couple of log messages in Vidalia's 'message log' window, which they
542)     likely never see since they don't receive a notification that something
543)     has gone wrong. Even if the user does actually look at the message log,
544)     most of the messages make little sense to the novice user.</p>
545)     <p>Tor has the ability to inform Vidalia of many such status
546)     changes, and we recently implemented support for a couple of these
547)     events. Still, there are many more status events which the user should
548)     be informed of, and we need a better UI for actually displaying them
549)     to the user.</p>
550)     <p>The goal of this project then is to design and implement a UI for
551)     displaying Tor status events to the user. For example, we might put a
552)     little badge on Vidalia's tray icon that alerts the user to new status
553)     events they should look at. Double-clicking the icon could bring up a
554)     dialog that summarizes recent status events in simple terms and maybe
555)     suggests a remedy for any negative events if they can be corrected by
556)     the user. Of course, this is just an example and one is free to
557)     suggest another approach.</p>
558)     <p>A person undertaking this project should have good UI design and layout
559)     skills and some C++ development experience. Previous experience with Qt and
560)     Qt's Designer will be very helpful, but are not required. Some
561)     English writing ability will also be useful, since this project will
562)     likely involve writing small amounts of help documentation that should
563)     be understandable by non-technical users. Bonus points for some graphic
564)     design/Photoshop fu, since we might want/need some shiny new icons too.</p>
565)     </li>
566)     
567)     <li>
568)     <b>An Improved and More Usable Network Map in Vidalia</b>
569)     <br>
570)     Priority: <i>Low to Medium</i>
571)     <br>
572)     Effort Level: <i>Medium</i>
573)     <br>
574)     Skill Level: <i>Medium</i>
575)     <br>
576)     Likely Mentors: <i>Tomás?</i>
577)     <p>
578)     One of Vidalia's existing features is a network map that shows the user
579)     the approximate geographic location of relays in the Tor network and
580)     plots the paths the user's traffic takes as it is tunneled through the
581)     Tor network. The map is currently not very interactive and has rather
582)     poor graphics. Instead, we implemented KDE's Marble widget such
583)     that it gives us a better quality map and enables improved interactivity,
584)     such as allowing the user to click on individual relays or circuits to
585)     display additional information. We want to add the ability
586)     for users to click on a particular relay or a country containing one or
587)     more Tor exit relays and say, "I want my connections to exit
588)     from here."
589)     </p>
590)     
591)     <p>
592)     This project will first involve getting familiar with Vidalia
593)     and the Marble widget's API. One will then integrate the widget
594)     into Vidalia and customize Marble to be better suited for our application,
595)     such as making circuits clickable, storing cached map data in Vidalia's
596)     own data directory, and customizing some of the widget's dialogs.
597)     </p>
598)     
599)     <p>
600)     A person undertaking this project should have good C++ development
601)     experience. Previous experience with Qt and CMake is helpful, but not
602)     required.
603)     </p>

604)     </li>
605)     

606)     <!--
607)     <li>
608)     <b>Help with independent Tor client implementations</b>
609)     <br>
610)     Priority: <i>Medium</i>
611)     <br>
612)     Effort Level: <i>High</i>
613)     <br>
614)     Skill Level: <i>Medium to High</i>
615)     <br>
616)     Likely Mentors: <i>Bruce, Nathan</i>
617)     <p>Others are currently working on Tor clients for Java, Android, and Maemo
618)     environments.  The first step is to get a handle on the current state of
619)     the project in which you are interested in helping; <a
620)     href="http://github.com/brl/JTor">Tor for Java</a>,
621)     <a href="https://svn.torproject.org/svn/projects/android/trunk/">Android/Orbot</a>,
622)      or <a href="<page docs/N900>">Tor for Maemo</a>. Check out the
623)     repository and familiarize yourself
624)     with the source code.  Further, support for requesting or even providing
625)     Tor hidden services would be neat, but not required.</p>
626)     <p>A prospective developer should be able to understand and write new Java
627)     code, including a Java cryptography API. Being able to read C code would be helpful,
628)     too. One should be willing to read the existing documentation,
629)     implement code based on it, and refine the documentation
630)     when things are underdocumented. This project is mostly about coding and
631)     to a small degree about design.</p>
632)     </li>
633)     -->
634) 

635)     <li>
636)     <b>Bring up new ideas!</b>

637)     <br>

638)     Don't like any of these? Look at the <a
639)     href="<gitblob>doc/roadmaps/2008-12-19-roadmap-full.pdf">Tor development
640)     roadmap</a> for more ideas, or just try out Tor, Vidalia, and Torbutton,
641)     and find out what you think needs fixing.
642)     Some of the <a href="<gittree>doc/spec/proposals">current proposals</a>
643)     might also be short on developers.
644)     </li>
645)     
646)     </ol>
647)     
648)     <a id="OtherCoding"></a>
649)     <h2><a class="anchor" href="#OtherCoding">Other Coding and Design related ideas</a></h2>
650)     <ol>
651)     <li>Tor relays don't work well on Windows XP. On
652)     Windows, Tor uses the standard <tt>select()</tt> system
653)     call, which uses space in the non-page pool. This means
654)     that a medium sized Tor relay will empty the non-page pool, <a
655)     href="https://trac.torproject.org/projects/tor/wiki/TheOnionRouter/WindowsBufferProblems">causing
656)     havoc and system crashes</a>. We should probably be using overlapped IO
657)     instead. One solution would be to teach <a
658)     href="http://www.monkey.org/~provos/libevent/">libevent</a> how to use
659)     overlapped IO rather than select() on Windows, and then adapt Tor to
660)     the new libevent interface. Christian King made a
661)     <a href="https://svn.torproject.org/svn/libevent-urz/trunk/">good
662)     start</a> on this in the summer of 2007.</li>
663)     
664)     <li>We need to actually start building our <a href="<page
665)     docs/documentation>#DesignDoc">blocking-resistance design</a>. This involves
666)     fleshing out the design, modifying many different pieces of Tor, adapting
667)     <a href="<page projects/vidalia>">Vidalia</a> so it supports the
668)     new features, and planning for deployment.</li>
669)     
670)     <li>We need a flexible simulator framework for studying end-to-end
671)     traffic confirmation attacks. Many researchers have whipped up ad hoc
672)     simulators to support their intuition either that the attacks work
673)     really well or that some defense works great. Can we build a simulator
674)     that's clearly documented and open enough that everybody knows it's
675)     giving a reasonable answer? This will spur a lot of new research.
676)     See the entry <a href="#Research">below</a> on confirmation attacks for
677)     details on the research side of this task &mdash; who knows, when it's
678)     done maybe you can help write a paper or three also.</li>
679)     

680)     <li>Tor 0.1.1.x and later include support for hardware crypto
681)     accelerators via OpenSSL. It has been lightly tested and is
682)     possibly very buggy.  We're looking for more rigorous testing,

683)     performance analysis, and optimally, code fixes to OpenSSL and

684)     Tor if needed.</li>

685)     
686)     <li>Perform a security analysis of Tor with <a
687)     href="http://en.wikipedia.org/wiki/Fuzz_testing">"fuzz"</a>. Determine
688)     if there are good fuzzing libraries out there for what we want. Win fame by
689)     getting credit when we put out a new release because of you!</li>
690)     
691)     <li>Tor uses TCP for transport and TLS for link
692)     encryption. This is nice and simple, but it means all cells
693)     on a link are delayed when a single packet gets dropped, and
694)     it means we can only reasonably support TCP streams. We have a <a

695)     href="<page docs/faq>#TransportIPnotTCP">list

696)     of reasons why we haven't shifted to UDP transport</a>, but it would
697)     be great to see that list get shorter. We also have a proposed <a
698)     href="<gitblob>doc/spec/proposals/100-tor-spec-udp.txt">specification
699)     for Tor and
700)     UDP</a> &mdash; please let us know what's wrong with it.</li>
701)     
702)     <li>We're not that far from having IPv6 support for destination addresses
703)     (at exit nodes). If you care strongly about IPv6, that's probably the
704)     first place to start.</li>
705)     
706)     <li>We need a way to generate the website diagrams (for example, the "How
707)     Tor Works" pictures on the <a href="<page about/overview>">overview page</a>
708)     from source, so we can translate them as UTF-8 text rather than edit
709)     them by hand with Gimp. We might want to
710)     integrate this as an wml file so translations are easy and images are
711)     generated in multiple languages whenever we build the website.</li>
712)     
713)     <li>How can we make the various LiveCD/USB systems easier
714)     to maintain, improve, and document?  One example is <a
715)     href="https://amnesia.boum.org/">The (Amnesic) Incognito Live
716)     System</a>.
717)     </li>
718)     
719)     <li>
720)     Another anti-censorship project is to try to make Tor
721)     more scanning-resistant.  Right now, an adversary can identify <a
722)     href="<gitblob>doc/spec/proposals/125-bridges.txt">Tor bridges</a>
723)     just by trying to connect to them, following the Tor protocol,
724)     and seeing if they respond.  To solve this, bridges could <a
725)     href="<svnprojects>design-paper/blocking.html#tth_sEc9.3">act like
726)     webservers</a> (HTTP or HTTPS) when contacted by port-scanning tools,
727)     and not act like bridges until the user provides a bridge-specific key.
728)     To start, check out Shane Pope's <a
729)     href="http://dl.dropbox.com/u/37735/index.html">thesis and prototype</a>.
730)     </li>
731)     
732)     </ol>
733)     
734)     <a id="Research"></a>
735)     <h2><a class="anchor" href="#Research">Research</a></h2>
736)     <ol>
737)     <li>The "end-to-end traffic confirmation attack":
738)     by watching traffic at Alice and at Bob, we can <a
739)     href="http://freehaven.net/anonbib/#danezis:pet2004">compare
740)     traffic signatures and become convinced that we're watching the same
741)     stream</a>. So far Tor accepts this as a fact of life and assumes this
742)     attack is trivial in all cases. First of all, is that actually true? How
743)     much traffic of what sort of distribution is needed before the adversary
744)     is confident he has won? Are there scenarios (e.g. not transmitting much)
745)     that slow down the attack? Do some traffic padding or traffic shaping
746)     schemes work better than others?</li>
747)     <li>A related question is: Does running a relay/bridge provide additional
748)     protection against these timing attacks? Can an external adversary that can't
749)     see inside TLS links still recognize individual streams reliably?
750)     Does the amount of traffic carried degrade this ability any? What if the
751)     client-relay deliberately delayed upstream relayed traffic to create a queue
752)     that could be used to mimic timings of client downstream traffic to make it
753)     look like it was also relayed? This same queue could also be used for masking
754)     timings in client upstream traffic with the techniques from <a
755)     href="http://www.freehaven.net/anonbib/#ShWa-Timing06">adaptive padding</a>,
756)     but without the need for additional traffic. Would such an interleaving of
757)     client upstream traffic obscure timings for external adversaries? Would the
758)     strategies need to be adjusted for asymmetric links? For example, on
759)     asymmetric links, is it actually possible to differentiate client traffic from
760)     natural bursts due to their asymmetric capacity? Or is it easier than
761)     symmetric links for some other reason?</li>
762)     <li>Repeat Murdoch and Danezis's <a
763)     href="http://www.cl.cam.ac.uk/~sjm217/projects/anon/#torta">attack from
764)     Oakland 05</a> on the current Tor network. See if you can learn why it
765)     works well on some nodes and not well on others. (My theory is that the
766)     fast nodes with spare capacity resist the attack better.) If that's true,
767)     then experiment with the RelayBandwidthRate and RelayBandwidthBurst
768)     options to run a relay that is used as a client while relaying the
769)     attacker's traffic: as we crank down the RelayBandwidthRate, does the
770)     attack get harder? What's the right ratio of RelayBandwidthRate to
771)     actually capacity? Or is it a ratio at all? While we're at it, does a
772)     much larger set of candidate relays increase the false positive rate
773)     or other complexity for the attack? (The Tor network is now almost two
774)     orders of magnitude larger than it was when they wrote their paper.) Be
775)     sure to read <a href="http://freehaven.net/anonbib/#clog-the-queue">Don't
776)     Clog the Queue</a> too.</li>
777)     <li>The "routing zones attack": most of the literature thinks of
778)     the network path between Alice and her entry node (and between the
779)     exit node and Bob) as a single link on some graph. In practice,
780)     though, the path traverses many autonomous systems (ASes), and <a
781)     href="http://freehaven.net/anonbib/#feamster:wpes2004">it's not uncommon
782)     that the same AS appears on both the entry path and the exit path</a>.
783)     Unfortunately, to accurately predict whether a given Alice, entry,
784)     exit, Bob quad will be dangerous, we need to download an entire Internet
785)     routing zone and perform expensive operations on it. Are there practical
786)     approximations, such as avoiding IP addresses in the same /8 network?</li>
787)     <li>Other research questions regarding geographic diversity consider
788)     the tradeoff between choosing an efficient circuit and choosing a random
789)     circuit. Look at Stephen Rollyson's <a
790)     href="http://swiki.cc.gatech.edu:8080/ugResearch/uploads/7/ImprovingTor.pdf">position
791)     paper</a> on how to discard particularly slow choices without hurting
792)     anonymity "too much". This line of reasoning needs more work and more
793)     thinking, but it looks very promising.</li>
794)     <li>Tor doesn't work very well when relays have asymmetric bandwidth
795)     (e.g. cable or DSL). Because Tor has separate TCP connections between
796)     each hop, if the incoming bytes are arriving just fine and the outgoing
797)     bytes are all getting dropped on the floor, the TCP push-back mechanisms
798)     don't really transmit this information back to the incoming streams.
799)     Perhaps Tor should detect when it's dropping a lot of outgoing packets,
800)     and rate-limit incoming streams to regulate this itself? I can imagine
801)     a build-up and drop-off scheme where we pick a conservative rate-limit,
802)     slowly increase it until we get lost packets, back off, repeat. We
803)     need somebody who's good with networks to simulate this and help design
804)     solutions; and/or we need to understand the extent of the performance
805)     degradation, and use this as motivation to reconsider UDP transport.</li>
806)     <li>A related topic is congestion control. Is our
807)     current design sufficient once we have heavy use? Maybe
808)     we should experiment with variable-sized windows rather
809)     than fixed-size windows? That seemed to go well in an <a
810)     href="http://www.psc.edu/networking/projects/hpn-ssh/theory.php">ssh
811)     throughput experiment</a>. We'll need to measure and tweak, and maybe
812)     overhaul if the results are good.</li>
813)     <li>Our censorship-resistance goals include preventing
814)     an attacker who's looking at Tor traffic on the wire from <a
815)     href="<svnprojects>design-paper/blocking.html#sec:network-fingerprint">distinguishing
816)     it from normal SSL traffic</a>. Obviously we can't achieve perfect
817)     steganography and still remain usable, but for a first step we'd like to
818)     block any attacks that can win by observing only a few packets. One of
819)     the remaining attacks we haven't examined much is that Tor cells are 512
820)     bytes, so the traffic on the wire may well be a multiple of 512 bytes.
821)     How much does the batching and overhead in TLS records blur this on the
822)     wire? Do different buffer flushing strategies in Tor affect this? Could
823)     a bit of padding help a lot, or is this an attack we must accept?</li>
824)     <li>Tor circuits are built one hop at a time, so in theory we have the
825)     ability to make some streams exit from the second hop, some from the
826)     third, and so on. This seems nice because it breaks up the set of exiting
827)     streams that a given relay can see. But if we want each stream to be safe,
828)     the "shortest" path should be at least 3 hops long by our current logic, so
829)     the rest will be even longer. We need to examine this performance / security
830)     tradeoff.</li>
831)     <li>It's not that hard to DoS Tor relays or directory authorities. Are client
832)     puzzles the right answer? What other practical approaches are there? Bonus
833)     if they're backward-compatible with the current Tor protocol.</li>
834)     <li>Programs like <a

835)     href="<page torbutton/index>">Torbutton</a> aim to hide