Documentation de pré-configuration

La fonction de pré-configuration permet aux administrateurs de déployer l'application de bureau Workspace avec des paramètres préconfigurés et des sources de données (instances de Devolutions Server et Devolutions Hub Business) dans toute une organisation. Cela élimine la nécessité pour les utilisateurs finaux de configurer manuellement l'application après l'installation.

• Déploiement sans intervention : Les utilisateurs commencent avec des applications entièrement configurées

• Cohérence: S'assurer que tous les utilisateurs disposent des mêmes sources de données et paramètres

• Gain de temps: Éliminer les étapes de configuration manuelle

• Flexibilité : Multiples méthodes de déploiement pour correspondre à différentes infrastructures TI

• Évolutivité : Déployer sur des centaines ou des milliers de points de terminaison efficacement

• Windows : Prise en charge complète via les paramètres MSI et les fichiers de configuration

• macOS: Fichiers de configuration et préférences gérées par MDM/Jamf

Trois principales méthodes de déploiement sont disponibles.

Transmettre directement les paramètres de configuration à l'installateur Windows lors du déploiement. Combiner les paramètres de source de données avec les paramètres de l'application.

Cas d'utilisation : outils de déploiement en entreprise (SCCM, Intune, PDQ Deploy, etc.)

Exemple de base (seulement les sources de données):

msiexec /i Workspace.msi DVLS_SERVER_URL="https://server.com" HUB_NAME="mycompany"

