Il nome del file caricato dal cliente non può essere utilizzato direttamente come percorso di archiviazione: per evitare l'attraversamento del percorso e la duplicazione della copertura del nome
Il file caricato si chiama `../../report.pdf`, il che non significa che il server debba salvarlo con questo nome. Il nome del file proviene dall'utente e appartiene ai dati di input; il percorso del disco appartiene al limite delle autorizzazioni del sistema. Confondere i due può facilmente portare a problemi come l'attraversamento del percorso, la copertura dei nomi duplicati e comportamenti diversi tra Windows e Linux.
Solo perché il file caricato si chiama ../../report.pdf non significa che il server debba salvarlo con questo nome. Gli sviluppatori che scrivono funzioni di caricamento lato server, così come i team che devono gestire i file degli utenti e preoccuparsi dell'attraversamento del percorso e della copertura dei nomi duplicati, incontreranno questo problema. Dopo aver letto questo articolo, sarai in grado di distinguere tra nomi visualizzati e nomi di archiviazione, sapere quali controlli dovrebbero essere eseguiti a ciascun livello ed esaminare la tua implementazione in base agli elementi di accettazione.
Il nome del file proviene dall'utente e appartiene ai dati di input; il percorso del disco appartiene al limite delle autorizzazioni del sistema. Confondere i due può facilmente portare a problemi come l'attraversamento del percorso, la copertura dei nomi duplicati e comportamenti diversi tra Windows e Linux.
Questo articolo utilizza campioni sintetici per dimostrare il metodo di elaborazione. Il codice è stato controllato a campione in un ambiente isolato e non è una garanzia di tutti i file reali o delle prestazioni del prodotto. Prima di elaborare documenti importanti, conservare gli originali e rivederli rispettando i limiti e gli elementi di accettazione nel testo.
Il nome del file caricato può essere utilizzato direttamente come percorso di archiviazione? Conclusione di una frase
Non può essere utilizzato direttamente. Il nome visualizzato viene utilizzato per la visualizzazione dell'interfaccia e il percorso di archiviazione viene generato dal server in base all'ID interno.
| la tua situazione | Pratiche consigliate | motivo |
|---|---|---|
| Il nome del file originale dell'utente deve essere visualizzato sull'interfaccia | Nome visualizzato riservato solo alla visualizzazione | Nome visualizzato separato dal percorso del disco per evitare incroci di percorso |
| È necessario salvare i file caricati | Il server genera un ID interno e unisce il percorso di archiviazione | Evita di sovrascrivere con nomi duplicati e non essere influenzato dall'input dell'utente |
| L'estensione del file deve partecipare all'archiviazione | Prendi il suffisso dall'elenco dei server consentiti | Non copiare le estensioni fornite dagli utenti |
| È necessario determinare il vero tipo del file | Effettuare il rilevamento e l'analisi dei contenuti | Le estensioni possono essere false |
Il nome visualizzato e il nome di archiviazione sono separati
Il nome originale viene mantenuto per la visualizzazione sull'interfaccia, ma l'identificazione interna viene generata dal server. Anche il suffisso di archiviazione dovrebbe provenire dall'elenco consentito lato server, anziché copiare l'estensione fornita dall'utente.
L'esempio seguente costruisce solo un percorso e non crea una directory o un file.
Costruttore del percorso minimo
from pathlib import Path
import re
def storage_path(root, internal_id, extension):
if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
raise ValueError("invalid internal id")
if extension not in {".pdf", ".docx", ".udoc"}:
raise ValueError("unsupported extension")
base = Path(root).resolve()
candidate = (base / (internal_id + extension)).resolve()
if candidate.parent != base:
raise ValueError("outside storage root")
return candidate
root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
try:
storage_path(root, bad, ".pdf")
except ValueError:
pass
else:
raise AssertionError(bad)
Questo esempio presuppone che l'ID interno sia stato generato dal server. Non è un'implementazione sicura dei file di scrittura per ambienti di attacco al disco arbitrari:
- Potrebbe ancora verificarsi una corsa tra il controllo e l'effettiva apertura.
- Le autorizzazioni della directory principale e le politiche di collegamento simbolico devono essere controllate separatamente.
- Un ID univoco non significa inoltre che la politica "nessuna sostituzione" possa essere ignorata.
La sanificazione dei nomi file non è un'autenticazione dei file
La pulizia dei nomi dei file può risolvere solo una parte del problema e diversi fenomeni devono essere gestiti a diversi livelli:
| fenomeno di ingresso | A quale livello dovrebbe essere elaborato? | carenze |
|---|---|---|
| Contiene il separatore di percorso | Non utilizzato come percorso di archiviazione | Rimuovere semplicemente la barra non è sufficiente |
| estensione PDF | Rilevamento e analisi dei contenuti | Le estensioni possono essere forgiate |
| Il nome visualizzato contiene HTML | Fuoriuscita dell'interfaccia | Non puoi risolverlo cambiando il nome del disco |
| Stesso nome visualizzato | Isolamento interno dell'ID | Non dovrebbe sovrascrivere il caricamento precedente |
📊 Confronto tra i nuclei
| Metodo | Cosa si può risolvere? | Carenze |
|---|---|---|
| Usa direttamente il nome file dell'utente | L'implementazione è la più semplice | Possono verificarsi attraversamenti di percorso e sovrascrittura di nomi duplicati |
| Rimuovi solo il separatore di percorso | Parte processata dell'input | Semplicemente rimuovere la linea diagonale non basta |
| Determina il tipo in base all'estensione | Differenziazione preliminare dei documenti | Le estensioni possono essere create e devono essere coordinate con il rilevamento dei contenuti |
| Il server genera ID interni | Isola i file duplicati, con i percorsi controllati dal sistema | Richiede comunque la cooperazione con la politica "No Override" e il controllo dei permessi della directory |
L'archiviazione degli oggetti ha gli stessi confini
R2 o altri oggetti memorizzano tutta la semantica senza il tradizionale attraversamento delle directory, ma le chiavi degli oggetti influenzano comunque l'isolamento, l'overripping e l'esposizione degli URL.
- Non scrivere direttamente la stringa fornita dal tenant in un prefisso condiviso.
- Il downloader non può dedurre l'autorizzazione basandosi solo sui nomi chiave.
I documenti dovrebbero avere un'identità prima di entrare nella traduzione
Accedendo al flusso di lavoro OmniDoc (Voce prodotto), gli utenti possono continuare a vedere nomi di file familiari, internamente usando ID di task e file indipendenti (ID di file).
Identità documentali chiare portano questi vantaggi:
- Quando falliscono e si ritentano, può corrispondere accuratamente al compito originale.
- Il download della traduzione e la successiva correzione di bozze assicurano che il file corretto sia corrispondente.
- Riduce il rischio di confondere il file di qualcun altro con lo stesso nome del risultato attuale.
🎯 Quale metodo ti si addice?
Se devi mostrare il nome del file
Il nome visualizzato originale dell'utente viene mantenuto, ma solo per l'interfaccia, non per il percorso disco.
Se devi salvare e caricare file
Il server genera l'ID interno, prende l'estensione dalla lista di permessi e controlla la copertura e i permessi di directory in base alle politiche effettive.
Se usi l'archiviazione degli oggetti
Non scrivere direttamente le stringhe tenant con il prefisso 'share' e prendi decisioni di autorizzazione separate durante il download.
❓ Domande Frequenti (FAQ)
1. Se rimuovi le linee diagonali, il nome del file diventa sicuro?
Non abbastanza. Rimuovere solo le barre processa solo una parte dell'input; la costruzione del percorso, l'overriing e la determinazione del tipo di file devono ancora essere gestite separatamente.
2. Se l'estensione del file è PDF, può essere confermato come PDF?
No. Le estensioni possono essere forgiate, richiedendo il rilevamento e l'analisi del contenuto.
3. Cosa dovrei fare se il nome visualizzato contiene HTML?
La fuga durante l'uscita dell'interfaccia non può essere risolta cambiando il nome del file sul disco.
4. Dopo aver usato un ID unico, devo comunque disabilitare la sovrascrittura?
Sì. Un ID unico non significa che puoi ignorare la politica "No Override".
📝 Riassunto
Il nome del file di upload dovrebbe essere gestito separatamente dal percorso di archiviazione: il nome visualizzato viene usato per la visualizzazione e il percorso di archiviazione viene generato dal server in base all'ID interno. Path, coperture, tipi e autorizzazioni devono essere verificati separatamente.
Riferimenti: Python pathlib


