diff options
author | Nick Mathewson <nickm@torproject.org> | 2014-04-14 16:36:50 -0400 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2014-04-14 16:37:29 -0400 |
commit | e8c89a12416026945aa65d67bcc011d9c1b6a3b2 (patch) | |
tree | bae8cdaf83b0fa9a26e00d5ba665482dbec89ab5 /proposals/ideas | |
parent | df51057a3f437ca69df026c0da66a3e280bb44e8 (diff) | |
download | torspec-e8c89a12416026945aa65d67bcc011d9c1b6a3b2.tar.gz torspec-e8c89a12416026945aa65d67bcc011d9c1b6a3b2.zip |
Make pluggable-transports-through-proxy.txt into proposal 232
Diffstat (limited to 'proposals/ideas')
-rw-r--r-- | proposals/ideas/xxx-pluggable-transports-through-proxy.txt | 78 |
1 files changed, 0 insertions, 78 deletions
diff --git a/proposals/ideas/xxx-pluggable-transports-through-proxy.txt b/proposals/ideas/xxx-pluggable-transports-through-proxy.txt deleted file mode 100644 index 3fc7754..0000000 --- a/proposals/ideas/xxx-pluggable-transports-through-proxy.txt +++ /dev/null @@ -1,78 +0,0 @@ -Filename: xxx-pluggable-transports-through-proxy.txt -Title: Pluggable Transport through SOCKS proxy -Author: Arturo Filastò -Created: 28 February 2012 -Status: Draft - -Overview - - Tor introduced Pluggable Transports in proposal "180 Pluggable - Transports for circumvention". - - The problem is that Tor currently cannot use a pluggable transport - proxy and a normal (SOCKS/HTTP) proxy at the same time. This has - been noticed by users in #5195, where Tor would be failing saying - "Unacceptable option value: You have configured more than one proxy - type". - -Trivia - - This comes from a discussion that came up with Nick and I promised - to write a proposal for it if I wanted to hear what he had to say. - Nick spoke and I am writing this proposal. - -Acknowledgments - - Most of the credit goes to Nick Mathewson for the main idea and - the rest of it goes to George Kadianakis for helping me out in writing - it. - -Motivation - - After looking at some options we decided to go for this solution - since it guarantees backwards compatibility and is not particularly - costly to implement. - -Design overview - - When Tor is configured to use both a pluggable transport proxy and a - normal proxy it should delegate the proxying to the pluggable - transport proxy. - - This can be achieved by specifying the address and port of the normal - proxy to the pluggable transport proxy using environment variables: - When both a normal proxy and the ClientTransportPlugin directives - are set in the torrc, Tor should put the address of the normal proxy - in an environment variable and start the pluggable transport - proxy. When the pluggable transport proxy starts, it should read the - address of the normal proxy and route all its traffic through it. - - After connecting to the normal proxy, the pluggable transport proxy - notifies Tor whether it managed to connect or not. - - The environment variables also contain the authentication - credentials for accessing the proxy. - -Specifications: Tor Pluggable Transport communication - - When Tor detects a normal proxy directive and a pluggable transport - proxy directive, it sets the environment variable: - - "TOR_PT_PROXY" -- This is the address of the proxy to be used by - the pluggable transport proxy. It is in the format: - <proxy_type>://[<user_name>][:<password>][@]<ip>:<port> - ex. socks5://tor:test1234@198.51.100.1:8000 - socks4a://198.51.100.2:8001 - - Acceptable values for <proxy_type> are: 'socks5', 'socks4a' and 'http'. - If no <password> can be specified (e.g. in 'socks4a'), it is left out. - - If the pluggable transport proxy detects that the TOR_PT_PROXY - environment variable is set, it attempts connecting to it. On - success it writes to stdout: "PROXY true". - On failure it writes: "PROXY-ERROR <errormessage>". - - If Tor does not read a PROXY line or it reads a PROXY-ERROR line - from its stdout and it is configured to use both a normal proxy and - a pluggable transport it should kill the transport proxy. - |