Ninja Threatlocker Solution Update#699
Open
Kamalgurna wants to merge 2 commits into
Open
Conversation
- Added Uninstall option in the `cPVAL Threatlocker Deployment` custom field. - Added missing components to the documents as per our new document standards. - Renamed the compound condition from `threatlocker-deployment-windows` to `threatlocker-deployment-workstations`. Separated workstations and servers compound conditions because servers use different Custom fields for deployment. - Added Threatlocker uninstallation script for windows and its corresponding Custom Field.
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the NinjaOne ThreatLocker solution documentation to support uninstallation, align supporting component docs with updated standards, and split Windows compound conditions between workstations and servers.
Changes:
- Added an uninstall automation + compound condition documentation and referenced it from the solution.
- Split Windows deployment compound conditions into separate Workstations and Servers docs.
- Updated multiple ThreatLocker custom field docs to include the new “Custom Field Tab Name” column and refreshed
last_update.
Reviewed changes
Copilot reviewed 9 out of 10 changed files in this pull request and generated 11 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/solutions/threatlocker-deployment-ninja-one.md | Updates the solution’s component list and implementation steps; adds uninstall flow and new compound conditions. |
| docs/ninjaone/custom-fields/cpval-threatlocker-organization-name.md | Adds “Custom Field Tab Name” column and updates metadata/changelog. |
| docs/ninjaone/custom-fields/cpval-threatlocker-mac-groupkey.md | Adds “Custom Field Tab Name” column and updates metadata/changelog. |
| docs/ninjaone/custom-fields/cpval-threatlocker-deployment.md | Adds “Custom Field Tab Name” column, adds Uninstall option, and updates metadata/changelog. |
| docs/ninjaone/custom-fields/cpval-threatlocker-auth-key.md | Adds “Custom Field Tab Name” column and updates metadata/changelog. |
| docs/ninjaone/compound-conditions/uninstall-threatlocker-windows.md | New doc describing the uninstall compound condition. |
| docs/ninjaone/compound-conditions/threatlocker-deployment-workstations.md | New doc describing the workstation-specific deployment compound condition. |
| docs/ninjaone/compound-conditions/threatlocker-deployment-servers.md | Updates/repurposes the server deployment compound condition doc with new ID and server-specific behavior. |
| docs/ninjaone/automations/uninstall-threatlocker.md | New doc for the ThreatLocker Windows uninstall automation. |
Comments suppressed due to low confidence (2)
docs/ninjaone/compound-conditions/threatlocker-deployment-servers.md:5
- This page is for the Servers compound condition, but the
title/title_metastill say "ThreatLocker Deployment - Windows", which is ambiguous.
docs/ninjaone/compound-conditions/threatlocker-deployment-servers.md:21 - The Servers compound condition
Namefield contains a typo ("Depoyment") and doesn't indicate that it targets servers. This should match the Servers-specific compound condition name.
| | ------- | ---- | ----------------- | -------- | | ||
| |[cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) | Drop-down | `Windows`, `Windows and Macintosh`, `Disabled` | Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level. | | ||
| | [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) | Drop-down | `Yes`, `No` | Allows exclusion of specific locations or devices from Threatlocker auto-deployment. | | ||
| |[cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) | Drop-down |`All`, `Windows`, `Windows and Macintosh`, `Disabled`, `windows workstations`, `windows servers and Macs`, `windows workstaions and macs`, `windows servers`, `macs`, `Uninstall` | Custom Field to select OS to enable auto-deployment of Threatlocker. Select 'Uninstall' to uninstall Threatlocker if its already installed on the machines. | |
Comment on lines
34
to
35
| | [Threatlocker Deployment](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) | Installs Threatlocker agent on Windows operating systems. | | ||
| | [Threatlocker Deployment - MAC](/docs/1196b011-bfba-486a-8653-92066f19e527) | Installs Threatlocker agent on Macintosh operating systems. | |
Comment on lines
63
to
64
| - [Threatlocker Deployment](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) | ||
| - [Threatlocker Deployment - MAC](/docs/1196b011-bfba-486a-8653-92066f19e527) |
| | cPVAL ThreatLocker Deployment | cpvalThreatlockerDeployment | Organization | drop-down | `All`, `Windows`, `Windows and Macintosh`, `Disabled`, `windows workstations`, `windows servers and Macs`, `windows workstaions and macs`, `windows servers`, `macs`, | `Disabled` | False | Editable | Read/Write | Read/Write | Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level. | | | | ||
| | Label | Field Name | Definition Scope | Type | Option Value | Default Value | Required | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | Custom Field Tab Name | | ||
| | ----- | ---------- | ---------------- | ---- | ------------ | ------------- | --------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | ---- | | ||
| | cPVAL ThreatLocker Deployment | cpvalThreatlockerDeployment | Organization | drop-down | `All`, `Windows`, `Windows and Macintosh`, `Disabled`, `windows workstations`, `windows servers and Macs`, `windows workstaions and macs`, `windows servers`, `macs`, `Uninstall` | `Disabled` | False | Editable | Read/Write | Read/Write | Select OS to enable auto-deployment of Threatlocker. Select 'Uninstall' to uninstall Threatlocker if its already installed on the machines.| Select OS to enable auto-deployment of Threatlocker. Select 'Uninstall' to uninstall Threatlocker if its already installed on the machines. | Threatlocker | Threatlocker | |
Comment on lines
+6
to
+7
| keywords: ['threatlocker','windows','groupKey','deployment'] | ||
| description: 'This script will check for ThreatLocker and attempt to install if not present on Windows Machines. It matches the organization to the client name. If no match is found, it will create the company in the ThreatLocker Portal. By default, servers will be installed into the Servers group, and workstations will be installed into the Workstations group' |
Comment on lines
+21
to
+22
| - **Name:** `ThreatLocker Depoyment - Windows` | ||
| - **Description:** `Triggers the auto-deployment script for ThreatLocker on Windows machines where uninstallation is enabled.` |
|
|
||
| ## Compound Condition Creation | ||
|
|
||
| - [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/threatlocker-deployment-windows-machines.toml) |
Comment on lines
+4
to
+5
| title: 'ThreatLocker Deployment - Windows' | ||
| title_meta: 'ThreatLocker Deployment - Windows' |
|
|
||
| ## Details | ||
|
|
||
| - **Name:** `ThreatLocker Depoyment - Workstations` |
| title: 'Uninstall Threatlocker - Windows' | ||
| title_meta: 'Uninstall Threatlocker - Windows' | ||
| keywords: ['threatlocker','windows','auto-deploy', 'agent-policy'] | ||
| description: 'Triggers the auto-deployment script for ThreatLocker on Windows machines where deployment is enabled' |
- Fixed name of the contents linked to other documents
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
cPVAL Threatlocker Deploymentcustom field.threatlocker-deployment-windowstothreatlocker-deployment-workstations. Separated workstations and servers compound conditions because servers use different Custom fields for deployment.