The 'Agent Settings' page allows you to make granular settings for some features of the ThreatLocker agent. To navigate to the 'Agent Settings' page, select 'Agent Settings' from the left-hand side of the page.
Navigating the Agent Settings Page
The 'Agent Settings' page will show you a list of the current settings within your organization. There are several rows displayed along with this that can provide information on the settings:
- Order - The order in which settings within your organization will be processed. A lower number ensures that a setting will be processed sooner than a setting with a higher number.
- Type - This is the setting type that matches this setting. The following setting types are available:
- UAC Branding
- Proxy Settings
- Full Self Elevation - Not available until ThreatLocker Windows Agent 10.2
- Relay Settings - Not available until ThreatLocker Windows Agent 10.3
- Applies To - This section displays which users this setting applies to. Settings can be applied to individual computers, computer groups, or the entire organization.
- Created - This is the date and time the setting was made.
Alongside these rows of information on each individual setting, there are two actionable buttons on the top right side of the page:
- Selecting this button will bring you to this article, which provides information on how to use the agent settings page.
- This refreshes the Agent Settings list.
Lastly, there are two actionable buttons on the top left-hand side of the page:
- + New Setting - When selected, this button opens a side panel titled 'Create Settings' that allows you to create a new agent setting.
- Update Agents - This button allows you to update agents within your organization. This is crucial when applying new agent settings, as the settings will not be applied until the agent is updated.
Creating a New Agent Setting
To create a new agent setting, select the '+ New Setting' button found in the top left-hand corner of the 'Agent Settings' page.
Once this has been selected, a page called 'Create Settings' will open.
Selecting the dropdown under 'Setting Type' will provide you with four options:
Once a Setting Type is selected, the available options for that setting will populate.
- Setting Type - A dropdown that permits users to select the Agent Setting.
- Applies To - This section will remain greyed out until a setting type is chosen. Once it is enabled, you can choose between the entire organization (selected by default), an individual computer, a computer group.
- Order By - By default, 'Add Settings to Top' will be chosen. The order of policies determines the order in which policies will be processed. Policies at the top (policies with a lower number), will be processed first whereas policies at the bottom (policies with a higher number), will be processed last.
The rest of the 'Create Settings' page will appear differently depending on the setting type chosen. Each setting type provides a unique setting that can be applied to users within your organization.
Finalizing the Agent Setting
Once you have filled out your Setting Type and Parameters, navigate to the bottom of the 'Create Settings' side panel. Select the 'Create' button at the bottom of the page to create the setting.
Once created, the new setting will appear on your 'Agent Settings' page. After making each agent setting, select the 'Update Agents' button to update the ThreatLocker agents and push this new setting to them.