> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migração para o RBAC v2

> Como suas funções, permissões e configurações de compartilhamento foram transferidas para o RBAC v2 e como os termos antigos correspondem aos novos.

## Visão Geral

A CrewAI migrou as organizações do sistema de funções original ("RBAC legado") para o [RBAC v2](https://docs-platform.crewai.com/platform/pt-BR/features/rbac.md).
Esta página explica como sua conta fica depois da migração, como os termos antigos correspondem aos novos e o que
verificar quando sua organização estiver no RBAC v2.

O objetivo da migração foi manter o acesso de todos o mais próximo possível do que era. Suas funções legadas e
configurações de compartilhamento foram transformadas em equipes e concessões. Ninguém precisou configurar nada novamente.

## Termos antigos, termos novos

| RBAC legado | RBAC v2 | O que mudou |
| :- | :- | :- |
| **Função** (Owner, Member, funções personalizadas) | **Equipe** | Cada função legada se tornou uma equipe com o mesmo nome e as mesmas pessoas. |
| **Permissão de funcionalidade** (Manage / Read / No access) | **Função** concedida no escopo de **Organização** | Em vez de um nível por funcionalidade, uma equipe tem funções específicas, como **Automation Creator**. |
| **Compartilhamento / visibilidade / whitelist** em um recurso | **Função** concedida em **um recurso** | Cada compartilhamento se tornou uma função naquele recurso, escolhida a partir do seu nível. |
| Tipos de permissão `run`, `traces`, `manage_settings`, `full_access` | **Operator**, **Editor**, **Admin** | Consulte [Níveis de compartilhamento](#níveis-de-compartilhamento). |
| Função **Owner** e owner da organização | Equipe **Administrators** | Owners recebem acesso total por estarem na equipe Administrators. |
| Atribuir uma função a um membro | Adicionar um membro a uma equipe ou dar uma função a ele | Uma pessoa pode pertencer a várias equipes e ter várias funções. |
| **Settings → Roles** | **Settings → Teams** e **Settings → Members** | A página Roles foi desativada. As funções legadas não controlam mais o acesso. |
| Funções personalizadas que você definiu | Equipes personalizadas | Você não pode definir novas funções. Você combina funções da lista da CrewAI. |

## Como sua conta fica depois da migração

### A equipe Administrators

Todos que eram **owners da organização**, ou tinham a função legada **Owner**, estão na equipe gerenciada pela CrewAI
**Administrators**. Essa equipe tem acesso total a tudo na organização.

Owners não recebem mais acesso apenas por serem owners. Se você remover alguém da equipe Administrators, essa pessoa
perde o acesso total.

### Uma equipe para cada função legada

Cada função legada (exceto Owner) se tornou uma **equipe personalizada**:

* A equipe tem o **mesmo nome** da função, por exemplo **Member**, **Developer** ou **Support**.
* A equipe tem as **mesmas pessoas** da função. Pessoas sem função foram tratadas como **Member**, então estão na
  equipe **Member**.
* As permissões de funcionalidade da função se tornaram **funções da equipe**. Consulte [Permissões de funcionalidade](#permissões-de-funcionalidade).
* Tudo o que estava compartilhado com a função foi compartilhado com a equipe.

Essas são equipes personalizadas comuns. Você pode renomeá-las, alterar seus membros e funções ou desativá-las.

### Compartilhamento

Todo compartilhamento foi transferido:

* Um recurso compartilhado com uma **pessoa** agora é uma função dessa pessoa naquele recurso.
* Um recurso compartilhado com uma **função legada** agora é uma função da equipe correspondente naquele recurso.

A função foi escolhida a partir do nível do compartilhamento. Consulte [Níveis de compartilhamento](#níveis-de-compartilhamento).

### Recursos que as pessoas possuem

Quem era dono de um recurso manteve o controle total sobre ele:

| O que possuíam | O que têm agora |
| :- | :- |
| Uma automação | **Automation Admin** nela e **Automation Creator** |
| Um projeto do Crew Studio | **Studio Project Admin** nele e **Studio Project Creator** |
| Uma conexão de aplicação | **Application Connection Admin** nela |

A partir de agora, quem cria um recurso se torna automaticamente seu **Admin**.

### Service accounts

Service accounts não tinham função legada, então não entraram em nenhuma equipe. Elas receberam:

* **Automation Admin** em cada automação que possuem.
* **Application Connection Admin** em cada conexão de aplicação que possuem.
* **Studio Project Admin** no escopo de Organização, para que ainda possam excluir projetos do Studio pela API.

## Permissões de funcionalidade

Esta tabela mostra as funções que cada permissão de funcionalidade legada deu à equipe da função. Todas estão no
escopo de Organização, salvo indicação em contrário.

| Permissão legada | Read | Manage |
| :- | :- | :- |
| `crews_dashboards` (Automações) | Nenhuma função. Todos podem abrir a página Automations, e ela lista as automações em que a pessoa tem uma função. | Automation Creator |
| `studio_projects` | Nenhuma função | Studio Project Viewer, Studio Project Creator, Automation Creator |
| `agents` | Agent Viewer | Agent Admin, Agent Creator |
| `tools` | Skill Operator, Application Connection Creator | Tool Creator, Tool Admin em cada ferramenta existente, Skill Admin, Skill Creator, Application Connection Creator |
| `llm_connections` | Nenhuma função. As conexões compartilhadas determinam o acesso. | LLM Connection Creator |
| `environment_variables` | Nenhuma função. As variáveis compartilhadas determinam o acesso. | Environment Variable Creator |
| `agent_control_plane` | Agent Control Plane Viewer, ACP Policy Viewer | Agent Control Plane Viewer, ACP Policy Viewer, ACP Policy Creator, ACP Policy Admin |
| `invitations` | Nenhuma função | Identity and Access Admin |
| `organization_settings` | Identity and Access Admin | Organization Admin, Identity and Access Admin, Git Repository Operator, Git Repository Creator, Git Repository Admin |
| `default_settings` | Nenhuma função | Organization Admin |
| `usage_dashboards` | Nenhuma função | Usage and Billing Admin |
| `secret_providers` | Nenhuma função | Identity and Access Admin |
| `workload_identity` | Nenhuma função | Identity and Access Admin |
| `training_ui` | Nenhuma função | Nenhuma função |

> [!NOTE]
>
> Se sua organização não ativou a configuração **Git repositories RBAC**, as equipes cuja função legada podia criar
> automações (`crews_dashboards` Manage ou `studio_projects` Manage) também receberam **Git Repository Operator**, para que
> ainda possam escolher um repositório ao fazer deploy.

### O que a equipe Member padrão tem

A função legada padrão **Member** se tornou a equipe **Member**. A menos que você tenha alterado a função Member antes da migração,
a equipe Member tem:

* **Studio Project Viewer**, **Studio Project Creator** e **Automation Creator**
* **Agent Viewer**
* **Skill Operator** e **Application Connection Creator**
* **Agent Control Plane Viewer** e **ACP Policy Viewer**
* **Git Repository Operator**, se a configuração Git repositories RBAC estava desativada
* Uma função em cada recurso que estava compartilhado com a função Member, como variáveis de ambiente da organização

## Níveis de compartilhamento

Cada compartilhamento se tornou uma função naquele recurso. Quando um compartilhamento tinha mais de um nível, foi usado o nível mais alto.

### Automações

| Compartilhamento legado | Função no RBAC v2 |
| :- | :- |
| `full_access` | Automation Admin |
| `manage_settings` | Automation Editor |
| `run`, `human_in_the_loop`, `traces` ou sem nível | Automation Operator |

### Projetos do Crew Studio

| Compartilhamento legado | Função no RBAC v2 |
| :- | :- |
| `view` | Studio Project Viewer |
| `edit` | Studio Project Operator |
| `manage` ou `full_access` | Studio Project Editor, mais Automation Creator para que ainda possam publicar |

### Outros recursos

Os compartilhamentos legados destes recursos não tinham nível. A nova função depende do nível legado da pessoa ou da função
com quem o recurso foi compartilhado.

| Recurso | Compartilhado com alguém que tinha Manage | Compartilhado com qualquer outra pessoa |
| :- | :- | :- |
| Conexão LLM | LLM Connection Admin | LLM Connection Operator |
| Variável de ambiente | Environment Variable Admin | Environment Variable Viewer |
| Ferramenta | (coberto por Tool Admin acima) | Tool Operator |
| Repositório Git | Git Repository Operator | Git Repository Operator |

## O que funciona de forma diferente agora

A maioria das pessoas mantém o mesmo acesso. Estas são as diferenças que você tem mais chance de notar.

### Pessoas ganham acesso

* **Todos na equipe Member podem abrir todos os projetos do Studio** da organização, porque a função Member
  tinha Manage no Studio. Antes, os membros viam apenas os próprios projetos e os projetos compartilhados com eles. Abrir um
  projeto é somente leitura: executá-lo ou editá-lo ainda exige uma função mais alta naquele projeto.
* **Os compartilhamentos de automações ficaram mais simples.** Não existe uma função de automação somente de visualização, então qualquer pessoa com um compartilhamento em uma automação
  agora pode executá-la, ver seus traces e responder a solicitações human-in-the-loop.
* **As configurações não são mais exclusivas dos owners.** Billing, Integrations, Theme e o gerenciamento de membros antes exigiam um owner.
  Agora qualquer pessoa com **Usage and Billing Admin**, **Organization Admin** ou **Identity and Access Admin** pode abri-los.
* **Conexões LLM e variáveis de ambiente compartilhadas ficam visíveis.** Pessoas com um compartilhamento podem ver a conexão ou a
  variável na respectiva página de configurações. Environment Variable Viewer pode revelar o valor da variável.

### Pessoas perdem acesso

* **O acesso somente leitura a algumas configurações terminou.** Read em `usage_dashboards`, `secret_providers`, `default_settings`
  e `workload_identity` não deu nenhuma função. Para restaurá-lo, dê à pessoa ou à equipe a função correspondente da tabela
  [Permissões de funcionalidade](#permissões-de-funcionalidade).
* **Usar as telas de chat e kickoff de uma automação exige uma função nela.** Antes, qualquer membro podia iniciar uma execução,
  verificar seu status ou usar a memória pela Crew UI de uma automação sem um compartilhamento. Agora isso exige pelo menos
  **Automation Operator** naquela automação.
* **Operators não podem ver valores de variáveis de ambiente de automações nem excluir execuções.** Ver valores de variáveis de ambiente agora exige
  **Automation Editor** ou **Automation Admin**. Excluir execuções exige **Automation Admin**.
* **Editors não podem compartilhar nem excluir uma automação.** Quem tinha `manage_settings` sem `full_access` agora é
  **Automation Editor**. Compartilhar e excluir exigem **Automation Admin**.
* **Conexões de aplicação compartilhadas** ficam visíveis apenas para o dono e para a equipe Administrators, até que alguém as compartilhe pelo botão **Share** da conexão.
* **Service accounts e a API de pessoas.** Chamadas de API que convidam usuários, removem usuários ou alteram suas funções exigem
  a função **Identity and Access Admin**. Dê essa função a qualquer service account que use esses endpoints.

### O gerenciamento de acesso funciona de forma diferente

* **A página Roles foi desativada.** As funções legadas não controlam mais o acesso, então alterá-las não teria efeito.
  Use **Settings → Teams** e **Settings → Members**.
* **Convites não definem uma função.** Novas pessoas entram sem acesso. Adicione-as a uma equipe depois que aceitarem o
  convite, ou mapeie um grupo de SSO para uma equipe para que isso aconteça automaticamente.

## Depois da migração: um checklist

**1. Verificar a equipe Administrators**

Vá em **Settings → Teams** e abra **Administrators**. Confirme que estão nela apenas as pessoas que devem ter
acesso total.

**2. Revisar as equipes criadas a partir das suas funções**

Cada função legada agora é uma equipe com o mesmo nome. Verifique seus membros e funções. Renomeie equipes se um nome mais
claro ajudar e desative as equipes de que você não precisa mais.

**3. Decidir quem deve ver todos os projetos do Studio**

A equipe Member pode abrir todos os projetos do Studio. Se isso for amplo demais, remova **Studio Project Viewer** da
equipe Member e compartilhe os projetos com as pessoas que precisam deles.

**4. Planejar como novas pessoas recebem acesso**

Novos membros começam sem acesso. Decida em qual equipe as novas pessoas entram e adicione-as depois que aceitarem o
convite. Com SSO, configure [mapeamentos de grupos](https://docs-platform.crewai.com/platform/en/features/jit-sso.md).

**5. Verificar suas service accounts**

Em **Settings → Service Accounts**, dê **Identity and Access Admin** a qualquer service account que
convide ou gerencie usuários pela API.

**6. Restaurar o acesso somente leitura às configurações, se necessário**

Se alguém dependia de acesso de leitura a uso, provedores de segredos, padrões do Crew Studio ou workload identity, dê
a essa pessoa a função de organização correspondente.

***

> [card] [Precisa de Ajuda?](mailto:support@crewai.com)
>
> Fale com o nosso time de suporte se algo parecer diferente do esperado depois da migração.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.