aboutsummaryrefslogtreecommitdiffstats
path: root/docs/hazmat/primitives/mac
diff options
context:
space:
mode:
authorAlex Stapleton <alexs@prol.etari.at>2014-05-01 09:53:35 +0100
committerAlex Stapleton <alexs@prol.etari.at>2014-05-01 09:53:35 +0100
commit44eca4c8894e14ee777b007011ac7df6e6cd3d41 (patch)
tree7adb204a7677d9218820a5be950fcfd5a4ffc527 /docs/hazmat/primitives/mac
parent401164c1a2fe79ccac0ed1f97f11958cbe86632a (diff)
parent323b8e3116b6a136b8c9526ebe450db7a63fcb7a (diff)
downloadcryptography-44eca4c8894e14ee777b007011ac7df6e6cd3d41.tar.gz
cryptography-44eca4c8894e14ee777b007011ac7df6e6cd3d41.tar.bz2
cryptography-44eca4c8894e14ee777b007011ac7df6e6cd3d41.zip
Merge pull request #985 from Ayrx/document-preferred-mac
Fixes #983: Added note about preferred MAC algorithm
Diffstat (limited to 'docs/hazmat/primitives/mac')
-rw-r--r--docs/hazmat/primitives/mac/index.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/hazmat/primitives/mac/index.rst b/docs/hazmat/primitives/mac/index.rst
index 59fb8da2..4f075417 100644
--- a/docs/hazmat/primitives/mac/index.rst
+++ b/docs/hazmat/primitives/mac/index.rst
@@ -3,6 +3,13 @@
Message Authentication Codes
============================
+While cryptography supports both the CMAC and HMAC algorithms, we strongly
+recommend that HMAC should be used unless you have a good reason otherwise.
+
+For more information on why HMAC is preferred, see `Use cases for CMAC vs. HMAC?`_
+
+.. _`Use cases for CMAC vs. HMAC?`: http://crypto.stackexchange.com/questions/15721/use-cases-for-cmac-vs-hmac
+
.. toctree::
:maxdepth: 1