User Permissions

After a user gets invited and their account has been created, you can set specific permissions for them. By default, the new user will have User Roles applied but will not have any individual permissions assigned. To edit these privileges, navigate to the Administrators page.  

Editing User Permissions in the ThreatLocker Portal

On the Administrators page, select the name of the user you want to change the permissions on. 

In the 'Update User' side panel, navigate to the 'Roles/Permissions' section. In the 'Individual Permissions' dropdown, you can select as many or as few permissions as needed.

Definitions of Individual Permissions

Approval Permissions

If you would like your user to be able to approve using a maintenance mode, combine the 'Approval' permission with the corresponding 'Manage Maintenance Mode' permission (i.e., combine 'Approve for Entire Organization' with 'Manage Application Control Installation Mode' to allow the user to process approvals for the entire organization using Installation mode).

• Approve for Entire Organization—This permission allows users to view the Approval Center page and approve application and storage requests at the Entire Organization Level, the Computer Group Level, or for a Single Computer. It grants access to approve by custom rule or hash only but does not provide access to any maintenance modes. Combine it with a maintenance mode permission to give users access to use maintenance modes.
• Approve for Global - This permission allows users to view the Approval Center page and approve application and storage requests at the Global Group Level, the Entire Organization Level, the Computer Group Level, or for a Single Computer. It grants access to approve by custom rule or hash only but does not provide access to any maintenance modes. Combine it with a maintenance mode permission to give users access to use maintenance modes.
• Approve for Group—This permission allows users to view the Approval Center page and approve application and storage requests at the Computer Group Level or for a Single Computer. It grants access to approve by custom rule or hash only but does not provide access to any maintenance modes. Combine it with a maintenance mode permission to give users access to use maintenance modes. 
• Approve for Single Computer - This permission allows users to view the Approval Center page and approve application and storage requests for a Single Computer. It grants access to approve by custom rule or hash only but does not provide access to any maintenance modes. Combine it with a maintenance mode permission to give users access to use maintenance modes.
• Elevation User - This provides the ability to approve Elevation requests. It must be combined with one of the other Approval permissions to gain access to the Approval Center page.
• View Approvals—This allows you to view the Approvals Center page and open the approvals, but it does not allow you to action the requests.
• Approve for Single Computer (Application Only)—This provides the ability to view the Approval Center page and approve application requests for a single endpoint at a time. It does not grant the ability to approve storage requests.

User Permissions

• Assign Roles - This provides the ability to assign and remove User Roles from administrators. A Role is a collection of permissions.
• Change Permission - This provides the ability to add or remove individual permissions for a user. This must be combined with either the 'Edit Administrators' permission or the 'View Administrators' permission, which gives the user access to the Administrators page. This permission does NOT provide the ability to apply or edit User Roles.
• Edit Administrators - This permission provides the ability to view the Administrators page, add a new user, invite a new user, delete a user, reset passwords, and edit the information of listed administrators, minus the ability to change a user's permissions.
• Role Administrator - This provides the ability to create new User Roles, edit existing User Roles, and make changes to User Roles. A Role is a collection of permissions.
• View Administrators - This permission gives view-only access to the Administrators page.

Application Control Permission

• Allow Application Merge - This permission provides the ability to merge application definitions, but it does not provide viewing access to the Application Control > Applications page. You will also need to add the ability to Edit Application Control Applications.  
• Edit Application Control Applications - This provides the ability to view the Application Control > Applications page, to enable and disable applications, use the remove unused applications button, and to create, edit and delete applications. 
• Edit Application Control Policies - This permission gives the user full control of the Application Control > Policies page including creating new application policies, editing policies, deleting policies, and moving policies.
• Manage Tags - This permission gives the ability to edit and create new tags, as well as to add items to those tags.
• Promote to Group - This grants the user the ability to promote existing Application Control Application Policies to the Computer Group level.
• Promote to Entire Organization - This grants the user the ability to promote existing Application Control Application Policies to the Computer Group or Entire Organization level.

Billing Permissions

• Edit Billing - This gives the user the ability to view the Billing page and make changes to the information displayed on the Billing page.
• View Billing - This gives the user view-only access to the Billing page.   

Community Permissions

• Manage Community - This permission grants the user the ability to publish policies to the Community, and add and remove subscriptions and subscribers.
• View Community - This permission grants the user view-only access to the Community and policies that are published on the Community.

Computer Permissions

