Rispettare i limiti del client

Può recuperare le radici e leggere le funzionalità, ma il vero compito è rispettarle. Un server affidabile rimane entro i limiti tracciati dall’host. 🚧

Prima di toccare un file, verifichi che il suo percorso si trovi all’interno di una delle radici del client. In caso contrario, rifiuti l’operazione invece di uscire dall’area consentita.

Un percorso insidioso come ../../etc può uscire da una radice. Risolva sempre il percorso in un percorso assoluto e normalizzato prima di confrontarlo con le cartelle consentite.

Verifichi che il percorso risolto sia relativo a una radice. L’helper di pathlib genera un’eccezione se il percorso esce dalla radice, fornendo una risposta chiara sì/no sulla possibilità di procedere.

Se il client non ha mai dichiarato una funzionalità, non la chiami. Rispettare i confini significa fidarsi della negoziazione, non tentare di usare funzionalità mai offerte.

Quando le radici sono vuote o non supportate, non faccia supposizioni sul file system. Limiti ciò che lo strumento può fare e spieghi all’utente il motivo, invece di accedere a percorsi arbitrari.

Le radici stabiliscono un limite esterno, ma Lei può essere ancora più restrittivo. Chieda solo ciò che un’attività richiede davvero, secondo il principio del privilegio minimo, e lasci intatto il resto.

Il rispetto va oltre i percorsi. Rispetti anche il ritmo e i limiti dell’host, così non lo sovraccaricherà di chiamate né ignorerà una cancellazione richiesta dall’utente.

Quando arriva una notifica list_changed sulle radici, ricontrolli i percorsi memorizzati nella cache. Una cartella consentita un minuto fa potrebbe ora trovarsi fuori dall’ambito attuale dell’utente.

Se una richiesta punta fuori dalle radici, restituisca un errore chiaro che il modello possa leggere. Un rifiuto esplicito è preferibile a eseguire in silenzio un’operazione mai autorizzata dall’utente.

Gli utenti continuano a tenere installati i server che rispettano i confini. Un buon ambito trasforma uno strumento potente in uno strumento sicuro, a cui le persone concedono volentieri l’accesso. 💛

Risolve i percorsi, verifica che si trovino all’interno di una radice, evita le funzionalità non dichiarate, riduce le funzionalità con eleganza e rifiuta le operazioni fuori ambito. È questo che rende affidabile un server. ✅