annotate mod_onions.wiki @ 361:e935bb1e8299

Created wiki page through web user interface.
author thijsalkemade@gmail.com
date Mon, 10 Jun 2013 19:17:07 +0000
parents
children c133cef513f9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
361
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
1 #summary s2s to Tor hidden services
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
2 #labels Stage-Alpha
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
3
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
4 = Introduction =
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
5
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
6 This plugin allows Prosody to connect to other servers that are running as a Tor hidden service. Running Prosody on a hidden service works without this module, this module is only necessary to allow Prosody to federate to hidden XMPP servers.
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
7
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
8 For general info about creating a hidden service, see https://www.torproject.org/docs/tor-hidden-service.html.en.
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
9
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
10 = Usage =
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
11 This module depends on the bit32 Lua library.
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
12
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
13 To create a hidden service that can federate with other hidden XMPP servers, first add a hidden serivce to Tor. It should listen on port 5269 and optionally also on 5222 (if c2s connections to the hidden service should be allowed).
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
14
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
15 Use the hostname that Tor gives with a virtualhost:
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
16
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
17 {{{
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
18 VirtualHost "555abcdefhijklmn.onion"
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
19 modules_enabled = { "onions" };
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
20 }}}
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
21
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
22 = Configuration =
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
23 || *Name* || *Description* || *Type* || *Default value* ||
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
24 || onions_socks5_host || the host to connect to for Tor's SOCKS5 proxy || string || "127.0.0.1" ||
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
25 || onions_socks5_port || the port to connect to for Tor's SOCKS5 proxy || string || "9050" ||
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
26 || onions_only || forbid all connection attempts to non-onion servers || boolean || false ||
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
27
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
28
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
29
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
30 = Compatibility =
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
31 ||0.8||Doesn't work||
e935bb1e8299 Created wiki page through web user interface.
thijsalkemade@gmail.com
parents:
diff changeset
32 ||0.9||Works||