47. Federal Information Processing Standards (FIPS) CryptoDev Validation
Federal Information Processing Standards (FIPS) are publicly announced standards developed by the United States federal government for use in computer systems by non-military government agencies and government contractors.
This application is used to parse and perform symmetric cryptography computation to the NIST Cryptographic Algorithm Validation Program (CAVP) test vectors.
For an algorithm implementation to be listed on a cryptographic module validation certificate as an Approved security function, the algorithm implementation must meet all the requirements of FIPS 140-2 and must successfully complete the cryptographic algorithm validation process.
Only NIST CAVP request files are parsed by this application.
The version of request file supported is
If the header comment in a
.reqfile does not contain a Algo tag i.e
AES,TDES,GCMyou need to manually add it into the header comment for example:
# VARIABLE KEY - KAT for CBC / # TDES VARIABLE KEY - KAT for CBC
The application does not supply the test vectors. The user is expected to obtain the test vector files from NIST website. To obtain the
.reqfiles you need to email a person from the NIST website and pay for the
.rspfiles from the site can be used to validate and compare with the
.rspfiles created by the FIPS application.
- Supported test vectors
AES-CBC (128,192,256) - GFSbox, KeySbox, MCT, MMT
AES-GCM (128,192,256) - EncryptExtIV, Decrypt
AES-CCM (128) - VADT, VNT, VPT, VTT, DVPT
AES-CMAC (128) - Generate, Verify
HMAC (SHA1, SHA224, SHA256, SHA384, SHA512)
TDES-CBC (1 Key, 2 Keys, 3 Keys) - MMT, Monte, Permop, Subkey, Varkey, VarText
47.3. Application Information
.req is used as the input file after the application is finished
running it will generate a response file or
.rsp. Differences between the
two files are, the
.req file has missing information for instance if doing
encryption you will not have the cipher text and that will be generated in the
response file. Also if doing decryption it will not have the plain text until it
finished the work and in the response file it will be added onto the end of each
The application can be run with a
.rsp file and what the outcome of that
will be is it will add a extra line in the generated
.rsp which should be
the same as the
.rsp used to run the application, this is useful for
validating if the application has done the operation correctly.
47.4. Compiling the Application
To compile the sample application see Compiling the Sample Applications.
dos2unixon the request files
dos2unix AES/req/* dos2unix AES_GCM/req/* dos2unix CCM/req/* dos2unix CMAC/req/* dos2unix HMAC/req/* dos2unix TDES/req/*
47.5. Running the Application
The application requires a number of command line options:
./dpdk-fips_validation [EAL options] -- --req-file FILE_PATH/FOLDER_PATH --rsp-file FILE_PATH/FOLDER_PATH [--cryptodev DEVICE_NAME] [--cryptodev-id ID] [--path-is-folder] --mbuf-dataroom DATAROOM_SIZE
req-file: The path of the request file or folder, separated by
rsp-file: The path that the response file or folder is stored. separated by
cryptodev: The name of the target DPDK Crypto device to be validated.
cryptodev-id: The id of the target DPDK Crypto device to be validated.
path-is-folder: If presented the application expects req-file and rsp-file are folder paths.
mbuf-dataroom: By default the application creates mbuf pool with maximum possible data room (65535 bytes). If the user wants to test scatter-gather list feature of the PMD he or she may set this value to reduce the dataroom size so that the input data may be dividied into multiple chained mbufs.
To run the application in linux environment to test one AES FIPS test data file for crypto_aesni_mb PMD, issue the command:
$ ./dpdk-fips_validation --vdev crypto_aesni_mb -- --req-file /PATH/TO/REQUEST/FILE.req --rsp-file ./PATH/TO/RESPONSE/FILE.rsp --cryptodev crypto_aesni_mb
To run the application in linux environment to test all AES-GCM FIPS test data files in one folder for crypto_aesni_gcm PMD, issue the command:
$ ./dpdk-fips_validation --vdev crypto_aesni_gcm0 -- --req-file /PATH/TO/REQUEST/FILE/FOLDER/ --rsp-file ./PATH/TO/RESPONSE/FILE/FOLDER/ --cryptodev-id 0 --path-is-folder