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.
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: unevent_idde otro negocio no colisiona. - Los conflictos se resuelven solo dentro del negocio actual; un
idajeno responde404. - Un vendedor recibe
sync_entity_forbiddensi la entidad no está permitida para su token ysync_seller_scope_forbiddensi 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
localStoragey el hub escribe el token del equipo en claro enrestaurant-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-jsfigura en el móvil y no aparece usada ensrc/). 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:
- Respalda antes de cada actualización y guarda una copia fuera del servidor.
- Verifica la restauración en staging: un respaldo que nunca se restauró no está probado.
- Conserva el
.envjunto al respaldo: sinAPP_KEYlos 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 auditantes 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
¿Falta algo o encontraste un error?
Ayúdanos a mejorar esta documentación con tu experiencia real.
Escribir a soporte