Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Policy Enterprise per la gestione delle estensioni

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

​
Criteri di gruppo di Windows

Devin Desktop supporta i Criteri di gruppo di Windows basati sul Registro di sistema. I criteri possono essere distribuiti tramite soluzioni di Mobile Device Management (MDM) o configurati manualmente sui singoli dispositivi.
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}.

​
Passaggio 1: ottenere i file ADMX e ADML

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.

​
Passaggio 2: Installa i file di definizione dei criteri

  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).
Per copiare i file nella directory PolicyDefinitions sono necessari privilegi di amministratore.
Per gli ambienti Active Directory, copia i file ADMX e ADML nell’Archivio centrale 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.

​
Distribuzione su larga scala

Prodotti come 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
Le policy a livello di computer hanno la precedenza su quelle a livello di utente quando entrambe sono configurate.
  1. 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.
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).
La policy entrerà in vigore al successivo avvio di Devin Desktop.

​
Profili di configurazione per macOS

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.

​
Passaggio 1: Recuperare il profilo di configurazione di esempio

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 Windsurf.app e seleziona Mostra contenuto pacchetto.
  3. Vai a Contents/Resources/app/policies.
  4. Individua il file .mobileconfig di esempio.

​
Passaggio 2: Configura i valori delle policy

  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: 
<!-- Esempio: consenti estensioni da publisher specifici -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
Policy booleane — policy che accettano valori vero/falso: 
<!-- 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.
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).

​
Passaggio 3: Distribuzione dei criteri

​
Distribuzione su larga scala

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.

​
Testare manualmente le policy su una macchina locale

  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.
Le policy diventano effettive immediatamente per le nuove istanze di Devin Desktop. Se Devin Desktop è già in esecuzione, potrebbe essere necessario riavviarlo.

​
Rimuovere un profilo di configurazione

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.

​
Criteri JSON per Linux

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

​
Passaggio 1: Recupera il file di policy di esempio

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:
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
  1. Modifica il file con il tuo editor di testo preferito:
sudo nano /tmp/policy.json
  1. Configura i valori dei criteri. Ad esempio, per consentire solo determinati editori di estensioni:
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}

​
Passaggio 3: Distribuisci le policy

​
Distribuzione su larga scala

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:
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
Sono necessari privilegi root o sudo per creare la directory e gestire i file delle policy in /etc/windsurf/policies.
  1. 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.

​
Rimuovere le policy

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

​
Criteri per la gestione delle estensioni

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.

​
AllowedExtensions

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: 
{"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.

​
Risorse aggiuntive