Organización

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

¿Qué es una organización?

La organización te permite compartir apps con tu equipo controlando exactamente quién puede hacer qué. Cada cuenta de Capgo pertenece al menos a una organización, y puedes crear tantas como necesites.

El acceso se gestiona mediante control de acceso basado en roles (RBAC). A cada miembro del equipo se le asigna un rol —ya sea a nivel de organización o limitado a una app específica— que determina qué puede ver y hacer. El acceso a los canales se puede ajustar con permisos específicos por canal.

Resumen de ajustes de la organización

Accede a la configuración de la organización haciendo clic en Configuración en la barra lateral izquierda y seleccionando la pestaña Organización en la parte superior. Desde ahí, puedes navegar por estas secciones:

Pestaña	Descripción
General	Ver y editar el nombre, logo y email de gestión
Miembros	Gestionar miembros del equipo y sus permisos
Grupos	Crea y gestiona grupos de usuarios para asignar roles masivamente
Claves de API	Gestiona las keys de API para acceso programático
Planes	Consulta y gestiona tu plan de suscripción
Créditos	Ver y comprar créditos adicionales
Seguridad	Configura políticas de seguridad (2FA, requisitos de contraseña)
Uso	Monitoriza las estadísticas de uso de tu organización
Logs de auditoría	Ver los logs de actividad de tu organización
Webhooks	Configurar integraciones de webhooks
Facturación	Gestionar facturación e invoices

Cómo cambiar de organización

Haz clic en el selector de organización menú desplegable en la parte superior izquierda de la sidebar para ver y cambiar entre las organizaciones a las que tienes acceso.

Gestión de miembros

Ver miembros

La sección de Miembros muestra todos los usuarios con acceso a tu organización y su:

Miembro: Avatar y nombre
Rol: Rol actual (Super Admin, Admin, Billing Manager o Member) con un Activo o Pendiente badge
AccionesEditar rol, gestionar acceso a la app o eliminar de la organización

Los miembros activos se ordenan por prioridad de rol. Las invitaciones pendientes aparecen con un Pendiente badge.

Invitar a un miembro

Haz clic en el + Añadir botón en la sección de Miembros
Una Selecciona un rol aparecerá un modal — elige el rol a nivel de organización para el nuevo miembro:

Los roles disponibles a nivel de organización son:

Miembro — Acceso de solo lectura
Gestor de facturación — Acceso solo a facturación
Administrador — Administración total (sin facturación ni borrado)
Superadministrador — Control total

Haz clic en Confirma, luego completa el formulario de invitación (email, nombre y apellido opcionales, captcha) y haz clic en Enviar invitación.

El usuario invitado recibirá un email con un magic link. Al aceptarlo, se añadirá a la organización con el rol seleccionado.

Asignación de roles a nivel de app

Además del rol a nivel de organización, puedes dar acceso a miembros a apps específicas con un rol más detallado. Haz clic en el Control de acceso botón (icono de escudo) junto a un miembro para abrir el modal de acceso a la app:

Desde este modal puedes:

Buscar y seleccionar una app
Elegir un rol a nivel de app desde el desplegable

Los roles disponibles a nivel de app son:

Admin de la app — Administración completa de una app
Desarrollador de apps — Sube bundles y gestiona dispositivos, pero sin operaciones destructivas
Subidor de apps — Lee los datos de la app y sube bundles
Lector de apps — Acceso de solo lectura a una app

Haz clic en Asignar para otorgar el rol.

Editar el rol de un miembro

Haz clic en el botón de editar (icono de llave) junto a un miembro para cambiar su rol en la organización. Se abrirá el Selecciona un rol mismo modal con el rol actual preseleccionado.

Restricciones:

No puedes cambiar el rol del creador de la organización
No puedes eliminar al último Super Admin; siempre debe haber al menos uno
Para ascender o degradar a un Super Admin, tú también debes ser Super Admin

Eliminar un miembro

Haz clic en el botón de eliminar (icono de papelera) junto a un miembro. Aparecerá un diálogo de confirmación advirtiendo que esta acción no es reversible. Haz clic Eliminar para confirmar. Esto revocará inmediatamente todo su acceso a la organización, sus apps y sus canales.

Resumen de roles

Capgo utiliza control de acceso basado en roles con roles organizados por alcance. Puedes asignar un rol a nivel de organización nivel (acceso total), o limítalo a un solo app. El acceso a los canales se puede personalizar con permisos específicos por canal.

Roles de la organización

Se asignan al invitar a un miembro. Se aplican a toda la organización.

Rol	Nombre interno	Descripción
Superadministrador	`org_super_admin`	Control total: facturación, eliminación y transferencia. Se otorga automáticamente al creador de la org.
Administrador	`org_admin`	Administración completa: gestionar miembros, apps y canales. Sin acceso a facturación ni eliminación.
Gestor de facturación	`org_billing_admin`	Solo facturación: ver/actualizar pagos, facturas y auditoría. Sin acceso a apps o miembros.
Miembro	`org_member`	Acceso de solo lectura en toda la organización y sus apps.

Roles de app

Limitado a una sola app. Úsalos cuando un miembro del equipo deba trabajar solo en una app y no en toda la organización.

Rol	Nombre interno	Descripción
Admin de la app	`app_admin`	Control total de una app: canales, dispositivos y equipo. No puede eliminar ni transferir la app.
Desarrollador de apps	`app_developer`	Sube bundles, gestiona dispositivos, lanza builds y actualiza canales. Sin borrar ni cambiar ajustes.
Subidor de apps	`app_uploader`	Acceso de lectura + subir nuevas versiones de bundles.
Lector de apps	`app_reader`	Solo lectura: estadísticas, bundles, canales, logs y dispositivos.

Anulación de permisos de canal

