aboutsummaryrefslogtreecommitdiffstats
path: root/vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt
diff options
context:
space:
mode:
authorPaul Kehrer <paul.l.kehrer@gmail.com>2015-03-15 09:06:25 -0500
committerPaul Kehrer <paul.l.kehrer@gmail.com>2015-03-15 09:08:14 -0500
commit16430f93b4df8ef34d306664a24c64881684046d (patch)
treed998614cff2687f4276189d6a6ea183b6f1720a4 /vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt
parent31b3acbf09a181fcca9a90b96a308f538c6bb7ff (diff)
downloadcryptography-16430f93b4df8ef34d306664a24c64881684046d.tar.gz
cryptography-16430f93b4df8ef34d306664a24c64881684046d.tar.bz2
cryptography-16430f93b4df8ef34d306664a24c64881684046d.zip
add keywrap test vectors from NIST
From http://csrc.nist.gov/groups/STM/cavp/documents/mac/kwtestvectors.zip
Diffstat (limited to 'vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt')
-rwxr-xr-xvectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt27
1 files changed, 27 insertions, 0 deletions
diff --git a/vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt b/vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt
new file mode 100755
index 00000000..884b4988
--- /dev/null
+++ b/vectors/cryptography_vectors/keywrap/kwtestvectors/Readme.txt
@@ -0,0 +1,27 @@
+This zip file contains sample test vectors (values) for the following functions defined in
+NIST SP 800-38F:
+
+1. AES Key Wrap Authenticated Encryption (KW-AE) and Authenticated Decryption (KW-AD)
+ - file names indicate direction (KW_AE or KW_AD), AES key length (128, 192 or 256).
+ e.g., KW_AE_128 mean AES Key Wrap Authenticated Encryption using AES-128.
+ - for KW-AE, 'inv' at end of file name indicates AES inverse cipher transformation used
+ - for KW-AD, 'inv' at end of file name indicates AES forward cipher transformation used (i.e.,
+ authenticated decryption of ciphertext that has been *encrypted using AES inverse cipher function*)
+ - 5 plaintext lengths with 100 trials per plaintext length
+ - For each trial in KW-AE files, two inputs: key (K) and plaintext (P) and one output: resulting ciphertext (C)
+ - for each trial in KW-AD files, two inputs: key (K) and ciphertext (C) and one output: either the resulting
+ plaintext (P) or FAIL if ciphertext fails to authenticate. Should FAIL 20 times per 100 trials.
+
+2. AES Key Wrap with Padding Authenticated Encryption (KWP-AE) and Authenticated Decryption (KWP-AD)
+ - file names indicate same things as in (1.), just replace KW_ with KWP_
+ - trials same as in (1.)
+
+3. TDEA Key Wrap Authenticated Encryption (TKW-AE) and Authenticated Decryption (TKW-AD)
+ - file names indicate same things as in (1.), just replace KW_ with TKW_, except for...
+ - only one key size, so no 128/192/256 in file name
+ - trials same as in (1.)
+
+
+Refer to NIST SP 800-38F (December 2012) for more on these functions:
+
+http://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf \ No newline at end of file