Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Usuarios, grupos y permisos

En esta página (14)

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#

PermisoClaveQué habilita
Ejecutar pipelinerunPipelineejecutar ingestas/transformaciones
Ejecutar consultasrunQueryejecutar consultas en el datalake
Insertar datosdataInsertgrabar filas nuevas
Actualizar datosdataUpdatemodificar filas existentes
Eliminar datosdataDeleteeliminar filas
Exportar datosexportDatadescargar/exportar resultados
Ver datos PIIviewPIIver 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)#

  1. Ve a Configuración → Usuarios y permisos.
  2. 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.
  3. Atributos para RLS (opcional): define atributos como filial para la seguridad por fila — ver RLS.
  4. Activar/desactivar: un miembro puede estar Invitado, Activo o Desactivado.

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 personaQué pide la pantalla
Todavía no tiene cuentadefine su contraseña (mínimo 8 caracteres) y entra
Ya tiene cuenta en ingestia.ioentra 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 invitadosolo confirma: Aceptar invitación
Inició sesión con otro correola 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:

PantallaCuándo apareceQué hacer
"Esta invitación expiró"pasaron más de 24 horaspide al administrador Reenviar invitación
"Esta invitación fue cancelada"el administrador la canceló, o emitió un enlace más nuevopide Reenviar invitación
"Esta invitación ya se usó"el enlace es de un solo uso y ya fue aceptadoentra 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 enlacepide Reenviar invitación
"Enlace de invitación inválido"enlace inexistente o copiado a mediaspide 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.com como admin (gestiona fuentes, dashboards y personas);
  • a ana@example.com como member con runQuery y exportData activados, pero viewPII desactivado (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#

  • owner es estructural (dueño del workspace) — nunca se concede a un miembro vía el JSON de permisos (el fail-closed lo rebaja a viewer si 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íntomaCausa probableQué hacer
El miembro no logra ejecutar una consultarunQuery desactivado o rol vieweractiva 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ónel enlace se muestra una sola vezusa 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 anteriorusa Reenviar invitación y entrega el enlace más nuevo
El invitado recibió una contraseña y no funcionainvitació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 correoentrega de correo no configurada en el entornocopia 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 abiertahaz clic en Cerrar sesión y volver a esta invitación
El miembro ve PII indebidamenteviewPII activadodesactiva viewPII en el perfil

Próximos pasos: Roles (RBAC) y Seguridad por fila (RLS).

Enlaces relacionados