Pular para o conteúdo principal

Visão geral

Funções personalizadas e RBAC permitem ajustar detalhadamente o acesso à aplicação Devin. Administradores do Devin Enterprise podem criar funções personalizadas com permissões específicas e atribuí-las a usuários ou grupos do IdP, proporcionando controle granular sobre quais ações os usuários podem executar na sua implantação do Devin Enterprise. O Devin Enterprise implementa um sistema de funções em dois níveis, com escopos e funcionalidades distintos: funções em nível de organização e funções em nível de conta.

Funções em Nível de Organização

Funções em nível de organização são atribuídas por organização e não se aplicam fora da organização correspondente. Essas funções controlam o acesso a recursos e ações dentro de uma organização específica. Funções em nível de organização podem ser configuradas com as seguintes permissões:
PermissãoDescrição
Use DeepWikiAcesso à funcionalidade DeepWiki
Use Ask DevinAcesso ao recurso Ask Devin
Use Devin SessionsAcesso para criar e usar sessões do Devin
Manage MembershipAdicionar/remover usuários e grupos. Atribuir ou remover funções de permissão
Manage SettingsGerenciar configurações no nível da organização
Manage PlaybooksCriar/editar/excluir playbooks da organização
Manage SecretsCriar/editar/excluir segredos da organização
Manage KnowledgeCriar/editar/excluir base de conhecimento da organização
Manage SnapshotsCriar/editar/excluir snapshots de máquinas
Index RepositoriesIndexar repositórios para geração de conteúdo no AskDevin e no DeepWiki
Manage SessionsEditar sessões do Devin de outros usuários na organização
View SessionsVisualizar sessões do Devin de outros usuários na organização
Manage API KeysCriar/excluir/usar chaves de API
Manage MCP ServersCriar/editar/excluir servidores MCP
View MetricsVisualizar métricas da organização
View ConsumptionVisualizar consumo da organização
Os usuários podem criar suas próprias funções personalizadas com um conjunto específico de permissões ou usar uma das nossas três funções padrão da organização:
  • Admin: Acesso administrativo completo dentro da organização
  • Member: Acesso de usuário padrão com funcionalidades principais
  • DeepWiki Only: Acesso limitado, restrito à funcionalidade DeepWiki e AskDevin, incluindo permissões de indexação de repositórios

Funções em Nível de Conta (Funções Enterprise)

Funções em nível de conta (também conhecidas como funções em nível de enterprise) são atribuídas em toda a enterprise e se aplicam a todas as organizações dentro dela. Usuários com funções em nível de conta herdam automaticamente as permissões correspondentes em nível de organização em todas as organizações das quais são membros. Funções em nível de conta podem ser configuradas com as seguintes permissões:
PermissionDescription
Manage OrganizationsVisualizar/criar/editar/excluir organizações da enterprise
Manage Account MembershipVisualizar/criar/editar/excluir associação à enterprise e às organizações
Manage Enterprise SettingsVisualizar/editar configurações nos níveis de enterprise e de organização
Manage Git IntegrationsCriar/editar/excluir integrações Git (Github, Gitlab, ADO, Bitbucket). Gerenciar permissões de repositório e indexação de repositórios
Manage Chat IntegrationsCriar/editar/excluir integrações de chat como Microsoft Teams ou Slack
Manage Ticket IntegrationsCriar/editar/excluir integrações de tickets como Jira ou Linear
Use Account ToolsUsar sessões do Devin, Ask Devin e DeepWiki em qualquer organização
Manage Account ResourcesCriar/editar/excluir playbooks, segredos e bases de conhecimento em qualquer organização
Manage Account SnapshotsCriar/editar/excluir snapshots de máquinas em qualquer organização. Gerenciar snapshots em nível de conta e indexar repositórios
Index Account RepositoriesIndexar repositórios para geração de AskDevin e DeepWiki em toda a enterprise
Manage SessionsEditar sessões do Devin de outros usuários em qualquer organização
View SessionsVisualizar sessões do Devin de outros usuários em qualquer organização
View Enterprise Infra DetailsVisualizar detalhes da infraestrutura da enterprise
Manage Account API KeysCriar/editar/excluir/usar chaves de API na enterprise e em qualquer organização
Manage Account MCP ServersCriar/editar/excluir servidores MCP em qualquer organização
View Account MetricsVisualizar métricas da enterprise
Manage BillingVisualizar/editar o consumo da enterprise
Os usuários podem criar suas próprias funções personalizadas com um conjunto específico de permissões ou podem usar uma das nossas duas funções de conta padrão:
  • Admin: Acesso administrativo completo em toda a enterprise
  • Member: Acesso padrão de usuário em todas as organizações da enterprise

