Cryptographic Token Interface Standard

PKCS#11

AES secret key objects

AES secret key objects (object class CKO_SECRET_KEY, key type CKK_AES) hold AES keys. The following table defines the AES secret key object attributes, in addition to the common attributes defined for this object class: 




 Table 85, AES Secret Key Object Attributes   
Attribute Data type Meaning   


CKA_VALUE1,4,6,7 Byte array Key value (16, 24, or 32 bytes)   


CKA_VALUE_LEN2,3,6 CK_ULONG Length in bytes of key value  

 



- Refer to Table 15 for footnotes


The following is a sample template for creating an AES secret key object:



CK_OBJECT_CLASS class = CKO_SECRET_KEY;
CK_KEY_TYPE keyType = CKK_AES;
CK_UTF8CHAR label[] = "An AES secret key object";
CK_BYTE value[] = {...};
CK_BBOOL true = CK_TRUE;
CK_ATTRIBUTE template[] = {
{CKA_CLASS, &class, sizeof(class)},
{CKA_KEY_TYPE, &keyType, sizeof(keyType)},
{CKA_TOKEN, &true, sizeof(true)},
{CKA_LABEL, label, sizeof(label)-1},
{CKA_ENCRYPT, &true, sizeof(true)},
{CKA_VALUE, value, sizeof(value)}
};




CKA_CHECK_VALUE: The value of this attribute is derived from the key object by taking the first three bytes of the ECB encryption of a single block of null (0x00) bytes, using the default cipher associated with the key type of the secret key object.


 
 



RSA Security Inc. Public-Key Cryptography Standards - 
PKCS#11 - v220