aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHynek Schlawack <hs@ox.cx>2013-11-03 23:09:29 -0800
committerHynek Schlawack <hs@ox.cx>2013-11-03 23:09:29 -0800
commit6a1dfe63eb9aa0c077ec1c8c8158acc4d1388a5f (patch)
tree87c2f06f3b544af74f0d5098b801dfe265c1732a /docs
parent7c104fd66486c7c4cbd8dc989a6a12a7ff228342 (diff)
parenta0516bf23ceb6c02dbc56aa8c39b8df0cf01119e (diff)
downloadcryptography-6a1dfe63eb9aa0c077ec1c8c8158acc4d1388a5f.tar.gz
cryptography-6a1dfe63eb9aa0c077ec1c8c8158acc4d1388a5f.tar.bz2
cryptography-6a1dfe63eb9aa0c077ec1c8c8158acc4d1388a5f.zip
Merge pull request #217 from alex/glossary
Initial work on a glossary
Diffstat (limited to 'docs')
-rw-r--r--docs/glossary.rst30
-rw-r--r--docs/index.rst1
2 files changed, 31 insertions, 0 deletions
diff --git a/docs/glossary.rst b/docs/glossary.rst
new file mode 100644
index 00000000..e4fc8283
--- /dev/null
+++ b/docs/glossary.rst
@@ -0,0 +1,30 @@
+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. 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
+ 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