SCMException

public class SCMException extends Exception

Class describes an error resulting from a request to the SCWS service.

Fields

CKR_OK

public static final long CKR_OK

Methods

getErrorCode

public long getErrorCode()

Error code, suitable for checking when specific actions need to be taken depending on the cause.

Possible values are:

  • SCMException.CKR_CANCEL: The operation succeeded.

  • SCMException.CKR_HOST_MEMORY: Not enough memory on the host computer.

  • SCMException.CKR_SLOT_ID_INVALID: “The selected slot ID is invalid.

  • SCMException.CKR_GENERAL_ERROR: An unrecoverable error occurred. This may be due to an inconsistency in the smart card data.

  • SCMException.CKR_FUNCTION_FAILED: The operation failed for an unknown reason.

  • SCMException.CKR_ARGUMENTS_BAD: Bad argument were passed to the function.

  • SCMException.CKR_ATTRIBUTE_READ_ONLY: The token object cannot be modified because it is read-only.

  • SCMException.CKR_ATTRIBUTE_SENSITIVE: The token object cannot be read because it is sensitive.

  • SCMException.CKR_ATTRIBUTE_TYPE_INVALID: The object attribute is invalid.

  • SCMException.CKR_ATTRIBUTE_VALUE_INVALID: The value of the object attribute is invalid.

  • SCMException.CKR_ACTION_PROHIBITED: The action cannot be done because it is prohibited by the token.

  • SCMException.CKR_DATA_INVALID: The data is invalid.

  • SCMException.CKR_DATA_LEN_RANGE: The length of the data is inconsistent.

  • SCMException.CKR_DEVICE_ERROR: An error occurred during the communication with the card.

  • SCMException.CKR_DEVICE_MEMORY: There is not enough memory space available in the card.

  • SCMException.CKR_DEVICE_REMOVED: The card has been removed during the operation.

  • SCMException.CKR_ENCRYPTED_DATA_INVALID: The encrypted data is invalid.

  • SCMException.CKR_ENCRYPTED_DATA_LEN_RANGE: The length of the encrypted data is invalid.

  • SCMException.CKR_FUNCTION_CANCELED: The operation has been cancelled.

  • SCMException.CKR_FUNCTION_NOT_PARALLEL: The function cannot be executed in parallel

  • SCMException.CKR_FUNCTION_NOT_SUPPORTED: The operation is not supported by the card.

  • SCMException.CKR_KEY_HANDLE_INVALID: The specified key is not valid.

  • SCMException.CKR_KEY_SIZE_RANGE: The key size is outside of the range supported for this operation.

  • SCMException.CKR_KEY_TYPE_INCONSISTENT: The key types are inconsistent for this operation.

  • SCMException.CKR_KEY_NOT_NEEDED: An extraneous key was supplied.

  • SCMException.CKR_KEY_CHANGED: One of the keys specified is not the same key that was being used in the original saved session.

  • SCMException.CKR_KEY_NEEDED: The session state cannot be restored it because needs to be supplied with one or more keys that were being used in the original saved session.

  • SCMException.CKR_KEY_INDIGESTIBLE: The key cannot be digested.

  • SCMException.CKR_KEY_NOT_WRAPPABLE: The key cannot be wrapped.

  • SCMException.CKR_KEY_FUNCTION_NOT_PERMITTED: The key does not support this operation.

  • SCMException.CKR_KEY_UNEXTRACTABLE: The key cannot be extracted.

  • SCMException.CKR_MECHANISM_INVALID: The cryptographic algorithm is not supported.

  • SCMException.CKR_MECHANISM_PARAM_INVALID: The parameters for the cryptographic operation are incorrect.

  • SCMException.CKR_OBJECT_HANDLE_INVALID: The specified object handle is not valid.

  • SCMException.CKR_OPERATION_ACTIVE: There is already an active operation which prevents Cryptoki from activating the specified operation.

  • SCMException.CKR_OPERATION_NOT_INITIALIZED: There is no active operation of an appropriate type in the specified session.

  • SCMException.CKR_PIN_INCORRECT: The PIN value is incorrect.

  • SCMException.CKR_PIN_INVALID: The PIN does not have the proper format.

  • SCMException.CKR_PIN_LEN_RANGE: The length of the PIN is outside of the range.

  • SCMException.CKR_PIN_EXPIRED: The PIN has expired and needs to be changed.

  • SCMException.CKR_PIN_LOCKED: The PIN has been blocked.

  • SCMException.CKR_SIGNATURE_INVALID: The digital signature in invalid.

  • SCMException.CKR_SIGNATURE_LEN_RANGE: The length od the digital signature is incorrect.

  • SCMException.CKR_TOKEN_NOT_PRESENT: The token has been removed.

  • SCMException.CKR_TOKEN_NOT_RECOGNIZED: The token is not supported.

  • SCMException.CKR_TOKEN_WRITE_PROTECTED: The token is write-protected.

  • SCMException.CKR_UNWRAPPING_KEY_HANDLE_INVALID: The key handle specified to be used to unwrap another key is not valid.

  • SCMException.CKR_UNWRAPPING_KEY_SIZE_RANGE: The size of the unwrapping key is outside of the range supported for this operation.

  • SCMException.CKR_UNWRAPPING_KEY_TYPE_INCONSISTENT: The type of the unwrapping key is not supported for this operation.

  • SCMException.CKR_USER_ALREADY_LOGGED_IN: The user is already logged in.

  • SCMException.CKR_USER_NOT_LOGGED_IN: The appropriate user is not logged in.

  • SCMException.CKR_USER_PIN_NOT_INITIALIZED: The user PIN on this token has never been initially set.

  • SCMException.CKR_USER_TYPE_INVALID: The required user type is not defined for this card.

  • SCMException.CKR_USER_ANOTHER_ALREADY_LOGGED_IN: Another user is currently logged in.

  • SCMException.CKR_USER_TOO_MANY_TYPES: Too many users are logged in the token.

  • SCMException.CKR_WRAPPED_KEY_INVALID: The size of the wrapped key is outside of the range supported for this operation.

  • SCMException.CKR_WRAPPED_KEY_LEN_RANGE: The type of the wrapped key is not supported for this operation.

  • SCMException.CKR_WRAPPING_KEY_HANDLE_INVALID: The key handle specified to be used to wrap another key is not valid.

  • SCMException.CKR_WRAPPING_KEY_SIZE_RANGE: The size of the wrapping key is outside of the range supported for this operation.

  • SCMException.CKR_WRAPPING_KEY_TYPE_INCONSISTENT: The type of the wrapping key is not supported for this operation.

  • SCMException.CKR_DOMAIN_PARAMS_INVALID: Invalid or unsupported domain parameters were supplied to the function.

  • SCMException.CKR_CURVE_NOT_SUPPORTED: This curve is not supported by this token.

  • SCMException.CKR_BUFFER_TOO_SMALL: The output of the function is too large to fit in the supplied buffer.

  • SCMException.CKR_INFORMATION_SENSITIVE: The information is private and cannot be revealed.

  • SCMException.CKR_EXCEEDED_MAX_ITERATIONS: An iterative algorithm failed because we have exceeded the maximum number of iterations.

  • SCMException.CKR_LIBRARY_LOAD_FAILED: The Cryptoki library could not load a dependent shared library.

  • SCMException.CKR_PIN_TOO_WEAK: The new PIN must be different from the current one and recent previous PINs.

  • SCMException.CKR_PUBLIC_KEY_INVALID: The public key fails a public key validation.

  • SCMException.CKR_FUNCTION_REJECTED: The signature request is rejected by the user.

  • SCMException.CXR_NO_LICENSE_KEY: The software license key is invalid.

  • SCMException.CXR_PUK_ALREADY_USED: The Puk is already used.

  • SCMException.CXR_PIN_UNBLOCK_BLOCKED: The PIN cannot be unblocked anymore. The maximum number of unlock attempts has been reached.

  • SCMException.CXR_NOT_PERMITTED: The software license key is invalid.

  • SCMException.CXR_BT_INITIALIZATION_FAILED: Bluetooth initialization failed.

  • SCMException.CXR_BT_NOT_SCANNING: Bluetooth scan has not been started or has been stopped.

  • SCMException.CXR_BT_DEVICE_NOT_SUPPORTED: The bluetooth peripheral is not supported.

  • SCMException.CXR_BT_DEVICE_NOT_DETECTED: The bluetooth peripheral is not detected.

  • SCMException.CXR_BT_ALREADY_PAIRED: The operation is not permitted because a bluetooth peripheral is already paired.

  • SCMException.CXR_BT_PERMISSIONS_NOT_GRANTED: Bluetooth permissions are not granted.

  • SCMException.CXR_BT_LOCATION_NOT_ENABLED: Location parameter is not enabled.

  • SCMException.CXR_PACE_NEEDED: The card needs a Pace before using it.

  • SCMException.CXR_SIGNATURE_TIMESTAMP: Timestamping step of the signature failed.

  • SCMException.CXR_CERT_NOT_TRUSTED: The certificate has not been approved by an authority from the trusted zone.

  • SCMException.CXR_BROKEN_AUTHENTICATION: Secure chanel is broken.

  • SCMException.MWR_IMPORT_FILE_INVALID: The format of the file is unsupported or the file has been damaged.

  • SCMException.MWR_IMPORT_PASSWORD_INVALID: The file password is invalid.

  • SCMException.MWR_IMPORT_KEY_TYPE_UNSUPPORTED: The card does not support the required key type.

  • SCMException.MWR_IMPORT_KEY_LENGTH_UNSUPPORTED: The card does not support the required key length.

  • SCMException.MWR_PUK_ALREADY_USED: This PIN unblocking code has laready been used.

  • SCMException.MWR_SCWS_UNREACHABLE: The SCWS service could not be reached.

  • SCMException.MWR_SCWS_COMM_ERROR: The communication with the SCWS service failed.

  • SCMException.MWR_SCWS_COMM_TIMEOUT: The communication with the SCWS service has timed out.

  • SCMException.MWR_SCWS_BAD_PARAMS: Invalid input parameters.

  • SCMException.MWR_SCWS_UNKNOWN_ERROR: The SCWS service returned an invalid error code.

Returns:

the error code.

getStringCode

public String getStringCode()

Human-readable error message.

Returns:

the error message.