Vai al contenuto principale

Panoramica

I ruoli personalizzati e l’RBAC ti consentono di definire con precisione l’accesso all’applicazione Devin. Gli amministratori di Devin Enterprise possono creare ruoli personalizzati con autorizzazioni specifiche e assegnarli a utenti o gruppi IdP, garantendo un controllo granulare sulle azioni che gli utenti possono eseguire all’interno del deployment di Devin Enterprise. Devin Enterprise implementa un sistema di ruoli a due livelli con ambiti e funzionalità distinti: ruoli a livello di organizzazione e ruoli a livello di account.

Ruoli a livello di organizzazione

I ruoli a livello di organizzazione vengono assegnati per singola organizzazione e non si applicano al di fuori dell’organizzazione a cui sono assegnati. Questi ruoli controllano l’accesso alle risorse e alle azioni all’interno di una specifica organizzazione. I ruoli a livello di organizzazione possono essere configurati con le seguenti autorizzazioni:
AutorizzazioneDescrizione
Use DeepWikiAccesso alla funzionalità DeepWiki
Use Ask DevinAccesso alla funzionalità Ask Devin
Use Devin SessionsAccesso alla creazione e all’utilizzo delle sessioni Devin
Manage MembershipAggiungere/rimuovere utenti e gruppi. Assegnare o revocare ruoli di autorizzazione
Manage SettingsGestire le impostazioni a livello di organizzazione
Manage PlaybooksCreare/modificare/eliminare i playbook dell’organizzazione
Manage SecretsCreare/modificare/eliminare i segreti dell’organizzazione
Manage KnowledgeCreare/modificare/eliminare le conoscenze dell’organizzazione
Manage SnapshotsCreare/modificare/eliminare snapshot delle macchine
Index RepositoriesIndicizzare i repository per la generazione di AskDevin e DeepWiki
Manage SessionsModificare le sessioni Devin di altri utenti nell’organizzazione
View SessionsVisualizzare le sessioni Devin di altri utenti nell’organizzazione
Manage API KeysCreare/eliminare/utilizzare le chiavi API
Manage MCP ServersCreare/modificare/eliminare server MCP
View MetricsVisualizzare le metriche dell’organizzazione
View ConsumptionVisualizzare il consumo dell’organizzazione
Gli utenti possono creare i propri ruoli personalizzati con un set specifico di autorizzazioni oppure utilizzare uno dei tre ruoli di organizzazione predefiniti:
  • Admin: Accesso amministrativo completo all’interno dell’organizzazione
  • Member: Accesso utente standard con funzionalità principali
  • DeepWiki Only: Accesso limitato a DeepWiki e alla funzionalità AskDevin, incluse le autorizzazioni di indicizzazione dei repository

Ruoli a livello di account (ruoli enterprise)

I ruoli a livello di account (noti anche come ruoli a livello enterprise) vengono assegnati all’intera enterprise e si applicano a ogni organizzazione al suo interno. Gli utenti con ruoli a livello di account ereditano automaticamente le corrispondenti autorizzazioni a livello di organizzazione in tutte le organizzazioni di cui sono membri. I ruoli a livello di account possono essere configurati con le seguenti autorizzazioni:
PermissionDescription
Manage OrganizationsVisualizzare/creare/modificare/eliminare le organizzazioni dell’enterprise
Manage Account MembershipVisualizzare/creare/modificare/eliminare i membri dell’enterprise e delle organizzazioni
Manage Enterprise SettingsVisualizzare/modificare le impostazioni a livello di enterprise e di organizzazione
Manage Git IntegrationsCreare/modificare/eliminare integrazioni Git (GitHub, GitLab, ADO, Bitbucket). Gestire le autorizzazioni dei repository e l’indicizzazione dei repository
Manage Chat IntegrationsCreare/modificare/eliminare integrazioni di chat come Microsoft Teams o Slack
Manage Ticket IntegrationsCreare/modificare/eliminare integrazioni di ticketing come Jira o Linear
Use Account ToolsUtilizzare le sessioni Devin, Ask Devin e DeepWiki in qualsiasi organizzazione
Manage Account ResourcesCreare/modificare/eliminare playbook, secret e knowledge in qualsiasi organizzazione
Manage Account SnapshotsCreare/modificare/eliminare snapshot di macchine in qualsiasi organizzazione. Gestire snapshot a livello di account e indicizzare repository
Index Account RepositoriesIndicizzare repository per AskDevin e la generazione di DeepWiki in tutta l’enterprise
Manage SessionsModificare le sessioni Devin di altri utenti in qualsiasi organizzazione
View SessionsVisualizzare le sessioni Devin di altri utenti in qualsiasi organizzazione
View Enterprise Infra DetailsVisualizzare i dettagli dell’infrastruttura enterprise
Manage Account API KeysCreare/modificare/eliminare/utilizzare chiavi API nell’enterprise e in qualsiasi organizzazione
Manage Account MCP ServersCreare/modificare/eliminare server MCP in qualsiasi organizzazione
View Account MetricsVisualizzare le metriche dell’enterprise
Manage BillingVisualizzare/modificare l’utilizzo per l’enterprise
Gli utenti possono creare i propri ruoli personalizzati con un set specifico di autorizzazioni oppure possono usare uno dei nostri due ruoli di account predefiniti:
  • Admin: Accesso amministrativo completo in tutta l’enterprise
  • Member: Accesso utente standard in tutte le organizzazioni dell’enterprise

