ernestohc21
5fa97105c9
- Increased all sidebar navigation icons from text-sm to text-xl for better visibility - Moved user information and logout button from header to sidebar footer - Added user avatar with name and email in expanded sidebar state - Collapsed sidebar shows avatar icon and logout icon button stacked vertically - Simplified header by removing user badge and logout button - Added version info (v1.0.0) in sidebar footer - Improved responsive design for both collapsed and expanded states
221 lines
6.0 KiB
Markdown
221 lines
6.0 KiB
Markdown
# Sistema de Gestión de Usuarios y Permisos
|
|
|
|
Este sistema permite administrar usuarios y controlar qué bases de datos puede ver cada usuario.
|
|
|
|
## Características
|
|
|
|
- ✅ Autenticación con JWT
|
|
- ✅ Roles de usuario (Admin y Usuario normal)
|
|
- ✅ Permisos granulares por base de datos
|
|
- ✅ Gestión completa de usuarios (CRUD)
|
|
- ✅ Sesiones seguras con cookies HTTP-only
|
|
- ✅ Validación de contraseñas fuertes
|
|
|
|
## Instalación
|
|
|
|
### 1. Instalar dependencias
|
|
|
|
```bash
|
|
npm install bcrypt jsonwebtoken pg @types/pg @types/bcrypt @types/jsonwebtoken
|
|
```
|
|
|
|
### 2. Configurar PostgreSQL
|
|
|
|
Ejecuta el script SQL en tu base de datos PostgreSQL:
|
|
|
|
```bash
|
|
psql -h 10.0.20.152 -U postgres -d CONTROLDESK -f database/schema.sql
|
|
```
|
|
|
|
O manualmente desde pgAdmin o DBeaver.
|
|
|
|
### 3. Generar hash de contraseña para admin
|
|
|
|
```bash
|
|
node scripts/generate-password-hash.js
|
|
```
|
|
|
|
Copia el hash generado y actualiza el script `database/schema.sql` con la contraseña real.
|
|
|
|
### 4. Configurar variables de entorno
|
|
|
|
Copia `.env.example` a `.env` y actualiza los valores:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
Asegúrate de cambiar el `JWT_SECRET` por un valor seguro y aleatorio.
|
|
|
|
## Uso
|
|
|
|
### Primer Login
|
|
|
|
1. Ve a `http://localhost:5173/login`
|
|
2. Usuario: `admin`
|
|
3. Contraseña: `Admin123!` (o la que hayas configurado)
|
|
|
|
### Gestión de Usuarios (Solo Admins)
|
|
|
|
1. Inicia sesión como admin
|
|
2. Ve a "Gestión de Usuarios" en el sidebar
|
|
3. Podrás:
|
|
- Crear nuevos usuarios
|
|
- Editar usuarios existentes
|
|
- Activar/desactivar usuarios
|
|
- Eliminar usuarios
|
|
- Asignar permisos de bases de datos
|
|
|
|
### Asignar Permisos
|
|
|
|
1. En la página de "Gestión de Usuarios", haz clic en el ícono de candado 🔒 del usuario
|
|
2. Verás la lista de todas las bases de datos disponibles
|
|
3. Haz clic en "Sin Acceso" para otorgar acceso a una base de datos
|
|
4. Haz clic en "Con Acceso" para revocar el acceso
|
|
|
|
**Nota:** Los usuarios con rol de Administrador tienen acceso a todas las bases de datos automáticamente.
|
|
|
|
### Permisos
|
|
|
|
Cada usuario puede tener los siguientes permisos por base de datos:
|
|
|
|
- **puede_ver**: Permite ver la base de datos en el panel
|
|
- **puede_descargar_backup**: Permite descargar archivos de backup (futuro)
|
|
- **puede_restaurar**: Permite ejecutar restauraciones (futuro)
|
|
|
|
Actualmente, el sistema filtra las bases de datos que el usuario puede ver en:
|
|
- Panel principal (dashboard)
|
|
- Alertas críticas
|
|
|
|
## Roles
|
|
|
|
### Administrador
|
|
- Acceso completo a todas las bases de datos
|
|
- Puede gestionar usuarios y permisos
|
|
- Puede ver la sección "Gestión de Usuarios"
|
|
|
|
### Usuario Normal
|
|
- Solo ve las bases de datos que le han sido asignadas
|
|
- No puede gestionar usuarios
|
|
- No tiene acceso a la sección de administración
|
|
|
|
## Seguridad
|
|
|
|
### Contraseñas
|
|
|
|
Las contraseñas deben cumplir con los siguientes requisitos:
|
|
- Mínimo 8 caracteres
|
|
- Al menos una mayúscula
|
|
- Al menos una minúscula
|
|
- Al menos un número
|
|
- Al menos un carácter especial (!@#$%^&*(),.?":{}|<>)
|
|
|
|
### Sesiones
|
|
|
|
- Las sesiones usan JWT (JSON Web Tokens)
|
|
- Los tokens se almacenan en cookies HTTP-only (no accesibles desde JavaScript)
|
|
- Los tokens expiran después de 7 días
|
|
- En producción, las cookies usan el flag `secure` (solo HTTPS)
|
|
|
|
## Estructura de Base de Datos
|
|
|
|
### Tabla: `usuarios`
|
|
```sql
|
|
id SERIAL PRIMARY KEY
|
|
username VARCHAR(50) UNIQUE NOT NULL
|
|
email VARCHAR(100) UNIQUE NOT NULL
|
|
password_hash VARCHAR(255) NOT NULL
|
|
nombre_completo VARCHAR(100)
|
|
activo BOOLEAN DEFAULT true
|
|
es_admin BOOLEAN DEFAULT false
|
|
fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
ultimo_acceso TIMESTAMP
|
|
```
|
|
|
|
### Tabla: `usuario_base_datos`
|
|
```sql
|
|
id SERIAL PRIMARY KEY
|
|
usuario_id INTEGER NOT NULL (FK a usuarios)
|
|
base_datos_nombre VARCHAR(255) NOT NULL
|
|
puede_ver BOOLEAN DEFAULT true
|
|
puede_descargar_backup BOOLEAN DEFAULT false
|
|
puede_restaurar BOOLEAN DEFAULT false
|
|
fecha_asignacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
```
|
|
|
|
### Tabla: `sesiones`
|
|
```sql
|
|
id SERIAL PRIMARY KEY
|
|
usuario_id INTEGER NOT NULL (FK a usuarios)
|
|
token VARCHAR(255) UNIQUE NOT NULL
|
|
ip_address VARCHAR(50)
|
|
user_agent TEXT
|
|
fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
fecha_expiracion TIMESTAMP NOT NULL
|
|
activa BOOLEAN DEFAULT true
|
|
```
|
|
|
|
## API
|
|
|
|
### Rutas de Autenticación
|
|
|
|
- `GET /login` - Página de inicio de sesión
|
|
- `POST /login?/login` - Procesar inicio de sesión
|
|
- `GET /logout` - Cerrar sesión
|
|
|
|
### Rutas de Usuarios (Solo Admins)
|
|
|
|
- `GET /usuarios` - Página de gestión de usuarios
|
|
- `POST /usuarios?/createUser` - Crear usuario
|
|
- `POST /usuarios?/updateUser` - Actualizar usuario
|
|
- `POST /usuarios?/deleteUser` - Eliminar usuario
|
|
- `POST /usuarios?/managePermissions` - Asignar/revocar permisos
|
|
- `GET /usuarios/api/permissions?userId=X` - Obtener permisos de un usuario
|
|
|
|
## Troubleshooting
|
|
|
|
### Error: "Could not connect to PostgreSQL"
|
|
|
|
Verifica que:
|
|
1. PostgreSQL esté corriendo en el servidor
|
|
2. Las credenciales en `.env` sean correctas
|
|
3. El firewall permita conexiones al puerto 5432
|
|
4. La base de datos `CONTROLDESK` exista
|
|
|
|
### Error: "Invalid token"
|
|
|
|
1. Cierra sesión y vuelve a iniciar sesión
|
|
2. Verifica que `JWT_SECRET` sea consistente
|
|
3. Limpia las cookies del navegador
|
|
|
|
### Error: "User not found"
|
|
|
|
1. Verifica que hayas ejecutado el script SQL
|
|
2. Revisa que el usuario admin se haya creado correctamente:
|
|
```sql
|
|
SELECT * FROM usuarios WHERE username = 'admin';
|
|
```
|
|
|
|
### No puedo ver algunas bases de datos
|
|
|
|
Si eres usuario normal (no admin):
|
|
1. Contacta al administrador para que te asigne permisos
|
|
2. Verifica en la base de datos:
|
|
```sql
|
|
SELECT * FROM usuario_base_datos WHERE usuario_id = TU_ID;
|
|
```
|
|
|
|
## Futuras Mejoras
|
|
|
|
- [ ] Recuperación de contraseña por email
|
|
- [ ] Autenticación de dos factores (2FA)
|
|
- [ ] Registro de auditoría de acciones
|
|
- [ ] Permisos más granulares (lectura, escritura, eliminación)
|
|
- [ ] Grupos de usuarios
|
|
- [ ] API REST para integraciones
|
|
- [ ] Notificaciones por email de cambios de permisos
|
|
|
|
## Soporte
|
|
|
|
Para reportar problemas o sugerencias, contacta al equipo de desarrollo.
|