• Allow View Checkin History - When combined with either View or Edit Computers, will permit access to view the Checkin History tab in the Computers sidebar.
• Edit Computer Groups - This gives the user access to the Computer > Groups tab, provides the ability to create, edit and delete computer groups, change the Update Channel of a group, and update the ThreatLocker Version of a group. 
• Edit Computers—This permission allows the user to access the Computers page and the QR Scanner on the Mobile App. It does not grant the ability to change maintenance modes.
• View Override Codes - This permission is needed to be able to view the Override Codes report. This permission is included in Super Admin permissions.
• View Computers -  This permission will provide view-only access to the Computers page.
• View Computers - Managed Organization Only - This permission will provide view-only access to the Computers at the applied Organization Level only.
• Install Computers - This permission will provide access to the Install Computers button and view-only access to the Computers page.

General Permissions

• Edit Integrations - This permission gives the user the ability to view the Integrations page, create, edit and delete integrations.
• Edit Logon Settings - This permission gives the user the ability to edit logon settings.
• Manage Local Admin Settings - This permission allows the user to manage the local Windows and MacOS administrators on all endpoints with ThreatLocker installed.
• Super Admin - This provides the user full control of all listed user permissions for the parent account, including child organizations, and provides access to the System Audit page. 
• Super Admin-Child - This permission grants the user full control of all listed user permissions only on child organizations, not on the Organization this user is set on. This does not provide access to the System Audit page. For example, if Company A manages Company B and Company C, a super admin-child set on Company A will not have permissions on Company A, but will have full permissions on Company B and Company C.
• Super Admin - Parent Only - This permission grants the user full control of all listed user permissions only on the Parent organization. This admin will have no permission to access child organizations.
• View Reports — This provides access to the Reports page, where the user can generate and view reports.  
• View System Audit - This provides access to the System Audit page.
• View Unified Audit—This allows the user to view and search the Unified Audit page and view the file history for audit entries, but it does not provide permission to add to applications, permit applications, or deny applications. 
• View Health Center - This permission grants the user view-only access to the Health Center. 
• Manage Local Admin Settings - This permission grants the user the ability to manage the local Windows and macOS administrators on all endpoints with ThreatLocker installed.

Mutual Action Plan Permissions

• View Mutual Action Plans - This permission grants the user view-only access to the Mutual Action Plans, including notes and files.
• Edit Mutual Action Plans - This permission grants the users the ability to add Key Stakeholders, add notes, upload files, and mark tasks complete.

Network Control Permissions

• Edit Network Control Authorization Hosts - This provides the ability to edit, add, or delete authorization hosts and create their passwords.
• Edit Network Control Policies - This provides the ability to edit, add, or delete Network Control policies. 

Organization Permissions

• Edit Organizations - This permission grants the user the ability to view the Organizations page, delete an empty organization,  use the 'Deploy Policies' button located at the top of the page, and edit the General, Billing, Exclusions, Tray, and Branding settings for the organization.
• View Organizations - This provides the ability to view the Organizations page, to delete an empty organization, and  use the 'Deploy Policies' button located at the top of the Organizations page. 

Storage Control Permissions

• Edit Storage Control Policies - This allows you to edit, add, or delete Storage Control policies.
• Edit Storage Control Storage Devices - This allows you to edit, add, or delete Storage Devices.

Configuration Manager Permissions

• Edit Configuration Manager Policies - This provides the ability to add, edit, or delete Configuration Manager policies. 
• View Configuration Manager - This provides the ability to view Configuration Manager policies.
• View ThreatLocker user Password — This permission allows the user to view the TAPS password on the Computers page, as set by a Configuration Manager policy. 

ThreatLocker Detect Permissions

• Allow Remediation - This permission is NOT included in Super Admin. It needs to be combined with View Computers and View Threats at a minimum. It allows access to use the Remediator. If the Remediator is not already installed on the target endpoint, this will require Edit Computers to gain access to download and install the Remediator.
• Edit ThreatLocker Detect Policies - This allows you to edit, add, or delete ThreatLocker Detect policies.
• Manage ThreatLocker Detect Remediations - This grants the user access to the  Response Center Remediation page. It must be combined with View Computers to view the alert sidebar. It allows the user to put a computer into lockdown or isolate.
• Manage ThreatLocker Detect Threats — This grants the user access to the Response Center Threats page. The user can view and clear alerts, snooze alerts, update the threat status, and view, add, edit, and delete exclusions for both Cloud and Endpoint Detect.
• Manage Cyber Hero Response Settings - This permission grants access to view and edit Cyber Hero Response Settings for Endpoint and Cloud Detect. It must be combined with at least View ThreatLocker Detect Policies to access the ThreatLocker Detect page.
• View ThreatLocker Detect Policies - This allows you to view ThreatLocker Detect policies.
• View ThreatLocker Detect Remediations - This provides view-only access to the Response Center > Remediations tab.
• View ThreatLocker Detect Threats - This provides view-only access to the Response Center > Threats tab. 

