> 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/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start.md).

# Avvio rapido della pre-configurazione di Devolutions Password Manager

{% tabs %}
{% tab title="Windows" %}
Scopra come distribuire rapidamente Devolutions Password Manager con spazi di lavoro e impostazioni preconfigurati sugli endpoint Windows.

{% hint style="info" %}
Consulti [Preconfigurazione di Devolutions Password Manager](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md) per istruzioni più dettagliate, risoluzione dei problemi e scenari avanzati.
{% endhint %}

### Che cos'è la preconfigurazione

La preconfigurazione le consente di distribuire l'app Windows di Devolutions Password Manager con:

* Spazi di lavoro già configurati (Devolutions Server, Devolutions Cloud)
* Impostazioni dell'applicazione preapplicate (lingua, sicurezza, opzioni di blocco)
* Nessuna configurazione richiesta all'utente; gli utenti avviano l'app e sono immediatamente operativi

### Avvio rapido: scelga il suo metodo

#### Per la distribuzione aziendale (Intune/SCCM)

* Utilizzi `DEPLOY_CONFIG` per le distribuzioni automatizzate: consigliato per Intune, SCCM, installazioni silenziose

```bash
msiexec /i Devolutions.PasswordManager.msi /qn DEPLOY_CONFIG="C:\path\to\Config.cfg"
```

**Perché DEPLOY\_CONFIG?**

* Funziona in modo affidabile nelle installazioni automatizzate/silenziose
* Si applica a tutti gli utenti del computer
* Nessun problema di contesto utente
* Pulisce automaticamente il file di configurazione di origine

**Dove ottenere Config.cfg?**

* Lo crei utilizzando lo strumento di configurazione dell'interfaccia (***Strumenti*** – ***Installazione personalizzata*** in Devolutions Password Manager)
* Oppure [crei manualmente un file `.cfg`](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#configuration-file-structure)

#### Per distribuzioni semplici

* Utilizzi i parametri MSI inline per distribuzioni rapide

```bash
msiexec /i Devolutions.PasswordManager.msi /qn ^
  DVLS_SERVER_URL="https://devolutions-server.company.com" ^
  HUB_NAME="mycompany" ^
  ORGANIZATION_ID="your-org-guid" ^
  LANGUAGE="en-US"
```

### Esempi rapidi

#### Esempio 1: distribuire Devolutions Server con impostazioni

```bash
msiexec /i Devolutions.PasswordManager.msi /qn ^
  DVLS_SERVER_URL="https://devolutions-server.company.com" ^
  LOCKING_OPTION="windowsCredentials" ^
  LANGUAGE="en-US"
```

#### Esempio 2: distribuire Devolutions Cloud

```bash
# With Organization ID
msiexec /i Devolutions.PasswordManager.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 Devolutions.PasswordManager.msi /qn ^
  HUB_NAME="mycompany" ^
  REDUCE_TO_TRAY_ON_CLOSE="true"
```

#### Esempio 3: distribuire utilizzando un file di configurazione

```bash
msiexec /i Devolutions.PasswordManager.msi /qn DEPLOY_CONFIG="\\server\share\Config.cfg"
```

### Formato del file di configurazione

I file di configurazione (`.cfg`) utilizzano il formato 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
  }
}
```

* Più server: aggiunga altri oggetti all'array `dvls`.

### Distribuzione con Microsoft Intune

#### Passaggi rapidi

1. Prepari i file:

* `Devolutions.PasswordManager.msi`
* `config.cfg`
* `Install-Devolutions.PasswordManager.ps1` (vedere di seguito)

2. Script PowerShell (`Install-Devolutions.PasswordManager.ps1`):

```powershell
$ConfigSource = "$PSScriptRoot\config.cfg"
$ConfigTarget = "C:\Program Files\config.cfg"
$MsiPath = "$PSScriptRoot\Devolutions.PasswordManager.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. Crei il pacchetto .intunewin:

