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