NSSCryptoModuleSpec/Section 9: Self Tests

From MozillaWiki
Jump to navigation Jump to search

Note: This is a draft - A work in progress! - Not official.


Document Description

DTR Section

Assessment

Status

List every error state & error indicator - Document all error states associated with each self-test, and indicate for each error state the expected error indicator.

VE.09.04.01

Failure of any of the power-up, conditional, or operator-initiated self-tests causes the cryptographic module to enter the Error state (State 3 ). When the cryptographic module is in the Error state, most functions (including all the cryptographic functions) do nothing and return the error code CKR_DEVICE_ERROR. See also the Show Status service of the cryptographic module.

CKR_DEVICE_ERROR Cryptographic module is in or has entered the Error state.
Draft

Module in Error State: Ensure that cryptographic operations cannot be performed and all data output via the data output interface is inhibited while the module is in the error state. See VE02.06.01 for the vendor design requirement.

VE.09.05.01 VE.09.06.01

Power-up self-test: PKCS #11 Initialization: During the PKCS #11 initialization of the FIPS 140-2 module, any error return from the battery of self-tests will put the module in the Error state.

The Error state will inhibit further cryptographic operations (In Error State ).

Output from the cryptographic module is via two paths: 1) the return code of the cryptographic function and, 2) buffers and objects which are operated on by the function, the locations of which are passed as function arguments. In the Error state the return code is always CKR_DEVICE_ERROR. No action besides setting the return code is taken by the requested function, which prevents data output of the second type.

Draft

List of mandatory & optional self-tests performed by the module

VE.09.07.01

Power up Self Test Code

Power up SelfTest Design

No operator call backs have been implemented at any point within the power-up self tests. These tests are mandatory for the FIPS-140-2 mode of operation.

Draft

For each error condition, document the actions neccessary to clear the condition and resume normal operation.

VE.09.07.02

For fatal error conditions CKR_DEVICE_ERROR and CKR_HOST_MEMORY the only way to clear the condition is to reboot the module. Upon restart the power-up tests shall be initiated automatically and does not require operator intervention.

Draft

Describe self-test initiation on demand requires that the running of power-up self-tests not involve any inputs from actions by the operator.

VE.09.09.01

The products will not have a user visible way to initiate these tests other than restarting the program.

Draft

Cryptographic Algorithms Known Answer Test successful completion indicator for the power-up self-tests.

VE.09.10.01

Power Up Self Test Code This is demonstrated throughout the self test module. Each of the following functions declares static key material at the beginning of each test and upon successful completion returns CKR_OK:


sftk_fips_RC2_PowerUpSelfTest

sftk_fips_RC4_PowerUpSelfTest

sftk_fips_DES_PowerUpSelfTest

sftk_fips_DES3_PowerUpSelfTest

sftk_fips_MD2_PowerUpSelfTest

sftk_fips_MD5_PowerUpSelfTest

sftk_fips_SHA1_PowerUpSelfTest

sftk_fips_RSA_PowerUpSelfTest

sftk_fips_DSA_PowerUpSelfTest

sftk_fips_AES_PowerUpSelfTest

stk_fipsPowerUpSelfTest

Draft

Procedure by which an operator can initiate the power-up self-tests

VE.09.12.01

The products will not have a user visible way to initiate these tests other than restarting the program.

Draft

All self tests shall use a known answer.

VE.09.13.01

A known answer shall be conducted for all cryptographic functions (e.g., encryption, decryption, authentication and random number generation) of each Approved cryptographic algorithm self test.

Draft

If the calculated output does not equal the known answer, the known-answer test shall fail.

VE.09.16.01

CKR_DEVICE_ERROR is returned when ever the calculated output does not equal the known answer.

Draft

specify the method used to compare the calculated output with the known answer.

VE.09.17.01

PORT_Memcmp is used to compare the computed cipher text with the known ciphertext. sftk_fipsPowerUpSelfTest When keys are used for encryption/decryption the 'Pairwise Consistency Check Self Tests' are used.

Draft

Error State when two outputs are not equal.

VE.09.17.02

CKR_DEVICE_ERROR is returned when the two outputs are not equal.

Draft

Self-Test description for all tests implemented.

VE.09.18.01 VE.09.18.02 VE.09.19.01 VE.09.19.02 VE.09.20.01

Power up Self Test Code

Power up SelfTest Design

No operator call backs have been implemented at any point within the power-up self tests. These tests are mandatory for the FIPS-140-2 mode of operation.

Draft
Independant cryptographic algorithm implemenations VE.09.20.02

(N/A)

Draft

Integrity test for software components

VE.09.22.01 VE.09.22.02 VE.09.22.03

Digital Signature Standard (DSS) is used as the approved (DSA) authentication technique for the integrity test of the software component. When the softokn and freebl libraries (libsoftokn3/softokn3/libfreebl*) are built a DSA signature checksum is generated and stored in a file with the name libraryname.chk. When the module is in FIPS mode, at initialization the softoken computes checksums for its library and for freebl and compares it with the values in libraryname.chk

FC_Initialize calls nsc_CommonInitialize and then the DSS signature is checked before the module is allowed to load.


Draft
EDC for software integrity VE.09.24.01 (N/A)
Critical Functions

VE.09.27.01 VE.09.28.01

Random Number Generator Self tests are the Continuous Pseudo-Random Number Self-Tests

Draft

Key transport method

VE.09.31.01 VE.09.32.01

RSA encryption is the only FIPS approved key transport method that VE.09.31.01 applies to. See sftk_PairwiseConsistencyCheck

The other key transport/establishment methods either use a symmetric wrapping key (encrypting/wrapping with TDES or AES) or require two public/private key pairs (Diffie-Hellman or its elliptic curve variants).

Draft

Approved authentication technique

VE.09.33.01 VE.09.35.01 VE.09.35.02

When components are externally loaded in the cryptographic module, Digital Signature Standard (DSS) is used.

Draft

Manual Key Entry

VE.09.40.01 VE.09.40.02

(N/A) NSS does not implement manual Key entry

Random number generator is implemented, document the continuous RNG test performed

VE.09.42.01 VE.09.43.01

Continuous Pseudo-Random Number Self-Tests In this code reference, if the SHA-1 hash matches the previous SHA-1 hash (the odds are 2^160), then the error code SECFailure is returned. This will propogate up to calling functions to put the cryptographic module in critical error state.

Draft
ByPass Service

VE.09.45.01 VE.09.45.02 VE.09.46.01 VE.09.46.02

(N/A) NSS does not implement a ByPass service. Draft

Return to: NSSCryptoModuleSpec