Chapter 4 Using Crypto-C 113
Keys In Crypto-C
Keys In Crypto-C
The key object is used to hold any key-related information and to supply this
information to functions that require it. To build a key, create an empty key object
with B_CreateKeyObject. Then, use B_SetKeyInfo to fill it with the information
necessary to distinguish it as the desired key. That information for B_SetKeyInfo is
made up of two items, a Key Info Type (KI) and its specific accompanying
info
.
Chapter 3 of the Crypto-C Reference Manual (RM) gives a complete listing of KIs in
alphabetical order. Each entry in the Reference Manual contains a description of the
information that must accompany the KI.

Summary of KIs

Refer to the following tables, organized by function, for a list of Crypto-C KIs.
Table 4-14 Generic Keys
Key Information Type Description
KI_8Byte Generic 8-byte key
KI_16Byte Generic 16-byte key
KI_24Byte Generic 24-byte key
KI_32Byte Generic 32-byte key
KI_Item Generic variable-length key
Table 4-15 Block Cipher Keys
Key Information Type Description
KI_DES8 8-byte DES key satisfying DES parity requirement
KI_DES8Strong 8-byte DES key satisfying DES parity requirement;
checks for weak DES keys
KI_24Byte 24-byte 3DES key
KI_DES24Strong 24-byte 3DES key; checks for weak 3DES keys
KI_DES_BSAFE1 8-byte DES in BSAFE1.x format
KI_DESX DESX key
KI_DESX_BSAFE1 DESX key in BSAFE 1.x format