Sun Oracle Crypto Accelerator 6000 Board, Руководство пользователя

Страница: 150 / 266

128 Sun Crypto Accelerator 6000 Board User’s Guide for Version 1.1 • February 2013
■
Translate key (from the old MFK to the new MFK)
■
Retrieve KEK
Generate Key Function
fs_generate_key()
Applications generate different types of financial keys. DES keys are primarily used
for these functions. Along with the key type, key usage information is required to
limit when the key can be used. The following types of key uses are supported:
■
PIN encryption keys
■
Terminal PIN key (TPK)
■
Zone working key (ZWK)
■
PIN verification key (PVK)
■
Card verification key (CVK)
Once generated these keys are encrypted by the MFK and returned in the user-
provided buffer upon success.
The syntax for the
fs_generate_key()
function is as follows:
TABLE 5-9
lists the parameters for the
fs_generate_key()
function.
TABLE 5-10
lists the return values for the
fs_generate_key()
function.
fsReturn_t fs_generate_key(fsSessHandle_t handle, fsKeyType_t
type, fsKeyUsage_t usage, fsKey_t *key)
TABLE 5-9
fs_generate_key()
Function Parameters
Parameters Description
handle
Session handle returned by
fs_session_open()
type
Key algorithm type: DES, DES2, DES3
usage
Intended financial key usage
key
Buffer for the generated key, encrypted with the MFK or a derivative
TABLE 5-10
fs_generate_key()
Function Return Values
Return Value Description
fsOK
Key generated