Integração de Grupos do IdP

Administradores podem atribuir funções personalizadas a grupos do provedor de identidade (IdP). Quando você atribui uma função a um grupo do IdP, todos os membros desse grupo (conforme definido pelo seu provedor de identidade) receberão automaticamente essa função.
  1. Fluxo de Informações de Grupo: Durante a autenticação, o Devin Enterprise recebe informações de grupo do seu IdP.
  2. Atribuição Automática de Funções: Usuários herdam permissões com base em sua associação a grupos do IdP.
  3. Atualizações Dinâmicas: Alterações na associação a grupos são aplicadas quando o usuário se autentica novamente.
Grupos do IdP são compatíveis com conexões SSO corporativas. Entre em contato com o seu administrador se precisar de ajuda com a configuração de grupos.

Criando e Atribuindo Funções Personalizadas

Apenas administradores Enterprise ou usuários com a permissão Manage Account Membership podem configurar funções personalizadas. Acesse as configurações da sua Enterprise e selecione a guia “Roles” para gerenciar funções nos níveis de organização e de conta. Para criar uma função personalizada:
  1. Acesse Enterprise Settings > Roles
  2. Clique em “Create a custom role” para o nível Organization ou Enterprise
  3. Forneça um nome descritivo para a função
  4. Selecione as permissões específicas que deseja conceder
  5. Salve a função
Depois de criadas, as funções personalizadas podem ser atribuídas a usuários individuais ou a grupos do IdP pela interface de gerenciamento de membros:
  • Administradores Enterprise ou usuários com a permissão Manage Account Membership podem acessar a página “Enterprise members” em Enterprise settings e atribuir funções em nível de conta
    • Observe que este é o mesmo conjunto de usuários que pode criar, editar e excluir funções personalizadas
  • Administradores de Organization ou usuários com a permissão Manage Organization Membership podem acessar a página “Organization members” e atribuir funções em nível de organização
    • Observe que esses usuários podem atribuir funções personalizadas no nível de organização, mas talvez não possam criar, editar ou excluir funções personalizadas
Atualmente não oferecemos suporte a múltiplas funções por usuário, mas esse recurso está em nosso roadmap e planejamos oferecê-lo em breve. No momento, cada usuário pode receber apenas uma função por organização e uma função em nível de conta.

Melhores práticas

  • Princípio do menor privilégio: Conceda aos usuários apenas as permissões mínimas necessárias para sua função
  • Use grupos do IdP: Aproveite a integração com grupos do IdP para facilitar o gerenciamento de atribuições de função em larga escala
  • Auditorias regulares: Revise periodicamente as atribuições de função e permissões para garantir que permaneçam adequadas
  • Nomes descritivos: Use nomes claros e descritivos para funções personalizadas, de forma que seu propósito fique evidente
  • Documentação: Mantenha documentação interna sobre suas funções personalizadas e seus casos de uso previstos

Problemas comuns

Se um usuário não estiver recebendo a permissão esperada,
  • Verifique se o usuário está atribuído à função correta para aquela organização específica
  • Certifique-se de que a função tenha as permissões necessárias configuradas
  • Verifique se a associação a grupos no IdP está atualizada (pode ser necessário autenticar-se novamente)
Para suporte adicional com a configuração de funções, entre em contato com o administrador do Devin Enterprise da sua organização ou com o suporte.