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

# Integrar com ferramentas de acesso remoto existentes

> Integre Splashtop, AnyDesk, TeamViewer, RustDesk e outras ferramentas de acesso remoto ao Gorelo configurando campos personalizados de ativo e atalhos de URL.

Siga este guia para integrar outras ferramentas ao Gorelo, como Splashtop, AnyDesk, TeamViewer etc.

Você pode integrar o Gorelo a qualquer ferramenta de acesso remoto que permita ser iniciada por uma URL, como Splashtop, AnyDesk ou TeamViewer.

Este exemplo usa:

* Splashtop Business
* RustDesk
* Webroot

<Tabs>
  <Tab title="Splashtop">
    <Steps>
      <Step title="Crie o campo personalizado de ativo.">
        1. Acesse **Configurações** > **Ativos** > **[Campos personalizados](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)**.
        2. Adicione um campo personalizado com os seguintes detalhes:
           * **Nome**: `Splashtop SUUID`
           * **Variável**: `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="Escreva o script.">
        1. Acesse **[Scripts](https://app.gorelo.io/Asset/script-list)**.
        2. Crie um script com os seguintes detalhes:
           * **Nome**: `Store-SplashtopSUUID`
           * **Conteúdo**:

        ```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="Implante o script via uma política.">
        1. Acesse **[Políticas](https://app.gorelo.io/Asset/policy-management)**.
        2. Edite uma política existente que cubra os ativos para os quais deseja armazenar o SUUID do Splashtop.
        3. Adicione o script `Store-SplashtopSUUID` e configure-o para repetir diariamente no horário desejado.
        4. **Salve** e **distribua** a política.
      </Step>

      <Step title="Crie o atalho.">
        1. Acesse **[Atalhos de Ativo](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)**.
        2. Adicione um novo atalho com os seguintes detalhes:
           * **Nome**: `Splashtop`
           * **URL**: `t-business://com.splashtop.business?account=&uuid={{$gorelo:asset.splashtopSUUID}}&sessiontype=remote`
           * **Nome fixado**:  `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>
             Você deve ver agora o atalho **SPLASHTOP** no canto superior direito da página de detalhes do ativo. Se o script preencheu com sucesso a variável `$gorelo:asset.splashtopSUUID`, esse atalho abrirá o aplicativo 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>

    O atalho não instala o Splashtop — outro script seria necessário para isso, por exemplo:

    ```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">
    Recomenda-se fortemente hospedar seu próprio servidor RustDesk e modificar o script inicial de instalação para suportar isso.

    <Steps>
      <Step title="Crie o campo personalizado de ativo.">
        1. Acesse **Configurações** > **Ativos** > **[Campos personalizados](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)**.
        2. Adicione um campo personalizado com os seguintes detalhes:
           * **Nome**: RustDesk ID
           * **Variável**: 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. Adicione um campo personalizado com os seguintes detalhes:
           * **Nome**: RustDesk Password
           * **Variável**: 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="Envie o arquivo do instalador.">
        1. Acesse **Configurações** > Ativo > [**<u>Arquivos</u>**](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)
        2. Adicione um arquivo com os seguintes detalhes:
           * **Arquivo**: envie o instalador MSI mais recente do RustDesk
           * **Variável**: rustdesk
      </Step>

      <Step title="Escreva o script.">
        1. Acesse [**Scripts**](https://app.gorelo.io/Asset/script-list)
        2. Crie um script com os seguintes detalhes:
           * **Nome**: Install Rustdesk
           * **Conteúdo**:

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

        ```

        3. Crie um script com os seguintes detalhes:
           * Nome: Write Rustdesk ID and Password
           * Conteúdo:

        ```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="Implante os scripts via política.">
        1. Acesse **[Políticas](https://app.gorelo.io/Asset/policy-management)**.
        2. Edite uma política existente que cubra os ativos nos quais você deseja instalar e conectar via RustDesk.
        3. Adicione uma verificação de Serviço contínua para **RustDesk Service**. Adicione o script "Install Rustdesk" como etapa de remediação.
        4. Adicione o script "Write Rustdesk ID and Password" e configure-o para repetir diariamente no horário desejado.
        5. **Salve** e **distribua** a política.
      </Step>

      <Step title="Crie o atalho.">
        1. Acesse **[Atalhos de Ativo](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)**.
        2. Adicione um novo atalho com os seguintes detalhes:
           * **Nome**: `RustDesk`
           * **URL**:`rustdesk://{{\$gorelo:asset.rustdeskID}}?password={{\$gorelo:asset.rustdeskPassword}}`
           * **Nome fixado**: `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" />

          Você deve ver agora o atalho **RustDesk** no canto superior direito da página de detalhes do ativo. Se o script preencheu com sucesso os campos personalizados, esse atalho abrirá o aplicativo RustDesk.
        </Frame>

        A URL do Bitdefender para o exe de instalação deve se parecer com isto (exemplo fictício):

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