doc.rustdesk.com/content/self-host/client-deployment/integrations/tactical-rmm/_index.en.md
2023-09-22 22:13:37 +01:00

113 lines
3.6 KiB
Markdown

---
title: Tactical RMM
weight: 100
---
## To Use Tactical RMM with RustDesk, you must do the following
1. Install your own Tactical RMM Server, following their [official docs](https://docs.tacticalrmm.com/) and open ports.
2. Create the following scripts (all are PowerShell).
3. Create a [URL Action](https://docs.tacticalrmm.com/functions/url_actions/).
4. Create [custom fields](https://docs.tacticalrmm.com/functions/custom_fields/) for the RustDesk ID and password.
5. Create [collector tasks](https://docs.tacticalrmm.com/functions/automated_tasks/#collector-tasks).
## Install Script Replace IPADDRESS and KEY
```ps
$ErrorActionPreference= 'silentlycontinue'
If (!(Test-Path C:\Temp)) {
New-Item -ItemType Directory -Force -Path C:\Temp > null
}
cd C:\Temp
Invoke-WebRequest "https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-x86_64.exe" -Outfile "rustdesk.exe"
Start-Process .\rustdesk.exe --silent-install -wait
$ServiceName = 'Rustdesk'
$arrService = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
if ($arrService -eq $null)
{
Start-Sleep -seconds 20
}
while ($arrService.Status -ne 'Running')
{
Start-Service $ServiceName
Start-Sleep -seconds 5
$arrService.Refresh()
}
net stop rustdesk
$username = ((Get-WMIObject -ClassName Win32_ComputerSystem).Username).Split('\')[1]
Remove-Item C:\Users\$username\AppData\Roaming\RustDesk\config\RustDesk2.toml
New-Item C:\Users\$username\AppData\Roaming\RustDesk\config\RustDesk2.toml
Set-Content C:\Users\$username\AppData\Roaming\RustDesk\config\RustDesk2.toml "rendezvous_server = 'IPADDRESS' `nnat_type = 1`nserial = 0`n`n[options]`ncustom-rendezvous-server = 'IPADDRESS'`nkey = 'KEY='`nrelay-server = 'IPADDRESS'`napi-server = 'https://IPADDRESS'"
Remove-Item C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\RustDesk\config\RustDesk2.toml
New-Item C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\RustDesk\config\RustDesk2.toml
Set-Content C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\RustDesk\config\RustDesk2.toml "rendezvous_server = 'IPADDRESS' `nnat_type = 1`nserial = 0`n`n[options]`ncustom-rendezvous-server = 'IPADDRESS'`nkey = 'KEY='`nrelay-server = 'IPADDRESS'`napi-server = 'https://IPADDRESS'"
net start rustdesk
```
## RustDesk Get ID (Collector Script needs Custom Agent Field)
```ps
$ErrorActionPreference= 'silentlycontinue'
cd $env:ProgramFiles\RustDesk\
.\RustDesk.exe --get-id | out-host
```
## Create Script to be used as a Check
```
$ErrorActionPreference= 'silentlycontinue'
$confirmation_file = "C:\program files\RustDesk\rdrunonce.txt"
if ([System.IO.File]::Exists($confirmation_file)) {
echo "Confirmation file exists"
exit 0
}
else
{
echo "Confirmation file doesn't exists"
exit 1
}
```
## RustDesk Set and Get Password (Collector Script needs Custom Agent Field) to run on Check Failure
```
$ErrorActionPreference= 'silentlycontinue'
$confirmation_file = "C:\program files\RustDesk\rdrunonce.txt"
net stop rustdesk > null
$ProcessActive = Get-Process rustdesk -ErrorAction SilentlyContinue
if($ProcessActive -ne $null)
{
stop-process -ProcessName rustdesk -Force
}
$rustdesk_pw = (-join ((65..90) + (97..122) | Get-Random -Count 12 | % {[char]$_}))
Start-Process "$env:ProgramFiles\RustDesk\RustDesk.exe" "--password $rustdesk_pw" -wait
Write-Output $rustdesk_pw
net start rustdesk > null
New-Item $confirmation_file > null
```
## RustDesk URL Action
```
rustdesk://connection/new/{{agent.rustdeskid}}?password={{agent.rustdeskpwd}}
```
## Add Custom Agent Fields
`rustdeskid Type = Text` </br>
`rustdeskpwd Type = Text`