> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate with existing remote access tools

> Integrate Splashtop, AnyDesk, TeamViewer, RustDesk, and other remote access tools with Gorelo by configuring custom asset fields and URL launch shortcuts.

Follow this guide to integrate other tools in Gorelo, like Splashtop, AnyDesk, TeamViewer, etc.

You can integrate Gorelo with any remote access tool that supports launching via a URL, like Splashtop, AnyDesk, or TeamViewer.

This example uses:

* Splashtop Business
* RustDesk
* Webroot

<Tabs>
  <Tab title="Splashtop">
    <Steps>
      <Step title="Create the custom asset field.">
        1. Navigate to **Settings** > **Assets** > **[Custom Fields](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields).**
        2. Add custom field with the following details:
           * **Name**: `Splashtop SUUID`
           * **Variable**: `splashtopSUUID`

        <Frame>
          <img src="https://mintcdn.com/gorelo/VNk9kGyLTQMfiA_W/images/image-93.png?fit=max&auto=format&n=VNk9kGyLTQMfiA_W&q=85&s=fa3d59e87f10da576bb7b5435b89496c" alt="Image" width="784" height="606" data-path="images/image-93.png" />
        </Frame>
      </Step>

      <Step title="Write the script.">
        1. Navigate to **[Scripts](https://app.gorelo.io/Asset/script-list).**
        2. Create a script with the following details:
           * **Name**: `Store-SplashtopSUUID`
           * **Content**:

        ```powershell theme={null}
        # Define registry path for 64-bit machines
        $regPath64 = "HKLM:\SOFTWARE\WOW6432Node\Splashtop Inc.\Splashtop Remote Server"

        # Define the value name for the SUUID
        $regValue = "SUUID"

        # Try to retrieve the SUUID from the 64-bit registry
        if (Test-Path $regPath64) {
            try {
                $suuid = Get-ItemProperty -Path $regPath64 -Name $regValue -ErrorAction Stop
                
                # Check if the SUUID value is present
                if ($suuid.$regValue) {
                    $suuidValue = $suuid.$regValue
                    Write-Output "Splashtop SUUID: $suuidValue"
                    
                    # Write the SUUID to the Gorelo custom field
                    GoreloAction -SetCustomField -Name 'asset.splashtopSUUID' -Value $suuidValue
                } else {
                    Write-Output "SUUID not found in the registry."
                }
            } catch {
                Write-Output "Error retrieving SUUID from the registry: $_"
            }
        } else {
            Write-Output "Splashtop registry not found."
        }
        ```
      </Step>

      <Step title="Deploy the script via a policy.">
        1. Navigate to **[Policies](https://app.gorelo.io/Asset/policy-management).**
        2. Edit an existing policy that covers the assets you want to store the Splashtop SUUID for.
        3. Add the `Store-SplashtopSUUID` script and set to repeat daily at your preferred time.
        4. **Save** and **distribute** the policy.
      </Step>

      <Step title="Create the shortcut.">
        1. Navigate to **[Asset Shortcuts](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts).**
        2. Add a new shortcut with the following details:
           * **Name**: `Splashtop`
           * **URL**: `t-business://com.splashtop.business?account=&uuid={{$gorelo:asset.splashtopSUUID}}&sessiontype=remote`
           * **Pinned Name**:  `Splashtop`
                     <Frame>
                       <img src="https://mintcdn.com/gorelo/VNk9kGyLTQMfiA_W/images/image-94.png?fit=max&auto=format&n=VNk9kGyLTQMfiA_W&q=85&s=6f6a457fb40ae89f476e82e9493affdb" alt="Image 94" width="776" height="756" data-path="images/image-94.png" />
                     </Frame>
             You should now see the **SPLASHTOP** shortcut up the top-right corner of the Asset Detail page. If the script successfully populated the `$gorelo:asset.splashtopSUUID` variable, then this shortcut will launch the Splashtop Business application.
                     <Frame>
                       <img src="https://mintcdn.com/gorelo/VNk9kGyLTQMfiA_W/images/image-95.png?fit=max&auto=format&n=VNk9kGyLTQMfiA_W&q=85&s=c904bd21d026b986eb127ecb9c8d72d0" alt="Image" width="310" height="211" data-path="images/image-95.png" />
                     </Frame>
      </Step>
    </Steps>

    The shortcut does not install Splashtop -- another script would need to be used for that, for example:

    ```powershell theme={null}
    # Installs Splashtop Streamer using the installer MSI uploaded to $gorelo:file.splashtopInstaller
    # Runs a silent install using the 12-digit deployment key at $gorelo:client.splashtopKey

    #Check for presence of SplashtopKey
    if ([string]::IsNullOrEmpty($gorelo:client.splashtopKey)) {
    Write-Output "No SplashTop Key stored for this client. Automatic installation cancelled."
    GoreloAction -Alert -Severity 3 -Name "No Splashtop Key stored for this client" -Description "No Splashtop Key is stored in the client custom field so the automatic installation has been cancelled" -Suppress 0
    } else {
    Write-Output "Splashtop Key Found: " $gorelo:client.splashtopKey
    Write-Output "Installer Path: " $gorelo:file.splashtopInstaller
    }

    #Install Splashtop
    msiexec /i $gorelo:file.splashtopInstaller USERINFO="dcode=$gorelo:client.splashtopKey,hidewindow=1,confirm_d=0" /qn /norestart
    ```
  </Tab>

  <Tab title="RustDesk">
    It is strongly recommended to host your own RustDesk server and modify the initial install script to support this.

    <Steps>
      <Step title="Create the custom asset field.">
        1. Navigate to **Settings** > **Assets** > **[Custom Fields](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields).**
        2. Add custom field with the following details:
           * **Name**: RustDesk ID
           * **Variable**: rustdeskID
                     <Frame>
                       <img src="https://mintcdn.com/gorelo/U5LP8ONeOiG8YFD5/images/image-99.png?fit=max&auto=format&n=U5LP8ONeOiG8YFD5&q=85&s=269f2deb3032c4d2820a8a5c961a4e1a" alt="Image" width="803" height="622" data-path="images/image-99.png" />
                     </Frame>
        3. Add custom field with the following details:
           * **Name**: RustDesk Password
           * **Variable**: rustdeskPassword
                     <Frame>
                       <img src="https://mintcdn.com/gorelo/lqwr7vR8TnJnU6L2/images/image-100.png?fit=max&auto=format&n=lqwr7vR8TnJnU6L2&q=85&s=bbc282d1359062edafaed06e986119bd" alt="Image" width="802" height="618" data-path="images/image-100.png" />
                     </Frame>
      </Step>

      <Step title="Upload the installer file.">
        1. Navigate to **Settings** > Asset > [**<u>Files</u>**](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)
        2. Add a file with the following details:
           * **File**: Upload the latest RustDesk MSI installer
           * **Variable**: rustdesk
      </Step>

      <Step title="Write the script.">
        1. Navigate to [**Scripts**](https://app.gorelo.io/Asset/script-list)
        2. Create a script with the following details:
           * **Name**: Install Rustdesk
           * **Content**:

        ```powershell theme={null}
           #Install Rusdesk
           msiexec /i $gorelo:file.rustdesk /qn /norestart CREATESTARTMENUSHORTCUTS="N" CREATEDESKTOPSHORTCUTS="N" /l*v install.log

        ```

        3. Create a script with the following details:
           * Name: Write Rustdesk ID and Password
           * Content:

        ```powershell theme={null}
           $RustDeskPath = "$env:ProgramFiles\RustDesk\RustDesk.exe"
           
           # Get Rustdesk ID using the executable
           $RustdeskID = cmd /c "`"$RustDeskPath`" --get-id"
           
           if ($RustdeskID) {
              # Write ID to Gorelo custom field
              GoreloAction -SetCustomField -Name 'asset.rustdeskID' -Value $RustdeskID
              Write-Output "Rustdesk ID: $RustdeskID written to Gorelo"
           
              # Generate random 16 character password
              $Password = -join ((65..90) + (97..122) + (48..57) | Get-Random -Count 16 | ForEach-Object {[char]$_})
              
              # Set the password in Rustdesk
              cmd /c "`"$RustDeskPath`" --password $Password"
              
              # Write password to Gorelo custom field
              GoreloAction -SetCustomField -Name 'asset.rustdeskPassword' -Value $Password
              Write-Output "Rustdesk password set and saved to Gorelo"
              exit 0
           } else {
              Write-Output "Failed to get Rustdesk ID"
              exit 1
           }
        ```
      </Step>

      <Step title="Deploy the scripts via a policy.">
        1. Navigate to **[Policies](https://app.gorelo.io/Asset/policy-management).**
        2. Edit an existing policy that covers the assets you want to install and connect to via RustDesk.
        3. Add a continuous Service check for **RustDesk Service**. Add the ‘Install Rustdesk’ script as a remediation step.
        4. Add the 'Write Rustdesk ID and Password' script and set to repeat daily at your preferred time.
        5. **Save** and **distribute** the policy.
      </Step>

      <Step title="Create the shortcut.">
        1. Navigate to **[Asset Shortcuts](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts).**
        2. Add a new Shortcut with the following details:
           * **Name**: `RustDesk`
           * **URL**:`rustdesk://{{\$gorelo:asset.rustdeskID}}?password={{\$gorelo:asset.rustdeskPassword}}`
           * **Pinned Name**: `RustDesk`

        <Frame>
          <img src="https://mintcdn.com/gorelo/lqwr7vR8TnJnU6L2/images/image-101.png?fit=max&auto=format&n=lqwr7vR8TnJnU6L2&q=85&s=9be09dfa8c0571ab242e690fe0b81d75" alt="Image" width="776" height="756" data-path="images/image-101.png" />

          You should now see the **RustDesk** shortcut up the top-right corner of the Asset Detail page. If the script successfully populated the custom fields, then this shortcut will launch the RustDesk application.
        </Frame>

        Bitdefender URL for the install exe should look like this (fake example):

        [https://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader\_\[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==\].exe](https://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader_\[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==].exe)
      </Step>
    </Steps>
  </Tab>
</Tabs>