aboutsummaryrefslogtreecommitdiff
path: root/spec/rend-spec-v3/hidden-services-overview-preliminaries.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/rend-spec-v3/hidden-services-overview-preliminaries.md')
-rw-r--r--spec/rend-spec-v3/hidden-services-overview-preliminaries.md16
1 files changed, 11 insertions, 5 deletions
diff --git a/spec/rend-spec-v3/hidden-services-overview-preliminaries.md b/spec/rend-spec-v3/hidden-services-overview-preliminaries.md
index a71790c..382c732 100644
--- a/spec/rend-spec-v3/hidden-services-overview-preliminaries.md
+++ b/spec/rend-spec-v3/hidden-services-overview-preliminaries.md
@@ -1,5 +1,6 @@
<a id="rend-spec-v3.txt-0"></a>
-# Hidden services: overview and preliminaries.
+
+# Hidden services: overview and preliminaries
Hidden services aim to provide responder anonymity for bidirectional
stream-based communication on the Tor network. Unlike regular Tor
@@ -32,7 +33,8 @@ Operator -- A person running a hidden service
```
<a id="rend-spec-v3.txt-0.1"></a>
-## Improvements over previous versions.
+
+## Improvements over previous versions
Here is a list of improvements of this proposal over the legacy hidden
services:
@@ -46,6 +48,7 @@ f) Offline keys for onion services
g) Advanced client authorization
<a id="rend-spec-v3.txt-0.2"></a>
+
## Notation and vocabulary
Unless specified otherwise, all multi-octet integers are big-endian.
@@ -72,6 +75,7 @@ unsigned integer "val" in N bytes. For example, INT_4(1337) is [00 00
INT_4(42) is 42 % 4294967296 (32 bit).
<a id="rend-spec-v3.txt-0.3"></a>
+
## Cryptographic building blocks
This specification uses the following cryptographic building blocks:
@@ -129,8 +133,8 @@ This specification uses the following cryptographic building blocks:
where k_len is htonll(len(k)).
```
- When we need a particular MAC key length below, we choose
- MAC_KEY_LEN=32 (256 bits).
+ When we need a particular MAC key length below, we choose
+ MAC_KEY_LEN=32 (256 bits).
For legacy purposes, we specify compatibility with older versions of
the Tor introduction point and rendezvous point protocols. These used
@@ -142,6 +146,7 @@ themselves, but over those strings prefixed with a distinguishing
value.
<a id="rend-spec-v3.txt-0.4"></a>
+
## Protocol building blocks [BUILDING-BLOCKS]
In sections below, we need to transmit the locations and identities
@@ -177,6 +182,7 @@ material unless they control the secret key corresponding to the
server's public key.
<a id="rend-spec-v3.txt-0.5"></a>
+
## Assigned relay cell types
These relay cell types are reserved for use in the hidden service
@@ -237,6 +243,7 @@ protocol.
```
<a id="rend-spec-v3.txt-0.6"></a>
+
## Acknowledgments
This design includes ideas from many people, including
@@ -306,4 +313,3 @@ editing help from
Please forgive me if I've missed you; please forgive me if I've
misunderstood your best ideas here too.
-