Chapter 3 Key Info Types 253
KI_DESX
KI_DESX
Purpose:
This KI allows you to specify keying materials for the DESX algorithm. They include
the key value, input whitener, and output whitener. The key value will be used as the
DES encryption key for the DESX algorithm and thus it will be parity adjusted. See
the AI_DESX_CBC_IV8 section for descriptions of the DESX algorithm.
Type of information this allows you to use:
a DESX key where the key value, input whitener, and output whitener are specified.
Format of info supplied to B_SetKeyInfo:
pointer to an A_DESX_KEY structure:
The value of key is DES parity adjusted when it is copied to the key object.
Format of info returned by B_GetKeyInfo:
pointer to an A_DESX_KEY structure (see above). The value of key is DES parity
adjusted.
Can get this info type if key object already has:
KI_24Byte (if the DES parity is correct), KI_Item (if the length of the ITEM is 24 and
the data's DES parity is correct), or KI_DESX.
typedef struct {
unsigned char *key; /* pointer to 8-byte key */
unsigned char *inputWhitener; /* pointer to 8-byte input whitener */
unsigned char *outputWhitener; /* pointer to 8-byte output whitener */
} A_DESX_KEY;