Vai al contenuto principale
Questa documentazione si riferisce alle distribuzioni federali di Devin. Torna alla documentazione di Devin
Questa guida descrive come configurare, utilizzare e dismettere in modo sicuro gli account amministrativi di massimo livello in Devin Desktop. Include le definizioni dei ruoli amministrativi, le procedure relative al ciclo di vita degli account e tutte le impostazioni di sicurezza controllate dagli amministratori, con le relative funzioni, implicazioni per la sicurezza e valori consigliati.

​
Definizioni dei ruoli amministrativi

Devin Desktop utilizza un sistema di controllo degli accessi basato sui ruoli (RBAC) per regolare i privilegi amministrativi. I ruoli vengono gestiti tramite l’Admin Portal, nella sezione Role Management di Settings, e possono essere assegnati a singoli utenti.

​
Ruoli predefiniti

Devin Desktop offre due ruoli predefiniti che non possono essere eliminati.
RuoloDescrizioneAutorizzazioni predefinite
AdminAccesso amministrativo completo a Settings dell’organizzazione, gestione degli utenti, analisi e controlli di sicurezza. È il livello di privilegio più elevato che un utente possa avere all’interno di un team.Tutte le autorizzazioni abilitate
UserAccesso standard per l’utente finale, senza autorizzazioni amministrative. Gli utenti possono accedere alle funzionalità di programmazione di Devin Desktop, ma non possono visualizzare o modificare Settings dell’organizzazione.Nessuna autorizzazione amministrativa

​
Ruoli personalizzati

Gli amministratori possono creare ruoli personalizzati per applicare il principio del privilegio minimo. I ruoli personalizzati sono composti da autorizzazioni granulari selezionate dalle categorie riportate di seguito. Per creare un ruolo personalizzato, accedi all’Admin Portal e apri la sezione Role Management in Settings.

​
Riferimento delle autorizzazioni

La tabella seguente elenca tutte le autorizzazioni disponibili per l’assegnazione dei ruoli nella distribuzione FedRAMP. Ogni autorizzazione controlla l’accesso a una specifica funzione amministrativa.
CategoryPermissionDescription
TeamsTeams Read-OnlyAccesso in sola lettura alla pagina di gestione dei team
TeamsTeams UpdatePossibilità di aggiornare i ruoli utente nella pagina dei team
TeamsTeams DeletePossibilità di rimuovere utenti dalla pagina dei team
AnalyticsAnalytics ReadAccesso in lettura alla pagina di analisi e ai dashboards
AttributionAttribution ReadAccesso in lettura alla pagina Attribution
LicenseLicense ReadAccesso in lettura alla pagina della licenza
SSOSSO ReadAccesso in lettura alla pagina di configurazione SSO
SSOSSO WritePossibilità di configurare e modificare le impostazioni del provider SSO
Service KeyService Key ReadAccesso in lettura alla pagina delle chiavi di servizio
Service KeyService Key CreatePossibilità di creare nuove chiavi di servizio per l’accesso API
Service KeyService Key UpdatePossibilità di modificare le chiavi di servizio esistenti
Service KeyService Key DeletePossibilità di revocare ed eliminare le chiavi di servizio
Role ManagementRole ReadAccesso in lettura alla scheda dei ruoli in Settings
Role ManagementRole CreatePossibilità di creare nuovi ruoli
Role ManagementRole UpdatePossibilità di modificare le definizioni dei ruoli esistenti
Role ManagementRole DeletePossibilità di eliminare i ruoli
External ChatExternal Chat ManagementPossibilità di modificare le configurazioni dei modelli di chat esterna
IndexingIndexing ReadAccesso in lettura alla pagina di configurazione dell’indicizzazione
IndexingIndexing CreatePossibilità di creare nuovi indici
IndexingIndexing UpdatePossibilità di aggiornare le repo indicizzate esistenti
IndexingIndexing DeletePossibilità di eliminare gli indici
IndexingIndexing ManagementPossibilità di eseguire operazioni di gestione e pulizia del database degli indici
Fine-TuningFine-Tuning ReadAccesso in lettura alla pagina di fine-tuning
Fine-TuningFine-Tuning CreatePossibilità di creare job di fine-tuning
Fine-TuningFine-Tuning UpdatePossibilità di aggiornare job di fine-tuning
Fine-TuningFine-Tuning DeletePossibilità di eliminare job di fine-tuning
Alcune di queste autorizzazioni (come Attribution, License, SSO, Indexing e Fine-Tuning) esistono nel sistema RBAC, ma le corrispondenti pagine del portale non sono disponibili nella distribuzione FedRAMP multi-tenant. Queste autorizzazioni sono incluse nella UI di gestione dei ruoli per completezza, ma non concedono l’accesso ad alcuna funzionalità attiva in questo ambiente.

