aboutsummaryrefslogtreecommitdiffstats
path: root/docs/hazmat/primitives/symmetric-encryption.rst
diff options
context:
space:
mode:
authorPaul Kehrer <paul.l.kehrer@gmail.com>2013-12-21 18:53:19 -0600
committerPaul Kehrer <paul.l.kehrer@gmail.com>2013-12-21 18:53:19 -0600
commit048d6cb43a0757f3b4cca385e788d30173ebcb17 (patch)
treee0674a1a5af226ce1f1c5ddff17797a906d50712 /docs/hazmat/primitives/symmetric-encryption.rst
parentfc73e2d04315e21011869fbd925df9e7a99d21ae (diff)
downloadcryptography-048d6cb43a0757f3b4cca385e788d30173ebcb17.tar.gz
cryptography-048d6cb43a0757f3b4cca385e788d30173ebcb17.tar.bz2
cryptography-048d6cb43a0757f3b4cca385e788d30173ebcb17.zip
a few more doc changes to gcm tag info
Diffstat (limited to 'docs/hazmat/primitives/symmetric-encryption.rst')
-rw-r--r--docs/hazmat/primitives/symmetric-encryption.rst5
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/hazmat/primitives/symmetric-encryption.rst b/docs/hazmat/primitives/symmetric-encryption.rst
index f009bb78..6e3c1024 100644
--- a/docs/hazmat/primitives/symmetric-encryption.rst
+++ b/docs/hazmat/primitives/symmetric-encryption.rst
@@ -357,9 +357,10 @@ Modes
Cryptography will emit a 128-bit tag when finalizing encryption.
You can shorten a tag by truncating it to the desired length, but this
is **not recommended** as it lowers the security margins of the
- authentication (`NIST SP-800-38D`_ recommends 96-bit or greater).
+ authentication (`NIST SP-800-38D`_ recommends 96-bits or greater).
If you must shorten the tag the minimum allowed length is 4 bytes
- (32 bit).
+ (32-bits). Applications **must** verify the tag is the expected length
+ to guarantee the expected security margin.
:param bytes tag: The tag bytes to verify during decryption. When encrypting
this must be None.