Avec paramètres (sources de données + paramètres de l'application) :

msiexec /i Workspace.msi ^
  DVLS_SERVER_URL="https://server.com" ^
  HUB_NAME="mycompany" ^
  ORGANIZATION_ID="guid-here" ^
  LANGUAGE="fr"

Voir la section paramètres de l'installateur MSI pour la liste complète des paramètres disponibles.

Déployer un fichier .cfg pré-créé vers les systèmes cibles.

Cas d'utilisation : Déploiements scriptés, Intune, SCCM, lors de l'utilisation de l'interface utilisateur du Créateur de Configuration

Deux Options de Déploiement :

msiexec /i Workspace.msi DEPLOY_CONFIG="C:\path\to\Config.cfg"

Cible : %ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg

Comment il fonctionne :

1. MSI écrit la config dans ProgramData lors de l'installation.

2. Lorsque tout utilisateur lance l'application de bureau Workspace, elle détecte la configuration à l'échelle du système.

3. Copier automatiquement la configuration dans le profil itinérant de l'utilisateur.

4. L'utilisateur a configuré l'application.

• Fiable : Fonctionne quel que soit le contexte utilisateur (pas de problème « Utilisateur par défaut »)

• Consistant : Tous les utilisateurs sur la machine obtiennent la même configuration

• Convivial pour l'automatisation: Parfait pour Intune, SCCM, installations silencieuses

• Support multi-utilisateur : S'applique à tous les utilisateurs existants et futurs

Idéal pour : Intune, SCCM, installations silencieuses, machines multi-utilisateurs, postes de travail partagés

msiexec /i Workspace.msi USER_CONFIG="C:\path\to\Config.cfg"

Cible: %LOCALAPPDATA%\net.devolutions\Workspace\Config.cfg

1. MSI écrit config dans Local AppData de l'utilisateur pendant l'installation.

2. Lancer l'application de bureau Workspace.

3. Les configurations se copient sur le profil itinérant de l'utilisateur.

4. Seul cet utilisateur a configuré l'application.

• Configure uniquement l'utilisateur qui a exécuté l'installateur.

• Peut échouer dans les déploiements automatisés (problèmes de contexte utilisateur).

• Non adapté aux machines multi-utilisateurs.

Meilleur pour : Installations interactives par utilisateurs finaux, dispositifs à utilisateur unique

Déployer la configuration via des solutions de gestion des appareils mobiles (MDM) pour les environnements macOS gérés.

Cas d'utilisation : Jamf Pro, Microsoft Intune pour macOS, autres solutions MDM

Priorité : La plus haute (outrepasse toutes les configurations basées sur les fichiers)

Domaine de préférence : net.devolutions.workspace

Pour les administrateurs Jamf Pro : Importer ce schéma JSON dans Jamf Pro sous Ordinateurs - Profils de configuration - Paramètres d'application et personnalisés pour obtenir une interface graphique conviviale pour configurer tous les paramètres de l'application de bureau de Workspace.

Domaine de préférence : net.devolutions.authenticator

{
  "title": "Devolutions Workspace Configuration (net.devolutions.authenticator)",
  "description": "Configuration settings for Devolutions Workspace application deployed via Jamf Pro. These settings are deployed as managed preferences to managed devices.",
  "__version": "1.0",
  "__preferencedomain": "net.devolutions.authenticator",
  "options": {
    "remove_empty_properties": true
  },
  "properties": {
    "dvls": {
      "title": "DVLS Configuration",
      "description": "Devolutions Server connection settings",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "title": "Server Name",
            "description": "Display name for the DVLS server",
            "type": "string",
            "default": "Devolutions Server"
          },
          "serverUrl": {
            "title": "Server URL",
            "description": "Full URL to the DVLS server (e.g., https://server.company.com)",
            "type": "string",
            "pattern": "^https?://.*"
          },
          "serverVersion": {
            "title": "Server Version",
            "description": "DVLS server version (optional)",
            "type": "string",
            "default": ""
          }
        },
        "required": ["serverUrl"]
      },
      "default": []
    },
    "hubs": {
      "title": "Hub Business Configuration",
      "description": "Devolutions Hub Business connection settings",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "title": "Hub URL",
            "description": "Full Hub URL (e.g., https://yourcompany.devolutions.app)",
            "type": "string",
            "pattern": "^https://.*\\.devolutions\\.app$"
          },
          "organizationId": {
            "title": "Organization ID",
            "description": "Organization identifier for Hub Business",
            "type": "string"
          },
          "type": {
            "title": "Hub Type",
            "description": "Hub connection type (optional)",
            "type": "string"
          },
          "version": {
            "title": "Hub Version",
            "description": "Hub version compatibility",
            "type": "string",
            "default": "2020"
          }
        },
        "required": ["url"]
      },
      "default": []
    },
    "configs": {
      "title": "Application Settings",
      "description": "User preferences and application behavior settings",
      "type": "object",
      "properties": {
        "language": {
          "title": "Language",
          "description": "Default language for Workspace interface",
          "type": "string",
          "enum": [
            "en-US", "fr", "de", "es", "cs", "hu", "it", "nl", "pl", "ru", "sv", "tr", "uk", "zh-CHS", "zh-TW"
          ],
          "default": "en-US",
          "options": {
            "enum_titles": [
              "English", "Français", "Deutsch", "Español", "Čeština", "Magyar", "Italiano",
              "Nederlands", "Polski", "Русский", "Svenska", "Türkçe", "Українська", "简体中文", "繁體中文"
            ]
          }
        },
        "reduceToTrayOnClose": {
          "title": "Minimize to Tray on Close",
          "description": "When enabled, closing the window minimizes to system tray instead of quitting",
          "type": "boolean",
          "default": false
        },
        "clearClipboardSensitiveData": {
          "title": "Clear Clipboard Sensitive Data",
          "description": "Automatically clear sensitive data from clipboard after a specified timeout",
          "type": "boolean",
          "default": false
        },
        "clipboardTimer": {
          "title": "Clipboard Timeout (seconds)",
          "description": "Duration in seconds before clearing clipboard when sensitive data clearing is enabled",
          "type": "integer",
          "enum": [30, 60, 120, 180, 240, 300, 0],
          "default": 30,
          "options": {
            "enum_titles": ["30 seconds", "1 minute", "2 minutes", "3 minutes", "4 minutes", "5 minutes", "Never"]
          }
        },
        "useFavicon": {
          "title": "Use Favicons",
          "description": "Download and display website favicons for entries",
          "type": "boolean",
          "default": false
        },
        "useEntriesSyncOnDatasourceAccess": {
          "title": "Sync Entries on Data Source Access",
          "description": "Automatically synchronize entries when accessing a data source",
          "type": "boolean",
          "default": false
        },
        "useHubEmbeddedBrowser": {
          "title": "Use Hub Embedded Browser",
          "description": "Open Hub connections in embedded browser (disable if using credential providers)",
          "type": "boolean",
          "default": true
        },
        "lockingOption": {
          "title": "Locking Method",
          "description": "Authentication method used when locking/unlocking Workspace. Leave empty for no locking method.",
          "type": "string",
          "enum": ["", "password", "biometric", "windowsCredentials"],
          "default": "",
          "options": {
            "enum_titles": ["None", "Password/PIN", "Biometric (Touch ID/Face ID/Windows Hello)", "Windows Credentials"]
          }
        },
        "useBackgroundLock": {
          "title": "Lock When Backgrounded",
          "description": "Automatically lock the application when minimized or sent to system tray",
          "type": "boolean",
          "default": false
        },
        "useLockWhenInactive": {
          "title": "Auto-Lock When Inactive",
          "description": "Automatically lock the application after a period of inactivity",
          "type": "boolean",
          "default": false
        },
        "lockInactivityDelay": {
          "title": "Inactivity Lock Delay (seconds)",
          "description": "Time in seconds before locking due to inactivity (requires Auto-Lock to be enabled)",
          "type": "integer",
          "enum": [30, 60, 120, 180, 240, 300],
          "default": 30,
          "options": {
            "enum_titles": ["30 seconds", "1 minute", "2 minutes", "3 minutes", "4 minutes", "5 minutes"]
          }
        }
      }
    },
    "preventStartup": {
      "title": "Prevent Startup",
      "description": "When true, prevents Workspace from starting automatically after configuration deployment",
      "type": "boolean",
      "default": true
    }
  }
}

