From f6c47e9eacdcd096b5d112d73b96f7e84f908f61 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Thu, 8 Aug 2013 07:16:01 -0700 Subject: Started trying to document symmetric encryption --- docs/primitives/index.rst | 7 +++++++ docs/primitives/symmetric-encryption.rst | 22 ++++++++++++++++++++++ 2 files changed, 29 insertions(+) create mode 100644 docs/primitives/index.rst create mode 100644 docs/primitives/symmetric-encryption.rst (limited to 'docs/primitives') diff --git a/docs/primitives/index.rst b/docs/primitives/index.rst new file mode 100644 index 00000000..1066e30e --- /dev/null +++ b/docs/primitives/index.rst @@ -0,0 +1,7 @@ +Primitives +========== + +.. toctree:: + :maxdepth: 1 + + symmetric-encryption diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst new file mode 100644 index 00000000..acb5fc17 --- /dev/null +++ b/docs/primitives/symmetric-encryption.rst @@ -0,0 +1,22 @@ +Symmetric Encryption +==================== + +Symmetric encryption is a way to encrypt (hide the plaintext value) material +where the encrypter and decrypter both use the same key. + +Block ciphers +------------- + +Block ciphers work by encrypting content in chunks, often 64- or 128-bits. They +combine an underlying algorithm (such as AES), with a mode (such as CBC, CTR, +or GCM). A simple example of encrypting content with AES is: + +.. code-block:: pycon + + >>> from cryptography.primitives import BlockCipher, CBC + >>> from cryptography.primitives.aes import AES + >>> cipher = BlockCipher(AES(key), CBC(iv)) + >>> cipher.encrypt("my secret message") + cipher.finalize() + # The ciphertext + [...] + -- cgit v1.2.3