> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.