z/OS Cryptographic Services ICSF Application Programmer's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Usage Notes

z/OS Cryptographic Services ICSF Application Programmer's Guide
SA22-7522-16

SAF may be invoked to verify the caller is authorized to use this callable service, the key label, or internal secure key tokens that are stored in the CKDS or PKDS.

This is the message layout used to encode the key material exported with the new PKOAEP2 formatting method.

Table 108. PKCS#1 OAEP encoded message layout (PKOAEP2)
FieldSizeValue
Hash field32 BytesSHA-256 hash of associated data section in the source key identifier
Key Bit Length2 Bytesvariable
Key MaterialByte length of the key material (rounded up to the nearest byte)variable
Hash field
The associated data for the HMAC variable length token is hashed using SHA-256. Specifically referring to vartoken.h, this is the "VarAssocData_t AD" section of the VarKeyTkn_t structure, for the full length indicated in the 'SectLn' field of the VarAssocData_t.
Key Bit Length
A 2 Byte key bit length field.
Key Material
The key material is padded to the nearest byte with '0' bits.

This table lists the access control points in the ICSF role that control the function for this service.

Table 109. Symmetric Key Import2 Access Control Points
Key formatting methodAlgorithmAccess control point
PKOAEP2HMAC, AESSymmetric Key Import2 - HMAC/AES, PKOAEP2
AESKWHMAC, AESSymmetric Key Import2 - HMAC/AES, AESKW

When the Symmetric Key Import2 - disallow weak import access control point is enabled, a key token wrapped with a weaker key will not be imported. When the Variable-length Symmetric Token - warn when weak wrap access control point is enabled, the reason code will indicate when the wrapping key is weaker than the key being imported.

This table lists the required cryptographic hardware for each server type and describes restrictions for this callable service.

Table 110. Symmetric key import2 required hardware
ServerRequired cryptographic hardwareRestrictions
IBM eServer zSeries 900This service is not supported.
IBM eServer zSeries 990

IBM eServer zSeries 890

This service is not supported.
IBM System z9 EC

IBM System z9 BC

This service is not supported.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014