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 situazionePratiche consigliatemotivo
Il nome del file originale dell'utente deve essere visualizzato sull'interfacciaNome visualizzato riservato solo alla visualizzazioneNome visualizzato separato dal percorso del disco per evitare incroci di percorso
È necessario salvare i file caricatiIl server genera un ID interno e unisce il percorso di archiviazioneEvita di sovrascrivere con nomi duplicati e non essere influenzato dall'input dell'utente
L'estensione del file deve partecipare all'archiviazionePrendi il suffisso dall'elenco dei server consentitiNon copiare le estensioni fornite dagli utenti
È necessario determinare il vero tipo del fileEffettuare il rilevamento e l'analisi dei contenutiLe 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 ingressoA quale livello dovrebbe essere elaborato?carenze
Contiene il separatore di percorsoNon utilizzato come percorso di archiviazioneRimuovere semplicemente la barra non è sufficiente
estensione PDFRilevamento e analisi dei contenutiLe estensioni possono essere forgiate
Il nome visualizzato contiene HTMLFuoriuscita dell'interfacciaNon puoi risolverlo cambiando il nome del disco
Stesso nome visualizzatoIsolamento interno dell'IDNon dovrebbe sovrascrivere il caricamento precedente

📊 Confronto tra i nuclei

MetodoCosa si può risolvere?Carenze
Usa direttamente il nome file dell'utenteL'implementazione è la più semplicePossono verificarsi attraversamenti di percorso e sovrascrittura di nomi duplicati
Rimuovi solo il separatore di percorsoParte processata dell'inputSemplicemente rimuovere la linea diagonale non basta
Determina il tipo in base all'estensioneDifferenziazione preliminare dei documentiLe estensioni possono essere create e devono essere coordinate con il rilevamento dei contenuti
Il server genera ID interniIsola i file duplicati, con i percorsi controllati dal sistemaRichiede 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.

Esperienza ora: carica il tuo documento per iniziare a tradurre, mantenendo la formattazione originale

Riferimenti: Python pathlib

Aggiornato il 2026-11-15