From aeb714c5fb12e66a7e5e59150d38d8f083e7ebd4 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Mon, 9 Sep 2013 18:06:14 -0700 Subject: Iinital work on 3DES. No tests and no implementation yet. --- docs/primitives/symmetric-encryption.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'docs/primitives/symmetric-encryption.rst') diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst index 1b8d1d73..91f3b7aa 100644 --- a/docs/primitives/symmetric-encryption.rst +++ b/docs/primitives/symmetric-encryption.rst @@ -52,6 +52,25 @@ Ciphers This must be kept secret. +Insecure Ciphers +---------------- + +.. class:: cryptography.primitives.block.ciphers.TripleDES(key) + + Triple DES (Data encryption standard), sometimes refered to as 3DES, is a + block cipher standardized by NIST. Triple DES should be considered to be + cryptographically broken and should not be used for new applications, old + applications should strongly consider moving away from it. + + :param bytes key: The secret key, either ``64``, ``128``, or ``192`` bits + (note that DES functionally uses ``56``, ``112``, or + ``168`` bits of the key, there is a parity byte in each + component of the key), in some materials these are + referred to as being up to three separate keys (each + ``56`` bits long), they can simply be concatenated to + produce the full key. This must be kept secret. + + Modes ~~~~~ -- cgit v1.2.3 From 2f355d156f86d413c062ae06dd8b6fb7b1b8442f Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Mon, 9 Sep 2013 18:09:26 -0700 Subject: These are capitalized --- docs/primitives/symmetric-encryption.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/primitives/symmetric-encryption.rst') diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst index 91f3b7aa..ce3b13e8 100644 --- a/docs/primitives/symmetric-encryption.rst +++ b/docs/primitives/symmetric-encryption.rst @@ -57,7 +57,7 @@ Insecure Ciphers .. class:: cryptography.primitives.block.ciphers.TripleDES(key) - Triple DES (Data encryption standard), sometimes refered to as 3DES, is a + Triple DES (Data Encryption Standard), sometimes refered to as 3DES, is a block cipher standardized by NIST. Triple DES should be considered to be cryptographically broken and should not be used for new applications, old applications should strongly consider moving away from it. -- cgit v1.2.3 From 17adce696d5c5fd6f89e11d6fed327cac54f3d79 Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Wed, 16 Oct 2013 17:04:40 -0700 Subject: Fixed huge inaccuracies in the docs --- docs/primitives/symmetric-encryption.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) (limited to 'docs/primitives/symmetric-encryption.rst') diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst index 77d97911..b1b40486 100644 --- a/docs/primitives/symmetric-encryption.rst +++ b/docs/primitives/symmetric-encryption.rst @@ -61,15 +61,13 @@ Ciphers This must be kept secret. -Insecure Ciphers ----------------- - .. class:: cryptography.primitives.block.ciphers.TripleDES(key) Triple DES (Data Encryption Standard), sometimes refered to as 3DES, is a - block cipher standardized by NIST. Triple DES should be considered to be - cryptographically broken and should not be used for new applications, old - applications should strongly consider moving away from it. + block cipher standardized by NIST. Triple DES has known cryptoanalytic + flaws, however none of them currently enable a practical attack. + Nonetheless, Triples DES is not reccomended for new applications because it + is incredibly slow, old applications should consider moving away from it. :param bytes key: The secret key, either ``64``, ``128``, or ``192`` bits (note that DES functionally uses ``56``, ``112``, or -- cgit v1.2.3 From fbcc564cd234d3b6c29ddd40fa66d50d39c5c8dd Mon Sep 17 00:00:00 2001 From: Alex Gaynor Date: Tue, 22 Oct 2013 08:26:00 -0700 Subject: grammar --- docs/primitives/symmetric-encryption.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/primitives/symmetric-encryption.rst') diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst index cf251c91..96bd68f0 100644 --- a/docs/primitives/symmetric-encryption.rst +++ b/docs/primitives/symmetric-encryption.rst @@ -67,7 +67,7 @@ Ciphers block cipher standardized by NIST. Triple DES has known cryptoanalytic flaws, however none of them currently enable a practical attack. Nonetheless, Triples DES is not reccomended for new applications because it - is incredibly slow, old applications should consider moving away from it. + is incredibly slow; old applications should consider moving away from it. :param bytes key: The secret key, either ``64``, ``128``, or ``192`` bits (note that DES functionally uses ``56``, ``112``, or -- cgit v1.2.3