Allocate licenses for organizations, applications, and servers

Before you begin
Steps
  1. See an overview of license usage in an organization:

    1. From the user menu, select Organization settings.

    2. Select Organization.

    3. Under Licensing, view information about Assess and Protect licenses:

      • Available and used Assess (application) licenses, as well as how many applications are unlicensed

      • Available and used Protect (server) licenses as well as how many servers are unlicensed

      • To view expiration dates for licenses, hover over the bars for Assess licenses or Protect licenses. You can view expiration dates for used and unused licenses.

        LicenseExpiration.png
  2. (Optional) Under Licensing, automatically apply licenses to new applications or servers:

    1. For Assess licenses, turn on Automatically apply licenses to new applications.

      Image shows option for for applying licenses to applications automatically
    2. For Protect licenses, turn on Automatically apply licenses to new servers. Select the box next to the setting and select the server environments.

      This image shows the option for applying licenses to servers automatically

      The Protect settings in an agent configuration file override this setting for the server hosting that application.

      For example, if you turn on this setting and the setting for Protect in an agent configuration file is set to false, Contrast turns off Protect for the server hosting that application. No Protect licenses are applied to the server.

  3. If needed, apply Assess licenses to individual applications:

    1. Select Applications in the header.

      In the applications lisat, applications that are unlicensed show Unlicensed after their name.

      You cannot view vulnerability data for the application if it is unlicensed.

    2. To apply a license to an unlicensed application, select Unlicensed.

    3. In the Apply License window, select Apply License.

  4. If needed, remove Assess licenses from applications by deleting the application.

    Licenses applied to applications permanently count towards the number of maximum allowable applications. Deleting a licensed application has no effect on the number of licenses you are allowed to apply to applications

  5. If needed, add or remove Protect licenses from individual servers:

    1. Select Servers in the header.

    2. Turn the Protect setting on or off for the server.

      This image shows the Protect option in the off state
    3. Restart applications that the server is hosting.

    Important

    The Protect setting in an agent configuration file overrides this setting.

Protect license behavior

Contrast applies Protect licenses automatically to servers when these conditions exist:

  • Protect is turned on for an organization.

  • Automatic application of Protect licenses are turned on for an organization.

  • A server exists in one or more environments where automatic licensing is turned on.

If you also use the Protect setting in an agent configuration file, it overrides the license behavior in the following ways:

  • Protect is turned on in the agent configuration file

    • If no Protect licenses are available when the application starts, Contrast tries to apply a license to the server every time the agent communicates with Contrast.

  • Protect is turned off in the agent configuration file

    • If Protect is turned off for the server, based on an organization setting or you turn off Protect after the server is registered with Contrast, no license is applied.

    • If Protect is turned on for the server, based on an organization setting or you turned on Protect after the server is registered with Contrast, a license is applied, however Protect is turned off in the agent.