Skip to content

Commit c9e6fd0

Browse files
committed
added salt
1 parent 3ffc466 commit c9e6fd0

3 files changed

Lines changed: 49 additions & 0 deletions

File tree

‎_data/navigation.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,8 @@ envelope:
212212
url: /envelope/permits/
213213
- title: "Request & Response"
214214
url: /envelope/request/
215+
- title: "Salt"
216+
url: /envelope/salt/
215217
envelopecli:
216218
- title: "Envelope CLI"
217219
children:
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
cover: false
3+
header:
4+
overlay_color: "#000"
5+
overlay_filter: "0.25"
6+
overlay_image: /assets/images/dev-data-background.jpg
7+
og_image: /assets/images/bc-card.jpg
8+
title: Salting
9+
hide_description: true
10+
classes:
11+
- wide
12+
permalink: /envelope/salt/
13+
sidebar:
14+
nav: envelope
15+
redirect_from:
16+
- /salt/
17+
- /salting/
18+
- /envelope/salting/
19+
---
20+
21+
## Overview
22+
23+
Salting is a critical privacy enhancement for that keeps elided data
24+
private. It ensures that even when the same information is elided from
25+
multiple documents, the resulting hashes are different, preventing
26+
correlation attacks.
27+
28+
## Why is Salting Important?
29+
30+
Without salting, elision would have a serious privacy weakness:
31+
32+
- Identical content would produce identical hashes.
33+
- An observer could determine if the same information was elided in multiple documents.
34+
- Common values could be guessed through dictionary attacks.
35+
36+
### How Does Salting Work?
37+
38+
Salting solves this problem by adding random data to an Envelope leaf
39+
or node before hashing:
40+
41+
```
42+
Without salt: hash("name": "John Smith") → always the same hash
43+
With salt: hash("name": "John Smith" + random_salt) → different hash each time
44+
```
45+
46+
Salts should be cryptographically random and of sufficient length.

‎_pages/tech/data-format/envelope.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,7 @@ _See the [Gordian Envelope playlist](https://www.youtube.com/playlist?list=PLCkr
206206
* [**Known Values**](/known-values/)
207207
* [**Permits**](/envelope/permits/)
208208
* [**Request/Response**](/envelope/request/)
209+
* [**Salt**](/envelope/salt/)
209210

210211
**Industry Intros:**
211212

0 commit comments

Comments
 (0)