​
Procedure per il ciclo di vita dell’account amministrativo

Questa sezione descrive il ciclo di vita completo di un account amministrativo di livello superiore, dalla creazione iniziale fino alla dismissione.

​
Configurazione dell’account

L’onboarding tramite SSO è il principale metodo di provisioning nella distribuzione FedRAMP. La piattaforma supporta sia OIDC sia SAML 2.0 per l’integrazione SSO (Single Sign-On). Gli utenti si autenticano tramite il provider di identità configurato e, una volta che il primo accesso ha creato il loro account, un amministratore assegna il ruolo appropriato tramite l’Admin Portal. Si noti che l’integrazione SSO nell’ambiente FedRAMP richiede il coordinamento con il team FedRAMP di Devin Desktop e non può essere configurata in modalità Self-serve. Ogni nuovo account amministratore deve essere configurato secondo il principio del privilegio minimo. È preferibile usare ruoli personalizzati con solo le autorizzazioni necessarie per le responsabilità dell’amministratore, anziché assegnare il ruolo Admin completo, a meno che l’utente non richieda l’accesso completo al sistema.

​
Requisiti di autenticazione e MFA

La distribuzione FedRAMP utilizza esclusivamente l’SSO, con supporto per i protocolli OIDC e SAML 2.0. L’autenticazione con email e password non è disponibile. Tutti gli utenti devono autenticarsi tramite il provider di identità configurato. L’autenticazione a più fattori (MFA) è applicata tramite il provider di identità dell’organizzazione. Devin Desktop eredita i criteri MFA configurati nell’IdP connesso, il che significa che tutti i requisiti relativi al livello di sicurezza dell’autenticazione, come l’obbligo di un secondo fattore, di autenticatori resistenti al phishing o di criteri di accesso condizionale, sono gestiti a livello di IdP. Le organizzazioni dovrebbero configurare il proprio IdP in modo da richiedere l’MFA per tutti gli utenti che accedono all’applicazione Devin Desktop, in particolare per gli account con ruoli amministrativi.
Devin Desktop raccomanda vivamente di richiedere l’MFA per tutti gli account amministrativi. Configura il tuo provider di identità in modo da imporre l’MFA come condizione di accesso all’applicazione Devin Desktop.

​
Configurazione dell’account

Dopo la creazione di un account amministrativo, è necessario completare i seguenti passaggi di configurazione. L’assegnazione dei ruoli determina l’ambito dell’accesso amministrativo dell’account. Assegna i ruoli tramite l’Admin Portal accedendo alla scheda Manage Team, individuando l’utente, facendo clic su Edit e selezionando il ruolo appropriato dal menu a discesa. Le modifiche hanno effetto immediato. La gestione delle chiavi di servizio è necessaria quando l’amministratore ha bisogno di accesso all’API per l’automazione o l’analisi. Le chiavi di servizio vengono create in Settings con autorizzazioni limitate all’ambito d’uso previsto per la chiave. Ogni chiave di servizio deve avere un nome descrittivo (ad esempio, “Analytics Dashboard”) ed essere assegnata a un ruolo con le autorizzazioni minime necessarie.

​
Operatività dell’account

Le pratiche operative continuative per gli account amministrativi includono quanto segue. Revisioni periodiche degli accessi dovrebbero essere condotte per verificare che gli account amministrativi necessitino ancora dell’attuale livello di accesso. Esaminare periodicamente l’elenco degli utenti con il ruolo Admin tramite la scheda Manage Team e adeguare i ruoli man mano che cambiano le responsabilità. Il monitoraggio delle attività è disponibile tramite i dashboard di analisi integrati. Gli amministratori con autorizzazione Analytics Read possono monitorare l’attività degli utenti, le metriche di coinvolgimento e l’utilizzo delle funzionalità. L’API di analisi fornisce accesso programmatico a questi dati per l’integrazione con sistemi di monitoraggio esterni. La rotazione della chiave di servizio dovrebbe essere eseguita secondo una pianificazione regolare. Per effettuare la rotazione di una chiave, creare una nuova chiave di servizio con le stesse autorizzazioni, aggiornare il sistema che la utilizza affinché usi la nuova chiave, quindi eliminare la vecchia chiave.

