Usuarios (autenticación y autorización por Database)

Esta página describe cómo Anjana Data Platform gestiona la autenticación y la autorización de usuarios a través de la tabla Users del Panel de Configuración, con especial atención al proveedor interno Database.

• Autenticación (¿quién eres?): verifica la identidad del usuario cuando inicia sesión.

• Autorización (¿qué puedes hacer?): determina los permisos del usuario a partir de los roles que tenga asignados. La gestión de la autorización (asignación de roles a usuarios en unidades organizativas) se describe en la página Autorización.

Estructura de la tabla Users

La tabla Users almacena la información de cada usuario que puede autenticarse y ser autorizado en la plataforma.

Cada usuario se define mediante los siguientes campos:

• id: identificador único del usuario en la tabla.

• userName: identificador de inicio de sesión del usuario en la aplicación o en el proveedor de identidades integrado. Es un campo de valor único en la tabla (véase Identificación y autorización del usuario). El userName es, además, el identificador con el que Anjana Data Platform registra la auditoría: cuando la plataforma indica, por ejemplo, que el usuario que ha modificado un término de negocio es lucia.gomez, ese valor es el userName.

• firstName: nombre del usuario.

• lastName: apellidos del usuario.

• email: correo electrónico del usuario. También puede emplearse como identificador de acceso (véase Identificación y autorización del usuario).

• phone: número de teléfono del usuario.

• title: cargo del usuario (campo informativo, no obligatorio).

• Password: hash de la contraseña del usuario en formato BCrypt. El hash es único por usuario, incluso para contraseñas iguales, y puede generarse con cualquier herramienta estándar de BCrypt (véase Comportamiento del campo Password).

• isServiceUser: booleano que indica si es un usuario de servicio (true) o un usuario nominal (false).

Identificación y autorización del usuario

El acceso de un usuario a la plataforma se resuelve en dos fases:

• Identificación (autenticación): el identificador que devuelve el mecanismo de autenticación se compara indistintamente con los valores de userName y de email de la tabla Users. La comparación no distingue mayúsculas de minúsculas (es case-insensitive): por ejemplo, JGarcia y jgarcia se consideran el mismo valor. Por tanto, un usuario puede quedar identificado tanto por su userName como por su email.

• Autorización: una vez identificado, el usuario obtiene los permisos de los roles que tenga asignados. Estos roles se resuelven a partir del registro del usuario en la tabla Users (por su Id), no de su userName ni de su email.

Comportamiento del campo Password

El campo Password almacena el hash BCrypt de la contraseña y presenta el siguiente comportamiento en el Panel de Configuración:

• En el alta y modificación, el valor introducido por el usuario en el campo Password (el hash) se muestra en claro, sin enmascarar.

• En la consulta, el valor del hash no se muestra: aparece enmascarado por seguridad.

• La modificación no permite borrar el contenido de password, solo modificarlo.

• No se rellena durante la sincronización de usuarios.

Alta de usuarios

Los usuarios pueden incorporarse a la tabla Users mediante tres mecanismos:

Alta manual desde el Panel de Configuración

Método recomendado para crear usuarios de forma individual (ruta Schemas → Users → New):

1. Pulsar New.

2. Cumplimentar en el asistente de creación los campos descritos en Estructura de la tabla Users.

3. Pulsar Save para guardar el usuario o Cancel para descartarlo.

Alta mediante API

Permite automatizar el aprovisionamiento de usuarios desde procesos externos. Consulte la documentación de la API de usuarios de Zeus para más detalle.

Sincronización de usuarios

Obtiene y actualiza la información de los usuarios desde el directorio corporativo. Se ejecuta desde Inicio > Acciones > Sincronizar usuarios del Panel de Configuración y se detalla en la página Aprovisionamiento de usuarios.

Modificación de usuarios

La modificación de los atributos de un usuario debe realizarse con precaución.

