Guida alla risoluzione dei problemi delle sessioni delle app self-hosted dovuti a modifiche di proxy e cookie

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

L’approccio sicuro consiste nel trattare il confronto strato per strato tra richieste dirette e tramite proxy, cookie di risposta, archiviazione del browser e stato della sessione sul backend come una sequenza di verifiche osservabili, non come un singolo comando.

In un’applicazione web self-hosted dietro un reverse proxy, il rischio concreto è che gli utenti vengano disconnessi, rimangano bloccati in un loop di reindirizzamenti o non riescano a stabilire una sessione dopo modifiche al proxy o ai cookie. Registra l’identità attuale e il punto di ripristino, inizia con il test discriminante meno invasivo, interpreta i risultati positivi e negativi prima di modificare un’altra variabile e fermati se lo spazio di archiviazione diventa instabile o se l’unica copia recuperabile verrebbe esposta. Il flusso di lavoro qui sotto termina solo quando il carico di lavoro originale funziona oppure quando le prove raggiungono una soglia che richiede un’escalation.

Riproduci un percorso di sessione e conserva le prove

Scegli un utente, un profilo del browser, un hostname e un percorso di accesso. Registra la prima richiesta che non va a buon fine, la sequenza degli stati, le destinazioni dei reindirizzamenti, gli header di risposta Set-Cookie con i valori oscurati, i cookie della richiesta, i log del proxy, i log dell’applicazione e la modifica esatta della configurazione apportata prima del problema.

Non iniziare cancellando tutti i cookie o ruotando il segreto dell’applicazione. Usa un profilo del browser privato come ambiente di controllo pulito, conservando quello problematico per il confronto. Verifica se l’accesso diretto al backend funziona: così distinguerai i problemi di autenticazione dell’applicazione da quelli relativi all’URL e ai cookie derivati dal proxy.

Fermati se l’applicazione espone token nei log, se il proxy accetta header di inoltro contraffatti da client non attendibili o se l’accesso aggira TLS. Proteggi le credenziali e correggi il perimetro di sicurezza prima di proseguire con la diagnosi dei problemi funzionali.

Verifica schema, host e attendibilità del proxy

Confronta l’URL esterno con quello che l’applicazione ritiene di usare: schema, host, porta, percorso di base e IP del client. Esamina Host, X-Forwarded-Proto o gli header di inoltro standardizzati, e l’elenco dei proxy attendibili dell’applicazione. Un backend che considera HTTP le richieste HTTPS potrebbe rifiutare i cookie Secure o generare un reindirizzamento HTTPS infinito.

Usa un solo proxy affidabile per impostare o sostituire gli header di inoltro e configura l’applicazione affinché si fidi solo di quel proxy. Non aggiungere indiscriminatamente i valori forniti dal client. Dopo ogni modifica, prova un accesso e un reindirizzamento assoluto, invece di modificare insieme gli header del proxy e l’URL di base dell’applicazione.

La guida ZimaSpace sulla diagnosi dell’accesso diretto o tramite proxy applica lo stesso confronto tra accesso diretto e tramite proxy dopo il riavvio di un proxy. L’esempio di Immich è più circoscritto, ma il percorso di verifica è applicabile anche altrove: accertati che la sessione del backend funzioni, quindi controlla le intestazioni di inoltro, il routing e lo stato del browser.

Esamina l’ambito dei cookie e le decisioni del browser

Controlla il nome del cookie, Domain, Path, Secure, HttpOnly, SameSite, la scadenza e l’eventuale presenza di cookie duplicati con lo stesso nome su percorsi o domini diversi. Gli strumenti per sviluppatori del browser mostrano se un cookie è stato memorizzato, rifiutato o omesso dalla richiesta successiva; i soli log del server non rivelano questa decisione.

La spiegazione di OWASP sul comportamento dei cookie SameSite illustra come i valori SameSite controllano l’invio dei cookie nelle richieste cross-site. Se l’autenticazione coinvolge più siti o usa un flusso incorporato, SameSite=None richiede anche Secure; per una semplice applicazione same-site, ampliare inutilmente l’ambito dei cookie indebolisce la sicurezza.

Elimina solo il cookie interessato dal profilo di controllo, dopo averlo registrato, quindi ripeti l’accesso. Se un nuovo cookie funziona mentre quello del profilo conservato non funziona, confronta l’ambito e la scadenza; se entrambi non funzionano, torna a controllare le intestazioni della risposta o l’archiviazione delle sessioni nel backend, invece di cancellare ripetutamente i dati.

Verifica lo stato condiviso delle sessioni e convalida la correzione

Per le applicazioni con più container o repliche, verifica che ogni istanza usi lo stesso segreto per firmare le sessioni, la stessa fonte oraria e, quando necessario, un backend condiviso per le sessioni. Un proxy che alterna le istanze può sembrare causare disconnessioni casuali quando un’istanza non riesce a convalidare il cookie di un’altra.

La trattazione di PortSwigger sul confine di sicurezza SameSite si concentra sulla sicurezza, ma chiarisce che SameSite è un confine imposto dal browser, non un interruttore generico per riparare l’accesso. Mantieni la protezione CSRF rispettando l’origine effettiva dell’applicazione e il relativo flusso di reindirizzamento.

Verifica l’accesso, la disconnessione, la scadenza per inattività, il riavvio del browser, la modifica della password e l’accesso tramite i nomi host interni e remoti previsti. Chiudi il problema solo quando i vecchi cookie non sono più validi in modo sicuro, le nuove sessioni funzionano con il routing normale e nessuna regola di inoltro o attributo dei cookie è stata allentata oltre quanto documentato.

Assistenza e consigli

Altre letture

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.