 |
Zentitle SDK and Library
|
When an activation request is generated, the library generates a "receipt" of that request. When the actual activation certificate is imported into the library, it is verified against this receipt. Because of the receipt, there may be only one outstanding offline activation request at a time.
The general process is:
1) Generate activation request 2) Input activation request at Nalpeiron and receive an activation certificate 3) Import activation certificate into the Nalpeiron library to activate
Once the process is initiated with step 1 it must be completed through step 3 within 2 weeks, and before generating any new activation request, see https://support.nalpeiron.com/hc/en-us/articles/360005255054-NSL-V10-Offline-Activation
To restart the process, delete the local receipt.
Clearing the local receipt may be done on the client by calling NSLImportCert() with the keyword "clear" in place of the certificate. Alternatively, deleting the workdir will also clear the receipt. If you restart the process in this manner, any certificate received from Nalpeiron in step 2 will no longer be valid for step 3 as there is no receipt to verify against.
The receipt is a security measure to prevent an offline activation from being used multiple times or on different machines. When the library initiates an offline transaction of some sort, it keeps a local record of the fact– the "receipt". That record stores the sort of transaction that has been requested, uniquely identifies the transaction, etc. When it receives the certificate that originated at the Nalpeiron server, it checks the certificate against the receipt. If the check fails an error is returned.
A -1114 error indicates that the receipt is missing.
Along these lines, a -1055 indicates that the receipt (or certificate) is invalid. Similarly, a -1121 indicates that a certificate request has already been initiated, and needs either to be completed or cleared.
Generate an activation request, which will create the missing receipt. Fully complete steps 2 and 3 as outlined above to finish the process.
1.8.9.1
