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

# Intégrer des outils d'accès à distance existants

> Intégrez Splashtop, AnyDesk, TeamViewer, RustDesk et d'autres outils d'accès à distance à Gorelo en configurant des champs personnalisés d'actif et des raccourcis de lancement par URL.

Suivez ce guide pour intégrer d'autres outils dans Gorelo, comme Splashtop, AnyDesk, TeamViewer, etc.

Vous pouvez intégrer Gorelo à n'importe quel outil d'accès à distance qui prend en charge le lancement via une URL, comme Splashtop, AnyDesk ou TeamViewer.

Cet exemple utilise :

* Splashtop Business
* RustDesk
* Webroot

<Tabs>
  <Tab title="Splashtop">
    <Steps>
      <Step title="Créez le champ personnalisé d'actif.">
        1. Allez à **Paramètres** > **Actifs** > **[Champs personnalisés](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)**.
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : `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="Écrivez le script.">
        1. Allez à **[Scripts](https://app.gorelo.io/Asset/script-list)**.
        2. Créez un script avec les détails suivants :
           * **Nom** : `Store-SplashtopSUUID`
           * **Contenu** :

        ```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="Déployez le script via une politique.">
        1. Allez à **[Politiques](https://app.gorelo.io/Asset/policy-management)**.
        2. Modifiez une politique existante qui couvre les actifs pour lesquels vous voulez stocker le Splashtop SUUID.
        3. Ajoutez le script `Store-SplashtopSUUID` et configurez-le pour qu'il se répète quotidiennement à l'heure de votre choix.
        4. **Enregistrez** et **distribuez** la politique.
      </Step>

      <Step title="Créez le raccourci.">
        1. Allez à **[Raccourcis d'actifs](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)**.
        2. Ajoutez un nouveau raccourci avec les détails suivants :
           * **Nom** : `Splashtop`
           * **URL** : `t-business://com.splashtop.business?account=&uuid={{$gorelo:asset.splashtopSUUID}}&sessiontype=remote`
           * **Nom épinglé** : `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>
             Vous devriez maintenant voir le raccourci **SPLASHTOP** dans le coin supérieur droit de la page Détail de l'actif. Si le script a renseigné avec succès la variable `$gorelo:asset.splashtopSUUID`, ce raccourci lancera l'application 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>

    Le raccourci n'installe pas Splashtop — un autre script devrait être utilisé pour cela, par exemple :

    ```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">
    Il est fortement recommandé d'héberger votre propre serveur RustDesk et de modifier le script d'installation initial pour le prendre en charge.

    <Steps>
      <Step title="Créez le champ personnalisé d'actif.">
        1. Allez à **Paramètres** > **Actifs** > **[Champs personnalisés](https://app.gorelo.io/Admin/admin-settings#asset#assetcustomfields)**.
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : 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. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : 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="Téléversez le fichier d'installation.">
        1. Allez à **Paramètres** > Actif > [**<u>Fichiers</u>**](https://app.gorelo.io/Admin/admin-settings#asset#filerepository).
        2. Ajoutez un fichier avec les détails suivants :
           * **Fichier** : téléversez le dernier installeur MSI de RustDesk.
           * **Variable** : rustdesk
      </Step>

      <Step title="Écrivez le script.">
        1. Allez à [**Scripts**](https://app.gorelo.io/Asset/script-list).
        2. Créez un script avec les détails suivants :
           * **Nom** : Install Rustdesk
           * **Contenu** :

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

        ```

        3. Créez un script avec les détails suivants :
           * Nom : Write Rustdesk ID and Password
           * Contenu :

        ```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="Déployez les scripts via une politique.">
        1. Allez à **[Politiques](https://app.gorelo.io/Asset/policy-management)**.
        2. Modifiez une politique existante qui couvre les actifs sur lesquels vous voulez installer et vous connecter via RustDesk.
        3. Ajoutez une vérification de service continue pour le **service RustDesk**. Ajoutez le script « Install Rustdesk » comme étape de remédiation.
        4. Ajoutez le script « Write Rustdesk ID and Password » et configurez-le pour qu'il se répète quotidiennement à l'heure de votre choix.
        5. **Enregistrez** et **distribuez** la politique.
      </Step>

      <Step title="Créez le raccourci.">
        1. Allez à **[Raccourcis d'actifs](https://app.gorelo.io/Admin/admin-settings#asset#assetshortcuts)**.
        2. Ajoutez un nouveau raccourci avec les détails suivants :
           * **Nom** : `RustDesk`
           * **URL** : `rustdesk://{{\$gorelo:asset.rustdeskID}}?password={{\$gorelo:asset.rustdeskPassword}}`
           * **Nom épinglé** : `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" />

          Vous devriez maintenant voir le raccourci **RustDesk** dans le coin supérieur droit de la page Détail de l'actif. Si le script a renseigné avec succès les champs personnalisés, ce raccourci lancera l'application RustDesk.
        </Frame>

        L'URL Bitdefender pour l'exécutable d'installation devrait ressembler à ceci (exemple fictif) :

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