Guida a Devin Desktop per gli amministratori Enterprise
Scopo Questa guida aiuta gli amministratori Enterprise platform / developer-experience a pianificare, distribuire e gestire Devin Desktop per organizzazioni con team Enterprise di grandi dimensioni. È volutamente prescrittiva e rimanda a guide dettagliate “how-to” per ciascun argomento. Considerala sia come una guida da leggere per intero sia come una checklist durante l’onboarding.
- Pubblico e prerequisiti
- Checklist di avvio rapido
- Conferma le impostazioni a livello di organizzazione
- Configura SSO (Okta, Microsoft Entra ID, Google; consulta la documentazione SAML per le altre opzioni)
- Abilita SCIM e mappa i gruppi IdP → team di Devin Desktop
- Definisci il modello di ruolo e autorizzazione (privilegio minimo)
- Configura Admin Portal: visualizzazione dei team e controlli di sicurezza
- Distribuisci client/estensioni di Devin Desktop agli utenti finali
- Visualizza dashboard di analytics e token di accesso API
Usa questo elenco come checklist di monitoraggio della distribuzione per il “Giorno 0”.
- Concetti chiave di Devin Desktop
- Team – raccolte piatte di membri; non esistono team nidificati. I Team (chiamati anche Groups) determinano l’assegnazione dei ruoli e il raggruppamento analytics, consentendoti di definire l’ambito delle autorizzazioni e visualizzare le metriche di utilizzo per ciascun gruppo.
- Ruoli e autorizzazioni – RBAC predefinito; gli admin sono responsabili principalmente della gestione dei team, delle impostazioni delle funzionalità di Devin Desktop e delle analytics. I ruoli integrati in genere coprono queste esigenze, ma creare un ruolo personalizzato con l’autorizzazione analytics-view consente ai manager e ai responsabili dei team di visualizzare le metriche dei propri team. (documentazione RBAC)
- Admin Portal – UI centralizzata per la gestione di utenti e team, l’utilizzo dei crediti, la configurazione SSO, l’attivazione/disattivazione funzionalità (Web Search, MCP, Deploys), dashboard analytics/esportazione dei report, chiavi di servizio per l’utilizzo dell’API e controlli di ruoli/autorizzazioni.
- Agenti e workspace – l’IDE di Devin Desktop e i plugin JetBrains sono agentici
3.1 Panoramica di Admin Portal
L’Admin Portal consente la gestione centralizzata di tutte le funzionalità Enterprise di Devin Desktop tramite un’interfaccia web intuitiva. Le funzionalità principali includono:Gestione utenti e team
- Aggiungi, rimuovi e gestisci gli utenti della tua organizzazione
- Configura i team con la corretta assegnazione dei ruoli
- Monitoraggio dello stato e dell’attività degli utenti
Autenticazione e sicurezza
- Configura l’integrazione SSO con i principali provider di identità
- Imposta il provisioning SCIM per la gestione automatizzata del ciclo di vita degli utenti
- Gestisci il controllo degli accessi basato sui ruoli (RBAC)
- Crea e gestisci chiavi di servizio per le automazioni API con autorizzazioni di ambito specifico
Attivazione/disattivazione funzionalità e controlli
Importante: Questi controlli delle funzionalità influiscono sul comportamento dell’intera organizzazione e possono essere modificati solo dagli amministratori. Le nuove funzionalità principali con implicazioni sulla privacy dei dati vengono rilasciate disattivate per impostazione predefinita, così che sia tu a decidere quando e come abilitarle.Le impostazioni del team ti consentono di abilitare, disabilitare o limitare le funzionalità di Devin Desktop per ogni membro: modelli disponibili e modello predefinito, esecuzione automatica nel terminale e autorizzazioni dei comandi, sandboxing, server MCP e registry, ricerca sul web, estensioni e marketplace delle estensioni, condivisione delle conversazioni, Devin e altro ancora. Puoi gestirle nell’app Devin in Settings → Enterprise → Devin Desktop, oppure nella dashboard legacy di Windsurf all’indirizzo windsurf.com/team/settings. Consulta il riferimento ai controlli amministrativi di Devin Desktop per l’elenco completo delle impostazioni del team, con la funzione di ciascuna e i piani che la includono, oltre alle policy MDM per i dispositivi e ai file a livello di sistema che puoi distribuire insieme a esse. Lì sono indicate anche le impostazioni che memorizzano dati aggiuntivi o telemetria. L’Admin Portal gestisce anche queste integrazioni: Revisione delle PR (integrazione GitHub)
- Installa Devin Desktop nell’organizzazione GitHub del tuo team
- Abilita l’automazione della revisione delle PR e la modifica delle descrizioni
- Scopri di più sulla revisione PR di Windsurf
- Ti consigliamo Devin Review, la nostra nuova e migliorata esperienza di revisione del codice. Scopri di più.
- Seleziona e organizza le conoscenze provenienti da sorgenti Google Drive per i tuoi team di sviluppo
- Carica e organizza documentazione e risorse interne
- Scopri di più sulla knowledge base
- Gestione delle identità e degli accessi
Raccomandazione: Utilizza SSO con SCIM ove possibile per il provisioning e il deprovisioning automatici, nonché per la gestione dei gruppi.
4.1 Single Sign-On (SSO)
Consulta la Guida alla configurazione di SSO e SCIM per istruzioni dettagliate sulla configurazione di Okta, Microsoft Entra ID, Google e SAML generico.
4.2 Provisioning SCIM
- Perché – gestione automatizzata del ciclo di vita degli utenti e dell’appartenenza ai team su larga scala
- Funzionalità
- Crea / disattiva automaticamente gli utenti
- Crea automaticamente i team (oppure gestiscili manualmente)
- Gli utenti possono appartenere a più team
- Creazione di team personalizzati tramite API SCIM (documentazione)
- Strategie di mappatura
- 1 gruppo IdP → 1 team Devin Desktop (semplice, il caso più comune)
- Prefissi dei gruppi funzionali o basati sul progetto (ad es.
proj-foo-devs)
- Aspetti da decidere
- Quali gruppi escludere (ad es. stagisti, collaboratori esterni)
- Regole di ridenominazione quando cambiano i nomi dei gruppi IdP
- Attenzione: SCIM deve rimanere la tua fonte di riferimento — combinare SCIM con aggiornamenti manuali / API può causare disallineamenti. Usa l’API principalmente per aggiungere gruppi supplementari.
- Gestione di utenti e team su larga scala
- Team piatto → progettare attentamente la tassonomia del team (senza nidificazione su cui fare affidamento)
- Gli utenti possono appartenere a più gruppi. I gruppi vengono usati per consultare le analytics
- Al momento, SCIM non supporta l’assegnazione di ruoli agli utenti. SCIM supporta solo l’assegnazione di utenti ai gruppi
- Analytics e accesso alle API
6.1 Analytics integrate
Analytics mostra la percentuale di codice scritto da Devin Desktop, aiutando a quantificarne l’impatto: consulta le tue dashboard in analytics del team.
6.2 API
- Genera le chiavi di servizio in Team Settings → Service Keys. Assegna alle chiavi solo i privilegi minimi necessari.
- Per report più avanzati, consulta il riferimento dell’API Analytics.
- Per la gestione dei team, consulta l’API SCIM – Team personalizzati.
- Considerazioni operative
- Pagine di stato – monitora lo stato del servizio in tempo reale: Devin Desktop, Anthropic, OpenAI
- Canali di supporto – windsurf.com/support
- Mettere gli utenti finali nelle condizioni di avere successo
- Rimanda gli utenti finali alla guida all’installazione di Devin Desktop per installare l’estensione appropriata o il client desktop.
- Pubblica una pagina interna “Guida introduttiva a Devin Desktop” (collegamento alla documentazione ufficiale)
- Organizza sessioni di onboarding dal vivo / registra brevi demo
- Prepara template di progetto iniziali e prompt di esempio
- Raccogli feedback tramite un sondaggio dopo 2 settimane; apporta miglioramenti