> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Criteri Enterprise

> Gestisci centralmente le impostazioni di Devin Desktop con i criteri Enterprise. Configura le allowlist delle estensioni, le modalità di aggiornamento e altre impostazioni su Windows, macOS e Linux utilizzando criteri di gruppo, profili di configurazione e file JSON dei criteri.

<div id="enterprise-policies-for-extension-management">
  # Policy Enterprise per la gestione delle estensioni
</div>

Le policy Enterprise in Devin Desktop consentono alle organizzazioni di gestire centralmente le impostazioni dell'editor per i team di sviluppo, così da garantire coerenza e sicurezza in tutta l'organizzazione. Quando viene impostato un valore di policy, questo ha la precedenza sull'impostazione di Devin Desktop configurata a qualsiasi livello (predefinito, utente e workspace).

Gli admin IT possono distribuire e applicare configurazioni specifiche di Devin Desktop sui dispositivi degli utenti tramite diverse soluzioni di gestione dei dispositivi. Devin Desktop supporta l'applicazione delle policy su **Windows**, **macOS** e **Linux**.

<Note>
  Devin Desktop usa percorsi delle policy propri, separati da quelli di VS Code. Le policy configurate per VS Code non si applicano a Devin Desktop, e viceversa.
</Note>

***

<div id="windows-group-policies">
  ## Criteri di gruppo di Windows
</div>

