Back to Qt.io
Contact Us Blog Download Qt

Manage access control lists Manage long-term records in ACLs

Maintain access control lists

Add users and licenses to access control lists (ACLs) to control who can reserve licenses for Qt and QA products. You can manage user access for each license available on Qt License Server with an acl.json file.

Users are identified based on their user ID, which needs to match the user ID in the ACLs. By default, this ID is the currently logged in username from the operating system or the user ID that you set as the value of the QTLICD_CLIENT_USERNAME environment variable.

Define the ACL file

Define the ACL records in an acl.json file and add it to the Qt License Server root folder. For more information, see Qt License Server ACL file format.

Import records during startup

When Qt License Server starts, it imports the ACL records from the acl.json file.

Import records during runtime

The ACL JSON file (acl.json) is passed to Qt License Server, which validates it. If it does not find issues in the input file, it deletes the existing ACL records from the database and stores new records based on the given input.

To set an ACL file:

  1. Create an ACL file in JSON format.
  2. Set the ACL file to use.
    ./qt-license-server set-acl --from-json <.json file input path> --url <URL of the running instance>

    The changes take effect immediately. Qt License Server no longer references the JSON file.

  3. List ACL records for a license number.
    ./qt-license-server list-acl --license <number> --url <URL of the running instance>

    Omit --license to show ACLs for all licenses.

  1. Create an ACL file in JSON format.
  2. Set the ACL file to use.
    .\qt-license-server.exe set-acl --from-json <.json file input path> --url <URL of the running instance>

    The changes take effect immediately. Qt License Server no longer references the JSON file.

  3. List ACL records for a license number.
    .\qt-license-server.exe list-acl --license <number> --url <URL of the running instance>

    Omit --license to show ACLs for all licenses.

See also Qt License Server ACL file format, Override default user ID, and Qt License Server command-line interface.

Manage access control lists Manage long-term records in ACLs

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.