Integrazione dei gruppi IdP

Gli amministratori possono assegnare ruoli personalizzati ai gruppi dell’Identity Provider (IdP). Quando assegni un ruolo a un gruppo IdP, ogni membro di quel gruppo (come definito dal tuo Identity Provider) riceverà automaticamente quel ruolo.
  1. Flusso di informazioni sui gruppi: durante l’autenticazione, Devin Enterprise riceve le informazioni sui gruppi dal tuo IdP.
  2. Assegnazione automatica dei ruoli: gli utenti ereditano le autorizzazioni in base all’appartenenza al loro gruppo IdP.
  3. Aggiornamenti dinamici: le modifiche all’appartenenza ai gruppi vengono applicate al momento della nuova autenticazione dell’utente.
I gruppi IdP sono supportati per le connessioni SSO enterprise. Contatta il tuo amministratore se hai bisogno di assistenza per la configurazione dei gruppi.

Creazione e assegnazione di ruoli personalizzati

Solo gli admin Enterprise o gli utenti con il permesso Manage Account Membership possono configurare ruoli personalizzati. Accedi alle impostazioni dell’enterprise e seleziona la scheda “Roles” per gestire sia i ruoli a livello di organizzazione sia quelli a livello di account. Per creare un ruolo personalizzato:
  1. Vai a Enterprise Settings > Roles
  2. Clicca su “Create a custom role” per il livello Organization o Enterprise
  3. Fornisci un nome di ruolo descrittivo
  4. Seleziona le autorizzazioni specifiche che vuoi concedere
  5. Salva il ruolo
Una volta creati, i ruoli personalizzati possono essere assegnati ai singoli utenti o ai gruppi IdP tramite l’interfaccia di gestione dei membri:
  • Gli admin Enterprise o gli utenti con il permesso Manage Account Membership possono andare alla pagina “Enterprise members” nelle impostazioni Enterprise e assegnare ruoli a livello di account
    • Tieni presente che si tratta dello stesso gruppo di utenti che può creare, modificare ed eliminare ruoli personalizzati
  • Gli admin dell’Organization o gli utenti con il permesso Manage Organization Membership possono andare alla pagina “Organization members” e assegnare ruoli a livello di organizzazione
    • Tieni presente che questi utenti possono assegnare ruoli personalizzati a livello di organizzazione, ma potrebbero non essere in grado di creare, modificare o eliminare ruoli personalizzati
Al momento non supportiamo ruoli multipli per utente, ma questa funzionalità è nella nostra roadmap e prevediamo di supportarla a breve. Attualmente a ogni utente può essere assegnato un solo ruolo per organizzazione e un solo ruolo a livello di account.

Best practice

  • Principio del privilegio minimo: assegna agli utenti solo le autorizzazioni strettamente necessarie per il loro ruolo
  • Usa i gruppi dell’IdP: sfrutta l’integrazione con i gruppi dell’IdP per semplificare la gestione delle assegnazioni di ruolo su larga scala
  • Verifiche periodiche: rivedi regolarmente le assegnazioni di ruolo e le autorizzazioni per assicurarti che siano ancora appropriate
  • Nomi descrittivi: usa nomi chiari e descrittivi per i ruoli personalizzati, in modo che il loro scopo sia immediatamente evidente
  • Documentazione: mantieni una documentazione interna dei tuoi ruoli personalizzati e dei relativi casi d’uso previsti

Problemi comuni

Se un utente non riceve l’autorizzazione prevista,
  • Verifica che l’utente sia assegnato al ruolo corretto per quella specifica organizzazione
  • Assicurati che per il ruolo siano configurate le autorizzazioni necessarie
  • Controlla che l’appartenenza al gruppo IdP sia aggiornata (potrebbe essere necessaria una nuova autenticazione)
Per ulteriore assistenza con la configurazione dei ruoli, contatta il tuo amministratore Devin Enterprise oppure scrivi al support.