Ayuda/Seguridad/Autenticación

Cómo Funciona la Autenticación

¿Qué aprenderás?

SGG utiliza un sistema de autenticación moderno y seguro basado en JWT (JSON Web Tokens) con múltiples capas de protección.

Tipos de autenticación disponibles
Cómo funcionan los tokens JWT
Verificación de email obligatoria
Re-autenticación por inactividad

Tipos de Autenticación

1. Administradores (Email + Contraseña)

  • • Login con email y contraseña (mínimo 8 caracteres)
  • • Verificación de email obligatoria antes de acceder
  • • Tokens JWT con refresh automático cada 25 minutos
  • • Cookies httpOnly para máxima seguridad

2. Empleados (PIN de 4 dígitos)

  • • Acceso rápido al POS, Cocina y Meseros con PIN
  • • PIN único por empleado dentro del negocio
  • • PIN hasheado con bcrypt (nunca se almacena en texto plano)
  • • Re-autenticación automática tras 10 minutos de inactividad

3. Admins con Acceso POS

  • • Opción de configurar PIN para acceso rápido al POS
  • • Combina seguridad de admin con velocidad del PIN
  • • Auto-login desde panel de admin al POS

Sistema de Tokens JWT

Access Token (30 minutos)

Token de corta duración para operaciones normales. Se refresca automáticamente en segundo plano cada 25 minutos.

Refresh Token (7 días)

Token de larga duración almacenado de forma segura en cookies httpOnly. Se usa para obtener nuevos access tokens sin re-login.

Rotación de Tokens

Cada vez que se refresca, se genera un nuevo par de tokens. Los tokens antiguos quedan invalidados automáticamente.

Re-autenticación por Inactividad

Por seguridad, el sistema detecta inactividad y solicita re-autenticación:

  • Administradores: Después de 5 minutos sin actividad, aparece un modal solicitando la contraseña.
  • Empleados POS: Después de 10 minutos sin actividad, se solicita el PIN nuevamente.
  • Detección: Se monitorean eventos como clicks, teclas, scroll y movimientos del mouse.

Medidas de Seguridad Implementadas

Contraseñas hasheadas con bcrypt (12 rounds)
Cookies httpOnly (JavaScript no puede acceder)
HTTPS obligatorio en producción
Bloqueo tras múltiples intentos fallidos (15 min)
Verificación de email obligatoria
Tokens con expiración corta
Centro de ayuda: guías y tutoriales | Nandu