[tor-commits] [torspec/master] prop224: Add a section on the number of introduction points

dgoulet at torproject.org dgoulet at torproject.org
Mon Oct 17 16:06:06 UTC 2016


commit 6d968a1507ae074ab17f914522f25b68138efd42
Author: David Goulet <dgoulet at torproject.org>
Date:   Mon Oct 17 12:05:09 2016 -0400

    prop224: Add a section on the number of introduction points
    
    Acked-by: George Kadianakis <desnacked at riseup.net>
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 proposals/224-rend-spec-ng.txt | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/proposals/224-rend-spec-ng.txt b/proposals/224-rend-spec-ng.txt
index 558cf1f..1fe738d 100644
--- a/proposals/224-rend-spec-ng.txt
+++ b/proposals/224-rend-spec-ng.txt
@@ -37,6 +37,7 @@ Table of contents:
             2.3.2. Hidden services and changing shared random values
         2.4. Hidden service descriptors: outer wrapper [DESC-OUTER]
         2.5. Hidden service descriptors: encryption format [ENCRYPTED-DATA]
+            2.5.1. Number of introduction points [NUM_INTRO_POINT]
     3. The introduction protocol
         3.1. Registering an introduction point [REG_INTRO_POINT]
             3.1.1. Extensible ESTABLISH_INTRO protocol. [EST_INTRO]
@@ -999,7 +1000,8 @@ Table of contents:
       able to contact the host. Recognized types are: 'password' and
       'ed25519'. See [INTRO-AUTH] below.
 
-     Followed by zero or more introduction points as follows:
+     Followed by zero or more introduction points as follows (see section
+     [NUM_INTRO_POINT] below for accepted values):
 
         "introduction-point" SP link-specifiers NL
 
@@ -1058,6 +1060,21 @@ Table of contents:
    Other encryption and authentication key formats are allowed; clients
    should ignore ones they do not recognize.
 
+2.5.1. Number of introduction points [NUM_INTRO_POINT]
+
+   This section defines how many introduction points an hidden service
+   descriptor can have at minimum, by default and the maximum:
+
+      Minimum: 0 - Default: 3 - Maximum: 20
+
+   A value of 0 would means that the service is still alive but doesn't want
+   to be reached by any client at the moment. Note that the descriptor size
+   increases considerably as more introduction points are added.
+
+   The reason for a maximum value of 20 is to give enough scalability to tools
+   like OnionBalance to be able to load balance up to 120 servers (20 x 6
+   HSDirs) but also in order for the descriptor size to not overwhelmed hidden
+   service directories with user defined values that could be gigantic.
 
 3. The introduction protocol
 



More information about the tor-commits mailing list