RuntimeErrorEvent Error Codes
This runtime exeception can happen while developing and contain helpful informations or on run time. In this case app is not functional any more and triggers an automatic restart event.
SubSystem 500
MCSDK Error Codes caused by ASM-Service
| Code | Enum | Description |
|---|---|---|
| 500000001 | GENERAL_ERROR | General error |
| 500000002 | INVALID_ACTION | Failed to check App Version: Invalid action |
| 500000003 | ILLEGAL_STATE | Client session is in an illegal state |
| 500000004 | NO_SUCH_ALGORITHM | Cannot generate random number |
| 500000005 | CONNECTION_NOT_SECURED | Connection must be secured for this command |
| 500000006 | LICENCE | License error occurred |
| 500000007 | USER_NOT_FOUND | User does not exist |
| 500000008 | APPVERSION_NOT_FOUND | App version does not exist |
| 500000009 | NO_DEVICE_FOR_CERT | No device found for the certificate |
| 500000010 | USER_NOT_MAPPED | Device's certificate is not mapped to a user |
| 500000011 | SIGNED_CONTENT_INVALID | This error indicates the provided signed content is either corrupted or does not match the expected signature, preventing proper verification of its integrity. |
| 500000012 | TRANSACTION_CERT_NOT_FOUND | Invalid signed content |
| 500000013 | CREATE_HASH_FAILED | Failed to create digest |
| 500000014 | CERT_SIGNING_CREATION_FAILED | Issue with certificate signing/creation |
| 500000015 | CERT_REQUEST_DECODING_FAILED | Issue with certificate request decoding |
| 500000018 | DEVICE_SIGNATURE_INVALID_ALGORITHM | Invalid signature algorithm |
| 500000019 | DEVICE_SIGNATURE_INVALID_PUBKEY | Invalid public key |
| 500000020 | DEVICE_SIGNATURE_INVALID_SIGNATURE | Invalid signature |
| 500000021 | DEVICE_SIGNATURE_SIGNED_DATA_INVALID | Signed data is invalid |
| 500000022 | DEVICETYPE_NOT_FOUND | Device type does not exist |
| 500000023 | CERT_ALREADY_IN_DB | Certificate already exists in the database |
| 500000024 | DEVICEKEY_ENCRYPTION_FAILED | Cannot decrypt device key from the database |
| 500000025 | APP_REGISTRATION_USER_NOT_REGISTER_USER | User is not authorized to register the app |
| 500000026 | USER_NOT_TEST_USER | TestApp: User is not authorized to test the app |
| 500000028 | NOT_VIRTUAL_DEVICE | Device is not a virtual device |
| 500000029 | LOCKED_CERTIFICATE | Device's certificate is locked |
| 500000030 | RETRIES_EXCEEDED | Virtual device retry counter exceeded |
| 500000031 | USER_LOCKED | User is locked (by administrator) |
| 500000032 | TRANSACTION_INVALID_COMMANDSTATUS | Invalid command status in TransactionResponse |
| 500000033 | USER_TEMPORARILY_LOCKED | User is temporarily locked (e.g., RetryCounter exceeded) |
| 500000034 | CERTIFICATE_EXPIRED | Certificate is expired |
| 500000035 | CERTIFICATE_NOT_YET_VALID | Certificate is not yet valid |
| 500000036 | DEVICE_SIGNATURE_CERT_NOT_FOUND | Certificate not found for the device |
| 500000037 | CERTIFICATE_NOT_MAPPED_TO_USER | Certificate is not mapped to a user |
| 500000038 | SESSION_PRESUMABLY_CLOSED | Server received data for a closed session |
| 500000039 | NO_ISSUER_CERTIFICATE | Issuer certificate not found |
| 500000040 | INVALID_CERTIFICATE | Invalid certificate |
| 500000041 | NO_OTP_FOUND | OTP not found in session |
| 500000042 | APPNAME_MISSING | Hardware device does not provide an app name |
| 500000044 | APPVERSION_NOT_REGISTERED | App version is not registered |
| 500000045 | NO_TRANSACTION_DATA_STORED | No transaction data stored in session |
| 500000046 | SESSION_CLOSED | SSMS closed the session |
| 500000047 | APPVERSION_NOT_CONFIGURED_FOR_USER | App version is not configured for the user |
| 500000048 | UPDATE_VERSION_MISSING | Update version is missing |
| 500000049 | NOT_UPDATABLE_APPVERSION_EXPIRED | App version that doesn’t support the update process is expired |
| 500000052 | APP_VERSION_NOT_FOUND | App version not found in database |
| 500000053 | DEVICE_TEMPORARY_LOCKED | Device is temporarily locked |
| 500000054 | TEMPLATE_RESOLUTION_ERROR | Error resolving template |
| 500000055 | TRANSACTION_INVALID_NULL | Transaction parameter is null or invalid |
| 500000056 | INVALID_DATA | Server received invalid data |
| 500000057 | P2S_MESSAGE_INVALID_SIGNATURE | Invalid signature for P2S-Message |
| 500000058 | TENANT_CANNOT_REGISTER | Inheritable apps can only be registered in the master tenant |
| 500000059 | INHERITABLE_VERSION_EXPECTED | Inheritable version must be used (e.g., session key decrypted with master’s Asmca) |
| 500000060 | INVALID_CSR_PROFILE | Certificate signature request's key usage and extended key usage extensions do not match defined profiles |
SubSystem 800
MCSDK Error Codes caused by Backend (SSMS, SCP, IdP, ABS and other services)
| Code | Enum | Description | Troubleshooting |
|---|---|---|---|
| 800000001 | kNotExistScpConfigOnStartRuntimeError | SDK config not exist | Helpful while developing see if file is installed |
| 800000002 | kUnexpectedErrorGetScpConfigOnStartRuntimeError | Error retriving SDK Config | Helpful while developing see if file is installed |
| 800000003 | kNotExistStatusGetResultEventOnStartRuntimeError | SCP Config not exist | Helpful while developing see if file is installed |
| 800000004 | kUnknownStatusGetResultEventOnStartRuntimeError | Unexpected error during get SCP Config | Helpful while developing see if file is installed |
| 800000005 | kSCPConfigJsonParseRuntimeError | Parse error of SCP Config | UC37StartMCWithoutUrls |
| 801000008 | kSdkConfigParsingFailed | Raised if it it was not possible to parse the sdk config | maybe file is corrupt or not existant |
| 801000009 | kVerifyingSdkConfigFailed | Raised if it was not possible to verify the sdk config | maybe file is corrupt |
| 800000190 | kMcConfigJsonParseRuntimeError | MC config json parse error | UC37StartMCWithoutUrls |
| 800000191 | kMcConfigJsonMissingScpSectionRuntimeError | Missing scp section in mc config json | UC37StartMCWithoutUrls |
| 800000192 | kMcConfigJsonMissingTokenIssuerUrlRuntimeError | Missing token issuer url in scp section of mc config json | UC37StartMCWithoutUrls |
| 800000193 | kMcConfigJsonMissingIamSectionRuntimeError | Missing iam section in mc config json | UC37StartMCWithoutUrls |
| 800000194 | kMcConfigJsonMissingSmartScreenSectionRuntimeError | Missing smart screen scection in mc config json | UC37StartMCWithoutUrls |
| 800000197 | kMcConfigJsonMissingIamRuntimeError | Missing client id in iam section of mc config json | UC37StartMCWithoutUrls |
For legacy reasons we needed to keep the old Subsystem/ErrorCode logic here. Given the one error code MCSDK is providing, the least six significant digits are the ErrorCode while the remaining most significant digits are the SubSystem
| Error Code | Sybsystem | Description | Troubleshooting |
|---|---|---|---|
| 6 | 32, 102, 202, 602 | The user credentials folder cannot be parsed for user credentials. Normally the path is invalid or not accessible. | Secure storage of a device not available. User should unlock device before MCSDK usage |