Guía de solución de problemas de sesiones de aplicaciones autoalojadas para cambios de proxy y cookies

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

El enfoque seguro consiste en tratar la comparación, capa por capa, de las solicitudes directas y las que pasan por el proxy, las cookies de respuesta, el almacenamiento del navegador y el estado de la sesión en el backend como una secuencia de comprobaciones observables, no como un único comando.

En una aplicación web autohospedada detrás de un proxy inverso, el riesgo práctico es que los usuarios cierren sesión, queden atrapados en un bucle de redirección o no puedan establecer una sesión después de cambios en el proxy o las cookies. Registra la identidad actual y el punto de recuperación, empieza por la comprobación menos invasiva, interpreta los resultados positivos y negativos antes de cambiar otra variable, y detente si el almacenamiento se vuelve inestable o si la única copia recuperable quedaría expuesta. El flujo de trabajo siguiente solo termina cuando la carga de trabajo original funciona o las pruebas indican que hay que escalar el caso.

Reproduce una ruta de sesión y conserva las pruebas

Elige un usuario, un perfil del navegador, un nombre de host y una ruta de inicio de sesión. Registra la primera solicitud que falla, la secuencia de estados, las ubicaciones de redirección, los encabezados de respuesta Set-Cookie con los valores ocultos, las cookies de solicitud, los registros del proxy y de la aplicación, y el cambio de configuración exacto que precedió al fallo.

No empieces borrando todas las cookies ni rotando el secreto de la aplicación. Usa un perfil privado del navegador como entorno de control limpio y conserva el perfil que falla para compararlo. Confirma si funciona el acceso directo al backend; así distinguirás la autenticación de la aplicación del comportamiento de las URL y las cookies derivado del proxy.

Detente si la aplicación expone tokens en los registros, el proxy acepta encabezados de reenvío falsificados de clientes no confiables o el inicio de sesión elude TLS. Protege las credenciales y corrige el límite de seguridad antes de continuar con el diagnóstico funcional.

Verifica el esquema, el host y la confianza en los encabezados de reenvío

Compara la URL externa con lo que la aplicación considera que es: esquema, host, puerto, ruta base y dirección IP del cliente. Inspecciona Host, X-Forwarded-Proto o los encabezados de reenvío estandarizados, y la lista de proxies de confianza de la aplicación. Un backend que interpreta que las solicitudes HTTPS son HTTP podría rechazar las cookies Secure o generar un bucle de redirección a HTTPS.

Usa un único proxy de confianza para establecer o reemplazar los encabezados de reenvío y configura la aplicación para que confíe solo en ese salto. No añadas sin más los valores proporcionados por el cliente. Después de cada cambio, prueba un inicio de sesión y una redirección absoluta en lugar de modificar a la vez los encabezados del proxy y la URL base de la aplicación.

La guía de ZimaSpace sobre el diagnóstico del inicio de sesión directo y a través de un proxy aplica la misma comparación entre el acceso directo y el acceso a través de un proxy después de reiniciarlo. Su ejemplo de Immich es más específico, pero el método para recopilar pruebas es aplicable: demuestra que la sesión del backend funciona y luego inspecciona los encabezados de reenvío, el enrutamiento y el estado del navegador.

Inspecciona el alcance de las cookies y las decisiones del navegador

Comprueba el nombre de la cookie, Domain, Path, Secure, HttpOnly, SameSite, la fecha de vencimiento y si hay cookies duplicadas con el mismo nombre en distintas rutas o dominios. Las herramientas de desarrollo del navegador muestran si una cookie se almacenó, se rechazó o se omitió en la siguiente solicitud; los registros del servidor por sí solos no permiten conocer esa decisión.

La explicación de OWASP sobre el comportamiento de las cookies SameSite describe cómo los valores de SameSite controlan el envío de cookies entre sitios. Si la autenticación cruza sitios o usa un flujo integrado, SameSite=None también requiere Secure; en una aplicación sencilla del mismo sitio, ampliar innecesariamente el alcance de la cookie debilita el diseño.

Después de registrarla, elimina solo la cookie afectada en el perfil de control y repite el inicio de sesión. Si una cookie nueva funciona y el perfil conservado falla, compara el ámbito y el vencimiento; si ambas fallan, vuelve a revisar los encabezados de respuesta o el almacenamiento de sesiones del backend, en lugar de borrar el estado repetidamente.

Comprueba el estado compartido de las sesiones y valida la solución

En aplicaciones con varios contenedores o réplicas, confirma que todas las instancias usen el mismo secreto para firmar sesiones, la misma fuente de tiempo y el backend de sesiones compartido cuando sea necesario. Un proxy que alterna entre instancias puede parecer un cierre de sesión aleatorio si una de ellas no puede validar la cookie de otra.

El análisis de PortSwigger sobre el límite de seguridad de SameSite se centra en la seguridad, pero aclara que SameSite es un límite del navegador, no un mecanismo genérico para reparar el inicio de sesión. Mantén la protección contra CSRF y ajústala al origen real de la aplicación y al flujo de redireccionamiento.

Valida el inicio de sesión, el cierre de sesión, la caducidad por inactividad, el reinicio del navegador, el cambio de contraseña y el acceso mediante los nombres de host internos y remotos previstos. Cierra el problema solo cuando las cookies antiguas fallen de forma segura, las sesiones nuevas sobrevivan al enrutamiento normal y no se haya relajado ningún reenvío ni atributo de cookie más allá de lo necesario y documentado.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.