kytv/I2P_Website
1
0
Fork 0
forked from I2P_Developers/i2p.www
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Destination and RouterIdentity updates for Key Certs

Browse Source
This commit is contained in:
zzz
2014-02-21 17:45:13 +00:00
parent af9ea07829
commit cb3ff9bd2c
1 changed files with 32 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
i2p2www/pages/site/docs/spec/common-structures.html
View File

@@ -500,7 +500,11 @@ Defines the way to uniquely identify a particular router
+ + + +
| | | |
~ ~ ~ ~
~ ~
| |
+----+----+----+----+----+----+----+----+
| padding (optional) |
~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -508,7 +512,6 @@ Defines the way to uniquely identify a particular router
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -516,10 +519,15 @@ Defines the way to uniquely identify a particular router
+----+----+----+-// +----+----+----+-//
public_key :: `PublicKey` public_key :: `PublicKey`
length -> 256 bytes length -> 256 bytes or as specified in key certificate
signing_key :: `SigningPublicKey` padding :: random data
length -> 128 bytes length -> 0 bytes or as specified in key certificate
padding length + signing_key length == 128 bytes
signing__key :: `SigningPublicKey` (partial or full)
length -> 128 bytes or as specified in key certificate
padding length + signing_key length == 128 bytes
certificate :: `Certificate` certificate :: `Certificate`
length -> >= 3 bytes length -> >= 3 bytes
@@ -555,7 +563,11 @@ A Destination defines a particular endpoint to which messages can be directed fo
+ + + +
| | | |
~ ~ ~ ~
~ ~
| |
+----+----+----+----+----+----+----+----+
| padding (optional) |
~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -563,18 +575,22 @@ A Destination defines a particular endpoint to which messages can be directed fo
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
| certificate | certificate
+-// +----+----+----+-//
public_key :: `PublicKey` public_key :: `PublicKey` (partial or full)
length -> 256 bytes length -> 256 bytes or as specified in key certificate
signing_public_key :: `SigningPublicKey` padding :: random data
length -> 128 bytes length -> 0 bytes or as specified in key certificate
padding length + signing_public_key_length == 128 bytes
signing_public_key :: `SigningPublicKey` (partial or full)
length -> 128 bytes or as specified in key certificate
padding length + signing_public_key_length == 128 bytes
certificate :: `Certificate` certificate :: `Certificate`
length -> >= 3 bytes length -> >= 3 bytes
@@ -662,7 +678,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -670,7 +685,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -678,7 +692,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -686,7 +699,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+----+ + +----+ +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -694,10 +706,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+ + + +
| | | |
~ ~ ~ ~
~ ~
~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -705,7 +713,6 @@ bytes signed by the <a href="#struct_Destination">Destination's</a> <a href="#ty
+ + + +
| | | |
~ ~ ~ ~
~ ~ ~ ~
| | | |
+----+----+----+----+----+----+----+----+ +----+----+----+----+----+----+----+----+
@@ -727,17 +734,18 @@ encryption_key :: `PublicKey`
length -> 256 bytes length -> 256 bytes
signing_key :: `SigningPublicKey` signing_key :: `SigningPublicKey`
length -> 128 bytes length -> 128 bytes or as specified in destination's key certificate
num :: `Integer` num :: `Integer`
length -> 1 byte length -> 1 byte
Number of leases to follow
value: 0 <= num <= 16 value: 0 <= num <= 16
leases :: [`Lease`] leases :: [`Lease`]
length -> $num*44 bytes length -> $num*44 bytes
signature :: `Signature` signature :: `Signature`
length -> 40 bytes length -> 40 bytes or as specified in destination's key certificate
{% endhighlight %} {% endhighlight %}
@@ -760,6 +768,7 @@ The signature may be verified using the signing public key of the destination.
<li>{% trans -%} <li>{% trans -%}
The signing_key is currently unused. It was intended for LeaseSet revocation, which is unimplemented. The signing_key is currently unused. It was intended for LeaseSet revocation, which is unimplemented.
It is currently generated anew at every router startup, it is not persistent. It is currently generated anew at every router startup, it is not persistent.
The signing key type is always the same as the destination's signing key type.
{%- endtrans %}</li> {%- endtrans %}</li>
<li>{% trans -%} <li>{% trans -%}
The earliest expiration of all the Leases is treated as the timestamp or version of the LeaseSet. The earliest expiration of all the Leases is treated as the timestamp or version of the LeaseSet.