> ## 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. # Devin Desktop e CLI air-gapped > Panoramica per amministratori di Devin Desktop e della CLI air-gapped: cosa fornisce Cognition, cosa devi fornire tu, come funziona l'autenticazione e quali endpoint vengono usati. > [!NOTE] > > Questa documentazione riguarda le distribuzioni di Devin per il governo federale. [Torna alla documentazione di Devin](/it/get-started/devin-intro) La build air-gapped di Devin Desktop e della Devin CLI è pensata per reti prive di accesso a Internet. L'inferenza viene eseguita sugli endpoint dei modelli che ospiti tu, l'accesso è regolato da un file di licenza firmato e convalidato localmente e ogni evento viene registrato in un registro di audit locale. Questa guida è rivolta all'amministratore che installa, configura e gestisce il prodotto. È strutturata come un runbook: ogni pagina tratta un aspetto della distribuzione e si chiude con i codici di errore che potresti incontrare e le relative soluzioni. > [!NOTE] > > **Beta.** La build air-gapped è attualmente disponibile in versione beta. Le piattaforme supportate sono macOS (Apple silicon e Intel), Linux (x86\_64 e aarch64) e Windows (x64 e arm64). *** ## Che cos'è il prodotto | Componente | Funzione | | - | - | | **Devin Desktop (build air-gapped)** | L'applicazione desktop, installata dalla pagina dei download air-gapped del portale. Integra la Devin CLI air-gapped come agente e comunica con essa in locale. Non prevede accesso al cloud, Cascade né aggiornamenti automatici. | | **Devin CLI (build air-gapped)** | L'agente da terminale. Viene eseguita in modo autonomo in una shell (`devin`) oppure come agente all'interno di Desktop. Legge il catalogo dei modelli da un file di modelli che crei tu e i diritti di licenza da un file di licenza che installi. | Desktop e la CLI integrata vengono compilati dallo stesso commit di rilascio, quindi un singolo bundle di Desktop costituisce un'installazione completa e coerente. ## Prima di iniziare ### Forniti da Cognition | Elemento | Dove viene trattato | | - | - | | Accesso al portale con un diritto di licenza on-prem attivo per il tuo team, configurato dal tuo team di gestione dell'account | [Installazione](/it/federal/air-gapped/install) | | I bundle di Desktop (e la CLI del tunnel di Desktop), disponibili nella pagina dei download air-gapped del portale con i relativi checksum SHA-256 | [Installazione](/it/federal/air-gapped/install), [Aggiornamenti](/it/federal/air-gapped/updates) | | File di licenza firmati, emessi dal portale; le chiavi pubbliche per verificarli sono incorporate nei file binari | [Licenza](/it/federal/air-gapped/license) | ### Cosa devi fornire | Elemento | Dove viene trattato | | - | - | | Un host con una piattaforma supportata, con il file di licenza installato in `/etc/devin/license.devin-onprem-license` (Windows: `C:\ProgramData\Devin\license.devin-onprem-license`) o nel percorso indicato in `DEVIN_LICENSE_FILE` | [Licenza](/it/federal/air-gapped/license) | | Uno o più endpoint di modelli compatibili con OpenAI all'interno della tua rete, descritti in un file dei modelli in `/etc/devin/models.json` (Windows: `C:\ProgramData\Devin\models.json`) o nel percorso indicato in `DEVIN_MODELS_FILE` | [File dei modelli](/it/federal/air-gapped/models-file) | | Facoltativamente, un provider di identità OIDC per richiedere l'accesso degli utenti oltre alla licenza | [SSO](/it/federal/air-gapped/sso) | | Facoltativamente, un bundle di CA private, se gli endpoint dei tuoi modelli o l'IdP usano certificati non presenti nell'archivio di attendibilità del sistema operativo | [Rete e certificati](/it/federal/air-gapped/network-and-certificates) | ## Endpoint utilizzati dal prodotto La CLI e l'app Desktop air-gapped sono configurate interamente tramite file presenti sull'host. Gli endpoint che utilizzano sono quelli che configuri tu: * **Endpoint dei modelli** elencati nel tuo file dei modelli. Non esiste un catalogo di modelli nel cloud: l'elenco dei modelli, il selettore del modello e l'instradamento dell'inferenza provengono tutti da quel file. Gli endpoint devono usare `https://`; il semplice `http://` è accettato solo per host di loopback (`localhost`, `127.0.0.0/8`, `[::1]`), ad esempio un server vLLM o Ollama in esecuzione sulla stessa macchina. * **Il tuo provider di identità**, se abiliti l'SSO. La CLI legge il documento di rilevamento OIDC dell'emittente e ne usa gli endpoint di autorizzazione, token e JWKS. * **Gli eventuali server MCP** che configuri localmente. * **Il portale** (`windsurf.fedstart.com`), a cui un amministratore accede da browser per scaricare i bundle ed emettere le licenze. Il registro di audit e il report dei dati diagnostici vengono salvati sul disco locale. `devin update` è disabilitato: le nuove versioni si installano dai bundle che scarichi dal portale (vedi [Aggiornamenti](/it/federal/air-gapped/updates)). ## Come viene controllato l'accesso 1. **Licenza** (sempre). All'avvio la CLI verifica la firma e il periodo di validità del file di licenza tramite le chiavi pubbliche incorporate nel binario. Senza una licenza valida la CLI non si avvia; consulta [Licenza](/it/federal/air-gapped/license). 2. **SSO** (facoltativo). Se crei un file di autenticazione che imposta `"mode": "sso"`, ogni utente deve anche accedere al tuo IdP con `devin auth login`. L'accesso può essere vincolato all'appartenenza a un gruppo obbligatorio, e una sessione in esecuzione viene riconvalidata in base al token memorizzato nella cache; consulta [SSO](/it/federal/air-gapped/sso). Entrambi i meccanismi sono imposti dalla CLI, quindi valgono allo stesso modo sia per l'uso autonomo da terminale sia per l'agente all'interno di Desktop. ## Prossimi passi > **[Installazione](/it/federal/air-gapped/install)** > > Scarica dal portale, verifica il download, installa ed esegui la prima verifica dello stato di salute. > **[Codici di errore](/it/federal/air-gapped/error-codes)** > > Il catalogo completo dei codici `LIC`, `IDP`, `MDL`, `NET` e `CFG`, con le azioni consigliate agli operatori. > **[Risoluzione dei problemi](/it/federal/air-gapped/troubleshooting)** > > Il runbook di `devin airgap doctor` e le informazioni da inviare al supporto. > **[Formati su disco](/it/federal/air-gapped/on-disk-formats)** > > Percorsi di configurazione per ciascun sistema operativo e schema JSONL dei log di audit per l'ingestione nel SIEM. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.