Por defecto, el acceso al canal se hereda del rol de la app. Puedes anular permisos específicos de canal por usuario o grupo; por ejemplo, permitir que un App Reader también asocie bundles en el staging canal. Consulta Gestión de acceso a nivel de app abajo para saber cómo configurarlo.

Gestión de acceso a nivel de app

Cada app tiene una Pestaña pestaña dedicada donde puedes gestionar quién tiene acceso a la app y qué puede hacer, incluyendo roles de la app y permisos específicos por canal.

Ver el acceso de la app

Ve a tu app y haz clic en Pestaña Acceso. La lista de acceso muestra cada usuario o grupo con:

Email — el email del usuario (o el nombre del grupo)
Rol — su rol a nivel de app (App Admin, App Developer, App Uploader o App Reader)
Otorgado el — cuándo se asignó el rol
Acciones — permisos de canal (icono de escudo), editar rol (icono de llave inglesa) y eliminar (icono de papelera)

Cambiar el rol de una app

Haz clic en el editar botón (icono de llave inglesa) junto a un usuario para cambiar su rol a nivel de app:

Selecciona el nuevo rol y haz clic en Confirma. Los roles disponibles son:

Desarrollador de apps — Sube bundles y gestiona dispositivos, pero sin operaciones destructivas
Subidor de apps — Lee los datos de la app y sube bundles
Lector de apps — Acceso de solo lectura

Sobrescribir permisos de canal

Haz clic en el permisos de canal botón (icono de escudo) junto a un usuario para sobrescribir sus permisos de canal por defecto:

El modal muestra el rol actual del usuario en la app y lista todos los canales con tres permisos que se pueden sobrescribir individualmente:

Permiso	Descripción
Leer	Ver el canal y su bundle actual
Historial	Ver el historial de asignación de bundles
Asociar bundle	Establecer o cambiar el bundle activo en el canal

Cada permiso tiene por defecto Por defecto (permitir) — lo que significa que hereda del rol de la app. Puedes cambiar cualquier permiso a Permitir o Denegar para un canal específico, dándote un control granular sin cambiar el rol general del usuario en la app.

Grupos

Los Groups te permiten asignar roles a un conjunto de usuarios a la vez en lugar de gestionar a cada miembro individualmente. Un grupo pertenece a una organización y puede tener bindings de roles en cualquier scope: org o app.

Ejemplo: Crea un grupo “QA Team” y asígnale el Desarrollador de apps rol en tu app de producción, y cada miembro de ese grupo obtiene acceso de Developer a esa app al instante. Cuando alguien se una o deje el equipo, solo tienes que añadirlo o eliminarlo del grupo; no hace falta tocar los role bindings individuales.

Cómo funcionan los grupos

Un grupo es org-scoped — pertenece a una sola organización y no puede abarcar varias.
Asignas roles a un grupo de la misma forma que a un usuario: el grupo aparece como un principal en los role bindings.
Cuando se comprueban los permisos de un usuario, sus membresías de grupo se resuelven automáticamente. Si alguno de sus grupos tiene un rol que otorga el permiso requerido, se concede el acceso.
Un usuario puede pertenecer a varios grupos y los permisos de todos ellos se combinan.

Ver los grupos

Navigate to the Grupos pestaña en la configuración de tu organización. La lista de grupos muestra el nombre, descripción, rol, fecha de creación, y acciones (editar o eliminar).

Crear un grupo

Haz clic en el + Añadir botón para abrir la página de creación de grupos:

Completa:

Nombre (obligatorio) y Descripción (opcional)
Rol en la organización — asigna opcionalmente un rol a nivel de org (None, Admin, Billing Manager o Member)
Control de acceso pestaña — asigna roles a nivel de app haciendo clic + Añadir app, seleccionar una app y elegir un rol (ej. App Uploader, App Developer)

Necesitas Superadministrador o Administrador para crear grupos.

Gestionar miembros del grupo

Haz clic en un grupo para abrir su vista de detalles. Cambia a la Miembros pestaña:

Desde aquí puedes ver los miembros actuales y sus correos. Haz clic en + Añadir para añadir miembros:

El modal muestra todos los miembros de la organización. Busca por nombre, marca los miembros que quieras añadir y haz clic en Añadir miembros.

Facturación

Solo Superadministrador (org_super_admin) y Gestor de facturación (org_billing_admin) puede gestionar la facturación. Los planes están vinculados a una organización, no a tu cuenta personal.

FAQ

¿Puedo crear más de una organización?

Sí. Puedes crear tantas organizaciones como necesites y cambiar entre ellas usando el selector de organizaciones en la barra lateral.

¿Cómo configuro las políticas de seguridad?

Los Super Admins pueden configurar la obligatoriedad de 2FA, políticas de contraseñas y la seguridad de las claves API desde la Seguridad pestaña. Ver Seguridad de la organización para más detalles.

¿Puedo dar acceso a solo una app o canal?

Sí — asígnales un rol con alcance de app (como Desarrollador de app o Lector de app) desde la página de Members o la pestaña Access de la app. Puedes ajustar su acceso por canal usando anulaciones de permisos de canal. Referencia de control de acceso para ver la lista completa de roles.

¿Cuál es la diferencia entre Admin y App Admin?

Administrador (org_admin) tiene autoridad sobre toda la organización: todas las apps, canales y miembros. Admin de app (app_admin) tiene el mismo nivel de control, pero solo sobre una app específica y sus canales. Usa App Admin cuando quieras delegar el control total de una app sin dar acceso al resto de la org.

Continuar desde Organización

Si estás usando Organización para planificar las operaciones del dashboard y de API, conéctalo con Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para el detalle de implementación en API Keys, Dispositivos para el detalle de implementación en Devices, y Bundles para el detalle de implementación en Bundles.