Reference Guide

Chapter 4: Changes Between MES 4.3.1 and 4.4 29
RSA BSAFE Micro Edition Suite 4.4 Migration Guide
The following table lists the algorithm subtypes to specify when creating a
cryptographic object for key wrapping, for MES 3.1 through 4.3.1 and MES 4.4.
For example, if you are using a symmetric key to wrap a symmetric key object,
specify
R_CR_SUB_SYMMETRIC_KEY|R_CR_SUB_WRAP_SKEY.
Alternatively, if you are using an asymmetric key to wrap a symmetric key object,
specify
R_CR_SUB_ASYMMETRIC_KEY|R_CR_SUB_WRAP_SKEY.
Initialize the Cryptographic Object
The following table lists the functions used to initialize the cryptographic object for
key wrapping operations in MES 4.4.
Table 5 Key Wrapping Algorithm Subtypes
MES 4.3.1 MES 4.4
R_CR_SUB_NONE
If wrapping with a symmetric key,
R_CR_SUB_SYMMETRIC_KEY, plus the type of key you are
wrapping. One of:
•
R_CR_SUB_WRAP_SKEY
•
R_CR_SUB_WRAP_PKEY
•
R_CR_SUB_WRAP_RAW.
If wrapping with an asymmetric key,
R_CR_SUB_ASYMMETRIC_KEY, plus the type of key you are
wrapping. One of:
•
R_CR_SUB_WRAP_SKEY
•
R_CR_SUB_WRAP_PKEY
•
R_CR_SUB_WRAP_RAW.
Table 6 Key Wrapping Initialization Functions
MES 4.3.1 MES 4.4
R_CR_keywrap_wrap_init()
R_CR_keywrap_unwrap_init()
If wrapping with:
• A symmetric key,
R_CR_keywrap_wrap_init_SKEY()
• An asymmetric key,
R_CR_keywrap_wrap_init_PKEY()
If unwrapping with:
• A symmetric key,
R_CR_keywrap_unwrap_init_SKEY()
• An asymmetric key,
R_CR_keywrap_unwrap_init_PKEY()