> ## 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.

# 與現有遠端存取工具整合

> 透過設定自訂資產欄位與 URL 啟動捷徑，將 Splashtop、AnyDesk、TeamViewer、RustDesk 等遠端存取工具整合到 Gorelo。

請依本指南在 Gorelo 中整合其他工具，例如 Splashtop、AnyDesk、TeamViewer 等。

只要遠端存取工具支援透過 URL 啟動，例如 Splashtop、AnyDesk 或 TeamViewer，你都可以與 Gorelo 整合。

此範例使用：

* Splashtop Business
* RustDesk
* Webroot

<Tabs>
  <Tab title="Splashtop">
    <Steps>
      <Step title="建立自訂資產欄位。">
        1. 前往 **Settings** > **Assets** > **[Custom Fields](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)。**
        2. 新增自訂欄位，內容如下：
           * **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="撰寫指令稿。">
        1. 前往 **[Scripts](https://app.gorelo.io/Asset/script-list)。**
        2. 建立指令稿，內容如下：
           * **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="透過政策部署指令稿。">
        1. 前往 **[Policies](https://app.gorelo.io/Asset/policy-management)。**
        2. 編輯涵蓋你想儲存 Splashtop SUUID 之資產的現有政策。
        3. 新增 `Store-SplashtopSUUID` 指令稿，並設定每天於你偏好的時間重複執行。
        4. **Save** 並 **distribute** 政策。
      </Step>

      <Step title="建立捷徑。">
        1. 前往 **[Asset Shortcuts](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)。**
        2. 新增捷徑，內容如下：
           * **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>
             你現在會在 Asset Detail 頁面右上角看到 **SPLASHTOP** 捷徑。如果指令稿成功填入 `$gorelo:asset.splashtopSUUID` 變數，此捷徑會啟動 Splashtop Business 應用程式。
                     <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>

    捷徑不會安裝 Splashtop —— 需要另一個指令稿來執行此操作，例如：

    ```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">
    強烈建議自行架設 RustDesk 伺服器，並修改初始安裝指令稿以支援。

    <Steps>
      <Step title="建立自訂資產欄位。">
        1. 前往 **Settings** > **Assets** > **[Custom Fields](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)。**
        2. 新增自訂欄位，內容如下：
           * **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. 新增自訂欄位，內容如下：
           * **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="上傳安裝檔。">
        1. 前往 **Settings** > Asset > [**<u>Files</u>**](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)
        2. 新增檔案，內容如下：
           * **File**：上傳最新的 RustDesk MSI 安裝檔
           * **Variable**：rustdesk
      </Step>

      <Step title="撰寫指令稿。">
        1. 前往 [**Scripts**](https://app.gorelo.io/Asset/script-list)
        2. 建立指令稿，內容如下：
           * **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. 建立指令稿，內容如下：
           * 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="透過政策部署指令稿。">
        1. 前往 **[Policies](https://app.gorelo.io/Asset/policy-management)。**
        2. 編輯涵蓋你想安裝並透過 RustDesk 連線之資產的現有政策。
        3. 新增 **RustDesk Service** 的持續性 Service check，並加入「Install Rustdesk」指令稿作為修復步驟。
        4. 新增「Write Rustdesk ID and Password」指令稿，並設定每天於你偏好的時間重複執行。
        5. **Save** 並 **distribute** 政策。
      </Step>

      <Step title="建立捷徑。">
        1. 前往 **[Asset Shortcuts](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)。**
        2. 新增捷徑，內容如下：
           * **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" />

          你現在會在 Asset Detail 頁面右上角看到 **RustDesk** 捷徑。如果指令稿成功填入自訂欄位，此捷徑會啟動 RustDesk 應用程式。
        </Frame>

        Bitdefender 安裝執行檔的 URL 應如下（虛構範例）：

        [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>