Groups

Qué se ve
C21 Live Control modela el acceso en dos capas:
- Un User group es una colección de pertenencias. Los usuarios se agrupan para que tengan sentido los listados, filtros y operaciones masivas (un grupo por turno, uno por estudio, uno por equipo de integración).
- Un User profile es el conjunto de campos relevantes para el acceso adjunto a cada usuario. El rol del usuario (
user_role) junto con esos campos decide lo que el usuario puede hacer.
Las dos capas son independientes. Un usuario puede pertenecer a uno o varios User groups, y cada usuario tiene un User profile que rige su acceso.
GET /c21apiv2/crud/usergroups).Entidad User group
La lista de Groups expone tres columnas:
| Columna | Notas |
|---|---|
| Name | Nombre visible (ordenable). |
| # users | Recuento de miembros (ordenable). |
| Users | Lista CSV de los username de los miembros. |
El campo subyacente para los miembros es elements (array de User.id); la UI lo deriva en la columna Users. Los User groups exponen solo esos campos — no es donde se codifican los permisos. Para cambiar lo que un usuario puede hacer, cambia su rol o sus campos de User profile, no el User group.
Campos del User profile expuestos en el editor del User
El editor de Users (ver Users) mezcla los campos del User profile con los del User. Los campos relevantes para el acceso son:
| Etiqueta UI | Campo subyacente | Notas |
|---|---|---|
| Language | language | Idioma UI: 1 = English, 2 = Español. |
| API user | api | Si el usuario puede obtener API tokens. |
| Admin | admin | Si el usuario tiene privilegios admin dentro de la app. |
| Role | role | El rol del usuario (ver abajo). |
| Password version | password_version | 1 = política normal, 2 = política strong. |
| Date active | date_active | Timestamp en el que el perfil pasó a activo. |
| Last password change | last_password_change | Timestamp del último cambio de password satisfactorio. |
Roles
Los dos roles de producto:
| Rol | user_role | Notas |
|---|---|---|
| System Administrator | 1 | Acceso completo. Requerido para gestionar usuarios, User groups, licencias, integraciones y la superficie del sistema. |
| Operator | 2 | Opera el broadcast del día a día: On air, Live streams, Scheduler, Recordings. |
El CRUD de API tokens requiere rol System Administrator. Los API tokens autentican como uno de estos dos roles heredando el rol del usuario al que se emitieron; no hay un rol separado para callers no humanos.
Gestionar User groups
Crear
Abre Add user group, ponle un nombre y elige sus miembros desde la lista de usuarios.
Editar miembros
Abre el grupo y añade o quita miembros de la lista. Un usuario puede pertenecer a varios User groups; añadirlo a uno nuevo no lo quita de los demás.
Borrar
Abre el grupo y elige Delete. Los miembros sobreviven; solo el grupo en sí se elimina.
FAQ
POST /c21apiv2/security/tokens para ese usuario. El token autentica como el usuario (y hereda su rol). No hay un rol separado para callers no humanos en el esquema.