Aquí invitas personas, defines lo que cada una puede operar sobre los datos y gestionas los accesos no humanos (service principals / claves de API).
Conceptos#
- Usuario (Member): persona con acceso al workspace. Tiene un rol (RBAC) y un conjunto de permisos granulares.
- Grupos / service principals: identidades para automatización (integraciones, API). Un service principal es una identidad no humana con alcances definidos.
- Rol vs. permiso granular: el rol (RBAC) dice qué puede hacer la persona en la plataforma; los permisos granulares refinan qué puede operar sobre los datos.
Los 7 permisos granulares del miembro#
| Permiso | Clave | Qué habilita |
|---|---|---|
| Ejecutar pipeline | runPipeline | ejecutar ingestas/transformaciones |
| Ejecutar consultas | runQuery | ejecutar consultas en el datalake |
| Insertar datos | dataInsert | grabar filas nuevas |
| Actualizar datos | dataUpdate | modificar filas existentes |
| Eliminar datos | dataDelete | eliminar filas |
| Exportar datos | exportData | descargar/exportar resultados |
| Ver datos PII | viewPII | ver columnas sensibles (no enmascaradas) |
Por defecto, un miembro nuevo entra con todos los permisos desactivados (menor privilegio) y estado Invitado.
Disponibilidad#
- Planes: todos. El número de creadores y visualizadores está limitado por el plan (ver Planes).
- Funcionamiento: RBAC y service principals son fail-closed y están cubiertos por pruebas automáticas.
Permisos (para administrar personas)#
- Gestionar miembros exige el rol admin/owner (acción RBAC
member.manage). - Gestionar claves de API/service principals exige admin/owner (
apikey.manage). - Asignar roles es exclusivo del owner (
role.assign).
Configuración (paso a paso)#
- Ve a Configuración → Usuarios y permisos.
- Invitar persona: ingresa el nombre y el correo electrónico, elige el rol (admin/miembro/lector) y marca los permisos granulares. La plataforma emite un enlace de activación — cópialo de la pantalla o deja que se envíe por correo electrónico, cuando la entrega esté configurada en el entorno.
- Atributos para RLS (opcional): define atributos como
filialpara la seguridad por fila — ver RLS. - Activar/desactivar: un miembro puede estar
Invitado,ActivooDesactivado.
No existe contraseña provisional. La plataforma nunca envía una contraseña por correo y nunca muestra una contraseña en la pantalla. Quien fue invitado define su propia contraseña al abrir el enlace — o, si ya tiene una cuenta en ingestia.io, entra con la identidad que ya usa. La contraseña de quien ya existe no se modifica con la invitación.
Cómo funciona la invitación (lo que ve la persona invitada)#
El enlace de activación vale 24 horas y sirve una única vez. Al abrirlo:
| Situación de la persona | Qué pide la pantalla |
|---|---|
| Todavía no tiene cuenta | define su contraseña (mínimo 8 caracteres) y entra |
| Ya tiene cuenta en ingestia.io | entra con su contraseña de siempre (y el código MFA, si lo usa) — la contraseña no cambia |
| Ya inició sesión con el correo invitado | solo confirma: Aceptar invitación |
| Inició sesión con otro correo | la pantalla ofrece cerrar sesión y volver a esta invitación |
El workspace y el rol vienen de la invitación, resueltos en el servidor. Nada de eso se elige en el formulario del navegador.
Cuando el enlace ya no vale, la pantalla dice el motivo y qué hacer — y nunca revela de qué workspace era la invitación ni si ese correo existe:
| Pantalla | Cuándo aparece | Qué hacer |
|---|---|---|
| "Esta invitación expiró" | pasaron más de 24 horas | pide al administrador Reenviar invitación |
| "Esta invitación fue cancelada" | el administrador la canceló, o emitió un enlace más nuevo | pide Reenviar invitación |
| "Esta invitación ya se usó" | el enlace es de un solo uso y ya fue aceptado | entra por la pantalla de inicio de sesión; si no reconoces la aceptación, avisa al administrador |
| "Esta invitación fue bloqueada" | demasiados intentos en este enlace | pide Reenviar invitación |
| "Enlace de invitación inválido" | enlace inexistente o copiado a medias | pide Reenviar invitación |
Reenviar, cancelar y quitar#
- Reenviar invitación emite un enlace nuevo e invalida el anterior al instante.
- Cancelar invitación anula el enlace pendiente sin quitar a la persona de la lista.
- Desactivar o quitar al miembro también anula la invitación pendiente. El acceso al workspace deja de resolverse incluso en la sesión abierta — la verificación se hace en cada solicitud, contra la base de datos.
Sello "Invitación por reemitir"
Una persona invitada antes de la corrección del ciclo de invitación recibió una contraseña provisional que no autenticaba en ningún lado. Esas filas aparecen en la lista con el sello Invitación por reemitir. El arreglo es un clic: Reenviar invitación emite un enlace que funciona.
Validación#
- El nuevo miembro aparece en la lista como Invitado, con el rol y el resumen de los permisos, y con Invitación pendiente, válida hasta el ….
- El enlace de activación se muestra para que el administrador lo copie — y desaparece en cuanto se usa.
- Después de la aceptación, el estado pasa a Activo y la persona entra al workspace con el rol concedido.
- Los intentos de acción sin permiso se deniegan (fail-closed) y pueden ser auditados.
Ejemplo#
En Comércio Aurora, Maria (owner) invita:
- a
joao@example.comcomo admin (gestiona fuentes, dashboards y personas); - a
ana@example.comcomo member conrunQueryyexportDataactivados, peroviewPIIdesactivado (Ana analiza ventas sin ver datos sensibles); - a los gerentes de tienda como viewer (solo visualizan dashboards).
Costo#
- Gestionar usuarios y permisos: R$ 0.
- Las licencias adicionales tienen costo comercial (creador adicional; paquetes de visualizadores) — ver Planes.
Seguridad#
- Menor privilegio por defecto (todo desactivado en el registro).
- La invitación no crea, muestra ni envía ninguna contraseña. El enlace de activación se guarda solo como resumen criptográfico (el valor existe dentro del enlace, una vez), expira en 24 horas, vale una única vez y se invalida por reenvío, cancelación, desactivación o eliminación del miembro.
- Aceptar una invitación nunca sobrescribe la contraseña de una cuenta que ya existe.
- MFA disponible por miembro, y exigido en la aceptación de quien ya usa MFA.
- Las claves de API exponen solo campos seguros (nunca el hash/valor crudo) en la UI.
- El permiso Ver datos PII (
viewPII) separa a quien ve datos sensibles.
Límites#
owneres estructural (dueño del workspace) — nunca se concede a un miembro vía el JSON de permisos (el fail-closed lo rebaja aviewersi alguien lo intenta).- El aprovisionamiento automático vía IdP (SCIM) queda apagado hasta que se active para su organización (consulta SSO y SCIM).
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El miembro no logra ejecutar una consulta | runQuery desactivado o rol viewer | activa el permiso / eleva el rol |
| "Acción no permitida para el rol" | RBAC la denegó (fail-closed) | ajusta el rol según la matriz |
| Perdí el enlace de activación | el enlace se muestra una sola vez | usa Reenviar invitación (el enlace anterior queda invalidado) |
| El invitado dice que el enlace "expiró" o "fue cancelado" | pasaron más de 24 h, o un reenvío invalidó el anterior | usa Reenviar invitación y entrega el enlace más nuevo |
| El invitado recibió una contraseña y no funciona | invitación del modelo antiguo (sello Invitación por reemitir) | usa Reenviar invitación: la contraseña antigua no autentica y nunca autenticó |
| El invitado no recibió el correo | entrega de correo no configurada en el entorno | copia el enlace de la pantalla y entrégalo por un canal de confianza |
| "Iniciaste sesión con otra identidad" | la persona abrió el enlace con otra sesión abierta | haz clic en Cerrar sesión y volver a esta invitación |
| El miembro ve PII indebidamente | viewPII activado | desactiva viewPII en el perfil |
Próximos pasos: Roles (RBAC) y Seguridad por fila (RLS).