diff --git a/docs/ninjaone/automations/lock-stolen-system.md b/docs/ninjaone/automations/lock-stolen-system.md new file mode 100644 index 000000000..c7451dc5c --- /dev/null +++ b/docs/ninjaone/automations/lock-stolen-system.md @@ -0,0 +1,44 @@ +--- +id: '0f78be64-557a-4c0e-b7cf-e2ba41e71374' +slug: /0f78be64-557a-4c0e-b7cf-e2ba41e71374 +title: 'Lock Stolen System' +title_meta: 'Lock Stolen System' +keywords: ['lock','stolen','system'] +description: 'This script is used to track and lock down stolen systems. If Custom Field `cPVAL System Lockdown` is marked, it will enable BitLocker and shut down the computer.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Overview +This script is used to track and lock down stolen systems. If Custom Field `cPVAL System Lockdown` is marked, it will enable BitLocker and shut down the computer. + +## Sample Run + +`Play Button` > `Run Automation` > `Script` +![SampleRun1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/samplerun1.webp) + +![Image1](../../../static/img/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374/image1.webp) + +## Dependencies +- [Custom Field - cPVAL Mark System as Stolen](/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6) +- [Custom Field - cPVAL System Lockdown ](/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a) +- [Custom Field - cPVAL Current Location and IP Details](/docs/85cb62ba-6e5f-4235-9964-975af04658d0) +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Parameters + +| Name | Example | Required | Default | Type | Description | +| ---- | ------- | -------- | ------- | ---- | ----------- | +| BitlockerMessage | This system been marked as lost, please contact support@provaltech.com | False| This system been marked as lost, please contact xyz@abc.com | String/Text | The message to display on the BitLocker lock screen. **Please update the email address while configuring the script.** | +| BitlockerPassword | P@##word123 | False| P@##word123 | String/Text | The password to use to enable BitLocker on the target machine. **You can update the default password while configuring the script.**| + + +## Automation Setup/Import + +[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/lock-stolen-system.ps1) + +## Output + +- Activity Details +- Custom Field diff --git a/docs/ninjaone/compound-conditions/lock-stolen-systems.md b/docs/ninjaone/compound-conditions/lock-stolen-systems.md new file mode 100644 index 000000000..6e86c348e --- /dev/null +++ b/docs/ninjaone/compound-conditions/lock-stolen-systems.md @@ -0,0 +1,30 @@ +--- +id: '705b400b-28fc-4c01-95a6-edbf43960122' +slug: /705b400b-28fc-4c01-95a6-edbf43960122 +title: 'Lock Stolen Systems' +title_meta: 'Lock Stolen Systems' +keywords: ['lock','stolen','system'] +description: 'This condition triggers the `Lock Stolen Systems` script on Windows machines where `cPVAL Mark System as Stolen` is selected.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Summary +This compound condition triggers the [Lock Stolen Systems](/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374) script on Windows machines where [cPVAL Mark System as Stolen](/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6) is selected. + + +## Details + +- **Name:** `Lock Stolen Systems` +- **Description:** `This condition triggers the "Lock Stolen Systems" script on Windows machines where "cPVAL Mark System as Stolen" is selected.` +- **Recommended Agent Policies:** `Windows Workstation Policy` + +## Dependencies +- [Custom Field - cPVAL Mark System as Stolen](/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6) +- [Automation - Lock Stolen System ](/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374) +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Compound Condition Creation + +- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/lock-stolen-systems.toml) diff --git a/docs/ninjaone/custom-fields/cpval-current-location-and-ip-details.md b/docs/ninjaone/custom-fields/cpval-current-location-and-ip-details.md new file mode 100644 index 000000000..baf21ed48 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-current-location-and-ip-details.md @@ -0,0 +1,30 @@ +--- +id: '85cb62ba-6e5f-4235-9964-975af04658d0' +slug: /85cb62ba-6e5f-4235-9964-975af04658d0 +title: 'cPVAL Current Location and IP Details' +title_meta: 'cPVAL Current Location and IP Details' +keywords: ['lock','stolen','system'] +description: 'It stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address. This custom field is populated by `Lock Stolen System` solution.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Summary +It stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address. This custom field is populated by `Lock Stolen System` solution. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | Custom Field Tab Name | +| ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | ----------- | +| cPVAL Current Location and IP Details | cpvalCurrentLocationAndIpDetails | `Devices` | Text | No | | Editable | Read_Write | Read_Write | It stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address. This custom field is populated by `Lock Stolen System` solution. | Stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address.| Stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address. | Lock Stolen System | + +## Dependencies +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-current-location-and-ip-details.toml) + +## Sample Screenshot +![Sample ScreenShot](../../../static/img/docs/85cb62ba-6e5f-4235-9964-975af04658d0/samplescreenshot.webp) diff --git a/docs/ninjaone/custom-fields/cpval-mark-system-as-stolen.md b/docs/ninjaone/custom-fields/cpval-mark-system-as-stolen.md new file mode 100644 index 000000000..5f1c155e1 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-mark-system-as-stolen.md @@ -0,0 +1,31 @@ +--- +id: '20a99ff3-a63d-4f73-bd48-3bb8d66626e6' +slug: /20a99ff3-a63d-4f73-bd48-3bb8d66626e6 +title: 'cPVAL Mark System as Stolen' +title_meta: 'cPVAL Mark System as Stolen' +keywords: ['lock','stolen','system'] +description: 'Mark this Custom Field to mark a Computer as stolen. Selecting this, will enable `Lock Stolen System solution` on the machine.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Summary +Mark this Custom Field to mark a Computer as stolen. Selecting this, will enable `Lock Stolen System solution` on the machine. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | Custom Field Tab Name | +| ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | ----------- | +| cPVAL Mark System as Stolen | cpvalMarkSystemAsStolen | `Devices` | Checkbox | No | | Editable | Read_Write | Read_Write | Mark this Custom Field to mark a Computer as stolen. Selecting this, will enable `Lock Stolen System solution` on the machine | Select this Custom Field to mark a Computer as stolen.| Select this Custom Field to mark a Computer as stolen. | Lock Stolen System | + +## Dependencies +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-mark-system-as-stolen.toml) + +## Sample Screenshot + +![Sample ScreenShot](../../../static/img/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6/samplescreenshot.webp) \ No newline at end of file diff --git a/docs/ninjaone/custom-fields/cpval-system-lockdown.md b/docs/ninjaone/custom-fields/cpval-system-lockdown.md new file mode 100644 index 000000000..2278e61a9 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-system-lockdown.md @@ -0,0 +1,33 @@ +--- + +id: '4b18c9bf-8aea-41a5-8242-77dfcfd0042a' +slug: /4b18c9bf-8aea-41a5-8242-77dfcfd0042a +title: 'cPVAL System Lockdown' +title_meta: 'cPVAL System Lockdown' +keywords: ['lock','stolen','system'] +description: 'Mark this to lock down the machine once it comes online. `Lock Stolen System` solution will not enable BitLocker and shut down the computer if this is not flagged.' +tags: ['connectwise'] +draft: false +unlisted: false + +--- + +## Summary +Mark this to lock down the machine once it comes online. 'Lock Stolen System' solution will not enable BitLocker and shut down the computer if this is not flagged. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | Custom Field Tab Name | +| ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | -------- | ----------- | ----------- | +| cPVAL System Lockdown | cpvalSystemLockdown | `Devices` | Checkbox | No | | Editable | Read_Write | Read_Write | Mark this to lock down the machine once it comes online. 'Lock Stolen System' solution will not enable BitLocker and shut down the computer if this is not flagged. | Check this to lock down the machine once it comes online.| Check this to lock down the machine once it comes online. | Lock Stolen System | + +## Dependencies +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-system-lockdown.toml) + +## Sample Screenshot + +![Sample ScreenShot](../../../static/img/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a/samplescreenshot.webp) \ No newline at end of file diff --git a/docs/ninjaone/cw-manage-ticket-templates/lock-stolen-system.md b/docs/ninjaone/cw-manage-ticket-templates/lock-stolen-system.md new file mode 100644 index 000000000..1ecd4c83c --- /dev/null +++ b/docs/ninjaone/cw-manage-ticket-templates/lock-stolen-system.md @@ -0,0 +1,27 @@ +--- +id: 'be59a0a6-33da-4ef2-8baf-848d47ba2ac0' +slug: /be59a0a6-33da-4ef2-8baf-848d47ba2ac0 +title: 'Lock Stolen System' +title_meta: 'Lock Stolen System' +keywords: ['lock','stolen','system'] +description: 'This ticket template configures how a ConnectWise Manage ticket will be generated in response to the `Lock Stolen Systems` condition.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Overview + +This ticket template configures how a ConnectWise Manage ticket will be generated in response to the [Lock Stolen Systems](/docs/705b400b-28fc-4c01-95a6-edbf43960122) condition. + +## Requirement + +Ensure that the ConnectWise Manage app is enabled and connected. +![Requirement](../../../static/img/docs/86a9b907-a95e-48a8-a304-2bb243c3b6a1/requirement.webp) + +## Dependencies +- [Solution - Lock Stolen System](/docs/13b4df99-df9b-4a57-bc0f-8675c68be028) + +## Template Creation + +[CW Manage Ticket Template Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/cw-manage-ticket-templates/lock-stolen-system.toml) diff --git a/docs/solutions/lock-stolen-system-ninja.md b/docs/solutions/lock-stolen-system-ninja.md new file mode 100644 index 000000000..bb211a4cf --- /dev/null +++ b/docs/solutions/lock-stolen-system-ninja.md @@ -0,0 +1,37 @@ +--- +id: '13b4df99-df9b-4a57-bc0f-8675c68be028' +slug: /13b4df99-df9b-4a57-bc0f-8675c68be028 +title: 'Lock Stolen System' +title_meta: 'Lock Stolen System' +keywords: ['Lock','Stolen','System'] +description: 'TThe purpose of this solution is to track and lock down stolen systems.' +tags: ['connectwise'] +draft: false +unlisted: false +--- + +## Purpose + +The purpose of this NinjaOne solution is to track and lock down stolen systems. + +## Associated Content + +| Content | Type | Function | +|-----------------------------------------------------|-----------------------------------------------------------|--------------------------------------------------------| +| [cPVAL Mark System as Stolen](/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6) | Custom Field | Mark this Custom Field to mark a Computer as stolen. Selecting this, will enable `Lock Stolen System solution` on the machine.| +| [cPVAL System Lockdown ](/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a) | Custom Field | Mark this to lock down the machine once it comes online. 'Lock Stolen System' solution will not enable BitLocker and shut down the computer if this is not flagged. | +| [cPVAL Current Location and IP Details](/docs/85cb62ba-6e5f-4235-9964-975af04658d0) | Custom Field | It stores the Current IP address of the machine. Current city, Current state and Current coordinates of the machine according to the IP address. This custom field is populated by `Lock Stolen System` solution. | +| [ Lock Stolen System ](/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374) | Automation | This script is used to track and lock down stolen systems. If Custom Field `cPVAL System Lockdown` is marked, it will enable BitLocker and shut down the computer. | +| [Lock Stolen System ](/docs/705b400b-28fc-4c01-95a6-edbf43960122) | Compound Condition | This condition triggers the `Lock Stolen Systems` script on Windows machines where `cPVAL Mark System as Stolen` is selected. | +| [Lock Stolen System ](/docs/be59a0a6-33da-4ef2-8baf-848d47ba2ac0) | Ticket Template | This ticket template configures how a ConnectWise Manage ticket will be generated in response to the `Lock Stolen Systems` condition. | + +## Implementation + +- Create the below Custom Fields using the implementation instruction provided in the documents. + - [cPVAL Mark System as Stolen](/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6) + - [cPVAL System Lockdown ](/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a) + - [cPVAL Current Location and IP Details](/docs/85cb62ba-6e5f-4235-9964-975af04658d0) +- Create the below automations as per the implementation instruction provided in the documents. + - [Automation - Lock Stolen System ](/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374) +- Create the [Ticket Template - Lock Stolen System ](/docs/be59a0a6-33da-4ef2-8baf-848d47ba2ac0) as per the implementation instruction provided in the document. +- Create the [Compound Condition - Lock Stolen System ](/docs/705b400b-28fc-4c01-95a6-edbf43960122) as per the implementation instruction provided in the document. diff --git a/static/img/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374/image1.webp b/static/img/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374/image1.webp new file mode 100644 index 000000000..d120035e5 Binary files /dev/null and b/static/img/docs/0f78be64-557a-4c0e-b7cf-e2ba41e71374/image1.webp differ diff --git a/static/img/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6/samplescreenshot.webp b/static/img/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6/samplescreenshot.webp new file mode 100644 index 000000000..70ee68678 Binary files /dev/null and b/static/img/docs/20a99ff3-a63d-4f73-bd48-3bb8d66626e6/samplescreenshot.webp differ diff --git a/static/img/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a/samplescreenshot.webp b/static/img/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a/samplescreenshot.webp new file mode 100644 index 000000000..8c6273930 Binary files /dev/null and b/static/img/docs/4b18c9bf-8aea-41a5-8242-77dfcfd0042a/samplescreenshot.webp differ diff --git a/static/img/docs/85cb62ba-6e5f-4235-9964-975af04658d0/samplescreenshot.webp b/static/img/docs/85cb62ba-6e5f-4235-9964-975af04658d0/samplescreenshot.webp new file mode 100644 index 000000000..dee75b8ed Binary files /dev/null and b/static/img/docs/85cb62ba-6e5f-4235-9964-975af04658d0/samplescreenshot.webp differ