Skip to content

Commit 54c02c5

Browse files
committed
docs: minor corrections for encryption algorithms
1 parent 1f7d7ca commit 54c02c5

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

docs/reference/architecture/encryption-algorithms.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,16 @@ cryptographic algorithms for optimal security and performance.
1414

1515
### Symmetric Encryption
1616

17-
- **AES-GCM (Advanced Encryption Standard - Galois/Counter Mode)**
18-
- Used for encrypting data at rest and in transit.
19-
- Provides both encryption and authentication in a single step.
20-
- 256-bit key length for strong security.
21-
- Resistant to padding oracle attacks due to its authenticated encryption
22-
structure.
17+
-### Symmetric Encryption
18+
19+
- **XChaCha20-Poly1305 (IETF)**
20+
- **Key Size:** 256 bits
21+
- **Nonce Size:** 192 bits
22+
- **MAC Size:** 128 bits
23+
- This extended 192-bit nonce allows random nonces to be safely used, reducing the risk of nonce reuse and making the encryption scheme misuse-resistant.
24+
- A stream cipher approach is employed, encrypting data per block with a fresh, random nonce each time.
25+
- Polykey stores its persistent state in an encrypted database, protected by a “Data Encryption Key” (DEK). This DEK is **not** derived from the root key, so rotating the root key does **not** require re-encrypting the entire database.
26+
- By combining encryption and authentication, XChaCha20-Poly1305 ensures both confidentiality and integrity of the stored data.
2327

2428
### Asymmetric Encryption
2529

0 commit comments

Comments
 (0)