Google Summer of Tor 2010 - JTor Hidden Services

Wednesday, May 19, 2010, 06:25 PM ( 15 views )  - Posted by Administrator
My friend whipped up this spoof on the painting "The Son of Man" by Magritte, that is an onion in front of his face.

Thursday, May 13, 2010, 03:26 PM ( 10 views )  - Posted by Administrator


Kory Kirk

Google Summer of Tor: JTor's Hidden Services

              What project would you like to work on? Use our ideas lists as a starting point or make up your own idea. Your proposal should include high-level descriptions of what you're going to do, with more details about the parts you expect to be tricky. Your proposal should also try to break down the project into tasks of a fairly fine granularity, and convince us you have a plan for finishing it.


   I would like to work on JTor! Last semester I attended a class called Distributed Systems. For part of this class we had to take on a semester-long project where we implemented (part of) a distributed system. Most of the other students in the class took projects where not implementation was needed. I chose to take a go at Hidden Services.  Having recently dined with Roger and Jake, I decided to take on a part of JTor as my class project. JTor was just starting out, and because of its infantile nature I was suggested a task that was easily compartmentalized - Hidden Services. 

   I tried to write Hidden Services with the same style as the rest of JTor. I scoured the rend-spec and made my own notes. By the end of the semester came, the project was not near usable completion. I had gotten a lot of the basic components of the Hidden Services done, like the V2 descriptor, but did not get a chance to pull it all together into a working part of the library. And some parts were left largely untouched like connecting to a hidden service.  A log of the work (and some assignments) done can be found at

     For GSoC, I will complete JTor Hidden services. I believe one of the most important parts will be ensuring that accessing and publishing a HiddenService through JTor should look identical to Tor on the wire.  Being that I will be building this project up from scratch, and referring to the implementation of Tor Hidden Services, I would also like to update rend-spec to reflect any inconsistencies between the spec and actual implementation (due to possible undocumented revisions, partially implemented proposals, older protocol compatability, etc.). I foresee the rewrite as a gradual process that would span the length of GSoC. 

Below I have outlined what I believe to be the major components of the project:

JTor Hidden Services

