Skip to main content

Error Codes

Error codes that the server emits. Currently, this page does not list all errors.

License​

e-Protector (HASP)​

error:license:hasp:driverNotInstalled​

The driver required to operate e-Protector is not installed. Please install the driver from the "Settings" tab of the control panel.

error:license:hasp:expired​

The validity period of e-Protector has expired. Please update e-Protector using a magic number.

error:license:hasp:fingerprint:haspAlreadyEnabled​

A fingerprint file cannot be obtained if e-Protector is already installed.

error:license:hasp:invalid​

The contents of e-Protector are invalid. Please contact your sales agent or Asprova Corporation.

error:license:hasp:licenseApiNotFound​

The executable file required to operate e-Protector was not found.

error:license:hasp:magicnumber:incorrectlyFormatted​

error:license:hasp:unknownLicenseType​

The contents of the magic number are invalid. Please check for any copy-and-paste errors. If the problem persists, please contact Asprova Corporation.

error:license:hasp:magicnumber:expired​

An attempt was made to apply a magic number, but the license included in the magic number has expired. Please check for any copy-and-paste errors. If the problem persists, please contact Asprova Corporation.

error:license:hasp:magicnumber:serialNotMatching​

An attempt was made to apply a magic number, but the serial number did not match. Please check for any copy-and-paste errors. If the problem persists, please contact Asprova Corporation.

error:license:hasp:notAvailable​

e-Protector is not available. If you are not using e-Protector, no action is required. If you are using e-Protector for license authentication and this error occurs, please contact Asprova Corporation.

error:license:hasp:notStarted​

The validity period of e-Protector has not started yet. Please update e-Protector using a magic number.

error:license:hasp:unknown​

An unknown error occurred. We apologize for the inconvenience; please contact Asprova Corporation.

error:license:hasp:updateConsistencyFailed​

The HASP key's internal data failed a consistency check during a certificate-file or update operation. If the problem persists, please contact Asprova Corporation.

error:license:hasp:backup:invalidDummyLicense​

An attempt was made to activate the backup e-Protector, but the backup e-Protector could not be found.

error:license:hasp:backup:alreadyActivated​

An attempt was made to activate the backup e-Protector, but it has already been activated.

error:license:hasp:backup:notActivated​

The installed backup e-Protector has not been activated yet. Please activate the backup e-Protector before continuing.

error:license:hasp:locked​

The operation was blocked because another operation is currently in progress. Please wait and try again. If the problem persists even after waiting, please restart the server.

Certificate file (HASP .v2c)​

Errors raised when applying or cancelling a HASP certificate file (.v2c).

error:license:hasp:certificateFile:notFound​

The certificate file referenced by the operation could not be found.

error:license:hasp:certificateFile:invalid​

The certificate file could not be applied because its contents are invalid. Please check the file.

error:license:hasp:certificateFile:saveFailed​

After applying a certificate file or cancellation file, the resulting log file could not be saved.

License file (WS)​

Errors raised while loading, decrypting, parsing, or validating the WS license file (aslicense{serial}.txt).

error:license:hasp:licenseFile:notFound​

The WS license file could not be read at the expected path.

error:license:hasp:licenseFile:hexInvalid​

A row in the WS license file is not valid hex (wrong length, wrong block-size alignment, or contains non-hex characters).

error:license:hasp:licenseFile:decryptFailed​

A row in the WS license file could not be AES-decrypted. Most commonly indicates a wrong serial-number key.

error:license:hasp:licenseFile:nonPrintableAscii​

A row in the WS license file decrypted, but the resulting bytes contain a control character or non-ASCII byte. The BackEnd's magicnumber plaintext is always printable ASCII (0x20–0x7E) plus trailing NUL padding, so this typically indicates a wrong key (serial-number mismatch) or corrupted ciphertext.

error:license:hasp:licenseFile:tooFewCells​

A row in the WS license file has fewer fields than the minimum required by the row schema.

error:license:hasp:licenseFile:parseFailed​

A field in the WS license file could not be parsed as the expected type (e.g. a non-numeric value in an integer field).

error:license:hasp:licenseFile:renewalMismatch​

A row in the WS license file has a renewal count that does not match the e-Protector's renewal count. The license file may be stale relative to the e-Protector.

error:license:hasp:licenseFile:serialMismatch​

A row in the WS license file has a serial number that does not match the e-Protector's serial number. The license file may belong to a different key.

error:license:hasp:licenseFile:duplicateSubSerial​

The WS license file contains two or more rows with the same subSerialNo. The file is structurally invalid.

error:license:hasp:licenseFile:rawLineRejected​

A raw plaintext WS license row was found in a non-development environment. Raw rows are only accepted when mock e-Protector mode is configured.

Mock mode (development only)​

error:license:hasp:mockMode:unsupported​

Emitted only when mock e-Protector mode is configured ({user_file_directory}/config/mockEProtectorData.json is present) and the caller invokes an operation that touches real HASP hardware (read memory, fingerprint, magicnumber, create, cancel, backup). Will not be seen in production.

Legacy (older client versions)​

The codes below were emitted by older server versions. Current builds emit codes under "Certificate file" or "License file (WS)" instead. They are retained here so user-facing strings produced by older deployments still reference an entry.

error:license:hasp:applyLicenseFile:file:invalid​

Legacy. Equivalent to certificateFile:invalid (HASP certificate-file create/cancel) on current builds. WS license file decrypt/parse/validate failures are now reported under one of the licenseFile:* codes.

error:license:hasp:applyLicenseFile:file:notFound​

Legacy. Equivalent to certificateFile:notFound (HASP certificate-file create/cancel) or licenseFile:notFound (WS license file) on current builds.

error:license:hasp:applyLicenseFile:file:saveFailed​

Legacy. Equivalent to certificateFile:saveFailed on current builds.

error:license:hasp:file:malformed​

Legacy. Equivalent to one of the licenseFile:* codes (most commonly licenseFile:decryptFailed, licenseFile:serialMismatch, or licenseFile:renewalMismatch) for WS license file errors, or updateConsistencyFailed for HASP-key update consistency failures, on current builds.

Project​

Invitations​

Errors raised while accepting, or signing up through, a project invitation.

error:project:invitation:not-found​

A signup request included an invitation parameter, but no invitation with that id exists (it may have been mistyped, deleted, or never created). The signup is rejected rather than silently creating an ordinary account with no project access.

error:project:invitation:not-inviting-status​

The invitation is no longer pending — it has already been accepted, rejected, or cancelled — so it cannot be used again. Each invitation is single-use. Returned both when accepting such an invitation and when signing up through one.

error:project:invitation:not-target-user​

The invitation is addressed to a specific user, and the account trying to accept it is not that user. Open invitations (those with no designated target) do not produce this error.

error:project:invitation:designated-user-already-exists​

The invitation reserved an account id for the user it onboards, and that account has already been created (the invitation was already used to sign up). A designated invitation can create its user only once.