Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The current license key was introduced in January 2022. Some examples are shown below:

...

Image Removed

...

:

...

Image Modified

This type of key restricts users

...

as follows:

  1. Purchased CAST data = INSIGHT (stands for Imaging and/or any of the 3 Dashboards: these are defined as P1=Imaging, P2=Health, P3=Engineering, P4=Security)
  2. Named user for consumption = individual with a non-floating, unique and personal access rights to the purchased CAST data
  3. Period = the duration of the purchased License, the most typical terms being 3 months, 1 year, 3 years, 5 years, and perpetual

Legacy license type

The legacy key is accepted in all Dashboards regardless of release:

...

Info
  • A RESTRICTED key will have a specific number of GLOBAL and UNIT tokens assigned to it. In the example above, "2/4" tokens is equal to 2 GLOBAL tokens and 4 UNIT tokens.
  • An UNRESTRICTED key will not specify the number of GLOBAL and UNIT tokens assigned to it. In the example above, "2/4" tokens section is replaced by "Unrestricted".
  • This legacy license key is not limited in time and can be used indefinitely.

UI behaviour when using a legacy license key

All existing valid legacy license keys will function exactly as they are intended, however, if you are using one, users with the ADMIN role will now see a message explaining that a new license key type exists and that you should contact support to get more details. This message can be ignored for the time being, and all functionality will remain available:

Image Added

Image Added

Where do I obtain a license key from?

...

Or use the following option:

Image RemovedImage Added

The interface is available in the License tab:

...

Info

If you are using the standalone RestAPI JAR/WAR without a UI, you can define your license key using the legacy "license.key" file method for 1.x and 2.0 - 2.4 described below, or using the RestAPI itself.

When a key is successfully entered, the UI will update to show the license key details:

Image Added

1.x and 2.0 - 2.4 - legacy license.key file method

...

Code Block
languagetext
WAR 1.x
CATALINA_HOME\webapps\<dashboard>\WEB-INF\license.key

WAR ≥ 2.x
CATALINA_HOME\webapps\<dashboard>\WEB-INF\classes\license.key

ZIP ≥ 2.x
<unpacked_zip>\configurations\license.key

JAR ≥ 2.x
Windows: %PROGRAMDATA%\CAST\Dashboards\<dashboard>\license.key
Linux: /root/ProgramData/CAST/Dashboards/<dashboard>/license.key

Following any changes you make, restart your application server so that the changes are taken into account.

Info

This "legacy" method is still available for users of v. ≥ 2.5 but we would encourage you to use the UI method described above.

...

Note that the following statuses may be returned:

Use CaseStatusDescription
UNRESTRICTED
No LicenseNO_LICENSE_KEY
An unrestricted license has been successfully installed.
No license has been input in the UI (current license type) or no license.key file exists at the expected location (legacy type).
INVALID_LICENSE_KEYThe license.key file exists at the expected location but the license key itself does not conform to the expected format.
CANNOT_ACCESS_LICENSE_KEYThe license.key file exists at the expected location but the license key itself does not exist.
INVALID_LICENSE_FILEThe license.key file exists at the expected location but the license key itself does not conform to the expected format.
LICENSE_EXPIREDIndicates that the license key has expired.
Restricted LicenseRESTRICTED_LICENSEA restricted license has been successfully installed (legacy type only). Note that a current license key is always listed as "RESTRICTED_LICENSE".
GLOBAL_ACCESS_TOKENS_EXCEEDED

The number of GLOBAL tokens on a restricted license has been

exceeded

exceeded (legacy type only).

UNIT_ACCESS_TOKENS_EXCEEDEDThe number of UNIT tokens on a restricted license has been
exceeded
exceeded (legacy type only).
NO
Unrestricted LicenseUNRESTRICTED_LICENSE
_KEY
No license.key file exists at the expected location.INVALID_LICENSE_KEYThe license.key file exists at the expected location but the license key itself does not conform to the expected format.CANNOT_ACCESS_LICENSE_KEYThe license.key file exists at the expected location but the license key itself does not exist.INVALID_LICENSE_FILEThe license.key file exists at the expected location but the file is invalid or corrupt.
An unrestricted license has been successfully installed (legacy type only).

What happens if I attempt to access data when no license key is present?

If a user attempts to login to the dashboard when no license key has been configured, the following message will be displayed:

Image Added

Info
Note that users that have been granted the ADMIN role do not require a license key to access a Dashboard schema. Out of the box, no user in Default Authentication mode has this role.

Current license key tips

Use of license.xml file not required (current license key type only) for data authorization

The current license key type has no concept of RESTRICTED vs UNRESTRICTED unlike a legacy type license key (note that the RestAPI will always report a current license key as "RESTRICTED" however). This means that if you are using a current license key type, there is no need to define data authorization using the license.xml file as is the case with a legacy license key type (explained in the section below). All data authorization can be managed via the built in UI as described in Data authorization - 2.x and above.