main focus points: Hidden Service publication and Hidden Service access.


  •    Hidden Service Publication
    • V2 Service Descriptor
      •  Currently implemented V2 service descriptor as described in rend-spec.
      •  Need to verify correct encoding of descriptor-id and descriptor content.
    • Advertising Service Descriptor
      •  Choosing non-adjacent directory servers to be responsible (114)
      • Publishing  to 4 non-consecutive directory nodes, and 2 consecutive (for 0.2.0.x support)
    • Bad directory reporting
      • check if responsible directory server 404ing to the service descriptor request.
        • http post complaint if 404 
    • Establishing introduction points
      • post request to the directory server
      • Organizing new key pairs for each introduction point.
    • Accepting hidden service connections from clients. 
  • Hidden Service Access
    • Fetching V2 Service descriptors
      • parsing and  caching V2
      • verifying descriptor-id from v2
      • periodic fetch
    • Establishing Rendevous points
      • circuit
    • Optional client authentication with auth-data or descriptor cookie
    • Connecting to hidden service servers.
  • Cells
    • Lots of cells need to be created (which shouldn't be too hard becauese of CellImpl)
  • Configuration file
    • Retain settings and data for a specific Hidden Service.
    • Allow for granular control  of HiddenService, its supported protocols and authentication mechanisms.
    • use JTor to interface w/ config or edit by hand
  • Authorization mechanisms
    • Client authorization at directory
    • Client presence of descriptor cookie (partially implemented) upload Multiple descriptors with different descriptor cookies delayed (< 30 sec)
    •  Client authorization at introduction point
    • create abstract class for Authentication Mechanisms to be implemented in the future
    • Currently do not plan on implementing any directory or intro point authentication mechanisms, but will allow for use of them.  



    Week 1-4: Finish V2 Descriptor, Implement HiddenService publishing to directory services, checking for bad directories, relevant cells and the hidden service configuration file. Finish publish portion of  Hidden Services.  Ensure that rend-spec correctly reflects everything needed to implement publishing.

    Week 5-9: Descriptor fetching and verification, establishing and creating circuits to rend points, connecting to a hidden services,  implement relevant cells, support for authorization mechanisms, update any part of rend-spec that is inaccurate for accessing hidden services.

    Week  10-12: Documentation and rigorous testing, prepare for release of JTor - help with any addition documentation, tests or changes that need to be made before release.

2.              Point us to a code sample: something good and clean to demonstrate that you know what you're doing, ideally from an existing project.  - my contribution is the hiddenservices package (and I think one method somewhere in crypto). - Genetic Algorithm Comparator – this is a project I am still working on for my graduate thesis – I wrote it using the dANN framework to gather comparative data about the Genetic Wavelet Algorithm and Simple Genetic Algorithm. - This is the code for my team’s submission to this year’s MIT Battlecode programming competition. - this is a page with a bunch of older projects from when I was an undergrad.


3.              Why do you want to work with The Tor Project / EFF in particular?

Being involved with the Tor project last summer has really sparked an involvement in the open source community for me. I like the underlying idea behind Tor and especially the idea that it helps people with oppressive governments access the internet (because I want people to visit my website (just kidding, because I love the internet)). I recently became a member of the EFF in December. 

    I first heard about the EFF in my Ethics in Computing class (Which I am now a teaching assistant for), and was immediately drawn to the EFF after reading ‘Coming into the Country’ by John Perry Barlow.  The metaphor of the cyberspace frontier really resonated with me as to why the internet is so special, how it is a new frontier that needs to be kept free and protected. I think the EFF and Tor are doing a good job of that, and so I want to contribute in any way I can.

4.              Tell us about your experiences in free software development environments. We especially want to hear examples of how you have collaborated with others rather than just working on a project by yourself.

Last summer, working on Torbutton was my first contribution to any open source project. Since then I have a part of a few open source projects including JTor, dANN (Java AI framework) and imgur Firefox extension. All of the collaboration I have done has been over IRC.  I spent a big chunk of this semester working on an Java AI programming competition hosted by MIT called Battlecode. This was a collaboration between a few students, writing our team on and using git for version control. I also participated in the ACM ICPC (international collegiate programming contest), where a team of 3 has 5 hours to do 8 programming problems. My team used Java and placed 2nd in the local competition (greater Philadelphia area) and 9th in the Regional competition (Mid-atlantic region). I have a lot of experience working closely with others on code.


5.              Will you be working full-time on the project for the summer, or will you have other commitments too (a second job, classes, etc)? If you won't be available full-time, please explain, and list timing if you know them for other major deadlines (e.g. exams). Having other activities isn't a deal-breaker, but we don't want to be surprised.

This summer I have no obligations. I am finishing up my Masters next month, and moving back to Texas where I plan to spend the summer looking for a job (for after the summer), working on GSoC and maybe doing some freelance stuff.


6.              Will your project need more work and/or maintenance after the summer ends? What are the chances you will stick around and help out with that and other related projects?

I think that my project will need maintenance, and I would like to be a part of JTor and work on it in the future, not just this summer. Java is my best language, and I think it would be the area of Tor I can contribute to the most. Now that I am done with school, I will have a lot more time to dedicate myself to personal projects instead of academic projects, and I consider JTor a personal project .


7.              What is your ideal approach to keeping everybody informed of your progress, problems, and questions over the course of the project? Said another way, how much of a "manager" will you need your mentor to be?

              I do not think my mentor needs to be much of a manager, I am usually self-motivated. I would like to use my mentor as a backboard for ideas or a feedback machine rather than as a boss-figure. Last year I kept a blog of my progress, and I will do that again and document and describe my progress, changes to the code, and obstacles. My git commit messages are a good way to find information about progress on smaller steps of the project. 

8.              What school are you attending? What year are you, and what's your major/degree/focus? If you're part of a research group, which one?


I am attending Villanova University outside of Philadelphia. I am in a Computer Science Masters program that will be finished in May. I am a graduate assistant so I owe the Computer Science Department 20 hours a week. My assignment from the past two semesters includes: teaching assistant for three Algorithm and Data structure classes (Java programming) and Ethics in Computing, the Research Assistant for Machine Learning and Data Mining class, and worked at the computer science help desk. The help desk is a one man tutoring center where any computer science student can come ask help on projects mostly in Java or C.

The research I have been doing has been my own. Last semester I did an independent study which I have continued to research as my Master’s thesis. The project is surrounding a new type of genetic algorithm called the Genetic Wavelet Algorithm (GWA). I have been doing research to formally describe it and compare it to the classical genetic algorithm. The GWA is implemented in a open source AI library called dANN,, parts of my thesis can be found in the Genetic Wavelet section. I have also written code to contribute to the implementation of the Genetic Wavelet Algorithm.

9.              How can we contact you to ask you further questions? Google doesn't share your contact details with us automatically, so you should include that in your application. In addition, what's your IRC nickname? Interacting with us on IRC will help us get to know you, and help you get to know our community.

              I am almost always on freenode (in various channels), usually on oftc in #tor and #tor-dev. I usually operate under the nick koryk or koryk1 (sometimes toryk). You can also e-mail me at


10.              Is there anything else we should know that will make us like your project more?

     I believe I can complete this project resulting in a robust and flexible package for the JTor library. Other than that, there is nothing I can think of that will make you like my project more, so here are a few random facts about me:

- My great uncle invented the footlong hotdog (I know... how could someone invent a long hotdog? I was just always told this by my family growing up)

- I can bend my finger back to touch my hand.

- I have a genetic mutation that causes me to have freakishly low cholesterol (I am one of the X-Men)

- I always try to program a task in as few lines of code as possible

  In addition here is a short brainstorm of possible other names for the project beside JTor:

- Onion Jar, layered ogre,  coffee leek (like leek a type of onion), jleek, jbulb, onion bulb, Allium

    those are all onion or java related, if you want more suggestions let me know.   



<Back | 1 | 2 |