1. Acceda a Schemas → Users en el Panel de Configuración; se mostrará el listado de usuarios existentes.

2. Localice el usuario que desea modificar; puede filtrar por userName, email u otros campos de la tabla.

3. Pulse el icono del lápiz para abrir el panel de edición.

4. Modifique los campos necesarios: firstName, lastName, email, phone, title y Password (solo si desea cambiar la contraseña). Tenga en cuenta el comportamiento del campo Password descrito en apartados anteriores.

5. Guarde los cambios con Save.

Consideraciones importantes

• userName: es un campo de valor único (restricción de unicidad, incluso insensible a mayúsculas/minúsculas) y se emplea como identificador de inicio de sesión. No se recomienda modificarlo salvo necesidad excepcional, ya que puede estar referenciado en permisos/roles o en atributos de tipo usuario de las plantillas. Si se modifica: realizar una edición masiva para eliminar las referencias en atributos de tipo usuario; cumplir todas las restricciones del campo (unicidad, longitud, caracteres válidos); el usuario deberá iniciar sesión con el nuevo valor. Recuerde que la identificación también admite el email (véase Identificación y autorización del usuario).

• Cambio de contraseña: modifique el campo Password con un hash BCrypt válido; el usuario usará en el login la contraseña en claro correspondiente a ese hash. En la modificación, el valor del hash aparece enmascarado. No es posible eliminar una password una vez creada, solo modificarla.

• isServiceUser: campo informativo. No debe modificarse manualmente salvo que el equipo de plataforma lo indique.

Consulta y explotación en base de datos — Visión desarrollador

Además de gestionarse desde el Panel de configuración, la información de los usuarios internos (autenticación por Database) queda almacenada en la tabla zeus.users y puede consultarse en modo lectura para explotarla con fines analíticos. Por ejemplo, permite que el cliente construya su propio data mart, cuadros de mando o informes sobre los usuarios de su plataforma (altas, usuarios de servicio frente a nominales, usuarios por dominio y rol, etc.).

Tabla zeus.users

La información de los usuarios internos se almacena en la tabla zeus.users. Sus columnas, disponibles para su consulta, son:

Restricciones e índices relevantes

• Clave primaria: users_pkey (id_user)

• Unicidad de email: UNIQUE (email)

• Unicidad de username: UNIQUE (user_name)

• Unicidad case-insensitive de username:
  CREATE UNIQUE INDEX unique_lower_username ON zeus.users (lower(user_name::text));
  Esto evita duplicados por mayúsculas/minúsculas (por ejemplo, jgarcia y JGarcia).

Tablas relacionadas para enriquecer las consultas

Para obtener una vista más completa, la tabla de usuarios puede cruzarse con otras tablas del modelo:

• zeus.user_ou_role: asignación de roles a usuarios por unidad organizativa; permite conocer la autorización de cada usuario (enlazando id_user con user_id).

• A través de user_ou_role, las tablas zeus."role" (rol) y zeus.organizational_unit (dominio de datos) completan la vista de quién puede hacer qué y dónde.

Ejemplos de consulta

Listado de usuarios sin la credencial (password_hash):

SELECT id_user,
       user_name,
       first_name,
       last_name,
       email,
       title,
       is_service_user
FROM zeus.users
ORDER BY user_name;

Recuento de usuarios de servicio frente a nominales (útil como métrica para un data mart):

SELECT is_service_user,
       COUNT(*) AS total
FROM zeus.users
GROUP BY is_service_user;

Usuarios con sus roles y dominios de datos (autorización efectiva):

SELECT u.user_name,
       ou.alias    AS unidad_organizativa,
       r.role_name AS rol
FROM zeus.users u
JOIN zeus.user_ou_role uor        ON u.id_user = uor.user_id
JOIN zeus.organizational_unit ou  ON uor.ou_id = ou.id_organizational_unit
JOIN zeus."role" r               ON uor.rol_id = r.id_role
ORDER BY u.user_name;