​
Disattivazione dell’account

Quando un amministratore non necessita più dell’accesso, l’account deve essere disattivato tempestivamente seguendo la procedura riportata di seguito.
1

Revocare il ruolo amministrativo

Vai all’Admin Portal, apri la scheda Manage Team, individua l’utente, fai clic su Edit e modifica il suo ruolo da Admin a User (o a un ruolo personalizzato senza autorizzazioni amministrative).
2

Revocare le chiavi di servizio

Elimina tutte le chiavi di servizio create da o utilizzate esclusivamente dall’amministratore uscente. Vai in Settings, quindi in Service Key, ed elimina le chiavi pertinenti.
3

Rimuovere o disattivare l'account

Rimuovi l’utente dalla scheda Manage Team facendo clic su Delete accanto al suo nome. Questa operazione disattiverà l’account Devin Desktop dell’utente e libererà la licenza assegnata.
4

Verificare l'accesso residuo

Verifica che l’account disattivato non compaia più in alcun ruolo amministrativo controllando l’elenco utenti di Manage Team filtrato per il ruolo Admin. Conferma che tutte le chiavi di servizio associate all’account siano state eliminate.
Disattiva immediatamente gli account amministrativi quando un amministratore cambia ruolo o lascia l’organizzazione. Ritardare la disattivazione espone inutilmente a rischi per la sicurezza.

​
Riferimento delle impostazioni di sicurezza

La tabella seguente documenta tutte le impostazioni di sicurezza controllate dagli amministratori disponibili nell’Admin Portal della distribuzione FedRAMP. Ogni voce descrive la funzione dell’impostazione, il relativo impatto sulla sicurezza e la configurazione consigliata per una distribuzione orientata alla sicurezza.
ImpostazioneFunzioneImpatto sulla sicurezzaValore consigliato
Controllo degli accessi basato sui ruoli (RBAC)Controlla quali azioni amministrative ogni utente può eseguire in base al ruolo e alle autorizzazioni assegnati. Gestito nella sezione Role Management in Settings.Limita l’impatto di account compromessi restringendo le autorizzazioni a quelle strettamente necessarie per ciascun utente. Assegnazioni di ruolo eccessivamente ampie aumentano il potenziale impatto della compromissione di un singolo account.Configurare secondo il principio del privilegio minimo. Creare ruoli personalizzati con solo le autorizzazioni necessarie per ciascun amministratore. Riservare il ruolo Admin integrato a un numero ristretto di amministratori.
Autorizzazioni della chiave di servizioLimita gli access token API a insiemi specifici di autorizzazioni, controllando quali operazioni i sistemi automatizzati possono eseguire. Gestito nella sezione Service Key in Settings.Le chiavi di servizio con autorizzazioni eccessive possono essere sfruttate se esposte, concedendo accesso non autorizzato alla gestione degli utenti, ad analytics o ad altre funzioni.Limitare all’insieme minimo di autorizzazioni necessarie. Creare chiavi di servizio dedicate per ogni integrazione con solo le autorizzazioni richieste da tale integrazione. Ruotare le chiavi regolarmente.
Configurazione del provider SSOConfigura il provider di identità utilizzato per tutta l’autenticazione degli utenti, con supporto per i protocolli OIDC e SAML 2.0. L’autenticazione tramite email/password non è disponibile. La configurazione di SSO richiede il coordinamento con il team FedRAMP di Devin Desktop. Gestito nella sezione SSO in Settings.Centralizza l’autenticazione tramite l’IdP dell’organizzazione, consentendo di applicare MFA, accesso condizionale e policy di sessione. Una configurazione errata potrebbe impedire l’accesso a tutti gli utenti o consentire accessi non autorizzati.Configurare con il provider di identità approvato dall’organizzazione (OIDC o SAML 2.0). Verificare la configurazione testando l’accesso con un account non amministratore prima di estenderla su larga scala.
Ultimo aggiornamento: 28 gennaio 2026