> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/password-manager/fr/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start.md). # Démarrage rapide de la préconfiguration de Devolutions Password Manager {% tabs %} {% tab title="Windows" %} Apprenez à déployer rapidement Devolutions Password Manager avec des espaces de travail et des paramètres préconfigurés sur des points de terminaison Windows. {% hint style="info" %} Consultez la [préconfiguration de Devolutions Password Manager](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/) pour des instructions plus détaillées, des informations de dépannage et des scénarios avancés. {% endhint %} ### Qu'est-ce que la préconfiguration La préconfiguration vous permet de déployer l'application Windows de Devolutions Password Manager avec : * Des espaces de travail déjà configurés (Devolutions Server, Devolutions Cloud) * Des paramètres d'application prédéfinis (langue, sécurité, options de verrouillage) * Aucune configuration requise de la part des utilisateurs ; ceux-ci lancent l'application et sont immédiatement opérationnels ### Démarrage rapide : choisissez votre méthode #### Pour un déploiement en entreprise (Intune/SCCM) * Utilisez `DEPLOY_CONFIG` pour les déploiements automatisés : recommandé pour Intune, SCCM et les installations silencieuses ```bash msiexec /i Workspace.msi /qn DEPLOY_CONFIG="C:\path\to\Config.cfg" ``` **Pourquoi DEPLOY\_CONFIG ?** * Fonctionne de manière fiable lors des installations automatisées et silencieuses * S'applique à tous les utilisateurs de la machine * Aucun problème de contexte utilisateur * Nettoie automatiquement le fichier de configuration source **Comment obtenir Config.cfg ?** * Créez-le à l'aide de l'outil de configuration de l'interface utilisateur (***Outils*** – ***Installation personnalisée*** dans Devolutions Password Manager) * Ou [créez manuellement un fichier `.cfg`](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#configuration-file-structure) #### Pour les déploiements simples * Utilisez des paramètres MSI en ligne pour des déploiements rapides ```bash msiexec /i Workspace.msi /qn ^ DVLS_SERVER_URL="https://devolutions-server.company.com" ^ HUB_NAME="mycompany" ^ ORGANIZATION_ID="your-org-guid" ^ LANGUAGE="en-US" ``` ### Exemples rapides #### Exemple 1 : déployer Devolutions Server avec des paramètres ```bash msiexec /i Workspace.msi /qn ^ DVLS_SERVER_URL="https://devolutions-server.company.com" ^ LOCKING_OPTION="windowsCredentials" ^ LANGUAGE="en-US" ``` #### Exemple 2 : déployer Devolutions Cloud ```bash # With Organization ID msiexec /i Workspace.msi /qn ^ HUB_NAME="mycompany" ^ ORGANIZATION_ID="12345678-1234-1234-1234-123456789abc" ^ REDUCE_TO_TRAY_ON_CLOSE="true" ``` ```bash # Without Organization ID (if not required by your Devolutions Cloud) msiexec /i Workspace.msi /qn ^ HUB_NAME="mycompany" ^ REDUCE_TO_TRAY_ON_CLOSE="true" ``` #### Exemple 3 : déployer à l'aide d'un fichier de configuration ```bash msiexec /i Workspace.msi /qn DEPLOY_CONFIG="\\server\share\Config.cfg" ``` ### Format du fichier de configuration Les fichiers de configuration (`.cfg`) utilisent le format JSON : ```json { "dvls": [ { "name": "Production Server", "serverUrl": "https://devolutions-server.company.com" } ], "hubs": [ { "url": "https://mycompany.devolutions.app", "organizationId": "your-org-guid-here" } ], "configs": { "language": "en-US", "lockingOption": "windowsCredentials", "clearClipboardSensitiveData": true, "clipboardTimer": 60 } } ``` * Plusieurs serveurs : ajoutez d'autres objets au tableau `dvls`. ### Déploiement avec Microsoft Intune #### Étapes rapides 1. Préparez les fichiers : * `Workspace.msi` * `config.cfg` * `Install-Workspace.ps1` (voir ci-dessous) 2. Script PowerShell (`Install-Workspace.ps1`) : ```powershell $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 exit $Process.ExitCode ``` 3. Créez le package .intunewin : ```bash IntuneWinAppUtil.exe -c C:\IntuneApps\Workspace -s Install-Workspace.ps1 -o C:\Output ``` 4. Configurez dans Intune : * 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 * Règle de détection : MSI (Intune détecte automatiquement le code produit) * Ce qui se passe sur le point de terminaison : Intune exécute le script, qui copie `config.cfg` dans `C:\Program Files\` et installe le MSI avec `DEPLOY_CONFIG`. Le MSI applique la configuration, et les utilisateurs disposent d'une application entièrement configurée dès le premier lancement ### Emplacements des fichiers * À l'échelle du système (tous les utilisateurs) : `%ProgramData%\net.devolutions\Workspace\DefaultConfig.cfg` * Par utilisateur : `%APPDATA%\net.devolutions\Workspace\Config.cfg` * Remarque : la configuration à l'échelle du système nécessite un fichier indicateur `config.ready` dans le même répertoire ### Paramètres courants #### Paramètres de sécurité ```json { "language": "en-US", "reduceToTrayOnClose": true, "useFavicon": true, "useEntriesSyncOnDatasourceAccess": true } ``` #### Options de verrouillage * `password` - Mot de passe principal * `biometric` - Empreinte digitale/Face ID * `windowsCredentials` - Windows Hello #### Codes de langue `en-US`, `fr`, `de`, `es`, `cs`, `hu`, `it`, `nl`, `pl`, `ru`, `sv`, `tr`, `uk`, `zh-CHS`, `zh-TW` ### Solutions rapides de dépannage #### Configuration non appliquée * Vérifiez si le fichier `config.ready` se trouve à côté de `DefaultConfig.cfg` * Validez la syntaxe JSON (pas de virgules en fin de ligne) * Vérifiez les autorisations de fichiers #### Échec du déploiement Intune * Utilisez `DEPLOY_CONFIG` (et non `USER_CONFIG`) * Incluez le `.msi` et le `.cfg` dans le même package * Utilisez `/l*v install.log` pour capturer des journaux détaillés #### Les paramètres ne persistent pas * La configuration système ne s'applique que si la configuration utilisateur n'existe pas * Une fois que l'utilisateur modifie les paramètres, ceux-ci sont enregistrés dans la configuration utilisateur et remplacent les valeurs par défaut du système. ### Arbre de décision ``` Enterprise deployment? ├─ YES → Use DEPLOY_CONFIG with .cfg file │ (Intune, SCCM, silent installs) │ ├─ Simple setup → Use inline MSI parameters │ (Quick, one Devolutions Server) │ └─ Complex setup → Create .cfg with UI tool first (Multiple servers, many settings) ``` ### Support et ressources * [Documentation complète](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/) * [Référence des paramètres MSI](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#method-1-msi-installer-parameters) * [Paramètres de configuration](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#configuration-settings-reference) * * [Forum](https://forum.devolutions.net/) {% endtab %} {% tab title="macOS" %} Apprenez à déployer rapidement Devolutions Password Manager avec des espaces de travail et des paramètres préconfigurés sur des points de terminaison macOS. {% hint style="info" %} Consultez la [préconfiguration de Devolutions Password Manager](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/?tab=macos) pour des instructions plus détaillées, des informations de dépannage et des scénarios avancés. {% endhint %} ### Qu'est-ce que la préconfiguration La préconfiguration vous permet de déployer l'application macOS de Devolutions Password Manager avec : * Des espaces de travail déjà configurés (Devolutions Server, Devolutions Cloud) * Des paramètres d'application prédéfinis (langue, sécurité, options de verrouillage) * Aucune configuration requise de la part des utilisateurs ; ceux-ci lancent l'application et sont immédiatement opérationnels #### Pour les Mac gérés par MDM (recommandé) Utilisez des profils MDM Jamf Pro ou Intune — la norme en entreprise pour les parcs gérés. 1. Téléchargez le schéma Jamf : [Schéma JSON Jamf Pro](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#option-a-using-json-schema-recommended). 2. Dans Jamf Pro, accédez à ***Computers*** – ***Configuration Profiles*** – ***Application & Custom Settings***. 3. Téléversez le schéma JSON et configurez les paramètres dans l'interface graphique. 4. Appliquez le profil aux ordinateurs cibles. Domaine de préférences : `net.devolutions.authenticator` **Pourquoi utiliser MDM** * Gestion centralisée depuis la console MDM * Priorité la plus élevée (remplace la configuration par fichier) * Capacités d'application des politiques * Approche standard en entreprise #### Pour les environnements sans MDM Utilisez des fichiers de configuration pour les déploiements scriptés ou les environnements sans MDM. #### Déploiement à l'échelle du système ```bash sudo cp config.cfg "/Library/Application Support/Devolutions/Workspace/DefaultConfig.cfg" ``` ### Exemples #### Exemple 1 : configurer un Devolutions Server avec Jamf Pro Utilisation du schéma JSON Jamf (interface graphique) : 1. Téléversez le schéma dans un profil de configuration Jamf Pro 2. Configurez les paramètres, par exemple : * Devolutions Server : ajoutez un serveur avec l'URL `https://devolutions-server.company.com` * Méthode de verrouillage : biométrique (Touch ID) * Verrouiller lorsque l'application est en arrière-plan : activé 3. Appliquez et déployez #### Exemple 2 : créer un profil de configuration manuel (plist) ```xml PayloadContent PayloadType net.devolutions.authenticator PayloadIdentifier net.devolutions.authenticator.config PayloadDisplayName Devolutions Password Manager Configuration language en-US lockingOption biometric ``` #### Exemple 3 : commande defaults (test) ```bash # Configure settings defaults write net.devolutions.authenticator language -string "en-US" defaults write net.devolutions.authenticator lockingOption -string "biometric" defaults write net.devolutions.authenticator useBackgroundLock -bool true ``` ### Format du fichier de configuration Les fichiers de configuration (`.cfg`) utilisent le format JSON : ```json { "dvls": [ { "name": "Production Server", "serverUrl": "https://devolutions-server.company.com" } ], "hubs": [ { "url": "https://mycompany.devolutions.app", "organizationId": "your-org-guid-here" } ], "configs": { "language": "en-US", "lockingOption": "biometric", "clearClipboardSensitiveData": true, "clipboardTimer": 60 } } ``` **Plusieurs serveurs** : ajoutez d'autres objets au tableau `dvls`. ### Emplacements des fichiers * À l'échelle du système : `/Library/Application Support/Devolutions/Workspace/DefaultConfig.cfg` * Par utilisateur : `~/Library/Application Support/Workspace/Config.cfg` * MDM (priorité la plus élevée) : domaine de préférences `net.devolutions.authenticator` #### Ordre de priorité 1. Préférences gérées MDM (priorité la plus élevée) 2. Fichier de configuration utilisateur 3. Fichier de configuration système ### Paramètres courants #### Paramètres de sécurité ```json { "language": "en-US", "reduceToTrayOnClose": true, "useFavicon": true, "useEntriesSyncOnDatasourceAccess": true } ``` #### Options de verrouillage * `password` - Mot de passe principal * `biometric` - Touch ID #### Codes de langue `en-US`, `fr`, `de`, `es`, `cs`, `hu`, `it`, `nl`, `pl`, `ru`, `sv`, `tr`, `uk`, `zh-CHS`, `zh-TW` #### Solutions rapides de dépannage **Configuration MDM non appliquée** * Vérifiez le domaine de préférences : `net.devolutions.authenticator` * Vérifiez le statut du profil : Préférences Système – Profils * Forcez l'actualisation : `sudo profiles renew -type enrollment` **Fichier de configuration non chargé** * Vérifiez l'emplacement du fichier et les autorisations (`chmod 644`) * Validez la syntaxe JSON (pas de virgules en fin de ligne) * Supprimez la configuration utilisateur pour permettre l'application de la configuration système **Touch ID non fonctionnel** * Vérifiez que le Mac dispose du matériel Touch ID * Assurez-vous que Touch ID est configuré dans les Préférences Système * Revient au mot de passe si Touch ID n'est pas disponible ### Arbre de décision ``` Is this a managed Mac? ├─ YES (Jamf/Intune) – Use MDM profiles │ (Highest priority, centralized) │ └─ NO – Use config files - System-wide: /Library/Application Support/... - Per-user: ~/Library/Application Support/... ``` ### Vérifier la configuration Vérifier les paramètres MDM : ```bash defaults read net.devolutions.authenticator ``` Vérifier un paramètre spécifique : ```bash defaults read net.devolutions.authenticator language ``` ### Support et ressources * [Documentation complète](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/?tab=macos) * [Paramètres de configuration](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#configuration-settings-reference-1) * [Télécharger le schéma](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#option-a-using-json-schema-recommended) * [support@devolutions.net](mailto:%20support@devolutions.net) * [Forum](https://forum.devolutions.net/) {% endtab %} {% tab title="iOS" %} Apprenez à déployer rapidement Devolutions Password Manager avec des espaces de travail et des paramètres préconfigurés sur des appareils iOS. {% hint style="info" %} Consultez la [préconfiguration de Devolutions Password Manager](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/?tab=ios) pour des instructions plus détaillées, des informations de dépannage et des scénarios avancés. {% endhint %} ### Qu'est-ce que la préconfiguration MDM La préconfiguration MDM vous permet de déployer Devolutions Password Manager avec : * Des espaces de travail déjà configurés (Devolutions Server, Devolutions Cloud) * Des paramètres d'application prédéfinis (sécurité, options de verrouillage) * Aucune configuration requise de la part des utilisateurs ; ceux-ci lancent l'application et sont immédiatement opérationnels ### Prérequis * Serveur Jamf Pro ou solution Apple MDM * Devolutions Password Manager déployé via MDM * iOS 13.0+ sur les appareils gérés * Appareils inscrits dans MDM ### Démarrage rapide : déploiement Jamf Pro #### Option 1 : utilisation du fichier de spécifications AppConfig (recommandé) 1. Téléchargez le [fichier de spécifications AppConfig](https://cdnweb.devolutions.net/docs/workspace_mobile_appconfig_specfile.xml). 2. Téléversez-le dans le [générateur AppConfig de Jamf](https://generator.appconfig.jamfresearch.com/generator) et configurez les paramètres via le formulaire de l'interface graphique. 3. Téléchargez le plist généré. 4. Dans Jamf Pro, accédez à ***Mobile Device Apps*** – ***Devolutions Password Manager*** – ***App Configuration.*** 5. Collez le plist généré. 6. Appliquez aux appareils cibles. 7. Déployez. #### Option 2 : configuration plist directe Si vous n'utilisez pas le fichier de spécifications, saisissez la configuration directement sous forme de dictionnaire plist dans le champ App Configuration de Jamf Pro. Utilisez le format de clé plat (l'application le transforme automatiquement) : ```json { "dvls": [ { "name": "Production DVLS", "serverUrl": "https://devolutions-server.company.com", "serverVersion": "2024.1" } ], "hubs": [ { "url": "https://password-manager.devolutions.app", "organizationId": "your-org-id", "type": "business", "version": "2020" } ], "configs": { "lockingOption": "biometric", "useBackgroundLock": true, "backgroundLockDelay": 0, "useLockWhenInactive": true, "lockInactivityDelay": 300 } ``` ### Exemples de configuration #### Devolutions Server uniquement ```json { "dvls": [ { "name": "Corporate DVLS", "serverUrl": "https://devolutions-server.company.com" } ] } ``` ### Devolutions Cloud avec sécurité ```json { "hubs": [ { "url": "https://password-manager.devolutions.app", "organizationId": "", "type": "business", "version": "2020" } ], "configs": { "lockingOption": "biometric", "useBackgroundLock": true, "backgroundLockDelay": 0 } } ``` #### Plusieurs espaces de travail ```json { "dvls": [ { "name": "Production Devolutions Server", "serverUrl": "https://devolutions-server-prod.company.com" }, { "name": "Test Devolutions Server", "serverUrl": "https://devolutions-server-test.company.com" } ], "hubs": [ { "url": "https://password-manager.devolutions.app", "organizationId": "org-abc123", "type": "business", "version": "2020" } ] } ``` #### Paramètres de sécurité | Paramètre | Valeurs | Description | | ----------------------- | --------------------------------------- | ---------------------------------------------- | | **lockingOption** | `""`, `"biometric"` | Méthode de verrouillage de l'application. | | **useBackgroundLock** | `true`, `false` | Verrouiller lorsque l'app est en arrière-plan. | | **backgroundLockDelay** | `0`, `60`, `300`, `900`, `1800`, `3600` | Délai avant le verrouillage (secondes). | | **useLockWhenInactive** | `true`, `false` | Verrouillage automatique après inactivité. | | **lockInactivityDelay** | `30`, `60`, `120`, `180`, `240`, `300` | Délai d'inactivité (secondes). | #### Paramètres généraux | Paramètre | Valeurs | Description | | ------------------------------ | --------------- | ------------------------------------------------------ | | **useFavicon** | `true`, `false` | Télécharger les favicons des sites web. | | **autoSearch** | `true`, `false` | Activer la recherche automatique dans le coffre. | | **useHubEmbeddedBrowser** | `true`, `false` | Utiliser le navigateur intégré pour Devolutions Cloud. | | **highlightSpecialCharacters** | `true`, `false` | Mettre en évidence les caractères spéciaux. | | **shareUsageData** | `true`, `false` | Partager des données analytiques anonymes. | ### Solutions rapides de dépannage #### Configuration non appliquée * Vérifiez sur l'appareil : Réglages – Général – VPN et gestion des appareils * Vérifiez que l'application est gérée par MDM (déployée via MDM, pas l'App Store) * Validez la syntaxe JSON (utilisez jsonlint.com) * Supprimez et réinstallez l'application #### Les utilisateurs ne peuvent pas supprimer les espaces de travail en attente * Nouveauté dans la version 2025.3.2 : les utilisateurs peuvent désormais supprimer les espaces de travail en attente * Appuyez longuement sur l'espace de travail – Sélectionnez ***Supprimer*** #### Face ID/Touch ID non fonctionnel * Vérifiez que l'appareil dispose du matériel biométrique * Assurez-vous que Face ID/Touch ID est configuré dans les Réglages * Revient au code d'accès si non disponible ### Bonnes pratiques #### Paramètres de sécurité recommandés ```json { "lockingOption": "biometric", "useBackgroundLock": true, "backgroundLockDelay": 0, "useLockWhenInactive": true, "lockInactivityDelay": 300, } ``` **Pourquoi** * Impose Face ID/Touch ID * Verrouille immédiatement lorsque l'application est en arrière-plan * Verrouillage automatique après 5 minutes d'inactivité #### Exigences relatives au format d'URL * Inclure le protocole (`https://`) * Être des URL valides et accessibles * Sans barre oblique finale **Exemples :** * `https://devolutions-server.company.com` * `devolutions-server.company.com` (https\:// manquant) ### Résumé des étapes de déploiement 1. Téléchargez le [fichier de spécifications AppConfig](https://cdnweb.devolutions.net/docs/workspace_mobile_appconfig_specfile.xml). 2. Téléversez-le dans le [générateur AppConfig de Jamf](https://generator.appconfig.jamfresearch.com/generator). 3. Configurez les paramètres via le formulaire de l'interface graphique. 4. Téléchargez le plist généré. 5. Dans Jamf Pro : **Mobile Device Apps** – **Devolutions Password Manager** – **App Configuration.** 6. Collez le plist, appliquez aux appareils cibles, déployez. 7. Vérifiez sur un appareil de test. ### Support et ressources * [Documentation complète](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/?tab=ios) * [Fichier de spécifications AppConfig](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start/?tab=ios#appconfig-specfile) * [Exemples de configuration](https://docs.devolutions.net/fr/password-manager/kb/application-knowledge-base/devolutions-password-manager-pre-configuration/#configuration-examples) * * [Support Jamf](https://www.jamf.com/support/) ### Fichier de spécifications AppConfig Voici le fichier de spécifications AppConfig au format `.xml`. ````xml 1 net.devolutions.workspace.mobile en-US false 0 false 30 false false false true false Full URL to the Devolutions Server including https:// (e.g., https://devolutions-server.company.com) Full Devolutions Cloud URL including https:// (e.g., https://yourcompany.devolutions.app) Organization identifier for Devolutions Cloud (optional) App display language Authentication method for app locking Lock app when it goes to background Time to wait before locking when backgrounded Lock after period of inactivity Time before locking due to inactivity Share anonymous usage analytics Download and display website favicons for entries Enable auto-search in vaults Open Devolutions Cloud connections in embedded browser Highlight special characters in passwords ``` ```` {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.devolutions.net/password-manager/fr/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.