CPC View is licensed for full operation on a particular computer through the installation of the CPC View registration key for that computer. The registration key is an alphabetic string that is derived from a numeric machine identifier that is unique for each computer.
In order to script the licensing of the viewer from a prepaid account, the following three steps are required:
To determine the machine identifier, simply embed an instance of CPC View with the appropriate redirect parameter. The following example will cause CPC View to redirect the host browser to the URL reg.cgi?arch=xxx, where xxx is the machine identifier. reg.cgi is evaluated relative to the URL of the containing page.
The HTTP request should be issued to the URL http://www.cartesianinc.com/Prepaid/Ops/GetLicense.cgi. The following parameters must be specified in the HTTP request:
Name Description accountID The account ID of your prepaid account accountPW The normal password for your prepaid account machineID The machine identifier for which to retrieve the registration key
For security purposes, it is recommended that you use a POST operation to submit the request. If you use a GET operation, the account password will be exposed in clear text in the URL of the operation. For further security, you should POST to https://www.cartesianinc.com/Prepaid/Ops/GetLicense.cgi, thereby encrypting the data while it is in transit.
Once the HTTP request returns, you will need to examine the resulting text page to extract the registration key. If the request was successful, the resulting text will contain a single <RegKey> block, which contains the registration key.
If an error occurs, the resulting text page will contain a single <Error> block, which contains a text message describing the error:
The only error that is expected during normal operation is There are no more licenses in the account.
All other errors indicate a problem in either the submitted request or the internal operations of the Cartesian
For example, if the registration key is 00BC614Efogututu, the following HTML can be used to install the key.
|© 1998-2006 Cartesian Products, Inc.||Contact Cartesian|