What happens if more users than I am licensed for log in (current license key type only)?

When using a current license key, the number of users that are authorized to use the CAST Dashboards is always specified in the key:

Image Added

This is also shown in the UI:

Image Added

The UI provides a list of users that have logged in to the Dashboard/RestAPI - each entry will consume 1 user license. In the example below, 4 users have logged in and the count of "Associated Users" reflects this:

Image Added

In the example above, the number of users that have logged in to the Dashboard/RestAPI exceeds the number of authorized users (as defined in the license key) and in this situation a message will be displayed on every page in the dashboard as follows:

Click to enlarge

Image Added

No Format
There are too many authorized users to connect to your Dashboard. To avoid this limitation, you can contact your CAST Administrator to update your licensing terms & conditions.

If you receive the message described above, deleting users from the list of logged in users so that you conform to your licensing agreement will ensure that the message is removed:

Image Added

Info
Deleting users from this list does not delete the user itself, it simply deletes the record of the logged in user to reduce the Associated User count.

Legacy license key tips

Anchor
restricted
restricted
How to authorize users when using a RESTRICTED license key (legacy key type only)

If you have installed a restricted license key (i.e. a key that specifies the number of GLOBAL/UNIT tokens (legacy license key)), you can authorize named users to access either ALL the applications in all the target Dashboard schemas (a GLOBAL token), or you can authorize named users to access a named Application in a specific Dashboard schema (a UNIT token).

This authorization is achieved using the following XML file, which you can edit in a text editor - see Data authorization - 2.x and above and Data authorization - 1.x for more information:

Code Block
languagetext
WAR 1.x
CATALINA_HOME\webapps\<dashboard>\WEB-INF\license.xml

WAR ≥ 2.x
CATALINA_HOME\webapps\<dashboard>\WEB-INF\classes\license.xml

ZIP ≥ 2.x
<unpacked_zip>\configurations\license.xml

JAR ≥ 2.x
Windows: %PROGRAMDATA%\CAST\Dashboards\<dashboard>\license.xml
Linux: /root/ProgramData/CAST/Dashboards/<dashboard>/license.xml

Authorization is achieved by adding a line into the file. Each line you add to file will use up ONE single user (or GLOBAL or UNIT token.

Warning

Note that when a RESTRICTED license key is installed, any authorizations that you have configured in the user interface (see Data authorization - 2.x and above) or in the authorizations.xml file (see see Data authorization - 1.x) will be completely ignored. In other words:

  • only the authorizations listed in license.xml will be taken into account when a RESTRICTED license is installed.
  • it is not possible to define authorizations based on groups, the allUsers scope, patterns, tags, categories etc. when a RESTRICTED license is installed.

Authorize a named user to access ALL Applications in ALL the target Dashboard schemas

Add the following line under the commented text to grant the user "James" access to ALL applications. Doing so will use ONE single GLOBAL token:

...

Following any changes you make, save the license.xml file and restart your application server so that the changes are taken into account.

Authorize a named user to access a named Application in a target Dashboard schema

Add the following line under the commented text to grant the user "John" access to the "MEUDON" Application stored in the "V83_CENTRAL" Dashboard schema. Doing so will use ONE single UNIT token:

...

Following any changes you make, save the license.xml file and restart your application server so that the changes are taken into account.

What happens

...

with a RESTRICTED license key (legacy type only) if I authorize more users than I am licensed for?

Take the following situationThe situation listed below will cause you to be in breach of your license:

  1. You are using a RESTRICTED license key (i.e. a key that specifies the number of GLOBAL/UNIT tokens)
  2. You are limited to 2 GLOBAL tokens (2 users with ALL Application authorization) and 5 UNIT tokens (5 users with named Application authorization) on your license key
  3. You authorize (via the license.xml file) either:
    1. 3 users to access ALL Applications
    2. 6 users to access a named Application

In either situation you are in breach of your license. A As such, a message will be displayed on every page in the dashboard as follows:

No Format
≥ 2.x
There are too many authorized users to connect to your Dashboard. To avoid this limitation, you can contact your CAST Administrator to update your licensing terms & conditions.

1.x
THIS SOFTWARE IS SUBJECT TO A LIMITED ACCESS.
There are too many authorized users to connect to your Dashboard.
To avoid this limitation, you can contact your CAST Project Manager to update your licensing terms & conditions.

What should you do when you receive the "limited access" message?

If you receive the message described above, you have two options:

  1. Review and reconfigure the users that have been authorized to access data in the Dashboard schema using the license.xml file - i.e. decrease the number of users that have been granted access.
  2. Contact the CAST Consultant responsible for your project, or contact your Account Manager to request an update to your license.

What happens if I attempt to access data when no license key is present?

If a user attempts to login to the dashboard when no license key has been configured, the following message will be displayed:

Image Removed

...

  1. .