Retrieving and Installing your license certificate
From CometWiki
| (5 intermediate revisions not shown) | |||
| Line 4: | Line 4: | ||
To run it directly simply run SecLic from READY: | To run it directly simply run SecLic from READY: | ||
| + | |||
[[image:SecLic.jpg]] | [[image:SecLic.jpg]] | ||
| + | |||
To run it silently from your own app, you pass your choice of options via # buffer this way: | To run it silently from your own app, you pass your choice of options via # buffer this way: | ||
print (#) "OPT 1" | print (#) "OPT 1" | ||
| + | |||
enter "SecLic" dir="REL" | enter "SecLic" dir="REL" | ||
| + | |||
input (#) Result$ | input (#) Result$ | ||
| Line 15: | Line 19: | ||
* 1 - retrieve the latest certificate from the server and put it in the CometServices folder | * 1 - retrieve the latest certificate from the server and put it in the CometServices folder | ||
* 2 - activate whatever certificate is in the CometServices folder | * 2 - activate whatever certificate is in the CometServices folder | ||
| - | * 3 - retrieve and then activate | + | * 3 - retrieve and then activate |
| + | * 4 - retrieve expiration dates and license counts for currently installed certificate | ||
The message you pass via the # buffer is case insensitive and any number of blanks are allowed between "opt" and the number. If the first 3 bytes of the buffer are anything other than ucase("opt") the dialog will display instead of running silently. | The message you pass via the # buffer is case insensitive and any number of blanks are allowed between "opt" and the number. If the first 3 bytes of the buffer are anything other than ucase("opt") the dialog will display instead of running silently. | ||
| Line 24: | Line 29: | ||
SecLic was added to the REL release in version 10.02 and requires Comet version .413 or higher and Comet Security Server version 10.0 or higher. | SecLic was added to the REL release in version 10.02 and requires Comet version .413 or higher and Comet Security Server version 10.0 or higher. | ||
| + | |||
| + | ---- | ||
| + | |||
| + | === Notes for Option 4 === | ||
| + | |||
| + | Option 4 was first released with Comet Security Server version 23.0, and requires REL version 23.01 | ||
| + | |||
| + | When run directly, the seclic program will have a button on the top of the screen titled "Check currently installed certificate" which, when pressed, will pop up a message box with license counts and expiration dates for your currently installed certificate. | ||
| + | |||
| + | [[image:Seclic-new.png]] [[image:Seclic-newmsg.png]] | ||
| + | |||
| + | |||
| + | When ENTERed, specifying "OPT 4" will return the data in a 31 byte string with the following format: | ||
| + | |||
| + | <nowiki> | ||
| + | Position Length Description | ||
| + | =========================================================== | ||
| + | 1 8 Certificate Expiration Date | ||
| + | 9 8 XAP Expiration Date (if applicable) | ||
| + | 17 5 Number of Full Comet licenses | ||
| + | 22 5 Number of Comet Anywhere licenses | ||
| + | 27 5 Number of XAP licenses | ||
| + | </nowiki> | ||
| + | |||
| + | If an error occurs, the return string will have the following format: "-ERR -- error message" | ||
Latest revision as of 00:38, 1 July 2023
SecLic - Comet License Retrieval / Installation Utility
SecLic is a utility which allows the retrieval and/or installation of the latest license certificate for your Comet Security Server. The license will be retrieved directly from a Signature Systems server and will be the most recent one issued for your security token. SecLic may be run either directly as a user utility or incorporated into your own application and ENTERed to run silently. Just be sure to have a WinSock gateway configured (a type 3 gateway).
To run it directly simply run SecLic from READY:
To run it silently from your own app, you pass your choice of options via # buffer this way:
print (#) "OPT 1"
enter "SecLic" dir="REL"
input (#) Result$
There are 3 options:
* 1 - retrieve the latest certificate from the server and put it in the CometServices folder * 2 - activate whatever certificate is in the CometServices folder * 3 - retrieve and then activate * 4 - retrieve expiration dates and license counts for currently installed certificate
The message you pass via the # buffer is case insensitive and any number of blanks are allowed between "opt" and the number. If the first 3 bytes of the buffer are anything other than ucase("opt") the dialog will display instead of running silently.
The result string will indicate the success or failure of the operation(s). It will begin with either "+OK" or "-ERR" and be followed by a descriptive message.
This utility is available on both Comet16 and Comet32 and for both USB and parallel plugs.
SecLic was added to the REL release in version 10.02 and requires Comet version .413 or higher and Comet Security Server version 10.0 or higher.
Notes for Option 4
Option 4 was first released with Comet Security Server version 23.0, and requires REL version 23.01
When run directly, the seclic program will have a button on the top of the screen titled "Check currently installed certificate" which, when pressed, will pop up a message box with license counts and expiration dates for your currently installed certificate.
When ENTERed, specifying "OPT 4" will return the data in a 31 byte string with the following format:
Position Length Description =========================================================== 1 8 Certificate Expiration Date 9 8 XAP Expiration Date (if applicable) 17 5 Number of Full Comet licenses 22 5 Number of Comet Anywhere licenses 27 5 Number of XAP licenses
If an error occurs, the return string will have the following format: "-ERR -- error message"
