CT_GetTmpPin

Synopsis

CK_DEFINE_FUNCTION(CK_RV, CT_GetTmpPin)(
    CK_SESSION_HANDLE hSession,
    CK_BYTE_PTR pPin,
    CK_ULONG_PTR pulPinLen
);

Description

This function is a SafeNet ProtectToolkit-C extension to PKCS#11provided with the SafeNet ProtectToolkit-C SDK as a host side library function.

The function requests the HSM to generate a random Temporary Pin value and to return the pin to the calling application. The function uses the CKH_VD_USER object to fetch the Pin.

A User or SO must be already logged on or this function will fail with error CKR_USER_NOT_LOGGED_ON.

The Application can pass this Temporary Pin to another process which can then use it to authenticate to the HSM (as the same user type only).

The Temporary Pin can be passed to the C_Login function to authenticate the user to the Token. See description of C_Login for more details.