Skip to main content

Enumerations and Bitsets

AuthenticationMode

Represents the authentication mode.

Objective-C - KSMAuthenticationMode

Java - AuthenticationMode

Values

JavaObjective-CDescription
NOKSMAuthenticationModeNoIndicates that no interactive authentication is required to access user credentials.
BIOMETRICKSMAuthenticationModeBiometricIndicates that biometric authentication is required to access user credentials.
PASSWORDKSMAuthenticationModePasswordIndicates that password authentication is required to access user credentials.
PINKSMAuthenticationModePinIndicates that device PIN authentication is required to access user credentials.

BannerType

Represents the banner type.

Objective-C - KSMBannerType

Java - BannerType

Values

JavaObjective-CDescription
DISPLAY_MESSAGEKSMBannerTypeDisplayMessageIndicates that a display message is waiting to be processed.
TRANSACTIONKSMBannerTypeTransactionIndicates that a transaction is waiting to be processed.

ConfirmationType

Represents the transaction confirmation type

Objective-C - KSMConfirmationType

Java - ConfirmationType

Values

JavaObjective-CDescription
OKKSMConfirmationTypeOkIndicates that the transaction is successfully processed and accepted.
CANCELKSMConfirmationTypeCancelIndicates that transaction processing is cancelled.
TIMEOUTKSMConfirmationTypeTimeoutIndicates that transaction processing is timed out.

KeyAccessProtectionMode

Represents the key access protection mode.

ValueDescription
NoIndicates that no interactive authentication is required to access keys from the device key strorage.
BiometricIndicates that biometric authentication is required to access user keys from the device key strorage.
DeviceCredentialIndicates that device PIN is required to access user keys from the device key strorage.

MessageType

Represents the display message type

Objective-C - KSMMessageType

Java - MessageType

Values

JavaObjective-CDescription
INFOKSMMessageTypeInfoIndicates an info display message
WARNINGKSMMessageTypeWarningIndicates an warning display message
ERRORKSMMessageTypeErrorIndicates an error display message

SdkState

Represents the SDK state.

Objective-C - KSMSdkState

Java - SdkState

Values

JavaObjective-CDescription
UNINITIALISEDKSMUninitialisedIndicates that the SDK has failed to initialise. Check the error code and description in the result event.
ACTIVATION_REQUIREDKSMActivationRequiredIndicates that the SDK has successfully initialised but there are no activated users.
LOGIN_REQUIREDKSMLoginRequiredIndicates that the SDK has successfully initialised, and there are already some activated users who may log in. The activated user list is provided in the result event.
UNIDENTIFIEDKSMUnidentifiedIndicates that the SDK has successfully initialized, but some internal error occurred during user activation or deactivation. Check the error code and description in the result event.

StatusType

Objective-C - KSMEventStatusType

Java - StatusType

Values

