Error Messages Returned by Trusted Device Microservice
- 22 Oct 2024
- 8 Minutes à lire
- SombreLumière
Error Messages Returned by Trusted Device Microservice
- Mis à jour le 22 Oct 2024
- 8 Minutes à lire
- SombreLumière
The content is currently unavailable in French. You are viewing the default English version.
Résumé de l’article
Avez-vous trouvé ce résumé utile ?
Merci pour vos commentaires
The error message the Trusted Device microservice and its endpoint return fall into different categories, marked with error code ranges.
Orchestration errors | ||
Category | Error code range | Examples |
|---|---|---|
System | [-1099, -1000] | Issues with the connection, a microservice, the database, or unexpected internal server issues. See also System error messages. |
User account | [-1199,-1100] | The user is locked, disabled, does not exist, etc. See also User account error messages. |
Provisioning | [-1299,-1200] | Problems with the ephemeral key, activation code, activation password, registration ID, authenticator limit, etc. See also Provisioning error messages. |
Authenticator | [-1399,-1300] | Problems with the decryption or encryption on the server side, the verification of signatures, OTPs, or secure messages, the creation of secure messages etc., or authenticator not found and/or not assigned. See also Authenticator error messages. |
Session | [-1499,-1400] | Request ID not found. See also Session error messages. |
Authentication | [-1699,-1600] | Authentication failure during authentication validation. See also Authentication error messages. |
Transaction | [-1799,-1700] | Transaction failure during signature validation. See also Transaction error messages. |
The following system error messages are possible:
System error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1000 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1001 | Communication Error | Input data validation failed. | GENERIC |
| Verify the mobile app integration with the Orchestration SDK , contact support@onespan.com for Mobile Security Suite. |
-1002 | Internal Server Error | Failed to decode input data | UNKNOWN | Calling the orchestration messaging failed for technical reasons. | Contact support@onespan.com for OneSpan Cloud Authentication. |
-1003 | Internal Server Error | Failed to encode output data | UNKNOWN | Calling the orchestration messaging failed for technical reasons. | Contact support@onespan.com for OneSpan Cloud Authentication. |
-1004 | Internal Server Error | Failed to encode output data | UNKNOWN | The call to the orchestration messaging failed to encode an ErrorEncodeInput data transfer object. | Contact support@onespan.com for OneSpan Cloud Authentication. |
The following user account error messages are possible:
User account error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1100 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1101 | User account not found | userId: '%s', domain: '%s' | GENERIC | The user account is referenced by the mobile app but does not (anymore) exist in OneSpan Cloud Authentication. | Retry with a registered user account. |
-1102 | User account not | userId: '%s', domain: '%s' | GENERIC | The user account has been locked after multiple failed authentication attempts. | Unlock the user account with the POST /users/{userID@domain}/unlock endpoint |
-1103 | User account not | userId: '%s', domain: '%s' | GENERIC | The user account was disabled by an administrative call. | Enable the user account via the PATCH /users/{userID@domain}. |
-1104 | User account not | userId: '%s', domain: '%s' | GENERIC | User account past its expiration date | Contact support@onespan.com for OneSpan Cloud Authentication to enable user account (or use Web Administration interface of the Authentication component). |
-1105 | User account not | userId: '%s', domain: '%s' | GENERIC | The administration user account cannot be used. | |
The following provisioning error messages are possible:
Provisioning error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1200 | Internal Server Error | Client component does not exist. An internal error occurred while attempting to call dsappSrpGgenerateEphemeralKey | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Try to restart the workflow later, contact support@onespan.com for OneSpan Cloud Authentication. |
-1201 | The registration session was not found | GENERIC | The session expired. | Restart the activation workflow | |
-1220 | License not supported | GENERIC | The multi-device licensing (MDL) authenticator license assigned to the user account does not supportDSAPP-SRP activation for the Orchestration SDK. | Unassign the license from the user account and select another license (type DAL10). | |
-1221 | The authenticator activation limit has been reached | Number of activation attempts exceeds number allowed. | GENERIC | When the number of activation attempts exceeds the allowed limit for a given authenticator. | Reset the provisioning activation count of the license with the POST /authenticators/{serialNumber}/reset-activation endpoint. |
-1222 | Invalid client evidence message | GENERIC | The client-side DSAPP SDK or Orchestration SDK generated wrong data. One possible failure reason could be that the user entered invalid date (e.g., outdated activation password). | Try restarting activation or assigning a different MDL license to the user account, and contact support@onespan.com for Mobile Security Suite. | |
-1223 | Internal Server Error | Failed to encrypt activation data> | UNKNOWN | Encryption failed on the server side. | Retry later or try assigning a different MDL license to the user account, and contact support@onespan.com for OneSpan Cloud Authentication. |
-1230 | License not supported | GENERIC | The MDL authenticator license that is assigned to the user account does not support DSAPP-SRP activation for the Orchestration SDK. | Unassign the license from the user account and select another license (type DAL10). | |
-1231 | The authenticator activation limit has been reached | The authenticator limit has been reached | GENERIC | When the number of activation attempts exceeds the allowed limit for a given authenticator type. | Remove old, unused, and/or previously activated authenticator instances from the user account. |
-1232 | Invalid device code | GENERIC | The client-side Digipass SDK or Orchestration SDK generated wrong data. | Try assigning a different MDL license to the user account, and contact support@onespan.com for Mobile Security Suite. | |
-1240 | Invalid signature | GENERIC | The client-side Digipass SDK generated a wrong signature of Activation Message 2. | Try synchronizing the client time, or assigning a different MDL license to the user account, and contact support@onespan.com for Mobile Security Suite. | |
-1250 | Invalid push notification ID format | GENERIC | The client-side Digipass SDK, Notification SDK, or Orchestration SDK generated wrong data. | Try registering for Push Notificationagain and contact support@onespan.com for Mobile Security Suite. | |
-1251 | Failed to decrypt push notification ID | GENERIC | The client-side Digipass SDK, Notification SDK, or Orchestration SDK generated wrong data. | Try registering for Push Notificationagain and contact support@onespan.com for Mobile Security Suite. | |
The following authenticator error messages are possible:
Authenticator error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1300 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1301 | Authenticator not found | domain: '%s', serialNumber: '%s', sequence: '%d' | GENERIC | The user account does not have any assigned authenticator (anymore). | Register a new authenticator to the user account. |
-1302 | Invalid authenticator | domain: '%s', serialNumber: '%s', sequence: '%d' | GENERIC | The client requested to use an authenticator instance which does not support the required functionality. | Try assigning a different MDL license to the user account, contact support@onespan.com for Mobile Security Suite. |
-1303 | Payload incomplete | GENERIC | The client-side Digipass SDK, Secure Messaging SDK, or Orchestration SDK did not provide the complete Secure Channel message. | Contact support@onespan.com for Mobile Security Suite. | |
-1304 | Invalid message format | GENERIC | The client-side Digipass SDK, Secure Messaging SDK, or Orchestration SDK provided the Secure Channel message in an invalid format. | Contact support@onespan.com for Mobile Security Suite. | |
The following session error messages are possible:
Session error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1400 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1401 | Session not found | requestId: '%s' | GENERIC | The request ID is invalid or has timed out. | Restart the workflow to generate a new session. |
The following Risk Management component error message is possible:
Risk Management component error messages | |||||
Error code | Message | Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1500 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
The following authentication error messages are possible:
Authentication error messages | |||||
Error code | Message | Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1600 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1601 | Authentication failed | GENERIC | The client provided invalid data like an invalid OTP, invalid password, etc. | Provide the valid data (OTP, password) required for authentication, try synchronizing the client time. | |
The following transaction error messages are possible:
Transaction error messages | |||||
Error code | Message | Examples: Custom payload / additional message | Error type | Cause | How to solve |
|---|---|---|---|---|---|
-1700 | Internal Server Error | UNKOWN | This is an unexpected error and needs to be investigated by the OneSpan support staff. | Contact support@onespan.com for OneSpan Cloud Authentication. | |
-1701 | Signature validation failed | GENERIC | The client provided invalid signature data. | Provide valid signature data based on the transaction fields, try synchronizing the client time. | |
Cet article vous a-t-il été utile ?