Configurazione di sistema

Panoramica

system.json è un file di policy facoltativo a livello di macchina che gli amministratori distribuiscono ai dispositivi gestiti, in genere tramite MDM. Risiede in una directory di sistema in cui può scrivere solo un amministratore; pertanto, a differenza della configurazione utente in ~/.config/devin/config.json, le impostazioni che contiene non possono essere modificate o rimosse dall’utente. Usalo per:

Bloccare l’autenticazione sull’host e/o sull’account Devin della tua Enterprise, in modo che devin auth login salti il menu del metodo di accesso e rifiuti qualsiasi account esterno alla tua organizzazione.
Forzare un proxy HTTP in uscita per la CLI e il relativo aggiornamento. L’impostazione Enterprise ha la precedenza sulla configurazione utente e, se un utente ha anche una sezione proxy nella propria configurazione, gli viene chiesto di rimuoverla prima dell’avvio della CLI. Prima di distribuirne uno, consulta proxy.

Il file è facoltativo e additivo: se non è presente, Devin CLI si comporta esattamente come su un dispositivo non gestito.

Percorso del file

Piattaforma	Percorso
macOS	`/Library/Application Support/Devin/system.json`
Linux	`/etc/devin/system.json`
Windows	`C:\ProgramData\Devin\system.json`

Si tratta delle stesse directory a livello di macchina, scrivibili dagli amministratori, che Devin Desktop usa per le regole e gli hook a livello di sistema. Distribuisci il file assegnandone la proprietà a root/Administrator e autorizzazioni di sola lettura per gli utenti normali: la CLI lo legge ovunque lo trovi, quindi una posizione scrivibile dagli utenti vanifica lo scopo della policy.

Esempio

// /Library/Application Support/Devin/system.json
{
  "enterprise_host": "acme.devinenterprise.com",
  "account_id": "acct-acme",
  "proxy": {
    "mode": "manual",
    "url": "http://proxy.corp.example.com:8080",
    "no_proxy": "localhost,127.0.0.1,.internal.corp"
  }
}

system.json viene analizzato come JSON rigoroso: qui i commenti e le virgole finali non sono supportati, a differenza del file config.json dell’utente, che è JSON con commenti. Il commento precedente è riportato solo per indicare il percorso del file.

Riferimento delle opzioni

Opzione	Tipo	Predefinito	Descrizione
`enterprise_host`	stringa	non impostato	Host di Devin Enterprise con cui gli utenti devono autenticarsi, ad es. `"acme.devinenterprise.com"`. Accetta un host senza schema o un URL completo
`account_id`	stringa	non impostato	Identificatore dell’account Devin a cui deve appartenere l’account autenticato
`proxy`	oggetto	non impostato	Impostazioni del proxy HTTP in uscita per la CLI e il programma di aggiornamento (`mode`, `url`, `no_proxy`)

Ogni campo è indipendente: imposta solo quelli necessari. I campi sconosciuti vengono ignorati, quindi una policy scritta per una CLI più recente applica comunque le impostazioni note su una versione precedente.

enterprise_host

Se impostato, devin auth login:

Salta il menu del metodo di accesso e la richiesta del sottodominio, eseguendo l’autenticazione direttamente sull’host configurato.
Rifiuta qualsiasi accesso il cui account risultante appartenga a un host diverso (o non appartenga ad alcun Devin Enterprise), mostrando un messaggio che indirizza l’utente all’host corretto.
Rifiuta completamente il percorso legacy di accesso a Windsurf.

Il valore viene confrontato senza distinzione tra maiuscole e minuscole e ignorando lo schema, pertanto acme.devinenterprise.com, ACME.DevinEnterprise.com e https://acme.devinenterprise.com/ sono equivalenti. Uno schema http:// esplicito viene mantenuto durante l’accesso (utile solo per il testing); altrimenti si presume https://.

account_id

Se impostato, l’account autenticato deve corrispondere a questo identificatore account, anche se l’host corrisponde già: usalo per bloccare un tenant specifico su un host condiviso. Un accesso che corrisponde a un altro account, o a nessun account, viene rifiutato dopo la verifica dell’account. Contatta il team account di Cognition se non sei sicuro dell’identificatore account da usare. L’impostazione di account_id rifiuta anche il percorso di accesso legacy di Windsurf, poiché un account Windsurf non può soddisfare una policy di account Devin.

proxy

Configura il modo in cui la CLI instrada il proprio traffico HTTP/HTTPS in uscita (chiamate API, aggiornamenti, server MCP). Utilizza la stessa struttura della sezione proxy del file di configurazione utente:

