commit 632de4498defe1002a9c6ee2fe8aac4a58866608 Author: Damian Johnson <atagar@torproject.org> Date: Sat Mar 22 12:25:55 2014 -0700 Using sub-headers for connection/authentication methods Using headers rather than an unordered list for the sections so we can link directly to them. --- docs/faq.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 72c7db1..4e79251 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -96,7 +96,8 @@ Yup. You don't need a library to interact with Tor's `controller interface <http We'll tackle each of these scenarios one at a time... -* **I'm using a ControlPort** +**I'm using a ControlPort** +~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are using a **ControlPort** then the easiest method of talking with Tor is via **telnet**. You always need to authenticate after connecting, even if Tor does not restrict access. If your torrc doesn't have a **CookieAuthentication** or **HashedControlPassword** then to authenticate you will simply call **AUTHENTICATE** after connecting without any credentials. @@ -118,7 +119,8 @@ If you are using a **ControlPort** then the easiest method of talking with Tor i 250 closing connection Connection closed by foreign host. -* **I'm using a ControlSocket** +**I'm using a ControlSocket** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A **ControlSocket** is a file based socket, so we'll use **socat** to connect to it... @@ -136,7 +138,8 @@ A **ControlSocket** is a file based socket, so we'll use **socat** to connect to QUIT 250 closing connection -* **I'm using cookie authentication** +**I'm using cookie authentication** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cookie authentication simply means that your credential is the content of a file in Tor's **DataDirectory**. You can learn information about Tor's method of authentication (including the cookie file's location) by calling **PROTOCOLINFO**... @@ -178,7 +181,8 @@ To get the credential for your AUTHENTICATE command we will use **hexdump**... 250 closing connection Connection closed by foreign host. -* **I'm using password authentication** +**I'm using password authentication** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Tor's other method of authentication is a credential you know. To use it you ask Tor to hash your password, then use that in your torrc...