License Server Help

Configuring user restrictions

License server users can be limited by machine username, machine host and product they are trying to obtain a license for.

Whitelist

Whitelist describes restrictions for users who are allowed to obtain licenses from a license server. If whitelist configuration is empty, any person can obtain a license from the license server. Otherwise, only users who meet the requirements described in the whitelist are allowed to obtain licenses.

Blacklist

Blacklist describes restrictions for users who are prevented from obtaining licenses from license server. If blacklist configuration is empty, all users described in the whitelist configuration are allowed to obtain licenses. Otherwise, users who meet the requirements described in the blacklist are prevented from obtaining licenses.

Configuration

To configure user restrictions, create a file and describe the restrictions in the following format

{ "whitelist": [ { "product": "(Intellij IDEA Ultimate|ReSharper Ultimate|CLion)", "userName": "windowsuser.*", "hostName": ".*.itdept.company.net" }, { "product": "(Intellij IDEA Ultimate|ReSharper Ultimate)", "userName": "macuser.*", "hostName": ".*.itdept.company.net" } ], "blacklist": [ { "product": "CLion", "userName": "windowsuser12", "hostName": ".*user12.itdept.company.net" } ] }

where "product" is a license requested by user, "userName" is a username set up on the machine where the product is used, and "hostName" is a host of the machine where the product is used. The properties "product", "userName" and "hostName" accept regular expressions.

To configure your license server to use the configuration file:

ZIP distribution

  1. Stop the license server by running <license_server_home>/bin/license-server.sh stop for Linux and Mac OS X or <license_server_home>\bin\license-server.bat stop for Windows.

  2. Set the path to the configuration file by running <license_server_home>/bin/license-server.sh configure --access.config=file:/path-to-configuration-file/access-config.json for Linux and Mac OS X or <license_server_home>\bin\license-server.bat configure --access.config=file:/path-to-configuration-file/access-config.json for Windows, where access-config.json is the configuration file with the restrictions specified as described above.

  3. Start the license server by running <license_server_home>/bin/license-server.sh start for Linux and Mac OS X or <license_server_home>\bin\license-server.bat start for Windows.

MSI distribution

  1. Stop the JetBrains License Service from the Windows Services panel.

  2. Set the path to the configuration file by running <license_server_home>\apps\license-server\bin\license-server.bat configure --access.config=file:/path-to-configuration-file/access-config.json, where access-config.json is the configuration file with the restrictions specified as described above.

  3. Start the JetBrains License Service from the Windows Services panel.

Last modified: 19 December 2017