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

# Permisos en áreas de trabajo (colaboradores)

El sistema de **Áreas de Trabajo** (Workspaces) es la forma oficial y segura de permitir que terceros colaboren en la gestión de tus aplicaciones, eliminando la necesidad de compartir las credenciales de inicio de sesión de tu cuenta principal.

A continuación, detallamos cómo configurar tu área de trabajo, añadir aplicaciones, gestionar invitaciones y estructurar los permisos de tu equipo.



## 📌 1. Requisitos previos

* **Plan Standard o superior:** La creación de áreas de trabajo y la funcionalidad de invitar colaboradores son recursos exclusivos para suscriptores del plan Standard o superior.
* **Cuentas activas:** Tanto el propietario del área de trabajo como los colaboradores invitados deben tener cuentas individuales registradas y activas en Square Cloud.



## 🏗️ 2. Cómo crear y configurar el Área de Trabajo

Solo el dueño de los recursos puede crear el área de trabajo y asignar las aplicaciones en ella.

**Creando el Área de Trabajo:**
1. Accede a tu panel (Dashboard).
2. Haz clic en el ícono de tu perfil y selecciona la opción **“Crear un Área de Trabajo”**.
3. Define un nombre de identificación para el área y confirma la creación.

**Añadiendo Aplicaciones al Área de Trabajo:**
1. Navega hasta el panel del Área de Trabajo recién creada.
2. Haz clic en el botón **“Añadir nuevo”**.
3. Selecciona en la lista qué aplicaciones formarán parte de este espacio de trabajo.
> **Atención:** Solo el **propietario** del área de trabajo tiene permiso técnico para añadir o eliminar aplicaciones del workspace.



## 🤝 3. ¿Cómo invito a un amigo o miembro al equipo?

El proceso de invitación es asíncrono y utiliza un código de autenticación temporal para garantizar que el acceso se conceda a la cuenta correcta. La coordinación debe realizarse entre el dueño del workspace y el colaborador.

**¿Dónde consigo el código para entrar a un área de trabajo? (Acción del Colaborador)**
Si fuiste invitado a acceder a un workspace, necesitas generar tu código de acceso y enviarlo al administrador:
1. Accede a la pestaña **“Mi Cuenta”** en tu propio panel.
2. Navega hasta la sección **"Autenticación"**.
3. Haz clic para generar un **código de área de trabajo** (código de invitación).
*(Nota: Este código tiene una validez de solo unos minutos por motivos de seguridad. Compártelo inmediatamente con el administrador).*

**¿Cómo añadir al miembro al Área de Trabajo? (Acción del Administrador)**
Con el código temporal del colaborador en mano, el *dueño del área de trabajo* debe:
1. En el panel, seleccionar el Área de Trabajo correspondiente y acceder a las **Configuraciones**.
2. Ir a la pestaña de **Miembros** y hacer clic en **Añadir miembro**.
3. Introducir el código proporcionado por el usuario y definir el nivel de permiso (rol) deseado.



## 🔐 4. Niveles de Permisos (Roles)

Al añadir un colaborador, debes asignarle una función de acceso. Recomendamos aplicar siempre el **Principio del Menor Privilegio**: concede solo el acceso estrictamente necesario para que el miembro realice su función.

* **Visor (View):** Ideal para monitoreo. El miembro solo puede visualizar los paneles (dashboards), métricas de hardware, logs en tiempo real y alertas.
* **Gerente (Manager):** Enfocado en la operación del servicio. Posee todos los permisos de *Visor*, sumando el control del ciclo de vida de las aplicaciones (capacidad de Iniciar, Detener y Reiniciar los servicios).
* **Mantenedor (Maintain/Maintainer):** Orientado a los desarrolladores del proyecto. Posee todos los permisos de *Gerente*, con la adición de control sobre el código fuente (subir/descargar archivos, editar el código directamente en el panel y modificar el archivo de configuración de la aplicación).
* **Administrador (Admin):** Acceso total al workspace. Posee todos los permisos de *Mantenedor*, añadiendo el poder de visualizar y editar datos confidenciales (variables de entorno) y la capacidad de ejecutar y restaurar *Snapshots* (copias de seguridad) del sistema.



## ⚙️ 5. Gestión y Buenas Prácticas

El propietario del área de trabajo mantiene el control absoluto sobre el workspace.

* **Revocación inmediata:** El acceso de cualquier miembro puede ser eliminado en cualquier momento desde las configuraciones. La revocación entra en vigor instantáneamente, interrumpiendo el acceso del colaborador a esas aplicaciones.
* **Flexibilidad de roles:** Es posible promover o degradar los permisos de un colaborador existente sin necesidad de eliminarlo y añadirlo de nuevo.
* **Seguridad en actualizaciones:** Antes de permitir que un miembro con nivel de *Mantenedor* realice cambios críticos en la estructura del código, asegúrate de que se haya generado un Snapshot reciente de la aplicación para facilitar el *rollback* en caso de que algo salga mal.