Opzione	Tipo	Predefinito	Descrizione
`mode`	stringa	`"system"`	`"system"` (rispetta `HTTP_PROXY`/`HTTPS_PROXY`/`ALL_PROXY` e il PAC della piattaforma), `"manual"` (instrada tramite `url`) o `"off"` (connessione diretta)
`url`	stringa/null	`null`	URL del proxy. Obbligatorio quando `mode` è `"manual"`. Supporta `http://`, `https://` e `socks5://`
`no_proxy`	stringa/null	`null`	Elenco di esclusioni separato da virgole, con la stessa sintassi della variabile d’ambiente `NO_PROXY`. Si applica in qualsiasi modalità

Il binario devin-updater legge la stessa impostazione, quindi gli aggiornamenti in background usano lo stesso proxy della CLI.

Il proxy Enterprise ha la precedenza sulla configurazione utente ed è un errore configurarlo in entrambi i file. Se un utente ha anche una sezione proxy nel proprio config.json, la CLI termina all’avvio e chiede di rimuoverla, anziché ignorare silenziosamente l’impostazione. Invita gli utenti a rimuovere qualsiasi sezione proxy locale prima di distribuire la policy.

Comportamento e modalità di errore

Un file di policy danneggiato o compreso solo in parte non disabilita mai la CLI: non comporta alcuna applicazione, mentre una policy valida viene sempre applicata:

Situazione	Risultato
File assente	Nessuna applicazione; la CLI si comporta come su un dispositivo non gestito
File illeggibile o JSON non valido	Viene trattato come assente, con un avviso nei log
Campi sconosciuti presenti	Vengono ignorati; i campi riconosciuti continuano a essere applicati
Sezione `proxy` non valida	La sezione `proxy` viene ignorata; continua l’applicazione di `enterprise_host` / `account_id`
`enterprise_host` / `account_id` non validi	L’applicazione delle restrizioni di accesso non viene eseguita; una sezione `proxy` valida continua a essere applicata
Valore vuoto o composto solo da spazi	Viene trattato come non impostato

L’applicazione delle restrizioni di accesso avviene durante devin auth login. Le credenziali già archiviate su un dispositivo su cui è stato effettuato l’accesso prima della distribuzione della policy non vengono nuovamente convalidate. Pertanto, distribuisci system.json prima di distribuire la CLI oppure chiedi agli utenti interessati di eseguire devin auth logout e di accedere nuovamente. Il percorso di system.json non può essere reindirizzato tramite una variabile d’ambiente nelle build stable, next o Enterprise, quindi gli utenti non possono indirizzare la CLI a una policy di propria scelta.

Verifica della policy

Su un dispositivo gestito:

devin auth logout
devin auth login

Con enterprise_host impostato, il menu dei metodi di accesso non dovrebbe essere visualizzato e l’URL di accesso generato dovrebbe puntare all’host configurato. Verifica quindi la sessione risultante:

devin auth status

Un tentativo di accesso con un account non conforme alla policy non va a buon fine e visualizza un messaggio esplicito che indica l’host o l’account richiesto dalla tua organizzazione. system.json definisce le policy a livello di dispositivo che devono essere configurate prima o durante l’accesso. La maggior parte degli altri controlli a livello di organizzazione — modelli, server MCP e registri, autorizzazioni del Terminale, applicazione della sandbox, ricerca sul web — viene gestita lato server in Team Settings e si applica automaticamente quando un utente effettua l’accesso.

Per approfondire

Devin Auth
Team Settings
File di configurazione
Controls
Devin Desktop Enterprise Policies — l’equivalente per l’Editor delle policy distribuite tramite MDM

Per iniziare

Integrazioni dell'Editor

Estensibilità

Enterprise

Riferimento

Changelog

Configurazione di sistema

Panoramica

Percorso del file

Esempio

Riferimento delle opzioni

enterprise_host

account_id

proxy

Comportamento e modalità di errore

Verifica della policy

Per approfondire

​Panoramica

​Percorso del file

​Esempio

​Riferimento delle opzioni

​enterprise_host

​account_id

​proxy

​Comportamento e modalità di errore

​Verifica della policy

​Impostazioni correlate

​Per approfondire

Panoramica

Percorso del file

Esempio

Riferimento delle opzioni

enterprise_host

account_id

proxy

Comportamento e modalità di errore

Verifica della policy

Impostazioni correlate

Per approfondire