# Papéis e permissões

Cada pessoa do time tem um papel que define o que ela vê e o que pode mudar. Há quatro papéis, do menor para o maior: Leitor, Membro, Administrador e Proprietário. Você só atribui papéis até o seu próprio nível.

## Papéis padrão

| Papel | Descrição no painel |
|---|---|
| **Proprietário** | Controle total, inclusive apagar o time. |
| **Administrador** | Convida pessoas e gerencia o time. |
| **Membro** | Cria projetos e publica. |
| **Leitor** | Só acompanha projetos e deploys. |

## Quem pode o quê

Cada papel inclui tudo o que o anterior pode.

| Ação | Leitor | Membro | Administrador | Proprietário |
|---|---|---|---|---|
| Ver projetos, deploys, logs e os nomes das variáveis | sim | sim | sim | sim |
| Fazer deploy, rollback e criar projetos e serviços | não | sim | sim | sim |
| Gerenciar domínios, volumes e enviar arquivos nas galerias | não | sim | sim | sim |
| Ver e alterar valores de variáveis não sensíveis do projeto | não | sim | sim | sim |
| Revelar valores sensíveis e credenciais de banco | não | não | sim | sim |
| Variáveis compartilhadas do time | não | não | sim | sim |
| Convidar, mudar papel e remover membros | não | não | sim | sim |
| Tokens de API, integrações e atividade do time | não | não | sim | sim |
| Renomear o time e excluir ou restaurar projeto | não | não | sim | sim |
| Apagar o time e transferir projeto entre times | não | não | não | sim |

O servidor é quem decide em cada chamada. O painel só esconde o que você não pode usar. Quando seu papel só acompanha, a página Time avisa: "Seu papel (X) permite acompanhar o time. Para mudar papéis ou convidar, peça a um administrador."

Ações sensíveis, como convidar um administrador ou proprietário e remover membro, pedem [confirmação de identidade](/seguranca/confirmacao-de-identidade/).

## Papéis por projeto

Dá para limitar um membro ou leitor a alguns projetos, de duas formas:

- Na página **Time**, a coluna **Acesso** tem **Todos os projetos** ou **Só atribuídos**. Com **Só atribuídos**, a pessoa só vê os projetos em que for adicionada. Voltar para **Todos os projetos** amplia o acesso e pede confirmação de identidade.
- Na aba **Membros** de cada projeto, defina o **Cargo no projeto** (Membro ou Leitor) de cada pessoa.

A regra: o cargo no projeto só pode restringir o cargo do time, nunca ampliar. O **Cargo efetivo** mostrado na tabela é o menor dos dois. Proprietários e administradores têm **Acesso total** e ignoram essas linhas. Subir de Leitor para Membro dentro de um projeto pede confirmação de identidade, e você não altera o seu próprio acesso.

## Papéis personalizados

A plataforma também aceita papéis personalizados (até 10 por time, com permissões escolhidas e escopo por projeto ou serviço). Hoje eles não têm tela no painel: o que você enxerga na interface são os quatro papéis padrão. Se precisar de um papel sob medida, fale com o suporte.

## Acesso assistido do suporte

Quando o suporte precisa ver seu time, ele pede acesso e você aprova, nega ou revoga. O acesso tem prazo e é somente leitura ou operacional, conforme o pedido. O pedido chega nas notificações do painel.

## Próximos passos

- [Convites e membros](/times/convites-e-membros/)
- [Visão geral dos times](/times/visao-geral/)
- [Tokens e escopos](/seguranca/tokens-e-escopos/)