1. Télécharger ou copier le schéma JSON ci-dessus.

2. Dans Jamf Pro, naviguer vers : Computers – Configuration Profiles – Application & Custom Settings.

3. Cliquer sur Configurer et télécharger le fichier JSON.

4. Configurer vos paramètres souhaités en utilisant l'interface GUI.

5. Reporter le profil sur les ordinateurs cibles.

Si vous n'utilisez pas Jamf Pro, vous pouvez créer un profil de configuration macOS standard :

Exemple de profil (com.devolutions.workspace.mobileconfig) :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <dict>
            <key>PayloadType</key>
            <string>net.devolutions.authenticator</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>PayloadIdentifier</key>
            <string>net.devolutions.authenticator.config</string>
            <key>PayloadUUID</key>
            <string>GENERATE-UUID-HERE</string>
            <key>PayloadDisplayName</key>
            <string>Workspace Configuration</string>
            <key>language</key>
            <string>en-US</string>
            <key>reduceToTrayOnClose</key>
            <true/>
            <key>lockingOption</key>
            <string>biometric</string>
        </dict>
    </array>
</dict>
</plist>

• Jamf Pro : Profils de configuration – Télécharger le profil

• Microsoft Intune: Configuration de l'appareil – Profil personnalisé

• Autres MDMs : Télécharger le profil de configuration personnalisé

Pour configuration manuelle ou scripting :

# Set language
defaults write net.devolutions.workspace language -string "en-US"

# Enable tray minimize
defaults write net.devolutions.workspace reduceToTrayOnClose -bool true

# Set locking option
defaults write net.devolutions.workspace lockingOption -string "biometric"

• Gestion centralisée : Configurer depuis la console MDM

• Application des politiques: Peut empêcher les utilisateurs de modifier les paramètres

• Priorité la plus élevée: Outrepasse les fichiers de configuration locaux

• Norme Entreprise: Approche recommandée pour les flottes macOS gérées

Voir Référence des paramètres de configuration pour la liste complète des préférences disponibles.

Utiliser l'application de bureau pour créer des fichiers de configuration et des commandes MSI.

Cas d'utilisation: Les administrateurs TI préparent des paquets de déploiement

