C_GetTokenInfo
This function operates as specified in PKCS#11. The information returned will vary depending on the type of slot specified by the slotID parameter. This information is returned in the CK_TOKEN_INFO
structure.
Label |
This is the string specified by the user during the C_InitToken command, unless the token is the administration token, in which case the value is: AdminToken(ssss) Where ssss is the HSM serial number. |
ManufacturerID | "SafeNet, Inc.” |
Model |
“PSI-E2:PLxxx” Where xxx is the performance level or smartcard manufacturer. |
SerialNumber |
“xxxx-xxxx” Where the first field is the HSM serial number and the second field is a randomly assigned token serial number or the smartcard serial number. |
Flags | CKF_RNG (for non-smart card slots only) + CKF_CLOCK_ON_TOKEN (if the module’s clock has been set) + CKF_DUAL_CRYPTO_OPERATIONS + Other flags based on the current state of the slot. CKF_LOGIN_REQUIRED flag is set if the security mode specifies “no public crypto”. Admin slot have CKF_ADMIN_TOKEN and CKF_LOGIN_REQUIRED set. |
ulMaxSessionCount | The value of that CKA_MAX_SESSIONS for the associated slot object. |
ulSessionCount | Determined at run time – this is the total number of session to this Token by all applications. |
ulMaxRwSessionCount | The value of that CKA_MAX_SESSIONS for the associated slot object. |
ulRwSessionCount | Determined at run time – this is the number of RW sessions the calling application has to the Token. |
ulMaxPinLen | CK_MAX_PIN_LEN = 32. |
UlMinPinLength | This is the value specified in the configuration as shown by the CKA_MIN_PIN attribute of the slot object. |
UlTotalPublicMemory | Determined at run time. |
ulFreePublicMemory | Determined at run time. |
ulTotalPrivateMemory | Determined at run time. |
ulFreePrivateMemory | Determined at run time. |
hardwareVersion | ‘G’.0 (or later) |
FirmwareVersion | 1.0 (or later) |
UtcTime | Current time is returned if the modules clock has been set (else ASCII zeros are returned). |
Synopsis
C_GetTokenInfo( CK_SLOT_ID slotID, CK_TOKEN_INFO_PTR pInfo );
Operation in WLD Mode
When SafeNet ProtectToolkit is configured to operate in WLD mode, a random slot from the HSM Token List for the provided slot ID is chosen, so as not to overload a particular device and the command is forwarded to that slot. The following WLD specific information is returned in the CK_TOKEN_INFO structure:
SerialNumber | The serial number specified for the virtual WLD Slot in environment variables ET_PTKC_WLD_SLOT_n. Refer to SafeNet ProtectToolkit-C Administration Manual for details. |
Flags | The CKF_WLD_TOKEN bit is set to indicate that it is a WLD Token. |