From 8c9dcb38167938068fe7b662dc403dd03a8a7ef8 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Sun, 3 Nov 2013 13:10:57 -0800 Subject: Began writing a glossary --- docs/glossary.rst | 29 +++++++++++++++++++++++++++++ docs/index.rst | 1 + 2 files changed, 30 insertions(+) create mode 100644 docs/glossary.rst (limited to 'docs') diff --git a/docs/glossary.rst b/docs/glossary.rst new file mode 100644 index 00000000..b80b4b2b --- /dev/null +++ b/docs/glossary.rst @@ -0,0 +1,29 @@ +Glossary +======== + +.. glossary:: + + plaintext + User-readable data you care about. + + ciphertext + The encoded data, it's not user readable. Potential attackers are able + to see this. + + encryption + The process of converting plaintext to ciphertext. + + decryption + The process of converting ciphertext to plaintext. + + key + Secret data is encoded with a function using this key. Sometimes + multiple keys are used. + + symmetric cryptography + Cryptographic operations where encryption and decryption use the same + key. + + asymmetric cryptography + Cryptographic operations where encryption and decryption use different + keys. There are seperate encryption and decryption keys. diff --git a/docs/index.rst b/docs/index.rst index eb30b5dd..1b88e24e 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -32,6 +32,7 @@ Contents architecture exceptions + glossary contributing security community -- cgit v1.2.3 From a0516bf23ceb6c02dbc56aa8c39b8df0cf01119e Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Sun, 3 Nov 2013 13:20:41 -0800 Subject: Get real scary --- docs/glossary.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/glossary.rst b/docs/glossary.rst index b80b4b2b..e4fc8283 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -18,7 +18,8 @@ Glossary key Secret data is encoded with a function using this key. Sometimes - multiple keys are used. + multiple keys are used. These **must** be kept secret, if a key is + exposed to an attacker, any data encrypted with it will be exposed. symmetric cryptography Cryptographic operations where encryption and decryption use the same -- cgit v1.2.3