Devin Desktop supporta i [Criteri di gruppo di Windows basati sul Registro di sistema](https://learn.microsoft.com/en-us/windows/client-management/group-policies-overview). I criteri possono essere distribuiti tramite soluzioni di Mobile Device Management (MDM) o configurati manualmente sui singoli dispositivi.

<Note>
  Devin Desktop legge i criteri dal percorso del Registro di sistema `Software\Policies\Windsurf\{ProductName}` (ad es. `Software\Policies\Windsurf\Windsurf` o `Software\Policies\Windsurf\WindsurfInsiders`). Diversamente da VS Code, che legge da `Software\Policies\Microsoft\{ProductName}`.
</Note>

<div id="step-1-obtain-the-admx-and-adml-files">
  ### Passaggio 1: ottenere i file ADMX e ADML
</div>

Ogni release di Devin Desktop include una directory `policies` che contiene i file modello ADMX che definiscono i criteri disponibili.

Puoi ottenere i file ADMX e ADML da un'installazione esistente di Devin Desktop:

1. Vai alla directory di installazione di Devin Desktop.
2. Cerca la cartella `policies`. Questa cartella contiene i file modello ADMX (ad es. `windsurf.admx`) e una sottocartella `locales` con i file ADML per le diverse lingue.

In alternativa, scarica ed estrai l'archivio zip di Devin Desktop e individua la cartella `policies` tra i file estratti.

<div id="step-2-install-the-policy-definition-files">
  ### Passaggio 2: Installa i file di definizione dei criteri
</div>

1. Copia il file `windsurf.admx` in `C:\Windows\PolicyDefinitions`.
2. Copia il file ADML appropriato dalla sottocartella `locales` (ad es. `en-US\windsurf.adml`) in `C:\Windows\PolicyDefinitions\<your-locale>` (ad es. `C:\Windows\PolicyDefinitions\en-US`).

<Note>
  Per copiare i file nella directory `PolicyDefinitions` sono necessari privilegi di amministratore.
</Note>

Per gli ambienti Active Directory, copia i file ADMX e ADML nell'[Archivio centrale](https://learn.microsoft.com/en-us/troubleshoot/windows-client/group-policy/create-and-manage-central-store) per rendere i criteri disponibili in tutto il dominio.

### Passaggio 3: Distribuire i criteri

Puoi distribuire su larga scala i criteri configurati tramite una soluzione MDM oppure testarli manualmente su un computer locale usando l'Editor Criteri di gruppo locali.

<div id="deploy-at-scale">
  #### Distribuzione su larga scala
</div>

Prodotti come [Microsoft Intune](https://www.microsoft.com/en-us/security/business/microsoft-intune) o Active Directory Group Policy possono essere utilizzati per gestire centralmente i criteri per i dispositivi su larga scala. Queste soluzioni consentono agli amministratori di distribuire i file ADMX/ADML e le configurazioni dei criteri a più dispositivi da una posizione centrale.

#### Testare manualmente le policy su un computer locale

Segui questi passaggi per configurare le policy di Devin Desktop su un computer Windows locale usando l'Editor Criteri di gruppo locali:

1. **Apri l'Editor Criteri di gruppo locali:**
   * Premi `Windows+R` per aprire la finestra di dialogo Esegui.
   * Digita `gpedit.msc` e premi Invio.
   * Se richiesto da Controllo dell'account utente, seleziona **Sì**.

2. **Vai alle policy di Windsurf:**
   * **Configurazione computer** > **Modelli amministrativi** > **Windsurf**
   * **Configurazione utente** > **Modelli amministrativi** > **Windsurf**

<Tip>
  Le policy a livello di computer hanno la precedenza su quelle a livello di utente quando entrambe sono configurate.
</Tip>

3. **Configura una policy:**
   * Fai doppio clic sulla policy che vuoi configurare (ad es. **AllowedExtensions**).
   * Seleziona **Abilitato** per applicare la policy.
   * Per le policy di tipo stringa (ad es. `AllowedExtensions`), inserisci il valore nel campo di testo. Ad esempio: `{"publisher1": true, "publisher2": true}`.
   * Per le policy booleane (ad es. **EnableTelemetry**), la selezione di **Abilitato** o **Disabilitato** imposta il valore.
   * Seleziona **OK** per salvare le modifiche.

<Warning>
  Se il valore di una policy di tipo stringa contiene un errore di sintassi (ad es. JSON non valido), l'impostazione non verrà applicata. Puoi controllare gli errori nel Window Log di Devin Desktop (apri la command palette con `Ctrl+Shift+P` e inserisci **Show Window Log**).
</Warning>

La policy entrerà in vigore al successivo avvio di Devin Desktop.

***

<div id="macos-configuration-profiles">
  ## Profili di configurazione per macOS
</div>

I profili di configurazione consentono di gestire le impostazioni dei dispositivi macOS. Un profilo è un file XML (`.mobileconfig`) con coppie chiave/valore che corrispondono alle policy disponibili.

Questi profili possono essere distribuiti tramite soluzioni di Mobile Device Management (MDM) oppure installati manualmente sui singoli dispositivi.

<div id="step-1-obtain-the-sample-configuration-profile">
  ### Passaggio 1: Recuperare il profilo di configurazione di esempio
</div>

Ogni versione di Devin Desktop include un file `.mobileconfig` di esempio. Per trovare il file di esempio su un dispositivo macOS con Devin Desktop installato:

1. Apri Finder e vai a `/Applications`.
2. Fai clic con il pulsante destro su **Devin.app** e seleziona **Mostra contenuto pacchetto**.
3. Vai a `Contents/Resources/app/policies`.
4. Individua il file `.mobileconfig` di esempio.

<div id="step-2-configure-policy-values">
  ### Passaggio 2: Configura i valori delle policy
</div>

1. Copia il file `.mobileconfig` di esempio in una posizione di lavoro (ad es. la cartella Scrivania o Documenti).
2. Apri il file copiato in un editor di testo.
3. Modifica i valori delle policy in base alle tue esigenze:

**Policy di tipo stringa** — policy che accettano valori di testo o stringhe JSON:

```xml theme={null}
<!-- Esempio: consenti estensioni da publisher specifici -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
```

**Policy booleane** — policy che accettano valori vero/falso:

```xml theme={null}
<!-- Esempio: Abilitare il feedback degli utenti -->
<key>EnableFeedback</key>
<true/>

<!-- Esempio: Disabilitare la telemetria -->
<key>EnableTelemetry</key>
<false/>
```

**Rimuovi i criteri indesiderati** — elimina sia la chiave sia il valore di qualsiasi criterio che non vuoi applicare.

<Warning>
  Se è presente un errore di sintassi nel valore del criterio, l'impostazione non verrà applicata. Puoi verificare il log della finestra in Devin Desktop per individuare eventuali errori (apri la command palette con `⌘+Shift+P` e inserisci **Show Window Log**).
</Warning>

<div id="step-3-deploy-the-policies">
  ### Passaggio 3: Distribuisci le policy
</div>

<div id="deploy-at-scale">
  #### Distribuzione su larga scala
</div>

Per le distribuzioni Enterprise su più dispositivi, utilizza soluzioni di Mobile Device Management (MDM) come Apple Business Manager con MDM.

Per ulteriori informazioni sui profili di configurazione, consulta la [documentazione di Apple sui profili di configurazione](https://support.apple.com/guide/deployment/intro-to-mdm-profiles-depc0aadd3fe/web).

<div id="manually-test-policies-on-a-local-machine">
  #### Testare manualmente le policy su una macchina locale
</div>

1. **Installare il profilo di configurazione:**
   * Salva il file `.mobileconfig` modificato.
   * Fai doppio clic sul file `.mobileconfig` nel Finder.
   * Si aprirà **Settings**. Verifica i dettagli del profilo e seleziona **Install**.
   * Se richiesto, autenticati con le credenziali di amministratore.

2. **Verificare l'installazione del profilo:**
   * Apri **Settings**.
   * Vai a **Privacy & Security** > **Profiles** (oppure **General** > **Device Management** nelle versioni precedenti).
   * Verifica che il profilo di configurazione di Devin Desktop compaia nell'elenco.
   * Avvia Devin Desktop per visualizzare le policy applicate.

<Note>
  Le policy diventano effettive immediatamente per le nuove istanze di Devin Desktop. Se Devin Desktop è già in esecuzione, potrebbe essere necessario riavviarlo.
</Note>

<div id="remove-a-configuration-profile">
  #### Rimuovere un profilo di configurazione
</div>

Per rimuovere i criteri e ripristinare le impostazioni predefinite:

1. Apri **Impostazioni di Sistema** > **Privacy e sicurezza** > **Profili**.
2. Seleziona il profilo di configurazione di Devin Desktop.
3. Seleziona il pulsante **Remove** (o **-**).
4. Autenticati con le credenziali di amministratore per confermare la rimozione.

***

<div id="linux-json-policies">
  ## Criteri JSON per Linux
</div>

Puoi configurare i criteri delle impostazioni di Devin Desktop sui dispositivi Linux inserendo un file di criteri in formato JSON in `/etc/windsurf/policies/policy.json`. Questo approccio utilizza un semplice formato JSON per definire i valori dei criteri.

<Note>
  Devin Desktop legge i criteri da `/etc/windsurf/policies/policy.json`, mentre VS Code utilizza `/etc/vscode/policy.json`. Assicurati di collocare il file nel percorso corretto per Devin Desktop.
</Note>

<div id="step-1-obtain-the-sample-policy-file">
  ### Passaggio 1: Recupera il file di policy di esempio
</div>

Ogni versione di Devin Desktop include un file `policy.json` di esempio. Puoi recuperarlo da un'installazione esistente: si trova nella directory `resources/app/policies` all'interno del percorso di installazione di Devin Desktop.

### Passaggio 2: Configura i valori della policy

1. Copia il file `policy.json` di esempio in una directory di lavoro:

```bash theme={null}
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
```

2. Modifica il file con il tuo editor di testo preferito:

```bash theme={null}
sudo nano /tmp/policy.json
```

3. Configura i valori dei criteri. Ad esempio, per consentire solo determinati editori di estensioni:

```json theme={null}
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}
```

<div id="step-3-deploy-the-policies">
  ### Passaggio 3: Distribuisci le policy
</div>

<div id="deploy-at-scale">
  #### Distribuzione su larga scala
</div>

Per distribuzioni Linux aziendali su più dispositivi, usa strumenti di gestione della configurazione come **Ansible**, **Puppet**, **Chef** o **Salt** per distribuire il file `policy.json`. Questi strumenti consentono agli amministratori di distribuire, aggiornare e rimuovere i criteri da remoto su tutti i dispositivi Linux gestiti.

#### Testa manualmente le policy su una macchina locale

1. **Crea la directory delle policy e copia il file:**

```bash theme={null}
sudo mkdir -p /etc/windsurf/policies
sudo cp /tmp/policy.json /etc/windsurf/policies/policy.json
sudo chmod 644 /etc/windsurf/policies/policy.json
sudo chown root:root /etc/windsurf/policies/policy.json
```

<Note>
  Sono necessari privilegi root o sudo per creare la directory e gestire i file delle policy in `/etc/windsurf/policies`.
</Note>

2. **Verifica l'installazione delle policy:**
   * Avvia Devin Desktop (o riavvialo se è già in esecuzione).
   * Apri **File** > **Preferences** > **Settings** (oppure premi `Ctrl+,`).
   * Cerca le impostazioni corrispondenti alle policy configurate: dovrebbero risultare gestite dalla tua organizzazione oppure mostrare un'icona di blocco.

<div id="remove-policies">
  #### Rimuovere le policy
</div>

Per rimuovere tutte le policy e ripristinare le impostazioni predefinite, elimina il file `/etc/windsurf/policies/policy.json` e riavvia Devin Desktop.

***

<div id="extension-management-policies">
  ## Criteri per la gestione delle estensioni
</div>

Uno degli usi più comuni dei criteri Enterprise è controllare quali estensioni gli utenti possono installare. Il criterio `AllowedExtensions` consente agli amministratori di definire un'allowlist dei publisher di estensioni consentiti.

<div id="allowedextensions">
  ### AllowedExtensions
</div>

La policy `AllowedExtensions` accetta una stringa JSON che specifica quali editori di estensioni sono autorizzati. Quando questa policy è attiva, gli utenti possono installare solo estensioni degli editori elencati.

**Valore di esempio:**

```json theme={null}
{"windsurf": true, "github": true, "ms-python": true}
```

Questo può essere configurato tramite uno dei meccanismi specifici della piattaforma descritti sopra:

* **Windows:** Configurare tramite i modelli ADMX dei Criteri di gruppo o direttamente nel registry in `Software\Policies\Windsurf\{ProductName}`.
* **macOS:** Configurare in un profilo di configurazione `.mobileconfig`.
* **Linux:** Configurare in `/etc/windsurf/policies/policy.json`.

Quando il criterio `AllowedExtensions` viene applicato, la vista Extensions in Devin Desktop indica che l'impostazione è gestita dalla tua organizzazione e gli utenti non possono sovrascriverla.

***

<div id="additional-resources">
  ## Risorse aggiuntive
</div>

* [Guida di Devin Desktop per gli amministratori Enterprise](/it/desktop/guide-for-admins)