```bash
IntuneWinAppUtil.exe -c C:\IntuneApps\Devolutions Password Manager -s Install-Devolutions.PasswordManager.ps1 -o C:\Output
```

4. Configuri in Intune:

* Comando di installazione: `` `powershell.exe -ExecutionPolicy Bypass -File .\Install-Devolutions.PasswordManager.ps1 ``
* Comando di disinstallazione: `msiexec.exe /x {PRODUCT-CODE-GUID} /qn /norestart`
* Comportamento di installazione: sistema
* Regola di rilevamento: MSI (Intune rileva automaticamente il codice prodotto)
* Cosa succede sull'endpoint: Intune esegue lo script, che copia `config.cfg` in `C:\Program Files\` e installa l'MSI con `DEPLOY_CONFIG`. L'MSI applica la configurazione e gli utenti ottengono un'app completamente configurata al primo avvio

### Percorsi dei file

* A livello di sistema (tutti gli utenti): `%ProgramData%\net.devolutions\Devolutions Password Manager\DefaultConfig.cfg`
* Per utente: `%APPDATA%\net.devolutions\Devolutions Password Manager\Config.cfg`
* Nota: la configurazione a livello di sistema richiede il file indicatore `config.ready` nella stessa directory

### Impostazioni comuni

#### Impostazioni di sicurezza

```json
{
  "language": "en-US",
  "reduceToTrayOnClose": true,
  "useFavicon": true,
  "useEntriesSyncOnDatasourceAccess": true
}
```

#### Opzioni di blocco

* `password` - Password principale
* `biometric` - Impronta digitale/Face ID
* `windowsCredentials` - Windows Hello

#### Codici lingua

`en-US`, `fr`, `de`, `es`, `cs`, `hu`, `it`, `nl`, `pl`, `ru`, `sv`, `tr`, `uk`, `zh-CHS`, `zh-TW`

### Risoluzione rapida dei problemi

#### Configurazione non applicata

* Verifichi se il file `config.ready` esiste accanto a `DefaultConfig.cfg`
* Convalidi la sintassi JSON (nessuna virgola finale)
* Verifichi le autorizzazioni dei file

#### Distribuzione Intune non riuscita

* Utilizzi `DEPLOY_CONFIG` (non `USER_CONFIG`)
* Includa nel pacchetto sia `.msi` che `.cfg`
* Utilizzi `/l*v install.log` per acquisire log dettagliati

#### Impostazioni non persistenti

* La configurazione di sistema si applica solo se la configurazione utente non esiste
* Una volta che l'utente modifica le impostazioni, queste vengono salvate nella configurazione utente e sovrascrivono le impostazioni predefinite di sistema.

### Albero decisionale

```
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)
```

### Supporto e risorse

* [Documentazione completa](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md)
* [Riferimento dei parametri MSI](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#method-1-msi-installer-parameters)
* [Impostazioni di configurazione](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#configuration-settings-reference)
* <support@devolutions.net>
* [Forum](https://forum.devolutions.net/)
  {% endtab %}

{% tab title="macOS" %}
Scopra come distribuire rapidamente Devolutions Password Manager con spazi di lavoro e impostazioni preconfigurati sugli endpoint macOS.

{% hint style="info" %}
Consulti [Preconfigurazione di Devolutions Password Manager](https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration?tab=macos) per istruzioni più dettagliate, risoluzione dei problemi e scenari avanzati.
{% endhint %}

### Che cos'è la preconfigurazione

La preconfigurazione le consente di distribuire l'app macOS di Devolutions Password Manager con:

* Spazi di lavoro già configurati Devolutions Server, Devolutions Cloud
* Impostazioni dell'applicazione preapplicate (lingua, sicurezza, opzioni di blocco)
* Nessuna configurazione richiesta all'utente; gli utenti avviano l'app e sono immediatamente operativi

#### Per Mac gestiti tramite MDM (consigliato)

Utilizzi i profili MDM di Jamf Pro o Intune - Standard aziendale per le flotte gestite.

1. Scarichi lo schema Jamf: [Jamf Pro JSON Schema](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#jamf-pro-deployment).
2. In Jamf Pro, vada a ***Computers*** – ***Configuration Profiles*** – ***Application & Custom Settings***.
3. Carichi lo schema JSON e configuri le impostazioni nella GUI.
4. Definisca l'ambito del profilo per i computer di destinazione.

Dominio delle preferenze: `net.devolutions.authenticator`

**Perché utilizzare MDM**

* Gestione centralizzata dalla console MDM
* Priorità più alta (sovrascrive la configurazione basata su file)
* Funzionalità di applicazione dei criteri
* Approccio standard aziendale

#### Per ambienti senza MDM

Utilizzi i file di configurazione per distribuzioni tramite script o ambienti senza MDM.

#### Distribuzione a livello di sistema

```bash
sudo cp config.cfg "/Library/Application Support/Devolutions/Devolutions Password Manager/DefaultConfig.cfg"
```

### Esempi

#### Esempio 1: configurare un Devolutions Server con Jamf Pro

Utilizzando lo schema JSON Jamf (GUI):

1. Carichi lo schema in un profilo di configurazione di Jamf Pro
2. Configuri le impostazioni, ad esempio:
   * Devolutions Server: aggiunga un server con URL `https://devolutions-server.company.com`
   * Metodo di blocco: biometrico (Touch ID)
   * Blocca quando in background: abilitato
