git.iko.soy/urbit.org
on master help sign in
Merge branch 'ames-encryption' of github.com:urbit/docs into ames-encryption
a06799ddrbeefsupreme
arvo/ames/cryptography.md+2−3
compare with master
unifiedsplit
@@ -42,7 +42,7 @@ message fragment is signed using the authentication key. It is encrypted using
42
42
43## Diffie-Hellman key exchange {#key-exchange}
43## Diffie-Hellman key exchange {#key-exchange}
44
44
45−For each foreign ship a given ship has met, `$ames-state` contains a
45+For each foreign ship a given ship has communicated with, `$ames-state` contains a
46`$peer-state`, inside which the `$symmetric-key` (an atom which nests under
46`$peer-state`, inside which the `$symmetric-key` (an atom which nests under
47`@uw`) is utilized for encrypting all Ames packets shared between the two ships.
47`@uw`) is utilized for encrypting all Ames packets shared between the two ships.
48The `symmetric-key` is derived using [`+shar:ed:crypto`](@/docs/arvo/reference/cryptography.md#shar) found in `sys/zuse.hoon`,
48The `symmetric-key` is derived using [`+shar:ed:crypto`](@/docs/arvo/reference/cryptography.md#shar) found in `sys/zuse.hoon`,
@@ -122,7 +122,7 @@ This core is used for the standard asymmetric cryptographic operations: encrypti
122
122
123#### `+ex:acru`
123#### `+ex:acru`
124
124
125−This core stores keys and their fingerprints. `+sec` is the secret key (which
125+This core is used to extract keys and their fingerprints. `+sec` is the secret key (which
126may be empty), `+pub` is the public key associated to the secret key, `+pac` is
126may be empty), `+pub` is the public key associated to the secret key, `+pac` is
127the fingerprint associated to the secret key, and `+fig` is the fingerprint
127the fingerprint associated to the secret key, and `+fig` is the fingerprint
128associated to the public key. We note that when the core contains both
128associated to the public key. We note that when the core contains both
@@ -143,4 +143,3 @@ only the public key.
143These arms are for symmetric encryption (`+en`) and decryption (`+de` and
143These arms are for symmetric encryption (`+en`) and decryption (`+de` and
144`+dy`). The difference between the decryption arms is that `+de` returns null
144`+dy`). The difference between the decryption arms is that `+de` returns null
145and `+dy` crashes upon failure.
145and `+dy` crashes upon failure.
146−
arvo/reference/cryptography.md+1−3
@@ -18,8 +18,7 @@ library reference.
18
18
19`zuse` contains several cryptosuites. The ones utilized by Ames are
19`zuse` contains several cryptosuites. The ones utilized by Ames are
20[`+ed:crypto`](#ed), [`+aes:crypto`](#aes), and [`+crub:crypto`](#crub), with
20[`+ed:crypto`](#ed), [`+aes:crypto`](#aes), and [`+crub:crypto`](#crub), with
21−the latter being the only one which is implementable as an [`+acru:ames`
21+the latter being the only one which is implemented as an [`+acru:ames`](@/docs/arvo/ames/cryptography/#crypto-core)-shaped core.
22−core](@/docs/arvo/ames/cryptography/#crypto-core).
23
22
24## `+crub:crypto` {#crub}
23## `+crub:crypto` {#crub}
25
24
@@ -219,4 +218,3 @@ This core contains several doors, each one used for a different variation of AES
219according to key size and mode. The only ones currently in use are
218according to key size and mode. The only ones currently in use are
220`+siva:aes:crypto` and `+sivc:aes:crypto`, which are 128-bit and
219`+siva:aes:crypto` and `+sivc:aes:crypto`, which are 128-bit and
221256-bit modes of [`AES-SIV`](https://www.aes-siv.com) respectively.
220256-bit modes of [`AES-SIV`](https://www.aes-siv.com) respectively.
222−
system-overview/cryptography.md+1−1
@@ -120,5 +120,5 @@ The following pages contained more detailed information about the cryptography
120utilized by each of the system components.
120utilized by each of the system components.
121
121
122 - [Ames](@/docs/arvo/ames/cryptography.md)
122 - [Ames](@/docs/arvo/ames/cryptography.md)
123− - [zuse](@/docs/arvo/reference/cryptography.md)
123+ - [Zuse](@/docs/arvo/reference/cryptography.md)
124 - [Vere](@/docs/vere/cryptography.md)
124 - [Vere](@/docs/vere/cryptography.md)