Permissões em áreas de trabalho (colaboradores)

O sistema de Áreas de Trabalho (Workspaces) é a forma oficial e segura de permitir que terceiros colaborem na gestão das suas aplicações, eliminando a necessidade de compartilhar as credenciais de login da sua conta principal.

Abaixo, detalhamos como configurar sua área de trabalho, adicionar aplicações, gerenciar convites e estruturar as permissões da sua equipe.

📌 1. Pré-requisitos

• Plano Standard ou superior: A criação de áreas de trabalho e a funcionalidade de convidar colaboradores são recursos exclusivos para assinantes do plano Standard ou superior.
• Contas ativas: Tanto o proprietário da área de trabalho quanto os colaboradores convidados devem possuir contas individuais cadastradas e ativas na Square Cloud.

🏗️ 2. Como criar e configurar a Área de Trabalho

Apenas o dono dos recursos pode criar a área de trabalho e alocar as aplicações nela.

Criando a Área de Trabalho:

1. No dashboard, abra Áreas de trabalho > Nova área de trabalho.
2. Defina o nome da área de trabalho.
3. Clique em "Criar área de trabalho".

Adicionando Aplicações à Área de Trabalho:

1. Navegue até o painel da Área de Trabalho recém-criada.
2. Clique no botão “Adicionar aplicação”.
3. Selecione na lista quais aplicações farão parte deste escopo de trabalho.

Atenção: Apenas o proprietário da área de trabalho tem permissão técnica para adicionar ou remover aplicações do workspace.

🤝 3. Como convido um amigo ou membro para a equipe?

O processo de convite é assíncrono e utiliza um código de autenticação temporário para garantir que o acesso seja concedido à conta correta. A coordenação deve ser feita entre o dono do workspace e o colaborador.

Onde consigo o código para entrar em uma área de trabalho? (Ação do Colaborador)
Se você foi convidado para acessar um workspace, você precisa gerar o seu código de acesso e enviá-lo ao administrador:

1. Acesse Minha conta > Segurança no seu próprio painel.
2. Clique em "Solicitar código de convite".
3. Envie o código logo ao dono da área de trabalho.

(Nota: o código vale 5 minutos por motivos de segurança.)

Como adicionar o membro à Área de Trabalho? (Ação do Administrador)
Com o código temporário do colaborador em mãos, o dono da área de trabalho deve:

1. No painel, selecionar a respectiva Área de Trabalho e acessar as Configurações.
2. Ir até a aba de Membros e clicar em Adicionar membro.
3. Inserir o código fornecido pelo usuário e definir o nível de permissão (cargo) desejado.

🔐 4. Níveis de Permissões (Roles)

Ao adicionar um colaborador, você deve atribuir uma função de acesso. Recomendamos aplicar sempre o Princípio do Menor Privilégio: conceda apenas o acesso estritamente necessário para que o membro execute sua função.

• Visualizador (View): Ideal para monitoramento. O membro pode apenas visualizar os painéis (dashboards), métricas de hardware, logs em tempo real e alertas.
• Gerente (Manager): Focado na operação do serviço. Possui todas as permissões de Visualizador, adicionando o controle do ciclo de vida das aplicações (capacidade de Iniciar, Parar e Reiniciar os serviços).
• Mantenedor (Maintain/Maintainer): Voltado para os desenvolvedores do projeto. Controla o ciclo de vida (iniciar, parar, reiniciar) e o código (upload/download, edição de arquivos, commits, registros DNS e limpeza de cache), mas não vê as informações de deploy, que ficam com o Gerente. Os cargos não são uma escada: cada um tem permissões próprias.
• Administrador (Admin): Acesso total ao workspace. Possui todas as permissões de Mantenedor, adicionando o poder de visualizar e editar dados confidenciais (variáveis de ambiente) e a capacidade de executar e restaurar Snapshots (backups) do sistema.

⚙️ 5. Gerenciamento e Boas Práticas

O proprietário da área de trabalho mantém o controle absoluto sobre o workspace.

• Revogação imediata: O acesso de qualquer membro pode ser removido a qualquer momento nas configurações. A revogação entra em vigor instantaneamente, derrubando o acesso do colaborador àquelas aplicações.
• Flexibilidade de cargos: É possível promover ou rebaixar as permissões de um colaborador existente sem precisar removê-lo e adicioná-lo novamente.
• Segurança em atualizações: Antes de permitir que um membro com nível Mantenedor realize alterações críticas na estrutura do código, garanta que um Snapshot recente da aplicação foi gerado para facilitar o rollback caso algo dê errado.

Atualizado em: 04/10/2026