3. Definisca l'ambito e distribuisca

#### Esempio 2: creare un profilo di configurazione manuale (plist)

```xml
<?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>PayloadIdentifier</key>
            <string>net.devolutions.authenticator.config</string>
            <key>PayloadDisplayName</key>
            <string>Devolutions Password Manager Configuration</string>
            <key>language</key>
            <string>en-US</string>
            <key>lockingOption</key>
            <string>biometric</string>
        </dict>
    </array>
</dict>
</plist>
```

#### Esempio 3: comando 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
```

### Formato del file di configurazione

I file di configurazione (`.cfg`) utilizzano il formato 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
  }
}
```

**Più server** Aggiunga altri oggetti all'array `dvls`.

### Percorsi dei file

* A livello di sistema: `/Library/Application Support/Devolutions/Devolutions Password Manager/DefaultConfig.cfg`
* Per utente: `~/Library/Application Support/Devolutions Password Manager/Config.cfg`
* MDM (priorità più alta): dominio delle preferenze `net.devolutions.authenticator`

#### Ordine di priorità

1. Preferenze gestite MDM (priorità più alta)
2. File di configurazione utente
3. File di configurazione di sistema

### Impostazioni comuni

#### Impostazioni di sicurezza

```json
{
  "language": "en-US",
  "reduceToTrayOnClose": true,
  "useFavicon": true,
  "useEntriesSyncOnDatasourceAccess": true
}
```

#### Opzioni di blocco

* `password` - Password principale
* `biometric` - Touch ID

#### Codici lingua

`en-US`, `fr`, `de`, `es`, `cs`, `hu`, `it`, `nl`, `pl`, `ru`, `sv`, `tr`, `uk`, `zh-CHS`, `zh-TW`

#### Soluzioni rapide per la risoluzione dei problemi

**Configurazione MDM non applicata**

* Verifichi il dominio delle preferenze: `net.devolutions.authenticator`
* Controlli lo stato del profilo: Preferenze di Sistema – Profili
* Forzi l'aggiornamento: `sudo profiles renew -type enrollment`

**File di configurazione non caricato**

* Controlli la posizione e le autorizzazioni del file (`chmod 644`)
* Convalidi la sintassi JSON (nessuna virgola finale)
* Elimini la configurazione utente per consentire l'applicazione della configurazione di sistema

