diff --git a/docs/ninjaone/automations/threatlocker-deployment-mac.md b/docs/ninjaone/automations/threatlocker-deployment-mac.md index 2717fc706f..793ebbc218 100644 --- a/docs/ninjaone/automations/threatlocker-deployment-mac.md +++ b/docs/ninjaone/automations/threatlocker-deployment-mac.md @@ -1,123 +1,40 @@ --- id: '11444307-4a3f-4388-b5c5-096a50725b4e' slug: /11444307-4a3f-4388-b5c5-096a50725b4e -title: 'Threatlocker Deployment [MAC]' -title_meta: 'Threatlocker Deployment [MAC]' -keywords: ['Threatlocker','MAC','GroupKey','Deployment'] -description: 'This script deploys threatlocker agent on Mac machines' +title: 'ThreatLocker Deployment [MAC]' +title_meta: 'ThreatLocker Deployment [MAC]' +keywords: ['threatlocker','MAC','groupKey','deployment'] +description: 'This script deploys ThreatLocker agent on Mac machines' tags: ['security','setup','macos'] draft: false unlisted: false --- ## Overview -This script deploys threatlocker agent on Mac machines. + +This script deploys ThreatLocker agent on Mac machines. ## Sample Run `Play Button` > `Run Automation` > `Script` -![SampleRun1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/samplerun1.webp) - -Search and select `Threatlocker Deployment [MAC]` -![SampleRun1](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image4.webp) - -Set the required arguments and click the Run button to run the script. -`Run As`: System -`Preset Parameter`: `` -![SampleRun1](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image5.webp) - -`Run Automation`: Yes -![SampleRun1](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image6.webp) +![SampleRun1](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/samplerun.webp) ## Dependencies -- [cPVAL ThreatLocker Mac GroupKey](/docs/8305e5b2-41ee-44bb-848e-758ac72b185f) -- [cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) -- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) -- [Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - -## Automation Setup/Import - -### Step 1 - -Navigate to `Administration` > `Library` > `Automation` -![Step1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen, click on it and click the `New Script` button. -![Step2](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/step2.webp) - -The scripting window will open. -![ScriptingScreen](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/scriptingscreen.webp) -### Step 3 +- [cPVAL ThreatLocker Mac GroupKey](/docs/8305e5b2-41ee-44bb-848e-758ac72b185f) +- [cPVAL ThreatLocker Deployment - MAC](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -Configure the `Create Script` section as follows: +## Parameters -`Name`: Threatlocker Deployment [MAC] -`Description`: This script deploys threatlocker agent on Mac machines -`Categories`: ProVal -`Language`: ShellScript -`Operating System`: Mac -`Architecture`: 64-bit -`Run As`: System -![CreateSript](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image1.webp) +| Name | Required | Default | Type | Description | +| ---- | -------- | ------- | ---- | ----------- | +| ThreatLocker Mac Groupkey | False | -- | `String/Text` | Set this variable to override the value stored in the organization-level custom field cPVAL ThreatLocker Mac GroupKey | +## Automation Setup/Import -### Step 4 - -Paste the following Shell script in the scripting section: - -``` -#!/bin/bash - GroupKey= Ninja-property-get cpvalThreatlockerMacGroupkey -#install -if [ ! -d /Applications/Threatlocker.app ] - then - curl --output-dir "/Applications" -O https://updates.threatlocker.com/repository/mac/1.0/Threatlocker.app.zip - echo "Downloading Threatlocker" - open /Applications/Threatlocker.app.zip - sleep 5 - osascript -e 'quit app "Finder"' - rm -d /Applications/Threatlocker.app.zip - if [ ! -d /Applications/Threatlocker.app ] - then - echo "Not able to download the file" - exit 1 - else - open /Applications/ThreatLocker.app --args -groupKey $GroupKey - echo "Installing Threatlocker" - sleep 15 - echo "Verifying Group Key" - sleep 15 - if [ ! -d /Library/Application\ Support/Threatlocker ] - then - echo "GroupKey is Invalid" - exit 1 - else - echo "Threatlocker Installed" - exit 0 - fi - fi -fi -``` -![CreateSript](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image2.webp) - -## Script Variables - -Click the `Add` button next to `Script Variables`. -![AddVariableButton](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/addvariablebutton.webp) - -## Saving the Automation - -Click the `Save` button in the top-right corner of the screen to save your automation. -![SaveButton](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/savebutton.webp) - -You will be prompted to enter your MFA code. Provide the code and press the Continue button to finalize the process. -![MFA](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/mfa.webp) - -## Completed Automation -![CompletedAutomation](../../../static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image3.webp) +[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/threatlocker-deployment-mac.sh) ## Output -- Activity Details + +- Activity Details diff --git a/docs/ninjaone/automations/threatlocker-deployment.md b/docs/ninjaone/automations/threatlocker-deployment.md index 8320df4d29..91638c0a98 100644 --- a/docs/ninjaone/automations/threatlocker-deployment.md +++ b/docs/ninjaone/automations/threatlocker-deployment.md @@ -1,164 +1,42 @@ --- id: '1196b011-bfba-486a-8653-92066f19e527' slug: /1196b011-bfba-486a-8653-92066f19e527 -title: 'Threatlocker Deployment' -title_meta: 'Threatlocker Deployment' -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' +title: 'ThreatLocker Deployment' +title_meta: 'ThreatLocker Deployment' +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' tags: ['security','setup','windows'] draft: false unlisted: false --- ## Overview -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. + +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. ## Sample Run `Play Button` > `Run Automation` > `Script` -![SampleRun1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/samplerun1.webp) - -Search and select `Threatlocker Deployment` -![SampleRun1](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image4.webp) - -Set the required arguments and click the Run button to run the script. -`Run As`: System -`Preset Parameter`: `` -![SampleRun1](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image5.webp) - -`Run Automation`: Yes -![SampleRun1](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image6.webp) - +![SampleRun1](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/samplerun.webp) ## Dependencies -- [cPVAL Threatlocker Auth Key](/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a) -- [cPVAL Threatlocker Organization Name](/docs/573751d4-0648-4da9-8ec3-0ab96d4730de) -- [cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) -- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - -## Automation Setup/Import - -### Step 1 - -Navigate to `Administration` > `Library` > `Automation` -![Step1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen, click on it and click the `New Script` button. -![Step2](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/step2.webp) - -The scripting window will open. -![ScriptingScreen](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/scriptingscreen.webp) - -### Step 3 - -Configure the `Create Script` section as follows: - -`Name`: Threatlocker 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 organtization in Threatlcoker. -`Categories`: ProVal -`Language`: PowerShell -`Operating System`: Windows -`Architecture`: All -`Run As`: System -![CreateSript](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image1.webp) - - -### Step 4 -Paste the following Shell script in the scripting section: +- [cPVAL ThreatLocker Auth Key](/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a) +- [cPVAL ThreatLocker Organization Name](/docs/573751d4-0648-4da9-8ec3-0ab96d4730de) +- [cPVAL ThreatLocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -``` -[Net.ServicePointManager]::SecurityProtocol = "Tls12" +## Parameters -## Variables -[String]$organizationName = Ninja-property-get cpvalThreatlockerOrganizationName -[String]$UniqueIdentifier = Ninja-property-get cpvalThreatlockerAuthKey +| Name | Required | Default | Type | Description | +| ---- | -------- | ------- | ---- | ----------- | +| ThreatLocker AuthKey | False | -- | `String/Text` | Set this variable to override the value stored in the organization-level custom field cPVAL ThreatLocker AuthKey | +| ThreatLocker Org Key | False | -- | `String/Text` | Set this variable to override the value stored in the organization-level custom field cPVAL ThreatLocker OrganizationName | +## Automation Setup/Import -if(!($organizationName )) -{ - Throw 'Error: Missing Organization Name. Configure it in NinjaOne field ''cpvalThreatlcokerOrganizationName''' -} - -if(!($UniqueIdentifier)) -{ - Throw 'Error: Missing Threatlocker Authenticatio Key. Configure it in NinjaOne field ''cpvalThreatlockerAuthKey''' -} - -$service = Get-Service -Name ThreatLockerService -ErrorAction SilentlyContinue; - -if ($service.Name -eq "ThreatLockerService" -and $service.Status -eq "Running") { - return "Already Installed" -} - - -## Check if directory exists and create if not -if (!(Test-Path "C:\ProgramData\_automation\script\Threatlocker")) { - mkdir "C:\ProgramData\_automation\script\Threatlocker"; -} - -## Check the OS architecture and download the correct installer -try { - if ([Environment]::Is64BitOperatingSystem) { - $downloadURL = "https://api.threatlocker.com/updates/installers/threatlockerstubx64.exe"; - } - else { - $downloadURL = "https://api.threatlocker.com/updates/installers/threatlockerstubx86.exe"; - } - - $localInstaller = "C:\ProgramData\_automation\script\Threatlocker\ThreatLockerStub.exe"; - - Invoke-WebRequest -Uri $downloadURL -OutFile $localInstaller -Usebasicparsing; - -} -catch { - Write-Output "Failed to get download the installer"; - return; -} - -## Attempt install -try { - & "C:\ProgramData\_automation\script\Threatlocker\ThreatLockerStub.exe" key=$UniqueIdentifier Company=$organizationName -} -catch { - Write-Output "Installation Failed"; - return -} - -## Verify install -$service = Get-Service -Name ThreatLockerService -ErrorAction SilentlyContinue; - -if ($service.Name -eq "ThreatLockerService" -and $service.Status -eq "Running") { - Write-Output "Installation successful"; - return; -} -else { - ## Check the OS type - $osInfo = Get-CimInstance -ClassName Win32_OperatingSystem - - if ($osInfo.ProductType -ne 1) { - Write-Output "Installation Failed"; - return - } -} -``` -![CreateSript](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image2.webp) - -## Saving the Automation - -Click the Save button in the top-right corner of the screen to save your automation. -![SaveButton](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/savebutton.webp) - -You will be prompted to enter your MFA code. Provide the code and press the Continue button to finalize the process. -![MFA](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/mfa.webp) - -## Completed Automation -![CompleteAutomation](../../../static/img/docs/1196b011-bfba-486a-8653-92066f19e527/image3.webp) +[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/threatlocker-deployment-windows.ps1) ## Output -- Activity Details +- Activity Details diff --git a/docs/ninjaone/compound-conditions/threatlocker-deployment-mac.md b/docs/ninjaone/compound-conditions/threatlocker-deployment-mac.md index 08bb9e32d2..829f75c751 100644 --- a/docs/ninjaone/compound-conditions/threatlocker-deployment-mac.md +++ b/docs/ninjaone/compound-conditions/threatlocker-deployment-mac.md @@ -1,179 +1,31 @@ --- id: '73470264-63c3-43d1-a727-1e813cfe768d' slug: /73470264-63c3-43d1-a727-1e813cfe768d -title: 'Threatlocker Deployment - MAC' -title_meta: 'Threatlocker Deployment - MAC' -keywords: ['Threatlocker','MAC','auto-deploy', 'agent-policy'] -description: 'Triggers the auto-deployment script for Threatlocker on Macintosh machines where deployment is enabled' +title: 'ThreatLocker Deployment - MAC' +title_meta: 'ThreatLocker Deployment - MAC' +keywords: ['threatlocker','mac','auto-deploy', 'agent-policy'] +description: 'Triggers the auto-deployment script for ThreatLocker on Macintosh machines where deployment is enabled' tags: ['security','setup','macos'] -draft: False +draft: false unlisted: false --- ## Summary -Triggers the [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) automation on macintosh machines where deployment is enabled. -## Details - -**Name:** `Threatlocker Deployment - MAC` -**Description:** `Triggers the auto-deployment script for Threatlocker on Macintosh machines where deployment is enabled.` +Triggers the [ThreatLocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) automation on macintosh machines where deployment is enabled. -**Recommended Agent Policies:** It is advised to configure this compound policy within the following default agent policies: - -- `Mac Server [Default]` -- `Mac [Default]` +## Details +- **Name:** `ThreatLocker Deployment - MAC` +- **Description:** `Triggers the auto-deployment script for ThreatLocker on Macintosh machines where deployment is enabled.` +- **Recommended Agent Policies:** `Mac Policy [Default]` ## Dependencies -- [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) -- [cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) -- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - +- [Automation - ThreatLocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) +- [cPVAL ThreatLocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) ## Compound Condition Creation -Compound conditions can be configured within an `Agent Policy`. This document provides an example using the default `Mac [Default]` policy for demonstration purposes. - -Navigate to `Administration` `>` `Policies` `>` `Agent Policies`. -![Navigate](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/agentpolicies.webp) - -Search for `Mac` and select the default `Mac [Default]` policy. -![DefaultMac](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/defaultmac.webp) - -This will navigate you to the policy's landing page, which is the `Conditions` section. - -Note that conditions may vary across different policies and environments. The provided screenshot is for demonstration purposes only. -![Conditions](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/macconditionssection.webp) - -Navigate to the `Compound Conditions` section. - -Note that existing compound conditions may vary across different policies and environments. The provided screenshot is for demonstration purposes only. -![CompoundConditions](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/macworkstationscompoundconditionssection.webp) - -Click the `+ Add` button to add a compound condition. -![AddButton](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbutton.webp) - -Clicking the `+ Add` button opens the compound condition creation window. -![AddACompoundCondition](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addacompoundcondition.webp) - -## Conditions - -### Condition 1: Software - -- Click the `+ Add condition` button. -![AddCondition](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addcondition.webp) - -- Select the `Software` option from the list that will appear after clicking the `+ Add condition` button. -![CompoundConditionSoftware](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditionsoftware.webp) - -- `Add Software Condition` screen will appear on selecting the `Software` option: -![CompoundConditionSoftwareScreen](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditionsoftwarescreen.webp) - -- Configure the `Add Software Condition` as follow: - - **Software Name:** `Threatlocker` - **Trigger when:** `Any Software` `Doesn't exist` - - ![Image1](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image1.webp) - -- **Note:** The Return key must be pressed after pasting the name to set the `Software Name`. - -- Click the `Apply` button to save the `software` condition. -![Apply](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/apply.webp) - -### Condition 2: Custom fields - -- Click the `+ Add condition` button. -![AddCondition](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addcondition.webp) - -- Select the `Custom fields` option from the list that will appear after clicking the `+ Add condition` button. -![CompoundConditionCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditioncustomfields.webp) - -- `Add custom fields condition` screen will appear on selecting the `Custom fields` option: -![CompoundConditionCustomFieldsScreen](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditioncustomfieldsscreen.webp) - -- Click the `+ Add` button within the upper section labeled `Custom field value must meet ALL conditions`. -![AddButtonCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbuttoncustomfields.webp) - -- A new row will be added upon clicking the `+ Add` button. -![NewRow](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/searchcustomfield.webp) - -- Search and select the `cPVAL Threatlocker Deployment - Exclude` custom field. - -- **Condition:** `cPVAL Threatlocker Deployment - Exclude` `does not equal` `Yes` - - ![Image1](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image1.webp) - -- Click the `+ Add` button within the upper section labeled `Custom field value must meet ALL conditions`. -![AddButtonCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbuttoncustomfields.webp) - -- A new row will be added upon clicking the `+ Add` button. -![NewRow](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/searchcustomfield.webp) - -- Search and select the `cPVAL Threatlocker Deployment` custom field. - -- **Condition:** `cPVAL Threatlocker Deployment` `equals` `Windows and Macintosh` - - ![Image2](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image2.webp) - -- Click the `Apply` button to save the `custom field` condition. -![Image2](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image2.webp) - -## Automations - -Navigate to `Automations` section. -![AutomationSections](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/automationssection.webp) - -Click the `+ Add automation` button. -![AddAutomation](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addautomations.webp) - -`Automation Library` will appear upon clicking the `+ Add Automation` button. Note that existing automation library may vary across different environments. The provided screenshot is for demonstration purposes only. -![AutomationLibrary](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/automationlibrarymac.webp) - -Search and select the [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) script. -![Image3](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image3.webp) - -Click the `Apply` button to add the automation. -![Image3](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image4.webp) - -Completed Automation Section: -![Image5](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image5.webp) - -## Settings - -Navigate to `Settings` section. -![SettingsSection](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/settingssection.webp) - -Set the `Settings` section as follows: - -**Name:** `Threatlocker Deployment - MAC` -**Auto Reset:** - -- **After:** `True` `1 hour` -- **When no longer met:** `True` - -**Run Every:** `30 Minutes` -**Trigger uptime:** `False` - -![Image6](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image6.webp) - -## Notifications - -Leave the `Notifications` section untouched. - -## Completed Component - -Click the `Apply` button at the bottom to save the compound condition. -![Apply](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/apply.webp) - -![Image7](../../../static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image7.webp) - -## Saving Agent Policy - -Click the `Save` button located at the top-right corner of the screen to save the agent policy. -![Save](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/save.webp) - -You will be prompted to enter your MFA code. Provide the code and press the Continue button to finalize the process. -![MFA](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/mfa.webp) \ No newline at end of file +- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/threatlocker-deployment-macs.toml) \ No newline at end of file diff --git a/docs/ninjaone/compound-conditions/threatlocker-deployment-windows.md b/docs/ninjaone/compound-conditions/threatlocker-deployment-windows.md index b12e3e7017..67b32b8602 100644 --- a/docs/ninjaone/compound-conditions/threatlocker-deployment-windows.md +++ b/docs/ninjaone/compound-conditions/threatlocker-deployment-windows.md @@ -1,163 +1,31 @@ --- id: 'd7ba7616-f11d-4961-90fb-9e7cf9ed6f28' slug: /d7ba7616-f11d-4961-90fb-9e7cf9ed6f28 -title: 'Threatlocker Deployment - Windows' -title_meta: 'Threatlocker Deployment - Windows' -keywords: ['Threatlocker','windows','auto-deploy', 'agent-policy'] -description: 'Triggers the auto-deployment script for Threatlocker on Windows machines where deployment is enabled' +title: 'ThreatLocker Deployment - Windows' +title_meta: 'ThreatLocker Deployment - Windows' +keywords: ['threatlocker','windows','auto-deploy', 'agent-policy'] +description: 'Triggers the auto-deployment script for ThreatLocker on Windows machines where deployment is enabled' tags: ['security','setup','windows'] draft: False unlisted: false --- ## Summary -Triggers the [Threatlocker Deployment'](/docs/1196b011-bfba-486a-8653-92066f19e527) automation on Windows machines where deployment is enabled. -## Details - -**Name:** `Threatlocker Depoyment - Windows` -**Description:** `Triggers the auto-deployment script for Threatlocker on Windows machines where deployment is enabled.` +Triggers the [ThreatLocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) automation on Windows machines where deployment is enabled. -**Recommended Agent Policies:** It is advised to configure this compound policy within the following default agent policies: +## Details -- `Windows Server [Default]` -- `Windows Workstation [Default]` +- **Name:** `ThreatLocker Depoyment - Windows` +- **Description:** `Triggers the auto-deployment script for ThreatLocker on Windows machines where deployment is enabled.` +- **Recommended Agent Policies:** `Windows Workstation [Default]`, `Windows Server [Default]` ## Dependencies -- [Automation - Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) -- [cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) -- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -## Compound Condition Creation - -Compound conditions can be configured within an `Agent Policy`. This document provides an example using the default `Windows Workstation [Default]` policy for demonstration purposes. - -Navigate to `Administration` `>` `Policies` `>` `Agent Policies`. -![Navigate](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/agentpolicies.webp) - -Search for `Windows Workstation` and select the default `Windows Workstation [Default]` policy. -![DefaultWindowsWorkstation](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/defaultwindowsworkstations.webp) - -This will navigate you to the policy's landing page, which is the `Conditions` section. `Note` that conditions may vary across different policies and environments. The provided screenshot is for demonstration purposes only. -![Conditions](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/windowsworkstationsconditionssection.webp) - -Navigate to the `Compound Conditions` section. `Note` that existing compound conditions may vary across different policies and environments. The provided screenshot is for demonstration purposes only. -![CompoundConditions](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/windowsworkstationscompoundconditionssection.webp) - -Click the `+ Add` button to add a compound condition. -![AddButton](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbutton.webp) - -Clicking the `+ Add` button opens the compound condition creation window. -![AddACompoundCondition](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addacompoundcondition.webp) - -## Conditions - -### Condition 1: Custom fields - -- Click the `+ Add condition` button. -![AddCondition](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addcondition.webp) - -- Select the `Custom fields` option from the list that will appear after clicking the `+ Add condition` button. -![CompoundConditionCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditioncustomfields.webp) - -- `Add custom fields condition` screen will appear on selecting the `Custom fields` option: -![CompoundConditionCustomFieldsScreen](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/compoundconditioncustomfieldsscreen.webp) - -- Click the `+ Add` button within the upper section labeled `Custom field value must meet ALL conditions`. -![AddButtonCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbuttoncustomfields.webp) - -- A new row will be added upon clicking the `+ Add` button. -![NewRow](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/searchcustomfield.webp) - -- Search and select the `cPVAL Threatlocker Deployment - Exclude` custom field. - -- **Condition:** `cPVAL Threatlocker Deployment - Exclude` `does not equal` `Yes` - - ![Image1](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image1.webp) - -- Click the `+ Add` button within the lower section labeled `Custom field value must meet ANY conditions`. -![AddButtonCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbuttoncustomfields.webp) - -- A new row will be added upon clicking the `+ Add` button. -![NewRow](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/searchcustomfield.webp) - -- Search and select the `cPVAL Threatlocker Deployment` custom field. - -- **Condition:** `cPVAL Threatlocker Deployment` `equals` `Windows` - - ![Image3](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image3.webp) - -- Click the `+ Add` button within the lower section labeled `Custom field value must meet ANY conditions`. -![AddButtonCustomFields](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addbuttoncustomfields.webp) +- [Automation - ThreatLocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) +- [cPVAL ThreatLocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -- A new row will be added upon clicking the `+ Add` button. -![NewRow](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/searchcustomfield.webp) - -- Search and select the `cPVAL Threatlocker Deployment` custom field. - -- **Condition:** `cPVAL Threatlocker Deployment` `equals` `Windows and Macintosh` - - ![Image2](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image2.webp) - -- Click the `Apply` button to save the `custom field` condition. -![Image5](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image5.webp) - -## Automations - -Navigate to `Automations` section. -![AutomationSections](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/automationssection.webp) - -Click the `+ Add automation` button. -![AddAutomation](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/addautomations.webp) - -`Automation Library` will appear upon clicking the `+ Add Automation` button. - -Note that existing automation library may vary across different environments. The provided screenshot is for demonstration purposes only. -![AutomationLibrary](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/automationlibrary.webp) - -Search and select the [Threatlocker Deployment](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) script. -![Image6](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image6.webp) - -Click the `Apply` button to add the automation. -![Image7](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image7.webp) - -Completed Automation Section: -![Image8](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image8.webp) - -## Settings - -Navigate to `Settings` section. -![SettingsSection](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/settingssection.webp) - -Set the `Settings` section as follows: - -**Name:** `Threatlocker Depoyment - Windows` -**Auto Reset:** - -- **After:** `True`, `24 hour` -- **When no longer met:** `True` - -**Run Every:** `24 hour` -**Minimum uptime for Trigger:** `True`, `10 minutes` - -![Image9](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image9.webp) - -## Notifications - -Leave the `Notifications` section untouched. - -## Completed Component - -Click the `Apply` button at the bottom to save the compound condition. -![Apply](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/apply.webp) - -![Image10](../../../static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image10.webp) - -## Saving Agent Policy - -Click the `Save` button located at the top-right corner of the screen to save the agent policy. -![Save](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/save.webp) +## Compound Condition Creation -You will be prompted to enter your MFA code. Provide the code and press the Continue button to finalize the process. -![MFA](../../../static/img/docs/6cd46a25-ff1e-42db-9bed-9ea70cbaf8c0/mfa.webp) +- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/threatlocker-deployment-windows.toml) \ No newline at end of file diff --git a/docs/ninjaone/custom-fields/cpval-threatlocker-auth-key.md b/docs/ninjaone/custom-fields/cpval-threatlocker-auth-key.md index 552c8967ec..069d4efbe5 100644 --- a/docs/ninjaone/custom-fields/cpval-threatlocker-auth-key.md +++ b/docs/ninjaone/custom-fields/cpval-threatlocker-auth-key.md @@ -1,87 +1,34 @@ --- id: '0ff9eab8-6df8-4154-9ecc-4f5bdedd648a' slug: /0ff9eab8-6df8-4154-9ecc-4f5bdedd648a -title: 'cPVAL Threatlocker Auth Key' -title_meta: 'cPVAL Threatlocker Auth Key' -keywords: ['Threatlocker','windows','GroupKey','Deployment'] -description: 'Threatlocker Authentication Key to deploy threatlocker Agent on windows machines' +title: 'cPVAL ThreatLocker Auth Key' +title_meta: 'cPVAL ThreatLocker Auth Key' +keywords: ['threatlocker','windows','groupKey','deployment'] +description: 'Threatlocker Authentication Key to deploy threatlocker Agent on windows machines.' tags: ['security','setup','windows'] draft: false unlisted: false --- ## Summary -Threatlocker Authentication Key to deploy threatlocker Agent on windows machines + +Threatlocker Authentication Key to deploy ThreatLocker Agent on windows machines ## Details | Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | | ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | -| cPVAL Threatlocker Auth Key | cPVALThreatlockerAuthKey | Organization | Text | True | - | Editable | Read/Write | Read/Write | Threatlocker Authentication Key to deploy threatlocker Agent on windows machines | - | - | - +| cPVAL ThreatLocker Auth Key | cPVALThreatlockerAuthKey | Organization | Text | True | - | Editable | Read/Write | Read/Write | Threatlocker Authentication Key to deploy threatlocker Agent on windows machines | - | - | ## Dependencies -- [Automation - Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) - -## Custom Field Creation - -### Step 1 - -Navigate to the `Administration` menu, then proceed to `Devices` and select `Global Custom Fields`. -![Step1](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen and click on it. -![AddButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/addbutton.webp) - -### Step 3 - -After clicking the `Add` button, select the `Field` button that appears. -![FieldButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/fieldbutton.webp) - -The following Pop-up screen will appear: -![InitialCustomFieldPopup](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/initialcustomfieldpopup.webp) -### Step 4 +- [Automation - Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) +- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -Custom Field Type: `Text` -Select `Text` for the `Custom field type` and click `Continue` to proceed. -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp) - -### Step 5 - -A Pop-up screen will appear. Set the following details in the Overview section and click the Next button. - -Label: `cPVAL Threatlocker Auth Key` -Name: `cPVALThreatlockerAuthKey` -Definition Scope: `Organization` -Custom field is required: `` -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image2.webp) - -Clicking the `Next` button will take you to the `Permission` section. - -### Step 5 - -Set the following details in the `Permission` section and click the `Next` button. - -Technician: `Editable` -Automation: `Read/Write` -API: `Read/Write` -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp) - -### Step 6 - -Set the following details in the `Details` section and click the `Create` button to complete the creation of custom field. - -**Description:** `Threatlocker Authentication Key to deploy threatlocker Agent on windows machines` -**Tooltip text:** `` -**Footer text:** `` +## Custom Field Creation -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image4.webp) +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-threatlocker-auth-key.toml) -### Completed Custom Field -![CompleteCustomField](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image5.webp) +## Sample Screenshot -### Example -![Example](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image6.webp) +![Step1](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/authkey.webp) diff --git a/docs/ninjaone/custom-fields/cpval-threatlocker-deployment-exclude.md b/docs/ninjaone/custom-fields/cpval-threatlocker-deployment-exclude.md index 17a84dff31..78c0a3f234 100644 --- a/docs/ninjaone/custom-fields/cpval-threatlocker-deployment-exclude.md +++ b/docs/ninjaone/custom-fields/cpval-threatlocker-deployment-exclude.md @@ -1,111 +1,32 @@ --- id: 'c3329dd9-bdf8-42f6-aacc-bcfde0fa94da' slug: /c3329dd9-bdf8-42f6-aacc-bcfde0fa94da -title: 'cPVAL Threatlocker Deployment - Exclude' -title_meta: 'cPVAL Threatlocker Deployment - Exclude' -keywords: ['Threatlocker','windows','Mac','Deployment'] -description: 'Enable this custom field to exclude the location or device from Threatlocker Deployment.' +title: 'cPVAL ThreatLocker Deployment - Exclude' +title_meta: 'cPVAL ThreatLocker Deployment - Exclude' +keywords: ['threatlocker','windows','mac','deployment'] +description: 'Enable this custom field to exclude the location or device from ThreatLocker Deployment.' tags: ['security','setup','windows','macos'] -draft: False -unlisted: false +draft: false +unlisted: true --- ## Summary -Enable this custom field to exclude the location or device from Threatlocker Deployment. + +Enable this custom field to exclude the location or device from ThreatLocker Deployment. ## Details | Label | Field Name | Definition Scope | Type | Option Value | Default Value | Required | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | | ----- | ---------- | ---------------- | ---- | ------------ | ------------- | --------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | -| cPVAL Threatlocker Deployment - Exclude | cpvalThreatlockerDeploymentExclude| `Device`, `Location` | drop-down | `Yes`, `No` | `No` | False | Editable | Read/Write | Read/Write | Enable this custom field to exclude the location or device from Threatlocker Deployment. | Default is `No` | cPVAL Huntress Install - Exclude | - +| cPVAL ThreatLocker Deployment - Exclude | cpvalThreatLockerDeploymentExclude| `Device`, `Location` | drop-down | `Yes`, `No` | `No` | False | Editable | Read/Write | Read/Write | Enable this custom field to exclude the location or device from ThreatLocker Deployment. | Default is `No` | cPVAL Huntress Install - Exclude | ## Dependencies -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -- [Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) -- [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) -- [Compound Conditions - Threatlocker Depoyment - Windows](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) -- [Compound Conditions - Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) - -## Custom Field Creation - -### Step 1 - -Navigate to the `Administration` menu, then proceed to `Devices` and select `Global Custom Fields`. -![Step1](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen and click on it. -![AddButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/addbutton.webp) - -### Step 3 - -After clicking the `Add` button, select the `Field` button that appears. -![FieldButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/fieldbutton.webp) - -The following Pop-up screen will appear: -![InitialCustomFieldPopup](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/initialcustomfieldpopup.webp) - -### Step 4 - -**Custom Field Type:** `Drop-down` - -Select `Drop-down` for the `Custom field type` and click `Continue` to proceed. -![DropDown](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/dropdown.webp) - -The following Pop-up screen will appear: -![Overview](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedoverview.webp) - -### Step 5 -Set the following details in the `Overview` section and click the `Next` button. +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -**Label:** `cPVAL Threatlocker Deployment - Exclude` -**Name:** `cpvalThreatlockerDeploymentExclude` -**Definition Scope:** `Device`, `Location` -**Custom field is required:** `` -![Image1](../../../static/img/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da/image1.webp) - -Clicking the `Next` button will take you to the `Permission` section. -![Permission](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedpermissions.webp) - -### Step 6 - -Set the following details in the `Permission` section and click the `Next` button. - -**Technician:** `Editable` -**Automation:** `Read/Write` -**API:** `Read/Write` - -![Permission](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedgenericpermissions.webp) - -Clicking the `Next` button will take you to the `Details` tab. -![Details](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advanceddetails.webp) - -### Step 7 - -Fill in the following information in the `Details` section and click the `Next` button. - -**Description:** `Enable this custom field to exclude the location or device from Threatlocker Deployment.` -**Tooltip Text:** `` -**Footer Text:** `Default is "No"` - -![Image2](../../../static/img/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da/image2.webp) - -Clicking the `Next` button will take you to the `Advanced Settings` tab. -![AdvancedSettings](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedsettings.webp) - -### Step 8 - -Configure the following options in the specified order. To add an option, paste it and click the `Add` button: - -- Yes -- No +## Custom Field Creation -Click the `Create` button to create the `Custom Field`. -![Image3](../../../static/img/docs/bdb92684-f093-49f8-9568-09874f9f79d5/image3.webp) ## Completed Custom Field diff --git a/docs/ninjaone/custom-fields/cpval-threatlocker-deployment.md b/docs/ninjaone/custom-fields/cpval-threatlocker-deployment.md index ee91f808bb..abbe1cdf03 100644 --- a/docs/ninjaone/custom-fields/cpval-threatlocker-deployment.md +++ b/docs/ninjaone/custom-fields/cpval-threatlocker-deployment.md @@ -3,7 +3,7 @@ id: 'c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2' slug: /c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2 title: 'cPVAL Threatlocker Deployment' title_meta: 'cPVAL Threatlocker Deployment' -keywords: ['Threatlocker','windows','Mac','Deployment'] +keywords: ['threatlocker','windows','mac','deployment'] description: 'Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level.' tags: ['security','setup','windows','macos'] draft: false @@ -11,106 +11,27 @@ unlisted: false --- ## Summary + Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level. ## Details | Label | Field Name | Definition Scope | Type | Option Value | Default Value | Required | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | | ----- | ---------- | ---------------- | ---- | ------------ | ------------- | --------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | -| cPVAL Threatlocker Deployment | cpvalThreatlockerDeployment | Organization | drop-down | `Windows`, `Windows and Macintosh`, `Disabled` | `Disabled` | False | Editable | Read/Write | Read/Write | Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level. | - | Default is Disabled | +| 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. | | | ## Dependencies + - [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - [Automation - Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) - [Automation - Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) - [Compound Conditions - Threatlocker Depoyment - Windows](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) - [Compound Conditions - Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) -## Custom Field Creation - -### Step 1 - -Navigate to the `Administration` menu, then proceed to `Devices` and select `Global Custom Fields`. -![Step1](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen and click on it. -![AddButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/addbutton.webp) - -### Step 3 - -After clicking the `Add` button, select the `Field` button that appears. -![FieldButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/fieldbutton.webp) - -The following Pop-up screen will appear: -![InitialCustomFieldPopup](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/initialcustomfieldpopup.webp) - -### Step 4 - -**Custom Field Type:** `Drop-down` - -Select `Drop-down` for the `Custom field type` and click `Continue` to proceed. -![DropDown](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/dropdown.webp) - -The following Pop-up screen will appear: -![Overview](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedoverview.webp) - -### Step 5 - -Set the following details in the `Overview` section and click the `Next` button. - -**Label:** `cPVAL Threatlocker Deployment` -**Name:** `cpvalThreatlockerDeployment` -**Definition Scope:** `Organization` -**Custom field is required:** `` - -![Image1](../../../static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image1.webp) - -Clicking the `Next` button will take you to the `Permission` section. -![Permission](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedpermissions.webp) - -### Step 6 - -Set the following details in the `Permission` section and click the `Next` button. - -**Technician:** `Editable` -**Automation:** `Read/Write` -**API:** `Read/Write` - -![Permission](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedgenericpermissions.webp) - -Clicking the `Next` button will take you to the `Details` tab. -![Details](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advanceddetails.webp) - -### Step 7 - -Fill in the following information in the `Details` section and click the `Next` button. - -**Description:** `Enables Threatlocker auto-deployment for Windows or both Windows and Macintosh machines at the organization level.` -**Tooltip Text:** `` -**Footer Text:** `Default is Disabled` - -![Image2](../../../static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image2.webp) - -Clicking the `Next` button will take you to the `Advanced Settings` tab. -![AdvancedSettings](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/advancedsettings.webp) - -### Step 8 - -Configure the following options in the specified order. To add an option, paste it and click the `Add` button: - -- Windows -- Windows and Macintosh -- Disabled - -Click the `Create` button to create the `Custom Field`. -![Image3](../../../static/img/docs/67554954-e8da-48af-bda9-13a6a37c8295/image3.webp) - -## Completed Custom Field +### Custom Field Creation -![Image4](../../../static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image3.webp) +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-threatlocker-deployment.toml) -## Example +## Sample Screenshot -![Image5](../../../static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image4.webp) \ No newline at end of file +![Step1](../../../static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/TL-deployment.webp) \ No newline at end of file diff --git a/docs/ninjaone/custom-fields/cpval-threatlocker-mac-groupkey.md b/docs/ninjaone/custom-fields/cpval-threatlocker-mac-groupkey.md index fba2099126..c42b919e94 100644 --- a/docs/ninjaone/custom-fields/cpval-threatlocker-mac-groupkey.md +++ b/docs/ninjaone/custom-fields/cpval-threatlocker-mac-groupkey.md @@ -3,86 +3,32 @@ id: '8305e5b2-41ee-44bb-848e-758ac72b185f' slug: /8305e5b2-41ee-44bb-848e-758ac72b185f title: 'cPVAL ThreatLocker Mac GroupKey' title_meta: 'cPVAL ThreatLocker Mac GroupKey' -keywords: ['Threatlocker','MAC','GroupKey','Deployment'] -description: 'Stores the Threatlocker group key for agent deployment on Macintosh machines' +keywords: ['threatlocker','windows','groupKey','deployment'] +description: 'Stores the ThreatLocker group key for agent deployment on Macintosh machines' tags: ['security','setup','macos'] draft: false unlisted: false --- ## Summary -Stores the Threatlocker group key for agent deployment on Macintosh machines + +Stores the ThreatLocker group key for agent deployment on Macintosh machines ## Details | Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | | ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | -| -cPVAL ThreatLocker Mac GroupKey | cpvalThreatlockerMacGroupkey | Organization | Text | False | - | Editable | Read/Write | Read/Write | Stores the Threatlocker group key for agent deployment on Macintosh machines | - | - | +| cPVAL ThreatLocker Mac GroupKey | cpvalThreatLockerMacGroupkey | Organization | Text | False | - | Editable | Read/Write | Read/Write | Stores the ThreatLocker group key for agent deployment on Macintosh machines | - | - | ## Dependencies -- [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - -## Custom Field Creation - -### Step 1 - -Navigate to the `Administration` menu, then proceed to `Devices` and select `Global Custom Fields`. -![Step1](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen and click on it. -![AddButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/addbutton.webp) - -### Step 3 - -After clicking the `Add` button, select the `Field` button that appears. -![FieldButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/fieldbutton.webp) - -The following Pop-up screen will appear: -![InitialCustomFieldPopup](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/initialcustomfieldpopup.webp) - -### Step 4 -Custom Field Type: `Text` -Select Text for the `Custom field type` and click `Continue` to proceed. -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp) +- [ThreatLocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -### Step 5 - -A Pop-up screen will appear. Set the following details in the `Overview` section and click the `Next` button. - -Label: `cPVAL ThreatLocker Mac GroupKey` -Name: `cpvalThreatlockerMacGroupkey` -Definition Scope: `Organization` -Custom field is required: `` -![Configuration](../../../static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image1.webp) - -Clicking the `Next` button will take you to the `Permission` section. - -### Step 6 - -Set the following details in the `Permission` section and click the `Next` button. - -Technician: `Editable` -Automation: `Read/Write` -API: `Read/Write` -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp) - -### Step 7 - -Set the following details in the `Details` section and click the `Create` button to complete the creation of custom field. - -**Description:** `Stores the Threatlocker group key for agent deployment on Macintosh machines` -**Tooltip text:** `` -**Footer text:** `` +## Custom Field Creation -![Configuration](../../../static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image2.webp) +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-threatlocker-mac-groupkey.toml) -### Completed Custom Field -![CompleteCustomField](../../../static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image3.webp) +## Sample Screenshot -### Example -![Example](../../../static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image4.webp) +![Step1](../../../static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/macgroup.webp) diff --git a/docs/ninjaone/custom-fields/cpval-threatlockerorganizationname.md b/docs/ninjaone/custom-fields/cpval-threatlockerorganizationname.md index bde77f54f8..f21794f24a 100644 --- a/docs/ninjaone/custom-fields/cpval-threatlockerorganizationname.md +++ b/docs/ninjaone/custom-fields/cpval-threatlockerorganizationname.md @@ -1,87 +1,34 @@ --- id: '573751d4-0648-4da9-8ec3-0ab96d4730de' slug: /573751d4-0648-4da9-8ec3-0ab96d4730de -title: 'cPVAL Threatlocker Organization Name' -title_meta: 'cPVAL Threatlocker Organization Name' -keywords: ['Threatlocker','windows','GroupKey','Deployment'] -description: 'Organization name to be used for Threatlocker deployment. If deploying to an existing organization, the name must match the organization name in the ThreatLocker portal.' +title: 'cPVAL ThreatLocker Organization Name' +title_meta: 'cPVAL ThreatLocker Organization Name' +keywords: ['threatlocker','windows','groupKey','deployment'] +description: 'Organization name to be used for ThreatLocker deployment. If deploying to an existing organization, the name must match the organization name in the ThreatLocker portal.' tags: ['security','setup','windows'] draft: false unlisted: false --- ## Summary -Organization name to be used for Threatlocker deployment. If deploying to an existing organization, the name must match the organization's name in the ThreatLocker portal. + +Organization name to be used for ThreatLocker deployment. If deploying to an existing organization, the name must match the organization's name in the ThreatLocker portal. ## Details | Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | | ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | -| cPVAL Threatlocker Organization Name | cPVALThreatlockerOrganizationName | Organization | Text | False | - | Editable | Read/Write | Read/Write | Organization name to be used for Threatlocker deployment. If deploying to an existing organization, the name must match the organization's name in the ThreatLocker portal. | - | - | +| cPVAL ThreatLocker Organization Name | cPVALThreatLockerOrganizationName | Organization | Text | False | - | Editable | Read/Write | Read/Write | Organization name to be used for ThreatLocker deployment. If deploying to an existing organization, the name must match the organization's name in the ThreatLocker portal. | - | - | ## Dependencies -- [Automation - Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) -- [Solution - Threatlocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) - -## Custom Field Creation - -### Step 1 - -Navigate to the `Administration` menu, then proceed to `Devices` and select `Global Custom Fields`. -![Step1](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/step1.webp) - -### Step 2 - -Locate the `Add` button on the right-hand side of the screen and click on it. -![AddButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/addbutton.webp) - -### Step 3 - -After clicking the `Add` button, select the `Field` button that appears. -![FieldButton](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/fieldbutton.webp) - -The following Pop-up screen will appear: -![InitialCustomFieldPopup](../../../static/img/docs/3ce9e690-2bf1-4e78-9e66-04960f3f1b25/initialcustomfieldpopup.webp) - -### Step 4 -Custom Field Type: `Text` -Select `Text` for the `Custom field type` and click `Continue` to proceed. -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp) +- [Automation - ThreatLocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) +- [Solution - ThreatLocker Deployment [NinjaOne]](/docs/a1efd808-41ad-4dee-9ea1-ff0c2a36e019) -### Step 5 - -A Pop-up screen will appear. Set the following details in the `Overview` section and click the `Next` button. - -Label: `cPVAL Threatlocker Organization Name` -Name: `cpvalThreatlockerOrganizationName` -Definition Scope: `Organization` -Custom field is required: `` -![Configuration](../../../static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image1.webp) - -Clicking the `Next` button will take you to the `Permission` section. - -### Step 5 - -Set the following details in the `Permission` section and click the `Next` button. - -Technician: `Editable` -Automation: `Read/Write` -API: `Read/Write` -![Configuration](../../../static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp) - -### Step 6 - -Set the following details in the `Details` section and click the `Create` button to complete the creation of custom field. - -**Description:** `Organization name to be used for Threatlocker deployment. If deploying to an existing organization, the name must match the organization's name in the ThreatLocker portal.` -**Tooltip text:** `` -**Footer text:** `` +## Custom Field Creation -![Configuration](../../../static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image2.webp) +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-threatlocker-organization-name.toml) -### Completed Custom Field -![CompleteCustomField](../../../static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image3.webp) +## Sample Screenshot -### Example -![Example](../../../static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image4.webp) +![Step1](../../../static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/orgname.webp) \ No newline at end of file diff --git a/docs/solutions/threatlocker-deployment-ninja-one.md b/docs/solutions/threatlocker-deployment-ninja-one.md index 3b30d314b4..8cce412fa3 100644 --- a/docs/solutions/threatlocker-deployment-ninja-one.md +++ b/docs/solutions/threatlocker-deployment-ninja-one.md @@ -26,20 +26,19 @@ This solution is designed to configure the automatic deployment of the Threatloc | [cPVAL Threatlocker Organization Name](/docs/573751d4-0648-4da9-8ec3-0ab96d4730de) | Text | | Fill it with the organization name under which the Threatlocker agent is to be installed in Threatlocker Portal | | [cPVAL ThreatLocker Mac GroupKey](/docs/8305e5b2-41ee-44bb-848e-758ac72b185f) | Text | | Stores one or more tags, separated by commas (optional).| - ### Automation | Content | Function | -| ------- | -------- | -| [Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) | Installs Threatlocker agent on Windows operating systems. | -| [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) | Installs Threatlocker agent on Macintosh operating systems. | +| ------- | -------- | +| [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. | ### Compound Conditions | Content | Function | -| ------- | -------- | +| ------- | -------- | | [Threatlocker Depoyment - Windows](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) | Triggers the [Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) automation on Windows machines where deployment is enabled and `Threatlocker` is not installed. | -| [Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) | Triggers the [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) automation on Macintosh machines where deployment is enabled and `Threatlocker` is not installed. | +| [Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) | Triggers the [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) automation on Macintosh machines where deployment is enabled and `Threatlocker` is not installed. | ## Implementation @@ -48,24 +47,57 @@ This solution is designed to configure the automatic deployment of the Threatloc Create the following custom fields: - [cPVAL Threatlocker Deployment](/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2) -- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) +- [cPVAL Threatlocker Deployment - Exclude](/docs/c3329dd9-bdf8-42f6-aacc-bcfde0fa94da) - [cPVAL Threatlocker Auth Key](/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a) - [cPVAL Threatlocker Organization Name](/docs/573751d4-0648-4da9-8ec3-0ab96d4730de) -- [cPVAL ThreatLocker Mac GroupKey](/docs/8305e5b2-41ee-44bb-848e-758ac72b185f) +- [cPVAL ThreatLocker Mac GroupKey](/docs/8305e5b2-41ee-44bb-848e-758ac72b185f) + ### Step 2 Create the following automations: -- [Threatlocker Deployment](/docs/1196b011-bfba-486a-8653-92066f19e527) -- [Threatlocker Deployment [MAC]](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) +- [Threatlocker Deployment](/docs/11444307-4a3f-4388-b5c5-096a50725b4e) +- [Threatlocker Deployment - MAC](/docs/1196b011-bfba-486a-8653-92066f19e527) ### Step 3 -Create the [Threatlocker Depoyment - Windows](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) compound condition for both default agent policies: `Windows Server [Default]` and `Windows Workstation [Default]`. The example in the [document](/docs/73daf0e3-7d35-415b-ab69-386ddd7377e0) illustrates the deployment process for the `Windows Workstations [Default]` agent policy. It is also recommended to apply this compound condition to the `Windows Server [Default]` agent policy, following the same process. -![Image1](../../static/img/docs/e0ad73d2-fcab-43f0-9866-72a48623ef48/image1.webp) +Create the following Compound conditions: + +Create the [Threatlocker Depoyment - Windows](/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28) compound condition for both default agent policies: `Windows Server [Default]` and `Windows Workstation [Default]`. ### Step 4 -Create the [Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) compound condition for both default agent policies: `Mac Server [Default]` and `Mac [Default]`. The example in the [document](/docs/6e7c65c3-3a14-433e-9cbb-617674c1aff0) illustrates the deployment process for the `Mac [Default]` agent policy. It is also recommended to apply this compound condition to the `Mac Server [Default]` agent policy, following the same process. -![Image2](../../static/img/docs/e0ad73d2-fcab-43f0-9866-72a48623ef48/image2.webp) +Create the [Threatlocker Deployment - MAC](/docs/73470264-63c3-43d1-a727-1e813cfe768d) compound condition for both default agent policies: `Mac Server [Default]` and `Mac [Default]`. + +## FAQ + +**Q. What is this solution used for?** + +**A.** This solution is used to automatically deploy the ThreatLocker agent on Windows and macOS endpoints managed by NinjaOne when the agent is missing. It ensures consistent security coverage without requiring manual installation. + + +**Q. Which operating systems are supported**? + +**A.** Windows and macOS + +**Q. Will this reinstall ThreatLocker if it is already installed?** + +**A.** No. The compound conditions explicitly check whether the ThreatLocker agent is not installed. If the agent is already present, the deployment script will not run. + +**Q. Where are the ThreatLocker credentials stored?** + +**A.** Credentials are stored securely using NinjaOne Custom Fields: + * Windows Auth Key: cPVAL Threatlocker Auth Key + * Windows Organization Name: cPVAL Threatlocker Organization Name + * macOS Group Key: cPVAL ThreatLocker Mac GroupKey + +These values are retrieved dynamically at runtime by the deployment scripts. + +**Q. Can this be enabled or disabled per organization?** + +**A.** Yes. The custom field cPVAL Threatlocker Deployment controls whether automatic deployment is enabled at the organization level. This allows granular control over where ThreatLocker is deployed. + +**Q. Does this require user interaction?** + +**A.** No. The deployment runs silently in the background via NinjaOne automations and does not require any user interaction. diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/authkey.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/authkey.webp new file mode 100644 index 0000000000..8ee48d3d35 Binary files /dev/null and b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/authkey.webp differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp deleted file mode 100644 index a6f754d0fd..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image1.webp and /dev/null differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image2.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image2.webp deleted file mode 100644 index b9d45ec97b..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image2.webp and /dev/null differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp deleted file mode 100644 index e3041382e9..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image3.webp and /dev/null differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image4.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image4.webp deleted file mode 100644 index 11e0b699a1..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image4.webp and /dev/null differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image5.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image5.webp deleted file mode 100644 index 76f51435ee..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image5.webp and /dev/null differ diff --git a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image6.webp b/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image6.webp deleted file mode 100644 index 962c73959a..0000000000 Binary files a/static/img/docs/0ff9eab8-6df8-4154-9ecc-4f5bdedd648a/image6.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image1.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image1.webp deleted file mode 100644 index bff772f9ce..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image1.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image2.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image2.webp deleted file mode 100644 index cdaae63eba..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image2.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image3.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image3.webp deleted file mode 100644 index 8e4e10afad..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image3.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image4.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image4.webp deleted file mode 100644 index 41ca60aab7..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image4.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image5.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image5.webp deleted file mode 100644 index 36b5ec4737..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image5.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image6.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image6.webp deleted file mode 100644 index 7e36d71543..0000000000 Binary files a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/image6.webp and /dev/null differ diff --git a/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/samplerun.webp b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/samplerun.webp new file mode 100644 index 0000000000..fa27d8f7e3 Binary files /dev/null and b/static/img/docs/11444307-4a3f-4388-b5c5-096a50725b4e/samplerun.webp differ diff --git a/static/img/docs/1196b011-bfba-486a-8653-92066f19e527/samplerun.webp b/static/img/docs/1196b011-bfba-486a-8653-92066f19e527/samplerun.webp new file mode 100644 index 0000000000..23faa7bdf1 Binary files /dev/null and b/static/img/docs/1196b011-bfba-486a-8653-92066f19e527/samplerun.webp differ diff --git a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image1.webp b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image1.webp deleted file mode 100644 index f427bd4d2c..0000000000 Binary files a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image1.webp and /dev/null differ diff --git a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image2.webp b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image2.webp deleted file mode 100644 index a9de6fb0e5..0000000000 Binary files a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image2.webp and /dev/null differ diff --git a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image3.webp b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image3.webp deleted file mode 100644 index 62cb4b07bc..0000000000 Binary files a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image3.webp and /dev/null differ diff --git a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image4.webp b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image4.webp deleted file mode 100644 index b412a3f6dc..0000000000 Binary files a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/image4.webp and /dev/null differ diff --git a/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/orgname.webp b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/orgname.webp new file mode 100644 index 0000000000..af53c3322a Binary files /dev/null and b/static/img/docs/573751d4-0648-4da9-8ec3-0ab96d4730de/orgname.webp differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image1.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image1.webp deleted file mode 100644 index 2c12081c71..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image1.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image2.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image2.webp deleted file mode 100644 index 8e5ea441ef..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image2.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image3.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image3.webp deleted file mode 100644 index 3b3c6f572f..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image3.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image4.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image4.webp deleted file mode 100644 index 6a036cbd04..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image4.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image5.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image5.webp deleted file mode 100644 index 99a43ee7ee..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image5.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image6.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image6.webp deleted file mode 100644 index 533e4f89e1..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image6.webp and /dev/null differ diff --git a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image7.webp b/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image7.webp deleted file mode 100644 index 69d7920a04..0000000000 Binary files a/static/img/docs/73470264-63c3-43d1-a727-1e813cfe768d/image7.webp and /dev/null differ diff --git a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image1.webp b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image1.webp deleted file mode 100644 index 523f38b6b2..0000000000 Binary files a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image1.webp and /dev/null differ diff --git a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image2.webp b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image2.webp deleted file mode 100644 index e317505bbc..0000000000 Binary files a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image2.webp and /dev/null differ diff --git a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image3.webp b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image3.webp deleted file mode 100644 index de44714613..0000000000 Binary files a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image3.webp and /dev/null differ diff --git a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image4.webp b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image4.webp deleted file mode 100644 index e9c69528d4..0000000000 Binary files a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/image4.webp and /dev/null differ diff --git a/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/macgroup.webp b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/macgroup.webp new file mode 100644 index 0000000000..3c6b88bbe2 Binary files /dev/null and b/static/img/docs/8305e5b2-41ee-44bb-848e-758ac72b185f/macgroup.webp differ diff --git a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/TL-deployment.webp b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/TL-deployment.webp new file mode 100644 index 0000000000..ae23ac7829 Binary files /dev/null and b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/TL-deployment.webp differ diff --git a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image1.webp b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image1.webp deleted file mode 100644 index 6ba0ca80b1..0000000000 Binary files a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image1.webp and /dev/null differ diff --git a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image2.webp b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image2.webp deleted file mode 100644 index 44242e7178..0000000000 Binary files a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image2.webp and /dev/null differ diff --git a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image3.webp b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image3.webp deleted file mode 100644 index 2e88990855..0000000000 Binary files a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image3.webp and /dev/null differ diff --git a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image4.webp b/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image4.webp deleted file mode 100644 index 09e04fe375..0000000000 Binary files a/static/img/docs/c7aa0c9d-9b6b-4a78-bbf4-01a626acd6c2/image4.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image1.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image1.webp deleted file mode 100644 index 4394f766de..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image1.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image10.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image10.webp deleted file mode 100644 index 09bf7dea61..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image10.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image2.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image2.webp deleted file mode 100644 index 126975e35b..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image2.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image3.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image3.webp deleted file mode 100644 index 6e8cf211c3..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image3.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image4.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image4.webp deleted file mode 100644 index e92741158e..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image4.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image5.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image5.webp deleted file mode 100644 index cee63da286..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image5.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image6.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image6.webp deleted file mode 100644 index 1720435d58..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image6.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image7.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image7.webp deleted file mode 100644 index 9f6edc7456..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image7.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image8.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image8.webp deleted file mode 100644 index fae8f4a7a0..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image8.webp and /dev/null differ diff --git a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image9.webp b/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image9.webp deleted file mode 100644 index aa0b2698a2..0000000000 Binary files a/static/img/docs/d7ba7616-f11d-4961-90fb-9e7cf9ed6f28/image9.webp and /dev/null differ