Using the REST API, details of the license and the current status of subscription based licenses (when applicable) in cOS Core can be retrieved. The information is sent back by cOS Core in JSON format and consists of the values that can also be provided by using the cOS Core CLI license command.
The license shows information about registration key, subscription details and status of subscription based licenses (SECaaS).
Sending the Request
To retrieve license information from cOS Core, an HTTP GET should be sent as follows:
/api/oper/license
SECaaS Specific Information
Status can have the values "Running normally", "Local lockdown mode", "Demo mode" and "Reduced functionality mode".
When Seconds_until_reduced_mode is set to "-1" then the system is running normally, otherwise it will show the number of seconds until the firewall goes into reduced mode.
An Example JSON Reply
Below is an example of a typical JSON reply for an IP rule set with a single entry:{ "error": false, "license": { "registration_key": "1234-1234-1234-1234", "subscription_based": true, "issued_date": "2023-10-26", "lastmodified_date": "2023-10-21 22:04:23", "expiration_date": "2023-12-01", "techsupport_date": "2023-12-01", "idp_date": "2023-12-01", "av_date": "2023-12-01", "wcf_date": "2023-12-01", "di_date": "2023-12-01", "dcc_date": "2023-12-01", "incenter_date": "2023-12-01", "iprep_date": "2023-12-01" }, "secaas": { "status": "Running normally", "server_reached": true, "last_reached": "2023-10-31 11:52:43", "last_attempt": "2023-10-31 11:52:42", "last_result": "License is up to date", "seconds_until_next_attempt": 14384, "seconds_until_reduced_mode": -1 } }