JavaObjective-CDescription
OKKSMOKThe process was completed successfully.
UPDATE_AVAILABLEKSMUPDATE_AVAILABLEAn update of the app is available. (Info only)
APP_REGISTEREDKSMAPP_REGISTEREDWill be sent from SSMS to the app when the app registration was successful. (Info only). The App must restart the SDK itself.
USER_CANCELKSMUSER_CANCELThe user cancelled a process, e.g. a transaction.
USER_CONFIRMATION_TIMEOUTKSMUSER_CONFIRMATION_TIMEOUTThe process was cancelled by a timeout.
INVALID_PINKSMINVALID_PINThe user entered a wrong pin.
UNKNOWN_VERSIONKSMUNKNOWN_VERSIONActivation and Logon process: The app has a wrong version.
UNKNOWN_CLIENT_TYPEKSMUNKNOWN_CLIENT_TYPEActivation and Logon process: The app has a wrong client type.
UPDATE_NECESSARYKSMUPDATE_NECESSARYThis version of the app was replace by a newer one and the user must update.
WRONG_CREDENTIALSKSMWRONG_CREDENTIALSActivation and Logon process: The user ID, activation code or the PIN are incorrect.
UNKNOWN_CERTIFICATEKSMUNKNOWN_CERTIFICATEUser removed on the ssms server
INTERNAL_ERRORKSMINTERNAL_ERRORAn internal error occurred during the process, usually a Runtimer Error
ACTIVATION_CODE_EXPIREDKSMACTIVATION_CODE_EXPIREDActivation process: The activation code expired.
LOCKED_CERTIFICATEKSMLOCKED_CERTIFICATEUser locked on ssms server
LOCKED_USERKSMLOCKED_USERUser locked on ssms server
PROPERTY_NOT_EXISTSKSMPROPERTY_NOT_EXISTSRequested property is not stored on SSMS or local DataBase.
INVALID_KEY_LENGTHKSMINVALID_KEY_LENGTHProperty key is too long.
NOT_UNIQUEKSMNOT_UNIQUESent property string is not unique for this user.
TEXT_TOO_LONGKSMTEXT_TOO_LONGSent property string is too long.
INVALID_STATEKSMINVALID_STATEThe MasterController is in a state where it can't proceed the corresponding event.
INVALID_PARAMETERKSMINVALID_PARAMETEROne of the parameters of the invoked event has an invalid format
INVALID_USER_IDKSMINVALID_USER_IDThe given userID is invalid (e.g. no user credentials are available)
USER_ID_ALREADY_EXISTSKSMUSER_ID_ALREADY_EXISTSUser credentials already exists for the given userID at the user credential path
REGISTER_APPKSMREGISTER_APPThe app isn't registered at SSMS
MISMATCHED_USERKSMMISMATCHED_USERThe certificate doesn't match to the user (e.g. typing error for the userID)
NEGATIVEKSMNEGATIVEA negative status has been occured usually this comes with an additional errorCode and subSystem
READ_ONLYKSMREAD_ONLYRequested property is a read only property
TEMPORARY_LOCKEDKSMTEMPORARY_LOCKEDLogon process: The user ID is temporary locked by entering wrong PINs.
NOT_SUSPENDEDKSMNOT_SUSPENDEDResume has been invoked although MasterController had not been suspended before
INVALID_PASSWORDKSMINVALID_PASSWORDInvalid password for the keystorage was provided
PASSWORD_BLOCKEDKSMPASSWORD_BLOCKEDPassword for the keytorage is blocked
ATC_EXPIRES_SOONKSMATC_EXPIRES_SOONThe ATC used for the OfflineFunctions will soon expire
ATC_EXPIREDKSMATC_EXPIREDThe ATC used for the OfflineFunctions is expired
NOT_REACHABLEKSMNOT_REACHABLEOperation could not be completed, because connection to SSMS was lost
PIN_BLOCKEDKSMPIN_BLOCKEDThe PIN is blocked
ACCESS_DENIEDKSMACCESS_DENIEDThe requested property cannot be accessed by the App
PROPERTY_EXISTSKSMPROPERTY_EXISTSThe requested property exists
TENANT_ID_ALREADY_SETKSMTENANT_ID_ALREADY_SETIf the Tenant ID has already been set in the sdk config, it is not allowed to set it via doActivation. If a user still tries to set it this status code is returned with onActivationEnd */
UNINITIALIZEDKSMUNINITIALIZEDThe underlaying module necessary to execute the invoked event is uninitialised
FAILEDKSMFAILEDThe execution of the invoked event failed. Usually this cannot be fixed from App side and a Restart is necessary
LOGIN_REQUIREDKSMLOGIN_REQUIREDThe execution of tehinvoked event requires an online login
ALREADY_INITIALIZEDKSMALREADY_INITIALIZEDThe underlaying module necessary to execute the invoked event is already initialised
GLOBAL_PIN_SETKSMGLOBALPINSETActivation was successful and the global PIN for the given user had been set
UPDATE_AVAILABLE_GLOBAL_PIN_SETKSMUPDATE_AVAILABLE_GLOBAL_PIN_SETAn update is available for the App but the global PIN had been set
INVALID_TOKENKSMINVALID_TOKENAn invalid token had been provided for a transaction
OFFLINE_NOT_ACTIVATEDKSMOFFLINE_NOT_ACTIVATEDThe invoked event needs offline capabilities which had not been activated before
NOT_SUPPORTEDKSMNOT_SUPPORTEDThe invoked event is not supported with teh given configuration
CONNECTION_LOSTKSMCONNECTION_LOSTThe invoked event requires vaid IDP Token data which are not available
NO_TOKEN_DATA_AVAILABLEKSMNO_TOKEN_DATA_AVAILABLEThe invoked event requires vaid IDP Token data but available data is expired
TOKEN_DATA_IS_OUTDATEDKSMTOKEN_DATA_IS_OUTDATEDAn error occured while trying to acquire fresh IDP tokens from IDP
CANNOT_ACQUIRE_TOKEN_DATAKSMCANNOT_ACQUIRE_TOKEN_DATAAn error occured while trying to acquire an authorization code from IDP
CANNOT_ACQUIRE_AUTHORIZATION_CODEKSMCANNOT_ACQUIRE_AUTHORIZATION_CODEAn error occured while trying to acquire fresh IDP tokens from IDP via the an acquired authorisation code
CANNOT_ACQUIRE_ACCESS_TOKEN_FOR_AUTHORIZATION_CODEKSMCANNOT_ACQUIRE_ACCESS_TOKEN_FOR_AUTHORIZATIN_CODEThe operation cancelled on server side, e.g. a transaction.
SERVER_CANCELKSMSERVER_CANCELThe underlying operation could not be completed due to connection issues. Used in DisplayConfirmationResult and TransactionEnd events.

SupportedFeatures

A bitset used to inform about the supported features.

Objective-C - KSMSupportedFeatures

Java - SupportedFeatures

Values

JavaObjective-CDescription
SECURE_ELEMENT bit is setKSMSecureElementIndicates that Secure Element is supported on the device