ElVendedorDocs

Seguridad y respaldos

Autenticación con Sanctum, aislamiento por negocio, roles, manejo de secretos, HTTPS, respaldos y qué datos no deben salir nunca en soporte.

Para implementadores5 min de lecturaActualizado el 16 de noviembre de 2026

El backend concentra la autoridad: emite tokens, aísla negocios, audita eventos y decide qué rol puede escribir. Al terminar sabrás revisar la postura de seguridad de una instalación, respaldarla y no filtrar datos en una sesión de soporte.

Autenticación y tokens

La autenticación es Sanctum con tokens Bearer. Cada token lleva una ability y esa ability decide qué puede hacer:

Ability Quién la recibe Alcance
sync:owner Dueño (login o auth/sync-token) Todo el negocio; único rol que puede reprocesar eventos fallidos y gestionar vendedores.
sync:seller Vendedor invitado (auth/seller-token) Subconjunto de entidades y scope por almacén.
consumer Comprador del marketplace Solo sus pedidos y perfil.

El registro acepta 6 peticiones por minuto; login, emisión y canje de tokens comparten el límite de login. auth/sync-token entrega un token de dueño, auth/seller-token canjea una invitación y logout revoca el token usado.

El token que el móvil comparte con el escritorio viaja como QR con forma {"type":"el-vendedor-sync-token","token":"…"}. Ese QR es la credencial del dueño: quien lo fotografíe puede sincronizar el negocio.

Aislamiento por negocio y roles

El middleware current.business resuelve el negocio del usuario y lo deja en la petición; si no hay negocio actual, responde 409 con «Debes seleccionar un negocio actual para continuar». El contrato de sync añade que el token debe pertenecer al negocio actual: un token de otro negocio no sirve aunque sea válido.

  • Los eventos se evalúan por business_id + event_id: un event_id de otro negocio no colisiona.
  • Los conflictos se resuelven solo dentro del negocio actual; un id ajeno responde 404.
  • Un vendedor recibe sync_entity_forbidden si la entidad no está permitida para su token y sync_seller_scope_forbidden si el movimiento cae fuera de su almacén.

Roles del backend: owner y employee. Los roles operativos de la app (vendedor/mesero, cajero, cocina) viven en el cliente. La licencia la administra el dueño: los roles operativos nunca se bloquean por licencia.

Cifrado local de clientes

  • El móvil guarda el token de activación en localStorage y el hub escribe el token del equipo en claro en restaurant-lan-hub-token.txt; el escritorio persiste su base local sin cifrado documentado. No prometas cifrado del token ni de los datos del equipo.
  • El token del hub autoriza el restaurante completo: trátalo como una contraseña.

Pendiente de validación

  • La documentación comercial afirma «almacenamiento local cifrado», pero en el código revisado no hay uso de cifrado en los servicios de datos (la dependencia crypto-js figura en el móvil y no aparece usada en src/). Confirma el estado real con el equipo de desarrollo antes de usarlo como argumento de venta.
  • No hay documentación de cifrado en reposo para la base del backend ni para sus respaldos.

Secretos y .env

Variable Cuidado
APP_KEY Cifra cookies y datos sensibles. Rotarla invalida sesiones y datos cifrados.
LICENSING_STATE_SIGNING_KEY Clave HMAC del estado de licencia; vacía, usa APP_KEY.
LICENSING_LEGACY_CONSUMER_KEY / _SECRET Credenciales del shim legacy; sin ellas el shim rechaza todo.
Credenciales de base de datos y almacenamiento Nunca en el repositorio ni en capturas.

Reglas de operación: .env y cualquier *.sqlite quedan fuera de git, y los datos de demo salen de seeders, no de una base binaria. En producción, APP_DEBUG=false, y tras cambiar variables, php artisan config:cache.

Si un secreto se filtra, rota: borra los personal_access_tokens (los equipos vuelven a pedir token con auth/sync-token), fuerza cambio de contraseñas, invalida 2FA, limpia sesiones y regenera APP_KEY si el archivo estuvo en un entorno real. Rota además credenciales de terceros y registra qué se rotó y cuándo.

HTTPS

Los clientes hablan con el backend por HTTPS, detrás de un proxy inverso con certificado válido, y APP_URL tiene que coincidir con ese dominio para que las URLs absolutas salgan bien. El repositorio incluye un bloque de nginx de ejemplo para mapear /wp-json/dlm/ al backend legacy durante la transición, no un vhost de producción completo.

Respaldo y restauración

Un respaldo completo incluye la base de datos, el almacenamiento (storage/app/, con las imágenes de catálogo que sube el backend) y el .env. Los datos operativos de cada cliente viven además en sus equipos: un respaldo de la nube no sustituye al respaldo del escritorio.

Buenas prácticas:

  1. Respalda antes de cada actualización y guarda una copia fuera del servidor.
  2. Verifica la restauración en staging: un respaldo que nunca se restauró no está probado.
  3. Conserva el .env junto al respaldo: sin APP_KEY los datos cifrados no se leen, y un dump con tokens es tan sensible como el servidor.

Pendiente de validación

  • Los repositorios no traen un comando ni un procedimiento de respaldo/restauración del backend, ni declaran el motor de base de datos de producción. Defínelo con el responsable de infraestructura (herramienta, frecuencia, retención, destino) antes de asumir un compromiso con el cliente.
  • No hay política documentada de auditoría de dependencias: acuerda con el equipo si se ejecuta composer audit / npm audit antes de cada release.

Qué nunca compartir en soporte

Dato Por qué
Token Bearer, activation_token o el QR de sync Dan acceso al negocio completo; el QR del dueño además permite sincronizar.
.env, APP_KEY, credenciales de base o de almacenamiento Permiten descifrar o suplantar la instalación.
Dumps .sqlite / .sql y capturas de la base Contienen hashes, sesiones y tokens.
Contraseñas, códigos 2FA y de recuperación Comprometen cuentas de forma directa.
IPs privadas reales, rutas de máquina y correos personales No hacen falta para diagnosticar y exponen la infraestructura.

Para evidencia, comparte el código de error, las versiones de app y de contrato, la hora y el request_id: basta para reconstruir el caso sin exponer credenciales.

Siguiente paso

↑↓ para navegar · Enter para abrir · Esc para cerrar