Important Notice for ReadyAPI Customers
ReadyAPI has fully transitioned to the ID-based SmartBear License Management (SLM) system. We are now moving into the final phase of deprecation of file-based licenses. Customers still using file-based licensing need to plan for migration to SLM before September 30, 2025.
If you are still in the process of migrating or have yet to start, contact your Account Manager or SmartBear representative today. Our teams are ready to assist with smooth transition strategies. For additional support, please log a request with our Customer Care Team, who are standing by to help.
For further information and timelines, please refer to this page.
You use the Licensing Server Management Console to create, change, and delete user accounts and user groups on the license server.
Note
You can import user accounts from an LDAP server if needed. To automate the creation of user accounts, consider changing the configuration file that the license server uses.
The Management Console executable is in the <Protection! Licensing Server installation>\bin
folder, for example, C:\Program Files\ProtectionLS 4.9.0\bin\ManagementConsole.exe
. Run this executable.
Tip
You do not need to run the Management Console on the same machine where you run the license server. If needed, you can connect the console to the license server running on a remote machine.
In the Management Console, switch to the License Storage tab:
Select Edit > License Users:
In the License Users dialog, click New.
Configure the user attributes:
Option
Description
Name
The username that is displayed in the interface.
Username
The name the user has in the system. Usually, the same name is used to log in to the computer.
Important
This value is case-sensitive.
Host
The user's computer name.
IP Address
The user’s private IP address. Only IPv4 addresses are supported.
If necessary, associate a user with an already existing user group on the Member Of tab.
Click OK in both dialogs to save the changes.
Switch to the License Storage tab:
Select Edit > License User Groups:
In the License User Groups dialog, click New.
Configure the user group attributes:
Option
Description
Name
The user group name that is displayed in the interface.
Host
The range of computer names of users that can belong to the group. Supports the
*
and?
wildcards.IP Address
The range of IP addresses of users that can belong to the group. Supports the
*
and?
wildcards. Only IPv4 addresses are supported.If necessary, add the existing users to the group or remove them from it on the Members tab.
You can also add users from the LDAP directory to the group. To learn how to do this, see Work With LDAP Servers.
Click OK in both dialogs to save the changes.
To provide users with access to the installed license, you need to configure user group settings:
Select the license file from the License Entries list, then click Add User on the Allocation tab of the toolbar on the right:
The following dialog will appear:
In the dialog, select the desired group and click OK.
To delete a user or user group, open the corresponding dialog and click Delete.
You can create block lists and allow lists to limit users who can work with licenses. The lists work on several levels:
List | Applies to |
---|---|
Global | Any actions with licenses. |
Lock License – Named User | Requests for licenses that use the Named User Licensing model. |
Lock License – Floating User | Requests for licenses that use the Floating User Licensing model. |
Obtain License | Requests to obtain a license from the license server. |
![]() |
To configure the lists:
Select Edit > Access Control List > <The List You Need> > <White or Black> List Conditions.
In the Conditions dialog, click New or New Complex and configure the condition you need. You can find detailed instructions in the license server documentation.
![]() |
You can get usage reports for your licenses on the Summary page. Click Download Reports in the Licensing Statistics tile. Then, select the report you need:
Usage per User – The number of licenses each user uses on the server.
Total Users (Succeeded) – Information about users who successfully checked out a license.
Total Users (Failed) – Information about users who failed to check out a license.
Statistics – Overall information about the license operations.
All reports are created in the .csv
format.