Web Control Permissions

• View Web Control Policies - View only access to the Web Control module page, and view access to Web Control policy sidebars. No ability to edit any details on the main grid, create Web Control policies, or to update existing polices.
• Edit Web Control Policies - View and edit access to the Web Control page and policies. Full access on the page. Ability to process Web Control approval requests.

Maintenance Mode Permissions

• Manage All Maintenance Modes— This allows the user to enable/disable ALL maintenance modes via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. It must be combined with Edit Application Control Applications permission before Application Control Learning Mode or Application Control Installation Mode can be used. It must be combined with the Approval permission before the user can action Approval Requests. 
• Manage Application Control Installation Mode - This allows the user to enable/disable Application Control Installation mode via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. It must be combined with the Approval permission before the user can action Approval Requests.
• Manage Application Control Learning Mode -This allows the user to enable/disable Application Control Learning mode via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. It must be combined with the Approval permission before the user can action Approval Requests.
• Manage Application Control Monitor Only - This allows the user to enable/disable Application Control Monitor Only mode via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. It must be combined with the Approval permission before the user can action Approval Requests.
• Manage Network Control Monitor Only - This allows the user to enable/disable Network Control Monitor Only mode via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. 
• Manage Storage Control Monitor Only - This allows the user to enable/disable Storage Control Monitor Only mode via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes. It must be combined with the Approval permission before the user can action Approval Requests.
• Manage Tamper Protection - This allows the user to enable/disable Tamper Protection via the Computers page. It must be combined with the Edit Computers permission before the user can open the Computers sidebar and schedule maintenance modes.

Creating Custom User Roles

Administrators can create custom user roles based on their organization's specific needs. Once created, these user roles can be applied to specific administrators. These roles are organization-specific and must be created at the organization level where they will be applied.   

Navigate to the Administrators page and switch to the Roles tab. 

Select '+ New Role'.

Insert a name for the user role in the 'Role Name' textbox.

If desired, input a description for the user role in the 'Description' textbox.

Expand the 'Role Permissions' dropdown menu and select the checkbox next to the permissions you wish to include in this custom user role. 

Once you have made all the selections needed for this user role, select '+ Create Role'.

The role will now appear in the list on the main page. If you need to make changes to this role, clicking the 'Edit' button will open the 'Update Role' panel.   

Roles can be deleted by selecting the delete icon to the right role name.  

Applying Custom User Roles

 Once created, custom user roles can be applied to administrators in the same way as applying specific permissions.

On the Administrators page, select the name of the user you want to change the permissions on.  

In the 'Update user' side panel, navigate to the 'Roles/Permissions' section. 

Expand the 'Role' dropdown menu to select the desired role.

Optionally, you can select the organization to apply this custom role to. This is beneficial for organizations with child organizations, allowing the user to have different permissions for different organizations.

Select the '+' icon to add the role.

Select 'Update Admin' to save your changes.

Deprecated Permissions

Please Note: All deprecated permissions that are currently applied will continue to work as expected.

• Approve for Entire Organization (Learning Mode Only) - can process application or storage approval requests for an entire organization, a group, or a single computer, and when combined with edit computer, ONLY use Learning Mode.
• Approve for Entire Organization (Installation Mode Only) - can process application or storage approval requests for an entire organization, a group, or a single computer, and when combined with edit computer, ONLY use Installation Mode.
• Approve for Group (Learning Mode Only) - can process application or storage approval requests for a group or a single computer, and when combined with Edit Computer, use ONLY Learning Mode.
• Approve for Group (Installation Mode Only) - can process application or storage approval requests for a group or a single computer, and when combined with Edit Computer, use ONLY Installation Mode.
• Approve for Single Computer (Learning Mode Only) - can process application or storage approval requests for a single computer, and when combined with Edit Computer, ONLY use Learning Mode.
• Approve for Single Computer (Installation Mode Only) - can process application or storage approval requests for a single computer, and when combined with edit computer, ONLY use Installation Mode.
• Approve for Single Computer (Application and Learning Mode Only) - can process application approval requests for a single computer, and when combined with edit computer, ONLY use Learning Mode.
• Approve for Single Computer (Application and Installation Mode Only) - can process application approval requests for a single computer, and when combined with edit computer, ONLY use Installation Mode.