Accès : Outils - Installation Personnalisée (dans l'application de bureau)

Remarque : Explications détaillées pour chaque méthode dans la section Méthodes de Déploiement ci-dessus.

Les fichiers de configuration utilisent l'extension .cfg et contiennent des données au format JSON.

{
  "hubs": [
    {
      "url": "https://mycompany.devolutions.app",
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "type": "Business",
      "version": ""
    }
  ],
  "dvls": [
    {
      "name": "Production DVLS",
      "serverUrl": "https://dvls.company.com",
      "serverVersion": ""
    },
    {
      "name": "Development DVLS",
      "serverUrl": "https://dvls-dev.company.com",
      "serverVersion": ""
    }
  ],
  "configs": {
    "language": "en-US",
    "reduceToTrayOnClose": true,
    "clearClipboardSensitiveData": true,
    "clipboardTimer": 30,
    "useFavicon": true,
    "useEntriesSyncOnDatasourceAccess": false,
    "useHubEmbeddedBrowser": true,
    "shareUsageData": false,
    "lockingOption": "password",
    "useBackgroundLock": true,
    "useLockWhenInactive": true,
    "lockInactivityDelay": 300
  }
}

Tableau des instances de Devolutions Hub Business à configurer.

Tableau des instances de Devolutions Server à configurer.

Paramètres de l'application à préconfigurer. Voir Référence des paramètres de configuration pour la liste complète.

Les fichiers de configuration sont chargés par ordre de priorité en fonction de leur emplacement.

Fenêtre 1 : %APPDATA%\net.devolutions\Workspace\ with Config.cfg

Fenêtre 2 : %LOCALAPPDATA%\net.devolutions\Workspace\ avec Config.cfg

Fenêtre 3 : %ProgramData%\net.devolutions\Workspace\ avec DefaultConfig.cfg et config.ready

• AppData itinérant : %APPDATA%\net.devolutions\Workspace\Config.cfg

  • Défaut : C:\Users\[Username]\AppData\Roaming\net.devolutions\Workspace\Config.cfg

  • Synchroniser sur les ordinateurs joints au domaine

  • Priorité la plus élevée (spécifique à l'utilisateur)

• Données de l'application locale : %LOCALAPPDATA%\net.devolutions\Workspace\Config.cfg

  • Valeur par défaut : C:\Users\[Username]\AppData\Local\net.devolutions\Workspace\Config.cfg

  • Spécifique à la machine, pas synchronisé

  • Utilisé lors de l'installation MSI, puis copié dans Roaming

• ProgramData : %ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg

  • Défaut : C:\ProgramData\net.devolutions\Workspace\DefaultConfig.cfg

  • S'applique à tous les utilisateurs du système

  • Requiert le fichier indicateur config.ready dans le même répertoire

  • Copié à l'emplacement itinérant de l'utilisateur lors du premier lancement (si la configuration utilisateur n'existe pas)

• Fichier : config.ready

• Emplacement : Même répertoire que DefaultConfig.cfg

• But : Indique que la configuration système est prête pour le déploiement

• Contenu: Fichier vide, la présence est seulement vérifiée

• User library path ~/Library/Application Support/Workspace/Config.cfg

• Chemin de la bibliothèque système /Library/Application Support/Devolutions/Workspace/DefaultConfig.cfg

• Chemin: ~/Library/Application Support/Workspace/Config.cfg

• Priorité : Plus haute pour les configs spécifiques à l'utilisateur

• Chemin : /Library/Application Support/Devolutions/Workspace/DefaultConfig.cfg

• Priorité : Appliqué si la configuration utilisateur n'existe pas

• Priorité: La plus élevée (outrepasse toutes les configurations basées sur des fichiers)

• Domaine de préférence : net.devolutions.workspace

• Clés : Identiques à l'objet configs au format JSON

• Configuration : Via profil MDM ou commande defaults

Les sources de configuration sont vérifiées dans l'ordre suivant :

1. Préférences gérées macOS (macOS uniquement) - Politiques MDM/Jamf.

2. Fichier de configuration de l'utilisateur - Config spécifique à l'utilisateur.

3. Fichier de configuration du système - Par défaut pour tout le système (copié à l'emplacement utilisateur).

1. Vérifier les préférences MDM de macOS (priorité la plus élevée). Si trouvé, les utiliser.

2. Vérifier le fichier de configuration utilisateur. Si trouvé, utiliser cela.

3. Vérifier le fichier de configuration système. Si trouvé, copier à l'emplacement de l'utilisateur et utiliser.

Le programme d'installation MSI de Windows accepte les paramètres suivants pour la pré-configuration.

Remarque: Un seul Devolutions Server peut être configuré via les paramètres MSI. Pour plusieurs serveurs, utiliser un fichier de configuration.

Note: L'URL complète du Hub est construite de la manière suivante https://{HUB_NAME}.devolutions.app

Voir Méthode 2: Déploiement de fichier de configuration pour une comparaison détaillée et des directives d'utilisation.

Le paramètre TARGET_LOCATION détermine où la configuration est enregistrée :

• roaming (Par défaut): %APPDATA%\net.devolutions\Workspace\Config.cfg

  • Synchroniser sur les ordinateurs joints au domaine

  • Configuration par utilisateur

  • Recommandé pour les environnements de domaine

• local : %LOCALAPPDATA%\net.devolutions\Workspace\Config.cfg

  • Spécifique à la machine, ne se synchronise pas

  • Configuration par utilisateur

  • Recommandé pour les machines autonomes

• system: %ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg\n

  • Configuration à l'échelle du système pour tous les utilisateurs

  • Requiert des privilèges administratifs

  • Recommandé pour les ordinateurs partagés

L'application de bureau inclut un outil visuel pour créer des fichiers de configuration.

1. Lancer l'application de bureau Workspace.

2. Naviguer vers Outils - Installation personnalisée

1. Sélection de la source de données

   • Voir tous les serveurs Devolutions et instances Devolutions Hub Business configurés.

   • Sélectionner quelles sources de données inclure via des cases à cocher

   • Plusieurs sources de données prises en charge

2. Configuration des paramètres

   • Activer/désactiver les paramètres d'application individuels

   • Paramètres groupés par catégorie :

     • Général (Langue, Comportement de la barre d'état système)

     • Sécurité (Presse-papiers, Verrouillage)

     • Synchronisation

     • Confidentialité (statistiques d'utilisation)

3. Aperçu en direct

   • Aperçu JSON en temps réel de la configuration

   • Copier JSON dans le presse-papiers

   • Aperçu des mises à jour à mesure que les sélections changent

4. Options d'exportation

   • Générer fichier.cfg : Enregistrer la configuration dans le fichier .cfg

   • Copier la commande MSI : Générer une commande MSI complète avec tous les paramètres

1. Sélection de fichiers

   • Parcourir les fichiers .cfg

   • Validation et analyse des fichiers

2. Aperçu avant importation

   • Voir les sources de données et les paramètres avant d'appliquer

   • Détection des doublons (avertit si la source de données existe déjà)

3. Actions d'importation

   • Appliquer la configuration à l'application actuelle

   • Créer de nouvelles sources de données si elles n'existent pas

   • Mettre à jour les paramètres immédiatement

1. Préparer : Configurer une installation "modèle" avec les sources de données souhaitées

2. Exportation : Utiliser l'outil d'installation personnalisé pour générer un fichier .cfg

3. Distribuer : déployer le fichier .cfg via :

   • Paramètre MSI : DEPLOY_CONFIG="\\server\share\Config.cfg"

   • Copie manuelle à l'emplacement système : %ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg

Référence complète de tous les paramètres configurables.

Les fichiers de configuration et les paramètres MSI utilisent des "clés d'exportation" qui se conforment aux clés SharedPreferences internes.

Note : Si la biométrie/Windows Hello n'est pas disponible, revient au mot de passe.

msiexec /i Workspace.msi /quiet DVLS_SERVER_URL="https://dvls.company.com"

msiexec /i Workspace.msi /quiet ^
  HUB_NAME="mycompany" ^
  ORGANIZATION_ID="12345678-1234-1234-1234-123456789abc"

msiexec /i Workspace.msi /quiet ^
  DVLS_SERVER_URL="https://dvls.company.com" ^
  HUB_NAME="mycompany" ^
  ORGANIZATION_ID="12345678-1234-1234-1234-123456789abc" ^
  LANGUAGE="en-US" ^
  REDUCE_TO_TRAY_ON_CLOSE="true" ^
  CLEAR_CLIPBOARD_SENSITIVE_DATA="true" ^
  CLIPBOARD_TIMER="60" ^
  USE_FAVICON="true" ^
  LOCKING_OPTION="windowsCredentials" ^
  USE_BACKGROUND_LOCK="true" ^
  USE_LOCK_WHEN_INACTIVE="true" ^
  LOCK_INACTIVITY_DELAY="300" ^
  SHARE_USAGE_DATA="false"

msiexec /i Workspace.msi /quiet DEPLOY_CONFIG="\\fileserver\IT\Workspace\Config.cfg"

Meilleur pour : Déploiements en entreprise, Intune, SCCM, machines multi-utilisateurs.

Important : Utiliser DEPLOY_CONFIG pour les déploiements d'entreprise. Voir Méthode 2 pour les détails.

Créer un dossier de travail (par exemple, C:\IntuneApps\Workspace\) et y placer ces fichiers :

• Workspace.msi

• config.cfg (créé via Tools – Custom Installation ou manuellement)

• Install-Workspace.ps1 (script PowerShell ci-dessous)

Créer Install-Workspace.ps1:

# Install-Workspace.ps1
# Source files in the Intune package
$ConfigSource = "$PSScriptRoot\config.cfg"
$ConfigTarget = "C:\Program Files\config.cfg"
$MsiPath = "$PSScriptRoot\Workspace.msi"

# Copy config.cfg to Program Files
try {
    Copy-Item -Path $ConfigSource -Destination $ConfigTarget -Force
} catch {
    Write-Host "Error copying config file: $($_.Exception.Message)"
    exit 1
}

# Install MSI silently with DEPLOY_CONFIG parameter
$Arguments = "/i `"$MsiPath`" /qn /norestart DEPLOY_CONFIG=`"C:\Program Files\config.cfg`""
$Process = Start-Process "msiexec.exe" -ArgumentList $Arguments -Wait -PassThru

# Return exit code to Intune
exit $Process.ExitCode

Pourquoi cette approche?

• Le fichier config est intégré avec l'application

• Placé automatiquement à l'emplacement correct

• MSI reçoit le bon chemin DEPLOY_CONFIG

• Fonctionne de manière fiable dans le contexte SYSTEM d'Intune

• Le fichier de configuration source est automatiquement supprimé après une copie réussie (par Configure.ps1)

Utiliser l'outil de préparation de contenu Microsoft Win32 (IntuneWinAppUtil.exe):

IntuneWinAppUtil.exe -c C:\IntuneApps\Workspace -s Install-Workspace.ps1 -o C:\IntuneApps\Output

Paramètres :

• -c : Dossier source contenant tous les fichiers

• -s : Fichier de configuration (le script PowerShell)

• -o : Dossier de sortie pour le paquet .intunewin

Résultat : le paquet Workspace.intunewin prêt à être téléchargé.

Dans le portail Microsoft Intune:

1. Naviguer vers: Apps – Windows – Ajouter – Windows app (Win32)

2. Fichier de paquet de l'application : Télécharger Workspace.intunewin

3. Information de l'application :

   • Nom : Devolutions Workspace

   • Description : Gestionnaire de mots de passe et outil de connexion à distance

   • Éditeur : Devolutions

4. Configuration du programme :

   • Commande d'installation :

     powershell.exe -ExecutionPolicy Bypass -File .\Install-Workspace.ps1
     

   • Commande de désinstallation :

     msiexec.exe /x {PRODUCT-CODE-GUID} /qn /norestart
     

   • Comportement d'installation: Système

   • Comportement de redémarrage de l'appareil : Déterminer le comportement basé sur les codes de retour

5. Exigences :

   • Architecture du système d'exploitation : 64 bits

   • Système d'exploitation minimum : Windows 10 1607+

6. Règles de détection :

   • Type de règle : MSI

   • Code de produit MSI : (Détecté automatiquement à partir du paquet)

   Alternative - Détection de fichiers :

   • Chemin : C:\Program Files\Devolutions\Workspace

   • Fichier ou dossier : Workspace.exe

   • Méthode de détection : Existence du fichier ou du dossier

7. Attributions : Assigner aux groupes cibles (utilisateurs ou appareils)

Lorsque Intune installe l'application :

1. Extraction du paquet: Intune extrait Workspace.intunewin vers un répertoire temporaire

2. Exécution de script : Install-Workspace.ps1 s'exécute en tant que SYSTEM

3. Déploiement de la configuration : Le script copie config.cfg vers C:\Program Files\config.cfg

4. Installation MSI : Les installations MSI avec DEPLOY_CONFIG="C:\Program Files\config.cfg"

5. Traitement de la configuration : Configure.ps1 de MSI copie la configuration vers :

   • %ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg

   • Créer le fichier indicateur config.ready

   • Supprimer le fichier source C:\Program Files\config.cfg (nettoyage)

6. Premier lancement: Quand un utilisateur lance Workspace:

   • Application détecte DefaultConfig.cfg + config.ready

   • Copier la config dans le profil itinérant de l'utilisateur

   • L'utilisateur a une application entièrement configurée

Commande d'installation :

msiexec /i Workspace.msi /quiet /norestart DEPLOY_CONFIG="%~dp0Config.cfg"

Commande de désinstallation :

msiexec /x {PRODUCT-CODE} /qn /norestart

Méthode de détection :

• Clé du registre : HKLM\SOFTWARE\Devolutions\Workspace\Version

Remarque : Emballer à la fois Workspace.msi et Config.cfg ensemble. La variable %~dp0 référence le répertoire d'extraction.

• Fichiers de configuration : Recommandé pour le déploiement initial et les paramètres par défaut

• Stratégie de groupe : Utiliser pour appliquer des stratégies que les utilisateurs ne peuvent pas modifier

Les fichiers de configuration s'appliquent au démarrage, la stratégie de groupe peut remplacer les paramètres.

• Appartenance au domaine: Utiliser AppData itinérant (TARGET_LOCATION="roaming") pour la synchronisation de profil

• Autonome : Utiliser Local AppData (TARGET_LOCATION="local") ou Système (TARGET_LOCATION="system")

• Config par utilisateur: Aucune autorisation spéciale requise

• Configuration système : nécessite des privilèges administratifs pour écrire dans %ProgramData%

Le fichier config.ready est requis pour les configurations à l'échelle du système:

• Doit être dans le même répertoire que DefaultConfig.cfg

• Peut être vide (présence vérifiée, contenu ignoré)

• Sans cela, DefaultConfig.cfg est ignoré

• Créé automatiquement par l'installateur MSI et les scripts PowerShell

La configuration de macOS se fait principalement via MDM/Préférences gérées. Voir Méthode 3 : MDM/Préférences gérées pour des instructions détaillées.

Pour la configuration basée sur des fichiers (alternative à MDM), les fichiers de configuration suivent la même structure que Windows mais avec des chemins différents. Voir Emplacements des fichiers de configuration pour les chemins spécifiques à macOS.

Situation: Les nouveaux employés ont besoin de Workspace avec Devolutions Server et Devolutions Hub préconfigurés.

Solution :

1. Créer Config.cfg avec installation de modèle TI en utilisant l'outil d'installation personnalisé

2. Déployer via SCCM/Intune avec le paramètre DEPLOY_CONFIG

3. Utilisateurs lancent l'application, sources de données déjà configurées

Avantages : Élimine les appels au service d'assistance, assure la cohérence

Situation : L'organisation dispose de serveurs DVLS de Production, de Développement, et de Test. Certains utilisateurs ont besoin des trois.

Solution :

1. Créer Config.cfg avec les trois serveurs :

{
  "dvls": [
    {"name": "Production", "serverUrl": "https://dvls-prod.company.com"},
    {"name": "Development", "serverUrl": "https://dvls-dev.company.com"},
    {"name": "Test", "serverUrl": "https://dvls-test.company.com"}
  ]
}

2. Déployer aux développeurs/personnel TI

Avantages: Configuration unique, utilisateurs immédiatement productifs

Situation : La politique de sécurité exige un verrouillage automatique après 5 minutes, l'effacement du presse-papiers et l'authentification Windows Hello.

Solution :

msiexec /i Workspace.msi /quiet ^
  DVLS_SERVER_URL="https://dvls.company.com" ^
  LOCKING_OPTION="windowsCredentials" ^
  USE_LOCK_WHEN_INACTIVE="true" ^
  LOCK_INACTIVITY_DELAY="300" ^
  CLEAR_CLIPBOARD_SENSITIVE_DATA="true" ^
  CLIPBOARD_TIMER="30" ^
  SHARE_USAGE_DATA="false"

Avantages: Applique les politiques de sécurité dès le premier lancement

Situation : Organisation mondiale avec Devolutions Server régional et préférences linguistiques.

Solution : Créer des configurations régionales :

Amérique du Nord (Config-NA.cfg) :

{
  "dvls": [{"name": "NA DVLS", "serverUrl": "https://dvls-na.company.com"}],
  "configs": {"language": "en-US"}
}

France (Config-FR.cfg):

{
  "dvls": [{"name": "DVLS France", "serverUrl": "https://dvls-fr.company.com"}],
  "configs": {"language": "fr"}
}

Allemagne (Config-DE.cfg) :

{
  "dvls": [{"name": "DVLS Deutschland", "serverUrl": "https://dvls-de.company.com"}],
  "configs": {"language": "de"}
}

Déployer en fonction du site AD ou de la collection SCCM.

Avantages : Expérience localisée, connectivité au serveur régional

Problème: Fichier de configuration présent mais paramètres non appliqués.

Solutions :

1. Vérifier l'emplacement du fichier : Vérifier le chemin correct pour la plateforme

2. Vérifier la validité du JSON: Valider la syntaxe JSON (pas de virgules finales, guillemets appropriés)

3. Vérifier les autorisations : L'utilisateur doit avoir l'autorisation de lecture du fichier de configuration

4. Configuration du système Windows : Vérifier que le fichier config.ready existe dans le même répertoire

5. Vérifier les journaux : Revoir les journaux d'application pour les erreurs d'analyse

Problème : Configuration système ignorée.

Solution : Créer un fichier config.ready :

type nul > "%ProgramData%\net.devolutions\Workspace\config.ready"

Problème : USER_CONFIG échoue dans les installations silencieuses/automatisées, la configuration se retrouve dans C:\Users\Default\AppData\Local.

Cause : USER_CONFIG nécessite un contexte de session utilisateur active, qui n'est pas disponible pendant l'installation automatique de MSI.

Solution : Utiliser DEPLOY_CONFIG pour les déploiements en entreprise.

# CORRECT for Intune/SCCM
msiexec /i Workspace.msi /qn /norestart DEPLOY_CONFIG="%~dp0Config.cfg"

Voir Méthode 2 : Déploiement de fichiers de configuration pour une comparaison complète et des lignes directrices.

Problème : L'importation échoue avec le message "la source de données existe déjà".

Explication : L'analyseur de configuration détecte les doublons par URL normalisée (insensible à la casse, barre oblique finale supprimée).

Solutions :

1. Supprimer manuellement la source de données existante avant l'importation

2. Modifier le fichier de configuration pour supprimer les entrées en double

3. Utiliser l'outil d'installation personnalisé pour fusionner les configurations

Problème : Les paramètres reviennent aux valeurs par défaut après un redémarrage.

Solutions :

1. Configuration utilisateur vs système : La configuration du système ne s'applique que si la configuration utilisateur n'existe pas. Une fois que l'utilisateur modifie les paramètres, ils sont enregistrés dans la configuration utilisateur et remplacent les paramètres par défaut du système.

2. Remplacement de la politique de groupe : Vérifier si l'GPO applique les paramètres

3. Autorisations des fichiers : Vérifier autorisation d'accès en écriture à l'emplacement de configuration utilisateur

Problème : Les paramètres MSI ne créent pas de configuration.

Solutions :

1. Vérifier la syntaxe des paramètres : S'assurer que les guillemets sont corrects (utiliser "value", non 'value')

2. Journal de l'installation MSI : Ajouter /l*v install.log pour voir les erreurs détaillées

3. Vérifier l'exécution de PowerShell : Vérifier si la stratégie d'exécution bloque les scripts

4. Droits administratifs : Certaines opérations nécessitent une élévation

Exemple avec journalisation :

msiexec /i Workspace.msi /quiet /l*v C:\Temp\install.log DVLS_SERVER_URL="https://server.com"

Problème : L'outil d'installation personnalisé montre des sources de données inattendues.

Explication : L'outil affiche actuellement les sources de données configurées dans l'application en cours d'exécution.

Solution : Il s'agit d'un comportement attendu. Pour créer une configuration "propre":

1. Exporter uniquement les sources de données souhaitées (décochez les autres)

2. Ou créer un JSON manuellement basé sur le modèle

Problème : Biométrie ou Windows Hello ne s'active pas.

Solutions :

1. Vérification du matériel : Vérifier la disponibilité du matériel biométrique

2. Configuration de Windows Hello : S'assurer que Windows Hello est configuré dans les Paramètres Windows

3. Alternative : Le système utilise automatiquement le mot de passe si le matériel n'est pas disponible

4. macOS Biometric : Nécessite le matériel Touch ID

Problème : L'importation du fichier de configuration échoue à la validation.

Solutions :

1. Vérifier la syntaxe JSON : Utiliser le validateur JSON (par ex., jsonlint.com)

2. Vérifier les champs requis:

   • Hubs : url et organizationId requis

   • DVLS : nom et serverUrl requis

3. Vérifier les types de données:

   • Booléens : true/false (pas "true"/"false")

   • Nombres : 30 (pas "30")

   • Chaînes : "value" (avec guillemets)

Exemple Valide :

{
  "hubs": [
    {
      "url": "https://company.devolutions.app",
      "organizationId": "guid-here"
    }
  ],
  "configs": {
    "clipboardTimer": 30,
    "clearClipboardSensitiveData": true,
    "language": "en-US"
  }
}

• Configuration de la stratégie de groupe : Voir la documentation GPO pour appliquer des politiques

• Déploiement MDM (macOS) : Voir le guide de déploiement Jamf/MDM

• Meilleures pratiques de sécurité : Voir le guide de renforcement de la sécurité

• Intégration DVLS : Voir la documentation sur la connexion DVLS

• Configuration de Hub Business : Voir le guide de démarrage de Hub Business

Pour le soutien technique avec la pré-configuration :

• Courriel : support@devolutions.net

• Forum : https://forum.devolutions.net

• Base de Connaissances : https://docs.devolutions.net

{
  "hubs": [
    {
      "url": "https://mycompany.devolutions.app",
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "type": "Business",
      "version": ""
    }
  ],
  "dvls": [
    {
      "name": "Production DVLS",
      "serverUrl": "https://dvls.company.com",
      "serverVersion": ""
    },
    {
      "name": "Development DVLS",
      "serverUrl": "https://dvls-dev.company.com",
      "serverVersion": ""
    }
  ],
  "configs": {
    "language": "en-US",
    "reduceToTrayOnClose": false,
    "clearClipboardSensitiveData": false,
    "clipboardTimer": 30,
    "useFavicon": false,
    "useEntriesSyncOnDatasourceAccess": false,
    "useHubEmbeddedBrowser": true,
    "shareUsageData": true,
    "lockingOption": null,
    "useBackgroundLock": false,
    "useLockWhenInactive": false,
    "lockInactivityDelay": 30
  }
}