diff options
author | Jacob Appelbaum <jacob@appelbaum.net> | 2010-04-16 17:45:12 -0700 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2010-09-30 11:37:53 -0400 |
commit | 0f1b95d37c338190b4d81dd24587b923c89f299c (patch) | |
tree | 03e3e61959de3dcc0d0ca7005bd9f28f613bf94c /tor-fw-helper-spec.txt | |
parent | e58584ebdca7beb3758abebb49c33838b6627213 (diff) | |
download | torspec-0f1b95d37c338190b4d81dd24587b923c89f299c.tar.gz torspec-0f1b95d37c338190b4d81dd24587b923c89f299c.zip |
First implementation of tor-fw-helper.
tor-fw-helper is a command-line tool to wrap and abstract various
firewall port-forwarding tools.
This commit matches the state of Jacob's tor-fw-helper branch as of
23 September 2010.
(commit msg by Nick)
Diffstat (limited to 'tor-fw-helper-spec.txt')
-rw-r--r-- | tor-fw-helper-spec.txt | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/tor-fw-helper-spec.txt b/tor-fw-helper-spec.txt new file mode 100644 index 0000000..684f50f --- /dev/null +++ b/tor-fw-helper-spec.txt @@ -0,0 +1,44 @@ + + Tor's (little) Firewall Helper specification + Jacob Appelbaum + +0. Preface + + This document describes issues faced by Tor users who are behind NAT devices + and wish to share their resources with the rest of the Tor network. It also + explains a possible solution for some NAT devices. + +1. Overview + + Tor users often wish to relay traffic for the Tor network and their upstream + firewall thwarts their attempted generosity. Automatic port forwarding + configuration for many consumer NAT devices is often available with two common + protocols NAT-PMP[0] and UPnP[1]. + +2. Implementation + + tor-fw-helper is a program that implements basic port forwarding requests; it + may be used alone or called from Tor itself. + +2.1 Output format + + When tor-fw-helper has completed the requested action successfully, it will + report the following message to standard output: + + tor-fw-helper: SUCCESS + + If tor-fw-helper was unable to complete the requested action successfully, it + will report the following message to standard error: + + tor-fw-helper: FAILURE + + All informational messages are printed to standard output; all error messages + are printed to standard error. + +3. Security Concerns + + It is probably best to hand configure port forwarding and in the process, we + suggest disabling NAT-PMP and/or UPnP. + +[0] http://en.wikipedia.org/wiki/NAT_Port_Mapping_Protocol +[1] http://en.wikipedia.org/wiki/Universal_Plug_and_Play |