**Touch ID non funziona**

* Verifichi che il Mac disponga dell'hardware Touch ID
* Si assicuri che Touch ID sia configurato in Preferenze di Sistema
* Ripiega sulla password se non disponibile

### Albero decisionale

```
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/...
```

### Verifica della configurazione

Controlli le impostazioni MDM:

```bash
defaults read net.devolutions.authenticator
```

Controlli un'impostazione specifica:

```bash
defaults read net.devolutions.authenticator language
```

### Supporto e risorse

* [Documentazione completa](https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration?tab=macos)
* [Impostazioni di configurazione](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#configuration-settings-reference-1)
* [Scarica lo schema](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#jamf-pro-deployment)
* [support@devolutions.net](mailto:%20support@devolutions.net)
* [Forum](https://forum.devolutions.net/)
  {% endtab %}

{% tab title="iOS" %}
Scopra come distribuire rapidamente Devolutions Password Manager con spazi di lavoro e impostazioni preconfigurati sui dispositivi iOS.

{% hint style="info" %}
Consulti [Preconfigurazione di Devolutions Password Manager](https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration?tab=ios) per istruzioni più dettagliate, risoluzione dei problemi e scenari avanzati.
{% endhint %}

### Che cos'è la preconfigurazione MDM

La preconfigurazione MDM consente di distribuire Devolutions Password Manager con:

* Spazi di lavoro già configurati (Devolutions Server, Devolutions Cloud)
* Impostazioni dell'applicazione già applicate (sicurezza, opzioni di blocco)
* Nessuna configurazione richiesta all'utente; gli utenti avviano l'app e sono immediatamente produttivi

### Prerequisiti

* Server Jamf Pro o soluzione MDM Apple
* Devolutions Password Manager distribuito tramite MDM
* iOS 13.0+ sui dispositivi gestiti
* Dispositivi registrati in MDM

### Avvio rapido: distribuzione con Jamf Pro

#### Opzione 1: uso dello specfile AppConfig (consigliato)

1. Scarichi lo [specfile AppConfig](https://cdnweb.devolutions.net/docs/workspace_mobile_appconfig_specfile.xml).
2. Lo carichi nel [Jamf AppConfig Generator](https://generator.appconfig.jamfresearch.com/generator) e configuri le impostazioni tramite il modulo GUI.
3. Scarichi il plist generato.
4. In Jamf Pro, vada a ***Mobile Device Apps*** – ***Devolutions Password Manager*** – ***App Configuration.***
5. Incolli il plist generato.
6. Definisca l'ambito sui dispositivi di destinazione.
7. Distribuisca.

#### Opzione 2: configurazione plist diretta

Se non utilizza lo specfile, inserisca la configurazione direttamente come dizionario plist nel campo App Configuration di Jamf Pro. Utilizzi il formato a chiave piatta (l'app lo trasforma automaticamente):

```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
  }
```

### Esempi di configurazione

#### Solo Devolutions Server

```json
{
  "dvls": [
    {
      "name": "Corporate DVLS",
      "serverUrl": "https://devolutions-server.company.com"
    }
  ]
}
```

### Devolutions Cloud con sicurezza

```json
{
  "hubs": [
    {
      "url": "https://password-manager.devolutions.app",
      "organizationId": "",
      "type": "business",
      "version": "2020"
    }
  ],
  "configs": {
    "lockingOption": "biometric",
    "useBackgroundLock": true,
    "backgroundLockDelay": 0
  }
}
```

#### Più spazi di lavoro

```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"
    }
  ]
}
```

#### Impostazioni di sicurezza

| Impostazione            | Valori                                  | Descrizione                         |
| ----------------------- | --------------------------------------- | ----------------------------------- |
| **lockingOption**       | `""`, `"biometric"`                     | Metodo di blocco dell'app.          |
| **useBackgroundLock**   | `true`, `false`                         | Blocca quando è in background.      |
| **backgroundLockDelay** | `0`, `60`, `300`, `900`, `1800`, `3600` | Ritardo prima del blocco (secondi). |
| **useLockWhenInactive** | `true`, `false`                         | Blocco automatico dopo inattività.  |
| **lockInactivityDelay** | `30`, `60`, `120`, `180`, `240`, `300`  | Timeout di inattività (secondi).    |

#### Impostazioni generali

| Impostazione                   | Valori          | Descrizione                                          |
| ------------------------------ | --------------- | ---------------------------------------------------- |
| **useFavicon**                 | `true`, `false` | Scarica le favicon dei siti web.                     |
| **autoSearch**                 | `true`, `false` | Abilita la ricerca automatica nella cassaforte.      |
| **useHubEmbeddedBrowser**      | `true`, `false` | Utilizza il browser integrato per Devolutions Cloud. |
| **highlightSpecialCharacters** | `true`, `false` | Evidenzia i caratteri speciali.                      |
| **shareUsageData**             | `true`, `false` | Condivide dati analitici anonimi.                    |

### Soluzioni rapide per la risoluzione dei problemi

#### Configurazione non applicata

* Verifichi il dispositivo: Impostazioni – Generali – VPN e gestione dispositivi
* Controlli che l'app sia gestita da MDM (distribuita tramite MDM, non tramite App Store)
* Convalidi la sintassi JSON (utilizzi jsonlint.com)
* Elimini e reinstalli l'app

#### Gli utenti non possono eliminare gli spazi di lavoro in sospeso

* Novità in 2025.3.2: gli utenti possono ora eliminare gli spazi di lavoro in sospeso
* Prema a lungo sullo spazio di lavoro – Selezioni ***Rimuovi***

#### Face ID/Touch ID non funziona

* Verifichi che il dispositivo disponga di hardware biometrico
* Si assicuri che Face ID/Touch ID sia configurato in Impostazioni
* Ripiega sul codice di accesso se non disponibile

### Buone pratiche

#### Impostazioni di sicurezza consigliate

```json
{
  "lockingOption": "biometric",
  "useBackgroundLock": true,
  "backgroundLockDelay": 0,
  "useLockWhenInactive": true,
  "lockInactivityDelay": 300,
}
```

**Perché**

* Impone l'uso di Face ID/Touch ID
* Blocca immediatamente quando è in background
* Blocco automatico dopo 5 minuti di inattività

#### Requisiti del formato URL

* Includere il protocollo (`https://`)
* Essere URL validi e accessibili
* Nessuna barra finale

**Esempi:**

* `https://devolutions-server.company.com`
* `devolutions-server.company.com` (manca https\://)

### Riepilogo dei passaggi di distribuzione

1. Scarichi l'[AppConfig specfile](https://cdnweb.devolutions.net/docs/workspace_mobile_appconfig_specfile.xml).
2. Lo carichi nel [Jamf AppConfig Generator](https://generator.appconfig.jamfresearch.com/generator).
3. Configuri le impostazioni tramite il modulo GUI.
4. Scarichi il plist generato.
5. In Jamf Pro: **Mobile Device Apps** – **Devolutions Password Manager** – **App Configuration.**
6. Incolli il plist, definisca l'ambito sui dispositivi di destinazione, esegua il deployment.
7. Verifichi su un dispositivo di test.

### Supporto e risorse

* [Documentazione completa](https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration?tab=ios)
* [AppConfig Specfile](https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start?tab=ios#appconfig-specfile)
* [Esempi di configurazione](/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration.md#configuration-examples)
* <support@devolutions.net>
* [Supporto Jamf](https://www.jamf.com/support/)

### AppConfig Specfile

Di seguito è riportato il file spec AppConfig in formato `.xml`.

````xml
<?xml version="1.0" encoding="UTF-8"?>
<managedAppConfiguration>
  <version>1</version>
  <bundleId>net.devolutions.workspace.mobile</bundleId>

  <dict>
    <!-- DVLS configuration -->
    <string keyName="dvls_serverUrl"></string>

    <!-- Devolutions Cloud configuration -->
    <string keyName="hub_url"></string>
    <string keyName="hub_organizationId"></string>

    <!-- Security settings -->
    <string keyName="language">en-US</string>
    <string keyName="lockingOption"></string>
    <boolean keyName="useBackgroundLock">false</boolean>
    <integer keyName="backgroundLockDelay">0</integer>
    <boolean keyName="useLockWhenInactive">false</boolean>
    <integer keyName="lockInactivityDelay">30</integer>

    <!-- General settings -->
    <boolean keyName="shareUsageData">false</boolean>
    <boolean keyName="useFavicon">false</boolean>
    <boolean keyName="autoSearch">false</boolean>
    <boolean keyName="useHubEmbeddedBrowser">true</boolean>
    <boolean keyName="highlightSpecialCharacters">false</boolean>
  </dict>

  <presentation defaultLocale="en-US">
    <!-- Devolutions Server URL -->
    <field keyName="dvls_serverUrl" type="input">
      <label>
        <language value="en-US">Devolutions Server URL</language>
      </label>
      <description>
        <language value="en-US">Full URL to the Devolutions Server including https:// (e.g., https://devolutions-server.company.com)</language>
      </description>
    </field>

    <!-- Devolutions Cloud URL -->
    <field keyName="hub_url" type="input">
      <label>
        <language value="en-US">Devolutions Cloud URL</language>
      </label>
      <description>
        <language value="en-US">Full Devolutions Cloud URL including https:// (e.g., https://yourcompany.devolutions.app)</language>
      </description>
    </field>

    <!-- Devolutions Cloud organization ID -->
    <field keyName="hub_organizationId" type="input">
      <label>
        <language value="en-US">Devolutions Cloud Organization ID</language>
      </label>
      <description>
        <language value="en-US">Organization identifier for Devolutions Cloud (optional)</language>
      </description>
    </field>

    <!-- Language -->
    <field keyName="language" type="select">
      <label>
        <language value="en-US">Language</language>
      </label>
      <description>
        <language value="en-US">App display language</language>
      </description>
      <options>
        <option value="en-US">
          <language value="en-US">English (US)</language>
        </option>
        <option value="fr">
          <language value="en-US">French</language>
        </option>
        <option value="de">
          <language value="en-US">German</language>
        </option>
        <option value="es">
          <language value="en-US">Spanish</language>
        </option>
        <option value="cs">
          <language value="en-US">Czech</language>
        </option>
        <option value="hu">
          <language value="en-US">Hungarian</language>
        </option>
        <option value="it">
          <language value="en-US">Italian</language>
        </option>
        <option value="nl">
          <language value="en-US">Dutch</language>
        </option>
        <option value="pl">
          <language value="en-US">Polish</language>
        </option>
        <option value="ru">
          <language value="en-US">Russian</language>
        </option>
        <option value="sv">
          <language value="en-US">Swedish</language>
        </option>
        <option value="tr">
          <language value="en-US">Turkish</language>
        </option>
        <option value="uk">
          <language value="en-US">Ukrainian</language>
        </option>
        <option value="zh-CHS">
          <language value="en-US">Chinese (Simplified)</language>
        </option>
        <option value="zh-TW">
          <language value="en-US">Chinese (Traditional)</language>
        </option>
      </options>
    </field>

    <!-- Locking option -->
    <field keyName="lockingOption" type="select">
      <label>
        <language value="en-US">Locking Method</language>
      </label>
      <description>
        <language value="en-US">Authentication method for app locking</language>
      </description>
      <options>
        <option value="">
          <language value="en-US">None</language>
        </option>
        <option value="biometric">
          <language value="en-US">Biometric (Touch ID/Face ID)</language>
        </option>
      </options>
    </field>

    <!-- Lock when backgrounded -->
    <field keyName="useBackgroundLock" type="checkbox">
      <label>
        <language value="en-US">Lock When Backgrounded</language>
      </label>
      <description>
        <language value="en-US">Lock app when it goes to background</language>
      </description>
    </field>

    <!-- Background lock delay -->
    <field keyName="backgroundLockDelay" type="select">
      <label>
        <language value="en-US">Background Lock Delay</language>
      </label>
      <description>
        <language value="en-US">Time to wait before locking when backgrounded</language>
      </description>
      <options>
        <option value="0">
          <language value="en-US">Immediately</language>
        </option>
        <option value="60">
          <language value="en-US">1 minute</language>
        </option>
        <option value="300">
          <language value="en-US">5 minutes</language>
        </option>
        <option value="900">
          <language value="en-US">15 minutes</language>
        </option>
        <option value="1800">
          <language value="en-US">30 minutes</language>
        </option>
        <option value="3600">
          <language value="en-US">1 hour</language>
        </option>
      </options>
    </field>

    <!-- Auto-lock when inactive -->
    <field keyName="useLockWhenInactive" type="checkbox">
      <label>
        <language value="en-US">Auto-Lock When Inactive</language>
      </label>
      <description>
        <language value="en-US">Lock after period of inactivity</language>
      </description>
    </field>

    <!-- Inactivity lock delay -->
    <field keyName="lockInactivityDelay" type="select">
      <label>
        <language value="en-US">Inactivity Lock Delay</language>
      </label>
      <description>
        <language value="en-US">Time before locking due to inactivity</language>
      </description>
      <options>
        <option value="30">
          <language value="en-US">30 seconds</language>
        </option>
        <option value="60">
          <language value="en-US">1 minute</language>
        </option>
        <option value="120">
          <language value="en-US">2 minutes</language>
        </option>
        <option value="180">
          <language value="en-US">3 minutes</language>
        </option>
        <option value="240">
          <language value="en-US">4 minutes</language>
        </option>
        <option value="300">
          <language value="en-US">5 minutes</language>
        </option>
      </options>
    </field>

    <!-- Share usage data -->
    <field keyName="shareUsageData" type="checkbox">
      <label>
        <language value="en-US">Share Usage Data</language>
      </label>
      <description>
        <language value="en-US">Share anonymous usage analytics</language>
      </description>
    </field>

    <!-- Use favicons -->
    <field keyName="useFavicon" type="checkbox">
      <label>
        <language value="en-US">Use Favicons</language>
      </label>
      <description>
        <language value="en-US">Download and display website favicons for entries</language>
      </description>
    </field>

    <!-- Auto search -->
    <field keyName="autoSearch" type="checkbox">
      <label>
        <language value="en-US">Auto Search</language>
      </label>
      <description>
        <language value="en-US">Enable auto-search in vaults</language>
      </description>
    </field>

    <!-- Use Devolutions Cloud embedded browser -->
    <field keyName="useHubEmbeddedBrowser" type="checkbox">
      <label>
        <language value="en-US">Use Devolutions Cloud Embedded Browser</language>
      </label>
      <description>
        <language value="en-US">Open Devolutions Cloud connections in embedded browser</language>
      </description>
    </field>

    <!-- Highlight special characters -->
    <field keyName="highlightSpecialCharacters" type="checkbox">
      <label>
        <language value="en-US">Highlight Special Characters</language>
      </label>
      <description>
        <language value="en-US">Highlight special characters in passwords</language>
      </description>
    </field>
  </presentation>
</managedAppConfiguration>
```</div></div>
````

{% 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, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/password-manager/it/knowledge-base/application-knowledge-base/devolutions-password-manager-pre-configuration/devolutions-password-manager-pre-configuration-quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.