Gerenciando 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. Acesse o seu painel (Dashboard).
2. Clique no ícone do seu perfil e selecione a opção “Criar uma Área de Trabalho”.
3. Defina um nome de identificação para a área e confirme a criação.

Adicionando Aplicações à Área de Trabalho:

1. Navegue até o painel da Área de Trabalho recém-criada.
2. Clique no botão “Adicionar novo”.
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 a aba “Minha Conta” no seu próprio painel.
2. Navegue até a seção "Autenticação".
3. Clique para gerar um código de área de trabalho (código de convite).

(Nota: Este código tem validade de apenas alguns minutos por motivos de segurança. Compartilhe-o imediatamente com o administrador).

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. Possui todas as permissões de Gerente, com a adição de controle sobre o código-fonte (fazer upload/download de arquivos, editar o código direto no painel e modificar o arquivo de configuração da aplicação).
• 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: 15/04/2026